Tool buat ODOJ-ers Bagian 1: odoj help

[IKLAN] Dengan menginstall aplikasi Android di kanan ini, Anda sudah menunjukkan support secara nyata terhadap usaha mengembangkan aplikasi lokal. Terima kasih, semoga bermanfaat bagi kita semua ... 

Dari iseng bikin buat group sendiri,
akhirnya ... jadilah gateway ini ...
yang bisa dipake oleh seluruh group ODOJ.
Sebagian di antara kami menyebutnya si robot :)
Alhamdulillah, saat ini sudah dipakai di lebih dari 2000 group dari berbagai komunitas.

Buat yang sudah pakai, berikut ini petunjuk pemakaian ...
Buat yang belum pakai, silakan mencari informasinya di group-group lain yang sudah pakai.
Hal itu tidak akan dibahas disini, karena ini bukan tools "resmi".

Perintah yang dikenal

odoj help : menampilkan tulisan ini

odoj help admin : menampilkan bantuan lebih lanjut

odoj doa : menampilkan doa penutup

odoj list : menampilkan list harian.

List harian ditampilkan urut berdasarkan kelompok/tim, dan di dalam tim, urutan berdasarkan juz yang sedang dibaca. Jika misalnya sebuah group dibagi menjadi 3 tim/kelompok, maka list paling atas adalah kelompok 1, kemudian di dalam kelompok 1 itu, tampilan diurut berdasarkan juz. Dilanjutkan ke kelompok 2, di dalamnya juga diurut berdasarkan juz-juz anggota kelompok 2, dan seterusnya. Jika ingin satu group hanya diurut berdasarkan juz, maka group tersebut jangan dibagi-bagi ke dalam tim/kelompok kecil. Untuk mengubah data anggota, silakan baca bagian 2.

odoj tgl list : menampilkan list tanggal tgl

• contoh: odoj 1-sep-2015 list ... perintah ini akan menampilkan list tilawah untuk periode 1-sep-2015 ... Format tanggal bisa menggunakan 1-9-2015 atau 1-sep-2015 (nama bulan dalam bahasa Inggris) atau kata-kata, misalnya besok, kemarin/kemaren, hariini, sekarang, dsb ...
• contoh: odoj kemarin list ... menampilkan list harian kemarin. 

odoj list rekap

menampilkan rekap mingguan. List yang ditampilkan adalah laporan tilawah member 7 hari terakhir, termasuk laporan hari ini. Reward akan ditampilkan jika memang group menerapkan sistem reward.

odoj list mingguan

rekap mingguan (tanpa reward). List yang sama dengan perintah odoj list rekap ... bedanya, reward tidak akan ditampilkan, diganti dengan keterangan sudah lapor atau belum saja.

odoj <tgl> status <belum>

menampilkan member yang sudah/belum lapor saja

- contoh: odoj status ... menampilkan siapa saja yang sudah melapor
- contoh: odoj besok status ... menampilkan siapa saja yang sudah melapor untuk jatah besok
- contoh: odoj status belum ... menampilkan siapa saja yang belum melapor

- contoh: odoj kemarin status belum ... menampilkan siapa saja yang belum melapor untuk jatah juz kemarin.

Perintah yang akan sering digunakan adalah perintah lapor ...
Secara umum, aturannya adalah sebagai berikut :

odoj tgl_odoj lapor nama juz x kholas tgl_kholas jam_kholas

• tgl_odoj
• adalah tanggal jatah juz, atau tanggal list harian yang ingin diproses. Jika tanggal ini dikosongi, maka laporan akan mengacu ke jatah juz yang muncul di laporan harian. Tanggal bisa ditulis dalam format : 1-sep-2015 atau 1-9-2015 atau kata-kata : kemarin, hariini, sekarang, besok, dsb ...
• tgl_kholas
• adalah tanggal kapan kita kholas. Jika tanggal ini dikosong, maka yang digunakan adalah tanggal hari itu. Format tanggal seperti yang berlaku untuk tgl_odoj
• jam_kholas
• adalah jam kapan kita kholas. Jika dikosongi maka yang digunakan adalah jam saat itu. Format jam bisa hh atau hh:mm atau hh.mm.

odoj <tgl> lapor nama juz x

melaporkan status kholas/selesai untuk member nama dengan 'jatah' juz x menggunakan jam laporan saat ini. Kosongi bagian tanggal jika yang dilaporkan adalah jatah juz hari ini. Jika yang dilaporkan bukan hari ini, maka tanggal harus diisi, misalnya kemarin, atau besok.

- contoh: odoj lapor fulan juz 12

- contoh: odoj 8-sep-2015 lapor fulan juz 11

- contoh: odoj besok lapor fulan juz 11

- contoh: odoj kemarin lapor fulan juz 11

odoj <tgl> lapor nama juz x <jam|kholas> hh:mm

lapor sudah kholas juz x dengan jam kholas pada hh:mm

- contoh: odoj lapor fulan juz 12 5:30

- contoh: odoj 8-sep-2015 lapor fulan juz 11 jam 12.25 

- contoh: odoj besok lapor fulan juz 11 kholas jam 17:00 ... perintah ini artinya adalah, fulan lapor untuk jatah juz besok, sudah kholas sekarang/hari ini jam 17:00

- contoh: odoj kemarin lapor fulan juz 11 jam 16:00 ... perintah ini artinya adalah, fulan lapor untuk jatah juz kemarin, baru kholas hari ini jam 17:00

odoj <tgl> lapor nama juz x kemarin hh:mm

lapor sudah kholas juz x kemarin jam hh:mm

- contoh: odoj lapor fulan juz 12 kholas kemarin 19:30 ... fulan lapor untuk jatah juz hari ini, kholasnya sudah kemarin jam 19:30
- contoh: odoj kemarin lapor fulan juz 12 kholas kemarin 19:30 ... fulan telat lapor untuk jatah juz kemaren, kholasnya sudah kemarin jam 19:30

Khusus untuk akhwat, bagi yang sedang berhalangan, laporan bisa menggunakan tambahan keterangan tasmi / tarjim / murattal / murottal / haid ... dan laporan akan dicatat kholas dengan icon khusus.
- contoh: odoj lapor fulana juz 12 murottal 

Laporan juga bisa menggunakan keterangan "sedang dibaca" atau "on progress" atau "otw" ... untuk menandakan bahwa juz nya belum kholas, tetapi sudah lapor.
- contoh: odoj lapor fulan juz 3 sedang dibaca 

Untuk setiap laporan member, gateway akan memberikan respons berupa, laporan berhasil dicatat, dan list siapa saja yang sudah lapor untuk periode yang sama, dan kalimat-kalimat pendek tausiyah.
Untuk member-member yang tidak ingin menampilkan list tersebut, misalnya karena dianggap listnya terlalu panjang, bisa menggunakan perintah laporaja (list tidak ditampilkan, tetapi tausiyah masih ditampilkan), atau perintah lapor0 (list dan tausiyah tidak ditampilkan).
- contoh: odoj laporaja fulan juz 3
- contoh: odoj lapor0 fulan juz 3

odoj <tgl> batal nama

membatalkan laporan kholas

- contoh: odoj batal fulan

Untuk perintah mengganti/menambah/menghapus member dan mengubah-ubah bentuk tampilan laporan harian, akan dibahas di bagian kedua.