Skip to content

11. The public quiz experience

Everything described so far in this manual was about the admin side. This chapter is the other half of the story: what pupils, parents and teachers actually see when they use LexiScor.

You do not need to do anything here as an administrator — but understanding the flow helps you support pupils and answer questions from teachers.

The landing page (/)

The public homepage is intentionally minimal. It shows:

  • The LexiScor wordmark.
  • A hero photo of children reading.
  • A green Sign Up button that opens a Google Form (used to register a school or class for the LexiScor programme).
  • A yellow Discover Program button that links to the dedicated LexiScor section on the Editura Gama website.
  • A short tagline.

The homepage is not a directory of available quizzes — pupils reach quizzes via direct links printed in books or shared by teachers, not by browsing.

The quiz start page (/book/<isbn>)

This is the entry point for taking a quiz. The URL contains the book's ISBN, with or without dashes (both /book/9786068942835 and /book/978-606-89428-3-5 work).

The page is split in two:

  • Left side — a large book cover.
  • Right side —
  • The book title.
  • The class and module the book belongs to.
  • A green pill showing the points the quiz is worth.
  • A small metadata bar with three icons: number of questions, time limit (30 minutes), and a link to download a printable copy of the quiz.
  • A name input with placeholder "Enter your name".
  • A green Start Test button (disabled until a name is typed).

If the pupil has previously started this quiz on the same device but did not finish it, a Resume badge appears so they can pick up where they left off.

If no published quiz exists for the book, a friendly message tells them to come back later.

Taking the quiz (/book/<isbn>/take)

Once the pupil clicks Start Test, they land on the quiz-taking screen:

  • One question is shown at a time, with all its answers below.
  • A progress indicator ("Question 5 of 20") shows how far they are.
  • Previous / Next buttons move between questions; a Submit Quiz button replaces Next on the last question.
  • A timer counts down from the 30-minute time limit.
  • The book cover and title remain visible at the top.

A few things happen invisibly to make the experience smooth and fair:

  • Answer order is randomised per pupil when the quiz has Shuffle Answers enabled. The randomisation stays stable while the same pupil takes the quiz, so they don't see the same question twice with answers in different positions.
  • Progress is saved to the browser as they go — closing the tab and re-opening the same URL on the same device resumes the quiz.
  • The system never sends the correct answers to the browser. Scoring is done entirely on the server when the quiz is submitted, so refreshing or "view source" cannot reveal answers.
  • If the timer runs out the quiz is submitted automatically with whatever has been answered so far.

The results page (/book/<isbn>/results/<attemptId>)

Once the quiz is submitted (or auto-submitted at timeout) the pupil lands on a unique results URL. The URL is shareable but contains a random attempt ID, so it is not guessable.

The page shows different things depending on the outcome:

Passed (≥ 80% by default)

  • A short confetti animation to celebrate.
  • A score header with the book cover on the left and a friendly message on the right ("Great job, Sarah!"), the percentage in a green pill, and the time taken.
  • A diploma section:
  • A field for the pupil's email address.
  • A Send Diploma button.
  • After confirmation (see below), a download link for the personalised diploma.
  • A list of other recommended books, so they can keep going.

Failed (below the pass threshold)

  • No confetti — replaced by an encouraging message.
  • The same score header, but with the percentage shown in a red pill.
  • A wrong answers breakdown: each missed question with the answer the pupil chose and the correct one highlighted, so they can learn from their mistakes.
  • The same recommended-books list and a Retake Quiz button.

Timed out

  • A yellow banner reading "Time's up!".
  • The score earned for whatever was answered before time ran out.
  • An encouragement message and the option to retake.

The diploma & email confirmation flow

Diplomas can only be claimed by pupils who passed. The flow is:

  1. On the results page, the pupil types their email address into the diploma section and clicks Send Diploma.
  2. LexiScor sends a confirmation email to that address. The email contains a short message and a confirmation link.
  3. The pupil clicks the link, which opens /confirm-email/<token>. The page shows a green checkmark and the confirmation message "Your email has been confirmed!".
  4. Behind the scenes, LexiScor:
  5. Verifies the link's token (links are single-use and time-limited).
  6. Creates or updates a public-user account for that email.
  7. Links the current attempt — and any earlier anonymous attempts on the same device — to that account.
  8. Emails the diploma (and a results summary) to the address.

From this point on, the pupil can take more quizzes on the same device and they will all be linked to the same account automatically. No password is involved.

The email address and the "results sent / confirmed" status are visible to administrators in the Attempts page, which is how you can verify that diplomas actually went out.

Things teachers and parents often ask

Do pupils need to create an account first? No. They can take a quiz with just a name. An account is only created silently if and when they confirm an email to claim a diploma.

What if a pupil makes a typo in their email? The confirmation email goes to the wrong address and the diploma never arrives. The pupil can simply retake the quiz and try again — the attempt itself is preserved either way.

Can a quiz be retaken? Yes, as many times as the pupil wants. Each attempt is a separate record. There is no "best of" logic in the admin UI today — every attempt is reported on its own row.

Can you take a quiz on a phone? Yes. The public pages are responsive and work on phones, tablets and desktops.

Why are pupils getting a "no quiz available" message? The book exists in LexiScor but does not have a Published quiz. The admin needs to publish a draft (or import one first). See Quizzes.