Notification settings¶
Applies to: Owner, Administrator and any role with Notifications.View (see) or Notifications.Manage (change); Settings.View / Settings.Manage for payment reminder rules; Email.View / Email.Manage for email settings. Last reviewed: 2026-11-18.
This page lists every setting that affects notifications, its default, where it is, who may change it and what it does. Most settings are on the Notification Settings page; payment reminder rules and the school's own mail server have their own pages.
1. Where the settings are¶
| Settings | Where to click | Permission to see | Permission to change |
|---|---|---|---|
| Channels, per-message switches, reminder timing, quiet hours | Side menu Settings > Notifications tile ("Notification preferences"). Page title Notification Settings, address /settings/notifications. |
Notifications.View |
Notifications.Manage |
| Payment reminder rules | Settings > Payments. Page title Payment Settings, /settings/payments. |
Settings.View |
Settings.Manage |
| The school's own mail server | Settings > Email. Page title Email Settings, /settings/email. |
Email.View |
Email.Manage |
| Notification Log | Settings > System, /settings/system. |
Notifications.View |
Read-only |
| SMS bundles, WhatsApp add-on | Settings > Billing | Subscription.View |
Subscription.Manage |
The Settings entry in the side menu needs Settings.View. The Notifications, Email and System tiles are hidden from a SuperAdmin, because a SuperAdmin does not belong to a school.
In the default role set, Notifications.View, Notifications.Manage, Email.View and Email.Manage are granted together to the school's administrative roles (RolePermissionSeeder). A school can change this for its own custom roles under Settings > Roles.
A user with view permission only sees the banner "You can view these settings but not change them." and the Save Changes button is disabled.
The owner's mobile app has a simpler copy of the Notifications page; see section 6.
2. Notification Settings page¶
Screenshot to be added
Screen: Notification Settings. Should show: whole page showing Notification Channels, Student Notifications, Reminders, Staff Notifications and Quiet Hours.
Important
Nothing is saved until you click Save Changes at the top right. Success: "Notification settings saved successfully."
2.1 Notification Channels¶
"Choose which communication channels are available for your organisation."
| Setting | Default | Effect |
|---|---|---|
| On | Master switch for email. Off stops all engine emails, automatic invoice emails and automatic payment reminders. Manual sends and account emails still go. | |
| SMS | Off | Master switch for SMS. Can only be switched on when the plan includes SMS and credits are available. |
| Off | Master switch for WhatsApp. Can only be switched on when the plan includes WhatsApp and the add-on is paid. |
A channel master switch is the outer limit: a per-message tick can only narrow it.
There is no switch for push; see Push notifications.
2.2 Student Notifications¶
"Notifications sent to students." One row per message with columns Notification, Enabled, Email, SMS, WhatsApp, Timing.
| Notification | Enabled | SMS | Timing shown | Notes | ||
|---|---|---|---|---|---|---|
| Student Welcome | On | On | Off | Off | Immediately | Skipped during quiet hours |
| Lesson Booking Confirmation | On | On | Off | Off | Immediately | |
| Lesson Reminder | On | On | Off | Off | "1 day before" | Timing set in the Reminders card |
| Driving Test Reminder | On | On | Off | Off | "1 day before" | Timing set in the Reminders card |
| Lesson Rescheduled | On | On | Off | Off | Immediately | |
| Lesson Cancelled | On | On | Off | Off | Immediately | |
| Lesson Request Declined | On | On | Off | Off | Immediately | |
| Payment Received | On | On | Off | Off | Immediately | Email carries the receipt PDF |
| Payment Reminder | On | On | Off | Off | Link "Set in Payment settings" | Timing comes from Settings > Payments |
| Invoice Issued | On | On | Off | Off | Immediately | Email only: the SMS and WhatsApp ticks have no effect |
- Enabled off stops the message on every channel, including push.
- The SMS and WhatsApp boxes are disabled until the matching channel is switched on above.
- "Lesson Completed" is not in this list and cannot be configured (see section 5).
2.3 Reminders¶
"Choose when students receive lesson and driving test reminders."
| Setting | Default | Range | Effect |
|---|---|---|---|
| Lesson Reminder: send before | 1,440 minutes | 15 to 44,640 minutes (31 days), steps of 15 | How long before the lesson start the reminder is sent |
| Driving Test Reminder: send before | 1,440 minutes | Same | How long before the test the reminder is sent |
- The value is in minutes. 60 = 1 hour, 120 = 2 hours, 1,440 = 1 day, 2,880 = 2 days. The text under the field shows it in words, for example "Current value: 2 hours before".
- If the reminder is switched off in the student list the field is disabled and shows "Switched off in the student notifications list."
- The setting applies to the whole school. There is no per-branch or per-student timing, and only one reminder per lesson.
- Empty or 0 is treated as 24 hours. The API only rejects negative numbers ("Invalid reminder timing for ...").
- "Reminders held back by quiet hours go out when quiet hours end."
Details: Lesson reminders.
2.4 Staff Notifications¶
"Keep instructors and staff informed." One on/off switch per message.
| Notification | Default | Effect |
|---|---|---|
| New Lesson Assigned | On | Email (and push) to the instructor when a lesson is booked for them |
| Lesson Rescheduled | On | Email (and push) to the instructor when a lesson is moved |
| Lesson Cancelled | On | Email (and push) to the instructor when a lesson is cancelled |
| Daily Instructor Schedule | Off | Has no effect. No code sends this message. |
On the web page staff messages have no channel boxes: they go by email (default) and push. The stored preference does have SMS and WhatsApp flags, which the owner's mobile settings screen can change (section 6).
Note
Only instructors receive staff messages. Owners, administrators and receptionists are not notified of anything by email.
2.5 Quiet Hours¶
"Prevent non-urgent notifications from being sent during these hours."
| Setting | Default | Effect |
|---|---|---|
| Quiet Hours switch | Off | Turns the quiet window on |
| Quiet hours start | Empty | Start of the window, 24-hour clock |
| Quiet hours end | Empty | End of the window |
- Both times are required when the switch is on: "Please specify both quiet hour times." (page) or "Quiet hours require both a start and end time." (API).
- A window may run overnight (for example 21:00 to 07:00). If start and end are the same there is no quiet window.
- The clock used is the server's, not the branch's.
What quiet hours really do
The page says "Notifications scheduled during quiet hours will be delayed until the quiet period ends.", but the code behaves as shown in the table below. Most messages are sent anyway or dropped, not delayed.
| Message | During quiet hours |
|---|---|
| Lesson Booking Confirmation, Lesson Rescheduled, Lesson Cancelled, Lesson Completed, Lesson Request Declined, Payment Received, and the three instructor messages | Sent anyway (treated as urgent) |
| Lesson Reminder, Driving Test Reminder | Held and sent at the first 15-minute run after the window ends, if the lesson or test is still ahead |
| Student Welcome | Dropped. Not sent later. |
| Payment Reminder by SMS, WhatsApp or push | Dropped for that day's run |
| Payment reminder email, invoice emails, receipts, quotes, account emails | Not affected by quiet hours |
There is no queue of delayed messages.
Tip
If you register students in the evening and want them to get the welcome message, keep the quiet window clear of your working hours.
3. Settings that exist but are not on any page¶
| Setting | Value | Notes |
|---|---|---|
CompanyNotificationSettings.IsActive |
True | If false the engine sends nothing for the school. No page changes it. |
SendStudentWelcome, SendLessonReminder, LessonReminderHoursBefore, PaymentReminderDaysBefore and similar columns on CompanyNotificationSettings |
Various | Older columns. The engine does not read them; the per-message preferences replaced them. |
| Payment Reminder "send before" (4,320 minutes) | Stored | Not used. Timing comes from Payment Settings. |
When the settings are created¶
- Default settings and preferences are created when a school registers (
AuthService). - If a school somehow has none, they are created the first time someone opens the Notification Settings page. Until then the engine sends nothing for that school ("notifications are not configured or not active" in the server log).
- When DriveFlow adds a new message type, its preference row is created with defaults the next time the page is opened. Until then the engine treats the new message as enabled, email on, SMS and WhatsApp off.
4. Payment Settings page (payment reminders)¶
Settings > Payments. Save with Save Changes ("Payment settings saved."). "Changes apply from the next daily run."
| Card | Setting | Default | Range | Effect |
|---|---|---|---|---|
| Overdue Invoices | Grace period (days after due date) | 0 | 0-90 | "0 marks an invoice overdue the day after its due date." |
| Payment Reminder Emails - Before the due date | Send a "payment due soon" email (days before) | 3 | 0-30 | "0 turns the due-soon email off." |
| After the due date | On / Off switch | On | - | Overdue reminders on or off |
| First reminder (days after) | 1 | 1-90 | Days after the due date for the first overdue reminder | |
| Repeat every (days) | 7 | 0-90 | "0 sends one reminder only." | |
| Maximum reminders | 3 | 1-20 | Total overdue reminders per invoice |
The Example card on the right shows the dates these rules produce for an invoice due on the 1st of next month.
The page notes: "Reminders are sent daily at 08:00, and only while email notifications and the Payment Reminder notification are switched on in Notification settings. You can also send one at any time from an invoice's menu." See Lesson reminders section 4 for the time zone of that run.
The same page holds the school's PayFast details for online payments. When those are set up, reminders include a pay-online link.
5. What cannot be configured¶
| Item | Behaviour |
|---|---|
| Lesson Completed message | Always sent by email (if the Email master switch is on) and push |
| Push | Automatic when the plan includes the Mobile App |
| Message wording, subject lines, sender footer | Fixed in code; see Notification templates |
| Per-student or per-instructor opt-out | Does not exist |
| Per-branch settings | Do not exist; all settings are per school |
| CC to the office, reply-to address | Do not exist |
| SMS sender name, WhatsApp number | Platform-wide |
| Number of lesson reminders | Always one |
6. The same settings in the owner's mobile app¶
The mobile app has a Notifications screen under Settings ("Which messages DriveFlow sends for your school, and how."), using the same API and permissions.
Differences from the web page:
- Channels are check boxes: Email, SMS, WhatsApp (marked "add-on" when not available).
- Quiet hours are labelled Hold messages overnight.
- Messages are grouped To students and To instructors and staff, and every message, including the staff ones, shows Email / SMS / WhatsApp boxes for the channels that are switched on. This is the only place where SMS or WhatsApp can be ticked for an instructor message.
- Reminder timings are not shown; they are kept as they are and changed on the web.
- The button is Save notification settings.
7. Platform settings (server administrator)¶
Set in the API configuration, not in the application.
| Section | Purpose |
|---|---|
EmailSettings |
Global SMTP server and sender |
VodacomSms |
SMS provider, including Enabled, sender id and default country code |
MetaWhatsApp |
WhatsApp Cloud API, including Enabled |
| Firebase (push) | The Firebase key that push notifications need (kept private) |
Platform:AppUrl |
Web app address used in links and the email logo |
Platform:AdminEmail |
Receives new-registration alerts |
| Billing issuer options | Legal name, trading name and contact email shown on DriveFlow's own emails to schools |
| Default connection string | Also used by Hangfire for the job schedule |
Never put real values for these in documentation or source control.