Skip to content

5. Books

LexiScor offers two ways to look at the catalog of books:

  • The Dashboard (covered in chapter 4) groups books by package and is best for browsing.
  • The Books page at /admin/books is a flat, searchable table that is best for finding a specific title quickly.

This chapter covers the Books page itself and the per-book detail page that opens when you click on any book.

The Books listing (/admin/books)

Page header shows the title "Books" and the total book count. Below it is a single table with four columns:

Column Content
Cover Small thumbnail of the book cover.
Title The book title (clickable — opens the book detail page).
ISBN The 13-digit ISBN, displayed in monospace font.
Quizzes A status indicator (see below).

The Quizzes column shows one of three states:

  • A green badge with the version number — the book has a published quiz. Next to it is a small external-link icon that opens the public quiz page in a new tab. Useful for previewing what pupils will see.
  • A draft count — there are unpublished drafts only.
  • "No quizzes" — the book has no quiz at all yet.

When to use this page vs. the dashboard

  • Use Books when you know the title or ISBN and just want to jump to it.
  • Use Dashboard when you want to browse by class/module or see usage statistics.

The book detail page (/admin/books/<id>)

Clicking a book title — anywhere in the app — opens its detail page. This is the single source of truth for everything about that book.

  • A back arrow returns you to where you came from.
  • The book title and ISBN are shown prominently.
  • A View on Site button opens the public quiz URL in a new tab. This is what pupils see when they scan a QR code or follow a printed link.

Book info section

A card containing:

  • The large cover image.
  • The description (truncated to four lines, but the full text is in the database).
  • Badges for class, module and points.
  • A list of packages the book is part of, shown as small badges.

All of this metadata comes from EDG via the Magento sync. You cannot edit it inside LexiScor — if something is wrong, fix it in EDG and re-run the sync.

Statistics sidebar

Two big numbers:

  • Quizzes — how many quiz versions exist for this book (active and archived combined).
  • Attempts — how many completed attempts there are across all versions.

Active quizzes table

The main table lists every active (non-archived) quiz version. Columns:

Column What it shows
Version A clickable link such as "v1" or "v3". Opens the quiz viewer.
Status Badge: Published, Draft or Unlisted.
Mode Icon showing how the quiz was created — a spreadsheet icon for Excel imports, a pencil for the (now legacy) manual creator.
Questions Number of questions in this version.
Author Name of the admin who created the version.
Last edited The admin who last edited it and when.
Attempts Completed attempts on this specific version.

Above the table is an Import New Version button. Clicking it sends you to the Import page where you can upload a new Excel file. The new version starts as a draft; nothing on the public side changes until you publish it.

Archived quizzes section

Below the active quizzes you may see a smaller section listing archived versions. These are kept for historical reference (and so old attempts remain meaningful) but do not affect the public site.

Common workflows

"I want to publish a brand new quiz for a book"

  1. Open the book's detail page.
  2. Click Import New Version.
  3. Drop the Excel file and run the import.
  4. Come back to the book detail page; the new version appears in the table as a draft.
  5. Click the version link, then publish from the quiz page.

"I want to fix a typo someone reported"

  1. Open the book's detail page.
  2. Click the version link of the published quiz (the one with the green badge).
  3. Use the inline editor to fix the wording — see Quizzes. You do not need to re-import or re-publish.

"I want to add an extra question to a published quiz"

  1. Export or recreate the quiz in Excel with the new question added.
  2. Import it as a new version on the book detail page.
  3. Verify the new draft.
  4. Publish the new version. The previous version is automatically retired.