Create an award
Name, image, clubs, custom awards, and adding the triggers that earn it.
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
Screenshot to come
The award editor in Configuration, with name, image, description, clubs and the list of triggers
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:
| Trigger | Earned when |
|---|---|
| Specific book | Every required section of one named book is complete. |
| Specific units | Every required section of each named unit is complete. |
| Specific sections | Each individually named section is complete. |
| Section count | Any N sections in one named book are complete. Counts extra credit too. |
| Book count | N 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. |
| Attendance | See 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.