Fill in the school details
How to check the name and time zone of the school and set how kiosks behave during service.
When you need this
This is the first step on a new school. You come back here when you need to change the kiosk mode, the repeat-scan guard or the look of QR codes.
- Open Organization (the group School). The Organization details block shows the current values.
- Press Edit organization.
- Check School name (up to 120 characters) and School timezone. Write the time zone in the IANA format, for example Europe/Kyiv. Service dates, meal windows and reports are counted by it. For normal work keep Status at Active.
- If needed, change the kiosk settings (the table below).
- Press Save settings.
- After changing kiosk settings, press Refresh Session on every kiosk while it is online and do one trial serving before the line opens.
Kiosk settings
| Field | What it does |
|---|---|
| Meal confirmation | Automatic scan/serve: the kiosk scans and serves by itself, there is no mode switch. Manual confirmation: the kiosk always asks for confirmation, there is no switch either. Cook choice: the cook switches the mode on the kiosk. |
| Kiosk helper text | Minimal operator copy or Guided helper copy. Changes only the hints for the operator, not the serving rules. |
| Repeat-scan guard | On or Off. The field Guard interval in seconds takes a whole number from 1 to 900 (180 by default). If a student card is scanned again within this interval after a serving, the kiosk records nothing and shows that the meal is already served. With the guard off every scan is evaluated at once. |
| Repeated group scan | In the Auto mode on the kiosk: Show the record opens the serving already recorded for the group, Next meal offers the next meal the group can be served now. |
| USB serial scanner support | Switch it on only if the school has compatible USB scanners. The kiosk browser may still ask for permission to use the device. |
| Kiosk Tools only by staff card | When on, the Tools panel on kiosks opens only after a scan of a card of a staff member whose role is in the list Allowed roles. |
| Packed meals by card only | The same for packed meals; the roles are set by Roles allowed to issue packed meals. |
| Teacher student edits | Lets teachers change the category and status of students in their active classes. Class, name, photo and enrollment stay admin-only. |
| QR generation algorithm | How new QR codes are made: Random base64url (default), 12 numeric digits, 16 uppercase alphanumeric or Student ID hint + 8 random. Existing codes stay valid. |
| QR value prefix, QR value suffix | Optional, up to 16 characters: letters, digits, a dot, an underscore or a hyphen. |
The roles in the access lists are shown as Organization admin, Cook and Teacher. Staff cards are issued on the page Staff.
What you will see
After saving, the Organization details block shows the new values, and the field Last updated shows the time of the change. A kiosk gets the changes at its next sync.
If something goes wrong
- School name is required. or School name must be 120 characters or fewer.: fix the name.
- School timezone is required. or Enter a valid IANA timezone, such as Europe/Kyiv.: enter an IANA time zone.
- Enter a whole number of seconds from 1 to 900, or switch the guard off.: the interval must be from 1 to 900 seconds.
- Use only letters, digits, '.', '_' or '-'.: the prefix or suffix has a character that is not allowed. If they are too long (over 16 characters) the field says how many are allowed. If together with the code they exceed the allowed length, the form says the prefix and suffix are too long.
- No member with an allowed role has an active staff card. Issue a card first. or No member with a role allowed for packed meals has an active staff card. Issue a card first.: no staff member with an allowed role has an active card. Press Open staff, issue a card and save again. If the mode is already on and no active card is left, the page shows the warning The mode is on, but no member with an allowed role has an active staff card left. Kiosk Tools cannot be opened until a card is issued or the mode is turned off. (for packed meals - Packed meals by card is on, but no member with an allowed role has an active staff card left. Packed meals cannot be issued on the kiosk until a card is issued or the mode is turned off.).
- Organization settings could not be saved., Organization settings could not be saved. Check your connection and try again. or Organization settings were saved, but the response could not be read.: check the connection and reload the page; in the last case the settings are already saved.
- Organization settings are unavailable: the school could not be loaded, try again.