Setup and administration

Build a book

The book editor end to end: units, sections, points, prerequisites, and who the book is offered to.

Admin only

Books are built in Configuration → Books, per club. Admin only.

Pick a club on the left, open the Books tab, then create, edit, duplicate or delete a book.

Book fields#

FieldWhat it does
NameWhat clubbers and leaders see.
Cover imageShown on the book card on the Books tab.
AwardThe award this book earns. Shows as a badge on the book.
Offered toA whole club, or specific classes inside a club. Class assignment wins over club.
Prerequisite bookAnother book that must be completed first.
Minimum gradeThe grade a clubber must have reached.
Units and sectionsThe contents.
Book fields at the top, units and sections below.

Unit fields#

  • Name
  • Required or extra credit
  • Prerequisite unit — another unit that must be finished first
  • Report as separate book

Section fields#

  • Name
  • Points
  • Required or extra credit

Required versus extra credit#

Extra credit earns its points and appears on the Books tab; it just never counts toward completion. This is the single most common source of “they finished the book but it isn’t marked complete” — see Complete and un-complete a book.

Duplicate a book#

Duplicating copies a book with its units and sections. It is much faster than rebuilding a similar handbook from scratch, and the usual way to set up book two of a series.

Per-club actions#

Stop offering#

Deactivates the book for that club. Clubbers with partial progress can still finish it — a child does not lose a book halfway through because you stopped offering it to new starters.

To remove a stale book from one particular clubber’s tab, hide it instead. See Hide a book from one clubber.

Reset book progress#

Starts a new cycle for the next cohort. Prior progress is preserved for reports and lifetime points; the progress UI shows the new cycle as a clean slate. FlightPath shows you which clubbers are mid-book before you commit.

See Reset a book for a new year.

Delete#

A sensible build order#

  1. Create the book with its name and cover image.
  2. Add the units, marking each required or extra credit.
  3. Add each unit’s sections with their points and required flags.
  4. Set unit prerequisites where one unit must follow another.
  5. Set the book-level prerequisite book and minimum grade, if any.
  6. Link the award it earns.
  7. Choose which clubs or classes it is offered to.

Doing it in this order means you are never setting a prerequisite that does not exist yet.