Setup and administration

Create an award

Name, image, clubs, custom awards, and adding the triggers that earn it.

Admin only

Awards are created in Configuration → Awards, per club. Admin only.

Award fields#

  • Name
  • Image
  • Description
  • Which clubs it belongs to
  • Custom — a hand-granted award with no triggers
Award details at the top, triggers below.

Custom awards#

Tick custom for an award that is only ever granted by hand — a character award, a one-off recognition. Custom awards have no triggers and never fire on their own.

They are granted from a clubber’s Awards tab. See Grant or remove an award by hand.

Adding triggers#

A trigger is the rule that earns the award. Add one or more.

The seven types, with a worked example of each, are in The award trigger types:

TriggerEarned when
Specific bookEvery required section of one named book is complete.
Specific unitsEvery required section of each named unit is complete.
Specific sectionsEach individually named section is complete.
Section countAny N sections in one named book are complete. Counts extra credit too.
Book countN books linked to this award are complete.
Book count across clubs (track)N whole books across every club the award is linked to, repeats included. Takes an optional book allowlist.
AttendanceSee Attendance awards.

Attendance triggers need thought#

An attendance trigger takes a check-in item to watch, a maximum number of misses, a weeks from schedule setting, and a period schedule.

The weeks from schedule setting is the one to get right: an award about turning up to club must read club nights from the meeting calendar, or a child who missed four weeks entirely leaves no records behind and can win it by not coming. Read Attendance awards before you set one up.

Linking an award to a book#

A book has an award field, and setting it shows the award as a badge on the book. That is separate from a trigger — for the award to actually fire on completion, add a specific book trigger. See Build a book.

Testing a new award#

Because evaluation runs on every section toggle, the quickest check is to tick the final required section for a clubber who is nearly there and watch for the toast. If nothing fires, work down the list in How awards are earned.

Attendance awards cannot be tested this way — they only settle after their period closes, granted overnight by a background job.