Kebun Murajaah · panduan pemasangan

Pasang Kebun Murajaah di akun Google Anda

Data santri akan tersimpan di Google Sheet milik Anda sendiri. Ikuti 11 langkah ini, lalu kirim satu link ke kami lewat WhatsApp.

Sebelum mulai

  • Pakai laptop atau komputer. Menu yang dibutuhkan tidak ada di aplikasi Google Sheets di HP.
  • Masuk dengan akun Google lembaga atau keluarga yang akan menyimpan data santri.
  • Siapkan link "buat salinan" yang kami kirim lewat WhatsApp.

Tampilan Google bisa berbahasa Indonesia atau Inggris, tergantung pengaturan akun Anda. Nama tombol kami tulis dalam keduanya, misalnya Jalankan (Run).

  1. Buat salinan Sheet

    Buka link "buat salinan" dari kami, lalu tekan tombol Buat salinan (Make a copy). Google Sheet baru milik Anda akan terbuka.

  2. Buka Apps Script

    Di Sheet yang baru, buka menu Ekstensi (Extensions), lalu pilih Apps Script. Tab baru berisi kode akan terbuka.

    Menu Extensions di Google Sheets dengan pilihan Apps Script ditandai

  3. Pilih fungsi setup

    Di bagian atas ada daftar fungsi (biasanya bertuliskan doGet). Ketuk daftar itu, lalu pilih setup.

    Daftar fungsi terbuka dengan pilihan setup ditandai

  4. Tekan Jalankan

    Pastikan tertulis setup, lalu tekan Jalankan (Run).

    Tombol Run dan pilihan setup ditandai

  5. Tinjau izin

    Muncul kotak Perlu otorisasi (Authorisation required). Tekan Tinjau izin (Review permissions), lalu pilih akun Google Anda.

    Kotak Authorisation required dengan tombol Review permissions ditandai

  6. Tekan Lanjutan

    Google menampilkan peringatan Google belum memverifikasi aplikasi ini (Google hasn't verified this app). Tekan Lanjutan (Advanced) di kiri bawah.

    Layar peringatan Google dengan tautan Advanced ditandai

    Ini normal. Email yang tertulis di layar itu adalah email Anda sendiri, karena salinan program ini sekarang milik Anda. Program hanya mengakses Google Sheet di akun Anda.

  7. Buka program (tidak aman)

    Tekan tautan paling bawah: Buka … (tidak aman) (Go to … (unsafe)). Nama program di tautan itu bisa berbeda, misalnya "Kebun Murajaah".

    Tautan Go to project (unsafe) ditandai

  8. Izinkan, lalu tunggu

    Tekan Lanjutkan atau Izinkan (Continue / Allow). Tunggu beberapa detik sampai di bagian bawah muncul tulisan Eksekusi selesai (Execution completed).

    Layar izin akses Google Sheets dengan tombol Continue ditandai

    Di Google Sheet Anda sekarang ada tab Laporan, Santri, Jadwal, Hadiah, dan Pengaturan. PIN Ustadz ada di tab Pengaturan. Simpan baik-baik.

  9. Buat deployment baru

    Kembali ke tab Apps Script. Di kanan atas tekan Terapkan (Deploy), lalu Deployment baru (New deployment).

    Menu Deploy terbuka dengan New deployment ditandai

  10. Pilih Aplikasi web dan isi pengaturannya

    Tekan ikon roda di samping Pilih jenis (Select type), lalu pilih Aplikasi web (Web app).

    Jendela New deployment dengan ikon roda ditandai

    Isi pengaturannya seperti ini, lalu tekan Terapkan (Deploy):

    • Jalankan sebagai (Execute as)Saya (Me)
    • Yang memiliki akses (Who has access)Siapa saja (Anyone)

    Kalau Google meminta izin lagi, ulangi langkah 5 sampai 8.

  11. Salin URL, kirim ke kami

    Setelah muncul Deployment berhasil, salin URL aplikasi web (Web app URL) yang berakhiran /exec, lalu kirim ke kami lewat WhatsApp.

    Hasil deployment dengan URL aplikasi web ditandai Kirim URL lewat WhatsApp

    Atau kirim ke WhatsApp 0856-5445-6924.

Setelah itu

  • Kami pasangkan webnya, lalu mengirim alamat web dan cara masuk Halaman Ustadz.
  • Simpan PIN Ustadz dari tab Pengaturan. PIN bisa diganti kapan saja di tab itu.
  • Jangan bagikan Google Sheet ke santri. Santri cukup memakai link pribadinya masing-masing.

Kalau tersangkut

Menu Ekstensi tidak ada

Buka Google Sheet di laptop atau komputer lewat browser. Menu Ekstensi tidak tersedia di aplikasi Google Sheets di HP.

Tombol Jalankan tidak memunculkan kotak izin

Pastikan daftar fungsi di bagian atas sudah bertuliskan setup, bukan doGet atau doPost, lalu tekan Jalankan lagi.

URL saya berakhiran /dev, bukan /exec

Itu URL uji. Ulangi langkah 9 dan pilih Deployment baru (New deployment), bukan Uji deployment.

Terlanjur memilih "Hanya saya" di pengaturan akses

Buka Terapkan › Kelola deployment (Manage deployments), tekan ikon pensil, ubah akses menjadi Siapa saja (Anyone), pilih Versi baru, lalu Terapkan. URL-nya tetap sama.

Muncul tulisan error berwarna merah

Screenshot layarnya dan kirim ke kami lewat WhatsApp. Kami bantu sampai beres.