Online exams

EduBook Pro ships with a built-in online exam module. You author the exam on the desktop, publish it, share the link, and the system auto-grades the moment a student hits submit. Scores feed into the student’s profile, the parent dashboard, and the web dashboard automatically.

What you get

Four question types: MCQ, True / False, Fill in the blank (with multiple accepted answers), and Essay (free-form text with manual grading).
Auto-grading the moment a student submits for objective question types. Essay answers get a “needs review” badge until you grade.
Server-side timer (the clock can’t be cheated by closing the tab or changing the device time).
One-attempt-per-student rule with an admin retake override.
A public student player at exams.edubookapp.com/<slug> — no install needed.
Pro-rata score distribution: set a “Total Marks” target and the system spreads it evenly across all questions, or override per question for weighted sections.
CSV export of results.
Bilingual: write each question in English, Arabic, or both — the player picks the right side based on the student’s language.
Question banks (Enterprise) — reuse questions across many exams without retyping.
Math support — write equations in KaTeX and they render properly in both the builder and the player.
Image attachments — drop a diagram or photo into any question and the player shows it inline.

Author an exam

From the sidebar, open Assessments → Exams and click + New Exam.

Fill the form:

Field	Notes
Title (English / Arabic)	At least one of the two is required. Use whichever you teach in.
Type	Monthly / Term Review / Quick Quiz / Final — informational, doesn’t change behaviour.
Subject	Required if you want to limit access by enrollment.
Group	Optional. If empty, students from any group of that subject can attempt.
Duration	In minutes. Server-side enforced.
Opens at / Closes at	Time window for the exam. Students can’t start before the open time; the exam auto-closes at the close time.

Click Create — you land in the builder.
Switch to the Questions tab and add questions. For each question pick the type, write the stem (English, Arabic, or both), and:
- MCQ: type your options, click the letter on the left of the correct one to mark it.
- True / False: click the green or red button.
- Fill in the blank: type the canonical answer, plus any other acceptable variants comma-separated (e.g. mitochondria, Mitochondria, الميتوكوندريا). Comparison ignores case + whitespace.
In the Settings tab, set the Total Marks for the exam. The system distributes them evenly across all questions (e.g. 30 / 2 questions → 15 each, 30 / 4 → 7 / 7 / 8 / 8). For weighted scoring, edit individual question marks afterwards.
Click Publish when ready — the exam goes live within its open/close window.

From the list or the builder header, click Copy public link. The link looks like https://exams.edubookapp.com/ex_abc123.

Share it however you reach the cohort — group WhatsApp, email, classroom screen. The same link works for every enrolled student.

Students authenticate on the landing page with their attendance code — the same six-character code they use to mark attendance. The server verifies they’re enrolled in the exam’s subject / group before letting them in.

How students take the exam

The student opens the link → reads the rules → enters their attendance code → clicks Start.
Questions appear one at a time. Picking an answer saves it immediately to the server; there’s no “back” button — once answered, an answer is committed.
The timer counts down on the player. When it hits zero the exam auto-submits with whatever has been answered so far.
On submit, the student sees their score (if you have Show score immediately turned on) or a “submitted, awaiting release” message.

If a student closes the tab mid-exam, they can re-open the link within the deadline and resume from the same question — answers they already picked are preserved.

Release scores after review

If Show score immediately is off:

The student sees “submitted, awaiting release” until you act.
When you’re ready, open the exam in the builder and click Close exam in the header. All submitted attempts now show their scores.

If you ALSO enable Show correct answers after closing, students and parents see a per-question breakdown after the close — green ticks on the answers they got right, red crosses on wrong ones, plus the correct answer for each wrong pick.

See the results

The Results tab of an exam shows:

Attempts — how many students started the exam.
Submitted — how many actually finished.
Average score — across submitted attempts only.

Below, a table lists each student’s attempt with score, status (submitted / time ran out / abandoned), and the start + submit times. Click View to see what they chose per question, or Reset to delete the attempt and let them retake.

Click Export CSV for a spreadsheet you can hand to a parent or upload to a grade system. The file is UTF-8 with a BOM so Excel opens Arabic names correctly.

Where the scores show up

After a student submits:

Student profile (desktop) — Exam history tab lists every attempt with score and average percentage.
Group profile (desktop) — “View exams” item in each group’s action menu lists all exams attached to that group, with attempt counts and average score.
Parent dashboard (parent.edubookapp.com) — Exams tab on the child page lists attempts with scores and a per-attempt detail view. Correct answers reveal when the exam is closed AND you enabled the toggle.
Web dashboard (app.edubookapp.com) — Exams tab in the bottom nav lists all exams for the tenant, click any for a detail sheet with the same KPIs + attempt list.

Essay questions and manual grading

Essay questions are free-form text — the student types a paragraph or two, the system stores it, and you grade it yourself from the desktop. Use essays when there’s no single correct answer (short analyses, sentence translations, explain-your-reasoning prompts).

How essays show up across the product:

Builder — pick “Essay” as the question type. There’s no correct-answer field, just an optional rubric note for yourself.
Player — the student gets a textarea instead of options.
Submit time — the attempt is saved with a “needs review” badge. The objective questions auto-grade as normal; only the essay portion waits.
Student-facing surfaces — the parent dashboard, web dashboard, and result page all show “pending review” until you grade.

Grading an essay

Open the exam → Results tab.
Find the attempt with the needs review badge.
Click Grade essays.
For each essay question, type the score (0 to the question’s max) and an optional comment.
Save.

The overall score updates immediately and the “pending review” copy disappears from every surface. You can re-grade later if you need to.

Question banks

Question banks let you store a pool of questions once and pull them into many exams without retyping. Enterprise feature.

Creating a bank

From the sidebar, open Assessments → Question banks.
Click + New bank, name it, save.
Add questions the same way you do in the builder, except they live in the bank — not tied to any one exam yet. Use Bulk paste if you have a pre-formatted list (one question per line with options separated by |).

Drag-and-drop reordering, autosave at 350 ms, and the same four question types are supported.

Picking from a bank in an exam

In the exam builder, click + Add from bank in the Questions tab. A picker lists every question in every bank — filter by tag or search the stem. Tick the questions you want, click Add, and they land in the exam ordered like the bank had them. From there you can re-order or override the per-question marks.

Picked questions are copied, not linked — editing the source in the bank later doesn’t change exams that already pulled it. That’s deliberate so a stale exam doesn’t suddenly mutate the night before students sit it.

Math equations (KaTeX)

Wrap inline math in $ … $ and block math in $$ … $$. The builder previews the rendered equation while you type, and the player renders it the same way on the student’s screen.

Example: The integral $\int_0^1 x^2\,dx = \frac{1}{3}$ matters. Both the question stem and any of the answer fields accept math.

Image attachments

Drop an image into the Image slot on any question (or paste from clipboard). The image:

Lives on our object storage; the player loads it from a URL.
Renders inline above the question stem on the student screen.
Has no size cap enforced today, but keep diagrams under ~2 MB for fast load on slow networks.

Use images for diagrams, scans of handwritten problems, or chart questions.

Tips

Bilingual exams: fill both the English and Arabic stems for every question. The player picks the right side from the student’s chosen language. If you teach in Arabic only, leave the English column empty for both title and stems — the player falls back to Arabic gracefully.
One attempt per student by default. To allow a retake, open the Results tab and click Reset on that specific attempt — the student can then start again.
Shuffle questions / shuffle options can be toggled per exam in the Settings tab. Each student gets their own random order.
Cheating mitigation is enforced server-side: timer, no-back-navigation, IP and user-agent logging on every attempt. Tab-switch / blur events are detected but not auto-penalising — use the breakdown to spot patterns and decide.