Panduan Penggunaan untuk Guru

Dari masuk ke panel, membuat bank soal, mengisi soal (Word, JSON, atau ketik langsung), memeriksa kunci dan poin, sampai mengunduh nilai siswa. Semua tangkapan layar diambil dari aplikasi yang berjalan.

01

Alur Kerja Guru

Guru fokus menyusun soal dan memantau hasil. Data siswa, kelas, dan jadwal ujian dikelola admin sekolah.

Beri tahu admin bila bank soal siap

Jadwal ujian dibuat oleh admin dari bank soal Anda. Setelah soal selesai diperiksa, kabari admin agar segera dijadwalkan.

02

Mengenal Akun Guru

Akun guru dibuat oleh admin. Menu di sisi kiri hanya menampilkan fitur yang boleh dipakai guru.

MenuFungsi untuk guru
DashboardRingkasan jumlah siswa, guru, bank soal, token dinamis, serta daftar token ujian yang sedang berjalan.
Bank Soal / UploadMembuat bank soal, mengunduh template, mengimpor dan membuat soal, mengatur kunci dan poin, serta pratinjau. Guru hanya melihat bank soal miliknya sendiri.
Status Ujian & NilaiMemantau siswa yang sedang atau sudah mengerjakan, mengoreksi esai, serta mengunduh nilai dan jawaban.
Analisis Butir SoalMelihat kualitas soal dan sebaran jawaban siswa.
Petunjuk & TentangDokumentasi format soal dan informasi aplikasi.
Dikelola admin, tidak ada di akun guru

Data siswa, kelas, guru, mata pelajaran, jenis ujian, jadwal dan token ujian, cetak kartu peserta, dan pengaturan sistem. Hubungi admin bila mata pelajaran atau kelas yang Anda perlukan belum tersedia, atau bila lupa password.

03

Masuk ke Panel Guru

Panel guru dibuka dari alamat panel admin sekolah, misalnya https://alamat-sekolah/ujian/admin.php.

  1. Buka alamat panel

    Gunakan Chrome atau Edge. Jika ujian berjalan di jaringan lokal, alamatnya mengikuti IP server, misalnya http://192.168.1.100/ujian/admin.php.

  2. Isi username dan password

    Gunakan akun yang diberikan admin. Ikon mata pada kolom password menampilkan password yang diketik.

  3. Klik Login

    Anda diarahkan ke Dashboard.

localhost/ujian/admin.php
Halaman login panel admin dan guru
Halaman login panel admin dan guru

Dashboard menyapa Anda dengan nama akun dan menyediakan pintasan ke Bank Soal, Status Ujian & Nilai, tutorial upload soal, dan bantuan. Di bawahnya ada ringkasan data dan daftar token ujian yang sedang aktif.

localhost/ujian/admin.php?page=dashboard
Dashboard akun guru
Dashboard akun guru
Jaga keamanan akun

Jangan bagikan password kepada siswa. Keluar lewat menu nama Anda di pojok kanan atas bila memakai komputer bersama.

04

Membuat Bank Soal

Bank soal adalah wadah kumpulan soal untuk satu mata pelajaran, jenis ujian, dan kelas. Satu bank soal nantinya dipakai admin sebagai naskah jadwal ujian.

  1. Buka menu Bank Soal / Upload

    Daftar bank soal milik Anda tampil di sini. Kolom Jenis Ujian, Mata Pelajaran, Kelas, dan Tipe Soal membantu mengenali isi tiap bank.

  2. Klik Buat Bank Soal

    Tombol biru di kanan atas daftar. Pilih Jenis Ujian dan Mata Pelajaran, lalu centang kelas sasaran (boleh lebih dari satu).

  3. Periksa nama bank soal

    Nama terisi otomatis dengan format Jenis Ujian, Kelas, Mapel, dan kode unik. Nama boleh diubah, dan tombol Acak Kode membuat kode baru.

  4. Klik Simpan Bank Soal

    Bank soal baru muncul di daftar. Klik tombol Kelola Soal (ikon daftar, berwarna biru) pada barisnya untuk mulai mengisi soal.

localhost/ujian/admin.php?page=soal
Jendela Buat Bank Soal Baru
Jendela Buat Bank Soal Baru
localhost/ujian/admin.php?page=soal
Bank soal tersimpan. Tombol di kolom Aksi: Kelola Soal, Preview, Edit, Backup, dan Hapus
Bank soal tersimpan. Tombol di kolom Aksi: Kelola Soal, Preview, Edit, Backup, dan Hapus
05

Mengisi Soal

Halaman Kelola Soal punya toolbar yang dikelompokkan seperti menu Microsoft Word, dan tetap terlihat saat halaman digulir.

localhost/ujian/admin.php?page=soal
Halaman Kelola Soal pada bank soal yang masih kosong
Halaman Kelola Soal pada bank soal yang masih kosong
KelompokTombol
Input SoalBuat Soal, Template, Impor Soal, Buat via AI
Pratinjau & EksporPreview (tampilan seperti siswa), Ekspor Word
Kunci & PenilaianKunci Excel, Hitung Nilai (hitung ulang nilai bila kunci diubah)
Cadangan & BantuanBackup ZIP, Gambar WebP (kompres gambar), Petunjuk

Ada tiga cara mengisi soal. Pilih yang paling nyaman, dan boleh dikombinasikan pada bank soal yang sama.

A. Menyusun naskah dengan template Word

  1. Klik Template

    Pada grup Input Soal, pilih tipe soal: PG Biasa, PG Kompleks, Benar / Salah, atau Menjodohkan.

  2. Tentukan jumlah soal dan opsi

    Isi Jumlah Soal dan pilih 4 opsi (A–D) atau 5 opsi (A–E).

  3. Klik Unduh Template Word

    Berkas .docx tersimpan di folder Unduhan. Isi soal di Microsoft Word.

localhost/ujian/admin.php?page=soal
Mengatur jumlah soal dan opsi sebelum mengunduh template
Mengatur jumlah soal dan opsi sebelum mengunduh template

Aturan mengisi template: setiap soal ditulis dalam satu tabel tiga kolom (nomor, label opsi, isi). Beri satu baris kosong di antara tabel soal.

NoLabelIsi pertanyaan / pilihan jawaban
1.Teks pertanyaan (gambar boleh disisipkan di sel ini)
APilihan jawaban A
BPilihan jawaban B
CPilihan jawaban C
DPilihan jawaban D
JawabanA (untuk PG Kompleks tulis lebih dari satu, misalnya A, C)
Hal penting di Word

Simpan dengan format Word Document (*.docx) lewat File › Save As, karena format .doc lama berisiko gagal membaca gambar atau kunci. Atur gambar ke In Line with Text (klik kanan gambar › Wrap Text) agar posisinya tidak bergeser. Jangan mengubah susunan kolom tabel pada template.

B. Mengimpor soal

  1. Buka Kelola Soal, klik Impor Soal

    Lakukan pada bank soal tujuan.

  2. Pastikan Pilih Bank Soal sudah benar

    Jendela impor menampilkan bank soal tujuan.

  3. Pilih file soal

    Klik Choose File lalu pilih .docx/.doc, .json, atau .zip (hasil Backup ZIP).

  4. Klik Unggah Soal

    Tunggu sampai muncul pemberitahuan berhasil. Seluruh soal, kunci, dan gambar diproses otomatis.

localhost/ujian/admin.php?page=soal
Jendela Impor Data Soal. Tombol Unduh Template juga tersedia di sini
Jendela Impor Data Soal. Tombol Unduh Template juga tersedia di sini
Periksa hasil impor

Cek kembali tiap soal di daftar Kelola Soal. Opsi kunci ditandai hijau dengan label Kunci. Soal yang keliru dapat diperbaiki lewat tombol edit (kuning) di sisi kanan soal.

C. Mengetik soal langsung

Cocok untuk menambah atau memperbaiki beberapa soal.

  1. Klik Buat Soal

    Jendela Buat Soal Baru terbuka.

  2. Pilih Tipe Soal

    Pilihan Ganda (1 jawaban benar), Pilihan Ganda Kompleks (centang banyak), Benar-Salah (tabel pernyataan), Menjodohkan, atau Esai.

  3. Ketik pertanyaan

    Editor menyediakan huruf tebal, daftar, tabel, sisipkan gambar, tautan, dan tombol Rumus untuk menulis rumus dengan pratinjau langsung.

  4. Isi pilihan jawaban

    Gunakan tombol 4 Opsi (A-D) atau 5 Opsi (A-E) untuk mengatur jumlah pilihan.

  5. Tentukan kunci dan poin

    Gulir ke bawah, pilih kunci jawaban dan isi Poin (Skor), lalu klik Tambah Soal. Soal langsung masuk ke daftar.

localhost/ujian/admin.php?page=soal
Buat Soal Baru: tipe soal, pertanyaan, dan pilihan jawaban
Buat Soal Baru: tipe soal, pertanyaan, dan pilihan jawaban
localhost/ujian/admin.php?page=soal
Pilihan Ganda: kunci jawaban dan poin
Pilihan Ganda: kunci jawaban dan poin
localhost/ujian/admin.php?page=soal
PG Kompleks: centang semua kunci yang benar
PG Kompleks: centang semua kunci yang benar

Menulis rumus matematika

Klik tombol Rumus pada toolbar editor. Pilih simbol dari palet (pecahan dan akar, operasi, huruf Yunani, kalkulus, matriks), atau ketik kode LaTeX langsung. Pilih format Inline ($...$, menyatu dalam kalimat) atau Baris Baru / Display ($$...$$), cek pratinjau real-time, lalu klik Sisipkan Rumus ke Soal.

localhost/ujian/admin.php?page=soal
Editor Rumus Matematika dengan palet simbol dan pratinjau
Editor Rumus Matematika dengan palet simbol dan pratinjau

Contoh kode: \frac{a}{b}, x^2 + y^2 = r^2. Rumus tampil rapi di layar siswa, termasuk saat server tanpa internet.

Membuat soal dengan AI (opsional)

Klik Buat via AI untuk membuka generator soal di jendela samping. Sebutkan topik, jumlah soal, dan kelas, lalu unduh hasilnya sebagai berkas .json dan impor dengan langkah yang sama seperti bagian B. Contoh struktur JSON dapat dilihat lewat tautan Lihat petunjuk format JSON di jendela impor.

Periksa soal buatan AI

Soal hasil AI tetap perlu dibaca ulang oleh guru, terutama kebenaran kunci jawaban dan kesesuaian dengan kompetensi yang diujikan.

06

Memeriksa Soal Sebelum Ujian

Tiga pemeriksaan utama: kunci, poin, dan tampilan seperti siswa.

localhost/ujian/admin.php?page=soal
Daftar soal: tipe soal, poin, dan opsi kunci berwarna hijau
Daftar soal: tipe soal, poin, dan opsi kunci berwarna hijau

Set Poin (total nilai 100)

Klik Set Poin di bawah toolbar, lalu konfirmasi Ya, Set Poin!. Poin seluruh soal dibagi rata otomatis sehingga total tepat 100. Total saat ini selalu tampil di samping tombol. Bila jumlah soal tidak membagi 100 dengan rata, sebagian soal mendapat selisih 0,01 poin agar totalnya tetap 100 (pada contoh di atas, 33,34 dan 33,33).

Preview tampilan siswa

Klik Preview untuk melihat soal persis seperti di layar siswa, lengkap dengan nomor soal dan tombol navigasi. Aktifkan sakelar Kunci di pojok kanan atas untuk menandai jawaban benar. Tombol di sebelahnya membuka pratinjau di tab baru.

localhost/ujian/admin.php?page=soal
Pratinjau soal dengan tampilan halaman ujian siswa
Pratinjau soal dengan tampilan halaman ujian siswa

Kunci Excel dan Hitung Nilai

Klik Kunci Excel untuk memeriksa atau mengubah kunci jawaban secara massal. Pada tab Unduh Template Excel, pilih format sesuai bank soal saat ini (berisi seluruh soal beserta kunci sekarang) atau kustom baru (tentukan tipe dan jumlah soal). Isi kunci di Excel, lalu pakai tab Impor Kunci dari Excel.

localhost/ujian/admin.php?page=soal
Kelola Kunci Jawaban via Excel
Kelola Kunci Jawaban via Excel

Jika kunci diperbaiki setelah siswa selesai ujian, klik Hitung Nilai agar nilai seluruh siswa dihitung ulang dengan kunci terbaru.

Cadangan dan bantuan

  • Backup ZIP: mengunduh bank soal beserta gambarnya. Berkas ini bisa diimpor kembali lewat Impor Soal.
  • Gambar WebP: mengompres gambar soal agar hemat kuota dan cepat dimuat di HP siswa.
  • Petunjuk: membuka dokumentasi format Word, JSON, rumus, dan kunci Excel. Menu yang sama ada di sisi kiri.
localhost/ujian/admin.php?page=panduan
Menu Petunjuk: dokumentasi bank soal di dalam aplikasi
Menu Petunjuk: dokumentasi bank soal di dalam aplikasi
07

Melihat Nilai & Hasil Ujian

Setelah admin menjadwalkan ujian dari bank soal Anda, hasilnya dipantau dan diunduh dari menu Status Ujian & Nilai.

localhost/ujian/admin.php?page=status
Daftar ujian pada Status Ujian & Nilai
Daftar ujian pada Status Ujian & Nilai
  1. Buka Status Ujian & Nilai

    Daftar ujian menampilkan nama ujian, mata pelajaran, kelas, token, waktu, durasi, jumlah soal, dan status.

  2. Unduh rekap nilai

    Klik tombol hijau unduh pada kolom Aksi. File Excel berisi kolom No, Nama Siswa, Kelas, dan Nilai.

  3. Lihat siswa satu per satu

    Klik tombol biru bergambar mata (Lihat Status). Halaman status menampilkan progres, status, waktu mulai dan selesai, lama mengerjakan, dan skor tiap siswa.

  4. Muat data terbaru

    Data tidak diperbarui otomatis agar server tetap ringan. Klik Refresh untuk memuat data terbaru.

  5. Unduh jawaban

    Klik Unduh Jawaban untuk jawaban seluruh siswa dalam Excel, atau tombol di baris siswa untuk jawaban satu siswa.

  6. Koreksi soal esai

    Untuk soal esai, buka Koreksi Jawaban Esai Siswa pada siswa yang sudah selesai, beri nilai, lalu klik Simpan Penilaian.

localhost/ujian/admin.php?page=status&live_exam_id=1
Status siswa per ujian (tampilan dari panel admin, nama dikaburkan)
Status siswa per ujian (tampilan dari panel admin, nama dikaburkan)
TombolHasil unduhan
Unduh Rekap Nilai (daftar ujian)Excel nilai akhir: No, Nama Siswa, Kelas, Nilai.
Unduh Jawaban (halaman status)Excel jawaban seluruh siswa per butir soal.
Ikon Excel di baris siswaExcel jawaban satu siswa.
Tindakan pengawasan

Tombol seperti buka kunci, keluarkan, blokir, dan reset ujian pada gambar di atas umumnya khusus admin. Jika siswa terkunci atau perlu dikeluarkan, hubungi admin atau proktor.

Analisis Butir Soal

Menu Analisis Butir Soal menampilkan kualitas soal setelah siswa selesai: tingkat kesukaran, daya pembeda, rekomendasi (diterima, revisi, ditolak), dan sebaran jawaban pada tiap opsi. Pilih jadwal ujian, klik Analisis, dan ekspor hasilnya ke Excel bila perlu. Hasilnya berguna untuk merevisi soal sebelum dipakai lagi.

localhost/ujian/admin.php?page=analisis
Halaman Analisis Butir Soal
Halaman Analisis Butir Soal
08

Tips & Tanya Jawab

Checklist sebelum ujian dimulai

Soal

  • Semua soal punya kunci jawaban (opsi kunci hijau)
  • Total poin sudah 100
  • Teks, gambar, dan rumus benar di Preview

Cadangan

  • Bank soal sudah di-backup dengan Backup ZIP
  • Berkas Word asli disimpan di tempat aman

Koordinasi

  • Admin sudah diberi tahu bank soal siap dijadwalkan
  • Kelas dan mata pelajaran pada jadwal sudah sesuai

Pertanyaan umum

Gambar dari Word tidak muncul setelah impor

Simpan berkas sebagai .docx, letakkan gambar di dalam sel tabel pertanyaan, dan atur gambar menjadi In Line with Text.

Bank soal guru lain tidak terlihat

Benar. Setiap guru hanya melihat bank soal yang dibuatnya sendiri.

Kunci jawaban salah, padahal ujian sudah selesai

Perbaiki kunci pada soal (atau lewat Kunci Excel), lalu klik Hitung Nilai agar nilai siswa diperbarui.

Data status siswa tidak berubah

Klik Refresh. Data status sengaja tidak diperbarui otomatis.

Menu Data Siswa atau Jadwal Ujian tidak ada

Menu tersebut khusus admin. Hubungi admin sekolah.

Lupa password

Hubungi admin untuk mengatur ulang password akun guru Anda.

Rumus tidak tampil di layar siswa

Pastikan rumus ditulis dengan tombol Rumus (kode LaTeX di antara tanda $). Rumus tetap tampil tanpa internet karena pustakanya sudah ada di aplikasi.

Butuh panduan lebih rinci?

Buka menu Petunjuk di panel untuk dokumentasi format Word, JSON, rumus, dan kunci Excel. Panduan untuk admin ada di Panduan Admin.

Butuh pendampingan untuk guru?

Hubungi kami lewat WhatsApp untuk pelatihan singkat atau bantuan teknis.

Chat WhatsApp Panduan Admin