Settings Reference
Every Dantian Training Hub setting lives on one screen: Training Hub → Settings. This page lists every tab, every section and every field, with its default value, so you can check what a setting does before you change it.
Only users who can manage the site (the WordPress Administrator role, or any role with the manage_options capability) can open the Settings screen.
How the Settings screen is organised
The tab strip down the side of the screen is split into two bands:
| Band | Tabs |
|---|---|
| Core Settings | Getting Started · Setup & Enrolment · Pages & Reports · Access & Privacy · Appearance & Sessions · Course Details · Notifications · Debug & Maintenance |
| (between the bands, Pro only) | Modules — Pro licence activation |
| Feature Settings | Clinic Settings · Assignments (Pro) · Analytics (Pro) · Rubric Grading Suite (Pro) · Files & Storage (Pro) · Timetable Planner (Pro) |
A few things to know before you start:
- One Save button. Most tabs share the Save Settings button at the bottom of the screen. Changes on any of those tabs are saved together when you click it.
- Some controls save straight away. The Locations editor (Setup & Enrolment), the Course Details term lists, the Pro Modules tab and the Pro Files & Storage tab have their own buttons and save immediately — they do not need Save Settings.
- Renamed session terms. If you rename “Tutorial” or “Clinic” (see Terminology), every label on this screen uses your words. This page uses the default names.
- Pro sections are hidden, not locked. Without the Pro add-on, Pro-only sections and tabs simply don’t appear. A Free site shows one dismissible notice at the top of the screen — Pro add-on available. — with a View Pro features link.
- Dates and times use your site’s WordPress timezone and date format (Settings → General in WordPress).
Getting Started tab
The first tab is a guided setup checklist (the “Getting Started wizard”). It does not hold settings of its own — each card shows the status of one setup area and links to the tab where you change it. See 02 — Quick Start for a card-by-card walkthrough.
Setup & Enrolment tab
Enrolment Source
| Setting | What it does | Default | Allowed values |
|---|---|---|---|
| Enrolment provider | Where the plugin reads student enrolments from. | Auto-detect (shows which source it found, e.g. “Auto-detect (currently: tutorlms)”) | Auto-detect · TutorLMS · LifterLMS · Training Hub-native classes. A source whose plugin isn’t installed is listed as “— not installed” and can’t be chosen. |
Auto-detect checks for TutorLMS first, then LifterLMS, and falls back to Training Hub-native classes (standalone mode). Override it only if auto-detection picks the wrong source. See 11 — LMS Integration.
Shortcode Scan
Run Scan checks every published page for Training Hub shortcodes and opens a table of Shortcode · Found Pages · Mapped Setting · Suggested Mapping. Click Apply Suggestions to fill in the page selectors on the Pages & Reports tab, then Save Settings.
Locations
The list of rooms and online accounts your sessions can use. Two locations are created for you: Online (online account) and In-Person (physical room).
| Column | What it does | Allowed values |
|---|---|---|
| Name | The location name shown when scheduling a session. Must be unique (not case-sensitive). | Text, required |
| Type | Physical room or Online account. | Two options |
| Capacity | How many sessions can share the location at once. 1 means exclusive use. Used for clash detection in the Pro Timetable Planner. | 1–9999 |
| Default mins | Default session length. Fills in the session’s end time automatically. | 1–1440 |
Use Add location, Save and Delete on each row. These buttons save straight away. With the Pro Timetable Planner unlocked, extra columns (availability and sort order) appear in this editor.
Pages & Reports tab
PDF Reports
| Setting | What it does | Default |
|---|---|---|
| PDF Business Name | Heading printed at the top of every PDF (course, student and clinic reports, action plans, rubric assessments). If you leave it blank, the site title is used. | Your site title |
| PDF Logo | Optional logo at the top-left of every PDF. Use Upload to choose an image. PNG, JPEG, GIF, BMP, WEBP or SVG. It must be stored on this site — a logo URL from another website is ignored. If the file has been deleted from the server, a warning appears. | Blank (no logo) |
Frontend Pages
Choose the published page that hosts each front-end shortcode. Next to each selector, Auto-create page publishes a new page with the shortcode already on it and selects that page for you. Click Save Settings afterwards.
| Setting | Shortcode the page must contain | Required for setup? | Default |
|---|---|---|---|
| Mark Attendance Page | [dthub_mark_attendance] |
Yes | None |
| Student Report Page | [dthub_student_report] |
Yes | None |
| Student Calendar Page | [dthub_student_calendar] |
Yes | None |
| Trainer Calendar Page | [dthub_instructor_calendar] |
Yes | None |
| Manage Clinic Page | [dthub_clinic_student_dashboard] |
Yes | None |
| Email Preferences Page | [dthub_email_preferences] |
Only when the email-footer preferences link is turned on | None |
| Student Dashboard | [dthub_student_dashboard] |
Optional | None |
| Course Report | [dthub_course_report] |
Optional | None |
| Session Notes | [dthub_session_notes] |
Optional | None |
| Student Notes | [dthub_student_notes] |
Optional | None |
🔒 Pro feature — requires Dantian Training Hub Pro.
With Pro active, more page selectors are added to this table. All of them are optional for finishing setup:
| Setting | Shortcode | Default |
|---|---|---|
| Trainer Hub | [dthub_trainer_hub] |
None |
| Trainer Workspace | [dthub_assignment_hub] |
None |
| Overdue Assignments | [dthub_overdue_assignments] |
None |
| Trainer Action Plans | [dthub_trainer_action_plans] |
None |
| Student Action Plan | [dthub_student_action_plan] — linked from the student calendar for action plan deadlines |
None |
Pro also adds these sections to the tab:
- Custom Trainer Hub Links — up to 4 extra links (label + URL) on the Trainer Hub dashboard. Leave a slot blank to hide it.
- Custom Student Dashboard Links — up to 4 extra links on the Student Dashboard.
- Action Plan Email — Email Subject and Email Body for the email sent when an action plan is emailed to a student. If left blank, the subject is “Your Action Plan — {plan_label}” and a short built-in body is used. Merge tags:
{student_name},{plan_label},{plan_date},{site_name},{plan_url}. The PDF is attached automatically. - Action Plan Access — Allowed roles and Additional users who may view, edit and delete action plans in wp-admin (administrators always can), plus Trainer frontend — “Allow trainers to view and edit action plans on the frontend” (default on).
The two Action Plan sections appear only while the Progress Tracking & Analytics module is licensed. See 14 — Action Plans.
Recording Attendance Claims
Lets students who missed a live online session claim attendance by watching the recording. See 06 — Recording Claims.
| Setting | What it does | Default | Allowed values |
|---|---|---|---|
| Enable Recording Claims | Master switch. When off, the [dthub_recording_claims] page shows an “unavailable” notice and the review queue is hidden. |
Off | On/Off |
| Recording Claim Page | Where students make a claim. | None | A page |
| Claim Notification Email | Address(es) notified when a claim is submitted. Separate several with commas. Leave blank to send no notification. | Site admin email | Email addresses |
| Auto-Approve Recording Claims | Approves claims as soon as they’re submitted, without review. | Off | On/Off |
| Clinic Recording Claims | Lets students claim missed clinic sessions too, not just tutorials. | On | On/Off |
| Claim Window (days) | How many days after a session a claim can still be made. 0 = no limit. | 30 | 0–365 |
| Online Sessions Only | Only sessions with a linked Zoom meeting can be claimed. | On | On/Off |
| Require Course Enrolment | The student must be enrolled in the course. | On | On/Off |
Competency Marking
| Setting | What it does | Default |
|---|---|---|
| Trainer competency marking — “Allow trainers to set student competency” | Lets trainers (not just administrators) set a student’s overall subject competency from the course report. Administrators can always set it. | Off |
Assessment terminology and student report display (Pro)
🔒 Pro feature — requires Dantian Training Hub Pro.
| Section | Setting | What it does | Default |
|---|---|---|---|
| Assessment Outcome Terminology | Competency Label (Pass) | Shown for an individual assignment or quiz pass | Satisfactory |
| Competency Label (Not Yet) | Shown for an individual fail | Not Yet Satisfactory | |
| Overall Subject Competency Terminology | Overall Competency Label (Competent) | Shown when a subject is marked competent | Competent |
| Overall Competency Label (Not Yet Competent) | Shown when a subject is marked not yet competent | Not Yet Competent | |
| Student Report Display | Quiz count in student report | Which quizzes count in the student report summary card | All quizzes in the course (other option: Assessment quizzes only) |
Without Pro, the student report always counts all quizzes.
Course Filtering
| Setting | What it does | Default |
|---|---|---|
| Year-based course filtering — “Show year filters on course pickers and reports” | Adds year dropdowns to Manage Sessions, Course Report, Bulk Attendance, the Clinic Roster Manager, the front-end shortcodes and Pro report screens. Turn it on if your course titles include the year, or if you create a new set of courses each academic year. | Off |
Access & Privacy tab
Access Control
| Setting | What it does | Default |
|---|---|---|
| Backend Access (Trainers) | Roles that can manage tutorials and clinics. Only users in these roles can be chosen as a session Trainer. Administrators always have access. | Administrator + your LMS’s instructor role (tutor_instructor for TutorLMS, instructor for LifterLMS). In standalone mode: Administrator only. |
| Student Email Recipients | Only users with these roles receive student-facing plugin emails (reminders, digests, clinic alerts, assignment and quiz emails). Tick none to email everyone who is enrolled. | None ticked (no filtering) |
| Student Roles | Which roles count as students. Used by the student report selector, student search, recording-claim eligibility and ad-hoc attendee lists. If your students use a custom role, you must tick it here or they won’t appear in any picker. | None ticked — falls back to student, tutor_student, subscriber, customer |
| Ad-hoc Eligible Roles | Who can be added to a session as an ad-hoc attendee (someone not enrolled in the course, e.g. a workshop guest). | None ticked — uses Student Roles |
Calendar Subscription (Pro)
🔒 Pro feature — requires Dantian Training Hub Pro.
| Setting | What it does | Default | Allowed values |
|---|---|---|---|
| Calendar Subscription (ICS) | Lets students and instructors subscribe to their calendar via an ICS feed link | Off | On/Off |
| ICS Days Back | Past days included in feeds | 90 | 0–3650 |
| ICS Days Forward | Future days included in feeds | 365 | 0–3650 |
A Calendar subscribers — last synced list also appears on this tab. See 16 — ICS Calendar Feeds.
Uninstall Behaviour
| Setting | What it does | Default |
|---|---|---|
| Delete all plugin data on uninstall | When on, deleting the plugin from the Plugins screen permanently removes all Training Hub tables, options, capabilities, scheduled jobs and per-user data. This can’t be undone. When off, all data stays in place and you can reinstall later and carry on. | Off |
See 01 — Installation for exactly what is removed.
Purge Course Data
Permanently deletes all Training Hub data for one course: sessions, attendance, clinics, allocations, cancellations, recording claims, assignment extensions and attendance audit history. To use it:
- Choose the course under Select Course. A Preview of the data counts appears.
- Tick “I understand this permanently deletes all Dantian Training Hub data for the selected course.”
- Click Permanently Delete All Course Data.
There is no undo.
Retention, force-erase and Pro uninstall (Pro)
🔒 Pro feature — requires Dantian Training Hub Pro.
| Section | Setting | Default |
|---|---|---|
| Extended Data Retention | Enable extended retention | Off |
| Apply extended retention to all records institution-wide | Off | |
| Extended retention period (years) — maximum 50 | 15 | |
| Apply to record types — Assessment outcomes · Attendance records · Coaching & intervention records (action plans) · Operational admin records · Trainer working notes | — | |
| Force Erase (Override Retention) | Override notification email — if set, this address is emailed every time a record is force-erased | Blank |
| Currently Retained Records | A list of records held back from an erasure request, each with a Force Erase button. Force Erase asks for a reason of at least 20 characters and confirmation that institutional approval has been obtained. | — |
| Activity Timing | Activity tracking — record when, and what kind of, course activity students engage in | Off |
| Activity data retention (months) | 24 | |
| Pro Data Removal on Uninstall | On uninstall — “Permanently delete all Pro data when the Pro plugin is uninstalled” | Off |
Appearance & Sessions tab
Theme Colors
| Setting | Default |
|---|---|
| Primary Color | #2271b1 |
| Secondary Color | #646970 |
| Accent Color | #00a32a |
| Dark Mode — “Enable dark mode (follows the visitor’s device setting)” | On. When the visitor’s device is set to dark mode, the plugin’s front-end pages switch to dark colours. Untick to keep them light. |
Attendance Status Options
The statuses a trainer can choose when marking attendance. Each status has a Label, a Color, a Counts as Missed tick box and a Context (Tutorial only / Clinic only — leave both unticked to use it for both).
| Default status | Counts as Missed |
|---|---|
| Present | No |
| Absent | Yes |
| Late Arrival | No |
| Left Early | No |
| Watched Recording | No |
| Apologies | Yes |
Use Add Status to add more, the bin button to delete one, or Reset to Defaults to restore the six above.
Terminology
Rename the two session types. Your words are used everywhere — menus, labels, emails and reports.
| Setting | Default |
|---|---|
| Open Session — Singular | Tutorial |
| Open Session — Plural | Tutorials |
| Capped Session — Singular | Clinic |
| Capped Session — Plural | Clinics |
🔒 Pro feature — the settings below require Dantian Training Hub Pro.
| Section | Setting | Default |
|---|---|---|
| Course Levels (shown only when your LMS has course difficulty levels, e.g. TutorLMS) | Course Level — Beginner / Intermediate / Expert — renames each level | Beginner / Intermediate / Expert |
| Session Format Labels | One label per line, used to classify sessions in the Timetable Planner | Standard, Intensive, Practical, Workshop |
| Calendar Week Start | First Day of Week — the Timetable Planner numbers weeks from this day | Monday |
Course Details tab
Manage the options for two course taxonomies: Units of Competency and Qualifications. These appear as tick boxes on each course’s edit screen and are used in reports and PDFs. See 24 — Classes and Standalone Enrolment.
For each list you can type a new term and click Add Unit / Add Qualification, paste a comma-separated list under Bulk add and click Add All, add an optional full title next to each term, or Remove a term. Changes save straight away. There are no defaults — both lists start empty.
With the Pro Timetable Planner unlocked, a trainer settings card also appears on this tab.
Notifications tab
The tab heading is Email Notifications & Templates. Every email listed here is off by default unless the table says otherwise. For what each email contains and who receives it, see 10 — Email Notifications.
Several sections have a collapsed Customise email wording panel. It holds an editable template for that email. The {content} placeholder inserts the schedule, cards and buttons the plugin generates. Clear the box to restore the default wording.
Sender Identity
| Setting | Default |
|---|---|
| Sender Name | Your site title |
| Sender Email | Site admin email |
Email Footer
| Setting | What it does | Default |
|---|---|---|
| Email Preferences Link — “Show a ‘Manage email preferences’ link in email footers” | Adds a quiet opt-out link to every recipient-facing email. Stays hidden until an Email Preferences Page is chosen on Pages & Reports. | Off |
Weekly Admin Summary
| Setting | Default | Allowed values |
|---|---|---|
| Enable Summary — “Send weekly attendance summary to admins” | Off | On/Off |
| Recipients | Site admin email | Comma-separated addresses |
| Include Ad-Hoc — include ad-hoc tutorials and clinics | On | On/Off |
| Low Attendance Threshold — students with fewer than this many attendances are flagged | 2 | 0–100 |
| Send Day | Monday | Monday–Sunday |
| Send Time | 09:00 | Any time |
| Test — Send Test Summary button | — | — |
| Template: Weekly Admin Summary Template | {content} |
Placeholders {content}, {tutorials}, {clinics}, {site_name} |
Upcoming Tutorials Notification
| Setting | Default | Allowed values |
|---|---|---|
| Enable Upcoming Tutorials Email — “Send upcoming tutorials notifications” | Off | On/Off |
| Recipients — Instructors / Students | Both ticked | Either or both |
| Include ad-hoc make-up tutorials when emailing students | On | On/Off |
| Include missed online tutorials in student emails (with a link to the recording claims page) | Off | On/Off |
| Send Day | Friday | Monday–Sunday |
| Send Time | 09:00 | Any time |
| Test — Send Test Notification button | — | — |
| Template: Upcoming Sessions Template | {content} |
Placeholders {content}, {recipient_name}, {tutorial}, {tutorials}, {site_name} |
🔒 Pro only, when your LMS provides assignments or quizzes:
| Setting | Default | Allowed values |
|---|---|---|
| Include assignment reminders in student emails | Off | On/Off |
| Include assessment quiz reminders in student emails | Off | On/Off |
| Assignment Reminder Lead (weeks window) — 1 = days 0–7, 2 = days 0–14, and so on | 1 | 1–6 |
If the Weekly Student Digest is on and includes upcoming tutorials, a notice explains that the separate student email is paused.
Weekly Student Digest
| Setting | Default |
|---|---|
| Enable Weekly Digest — “Combine selected recurring student emails into a single weekly digest” | Off |
| Include upcoming tutorials in digest | Off |
| Include clinic reminders in digest | Off |
Template: Weekly Student Digest Template — placeholders {content}, {recipient_name}, {tutorials}, {clinics}, {site_name} |
Built-in wording |
The digest goes out on the same Send Day and Send Time as the Upcoming Tutorials Notification.
Instructor Reminders
| Setting | Default | Allowed values |
|---|---|---|
| Pre-Tutorial Reminder — “Send reminder before tutorial starts”. Buttons: Test (Standard), Test (With Zoom) | Off | On/Off |
| Minutes Before Tutorial | 20 | 5–1440 |
| Attendance Not Taken Reminder — “Send reminder after tutorial if attendance missing”. Button: Test | Off | On/Off |
| Hours After Tutorial | 48 | 1–168 |
| Templates: Pre-Session Reminder Template, Attendance-Not-Taken Reminder Template | Built-in wording | — |
Pro notification sections
🔒 Pro feature — requires Dantian Training Hub Pro.
Advanced Notification Templates → Support / Check-in Email (a check-in email you can send to a student with low attendance):
| Setting | Default |
|---|---|
| Support Email Sender Name | Your site title |
| Support Email Sender Email | Site admin email |
| Support Email Subject | Checking in – how can we support you? |
Support Email Template — placeholders {student_name}, {sender_first_name}, {attended}, {total}, {attendance_rate}, {course_breakdown}. Reset to Default restores the wording. |
Built-in wording |
Scheduled Report Delivery — emails CSV course attendance reports:
| Setting | Default | Allowed values |
|---|---|---|
| Enable Scheduled Reports | Off | On/Off |
| Report Frequency | Weekly | Weekly · Fortnightly · Monthly |
| Report Send Day | Monday | Monday–Sunday |
| Report Send Time | 07:00 | Any time |
| Report Recipients | Site admin email | Comma-separated addresses |
Early Warning Alerts (requires the Progress Tracking & Analytics licence):
| Setting | Default |
|---|---|
| Enable Early Warning Emails — a weekly list of students whose attendance is trending down | Off |
| Early Warning Recipients — blank = site admin email | Blank |
Webhook Notifications:
| Setting | Default |
|---|---|
| Enable Webhook Notifications — send a JSON POST when selected events happen | Off |
| Webhook URL (HTTPS) | Blank |
| Webhook Secret — optional; when set, each request is signed | Blank |
| Feedback Webhook URL / Feedback Webhook Secret — receives new or updated student feedback | Blank |
| Webhook Events — which events send a webhook | None ticked |
Built-In Email Log
| Setting | What it does | Default |
|---|---|---|
| Enable Built-In Email Log — “Record every outbound email in a searchable log” | Adds the Email Log screen. Leave it off if you already use an external mail logger such as FluentSMTP. | Off |
Clinic Emails
| Setting | Default | Allowed values |
|---|---|---|
| Notification Emails — staff addresses for clinic notifications (e.g. a student’s cancellation) | Site admin email | Comma-separated |
| Enable Student Reminders — weekly reminder to students with upcoming clinics | Off | On/Off |
| Enable Instructor Reminders — weekly reminder to supervisors with upcoming clinics | Off | On/Off |
| Send Day | Monday | Monday–Sunday |
| Send Time | 06:00 | Any time |
| Pre-Clinic Check-In Confirmation — one-click check-in button in the weekly student reminder | Off | On/Off |
Clinic Attendance Reminder
| Setting | Default | Allowed values |
|---|---|---|
| Clinic Attendance Reminder — “Send reminder to supervisor if clinic attendance not marked”. Button: Test | Off | On/Off |
| Hours After Clinic | 48 | 1–168 |
| Template: Clinic Attendance Reminder Template | Built-in wording | — |
Clinic Email Sender & Templates
| Setting | Default |
|---|---|
| Clinic Email Sender Name | Your site title |
| Clinic Email Sender Email | Site admin email |
Allocation Email Template — placeholders {student_name}, {clinic_details}, {site_name} |
Built-in wording |
Weekly Reminder Templates — one or more named templates (the Default template can’t be removed). Assign them per course or per clinic. Placeholders {student_name}, {clinic_list}, {clinic_count}, {cancellation_days}, {site_name}, {admin_email}. Add Template adds another. |
One template named “Default” |
Two test tools sit here. Test Student Email (pick a template, Simulate for Student, Send To) and Test Instructor Email (Simulate for Instructor, Send To) each have a Send Test Reminders button. The test is sent only to the address you type.
Advanced Assignment Email Templates (Pro)
🔒 Pro feature — requires Dantian Training Hub Pro.
| Section | Setting | Default |
|---|---|---|
| Assignment Email Notifications | Assignment Extension Notification | On |
| Extension Subject | Assignment Extension Granted | |
| Due Date Reminder — “Send email reminder before assignment due date” | On | |
| Reminder Days (1–30) | 3 | |
| Reminder Subject | Assignment Due Date Reminder | |
| Overdue Admin Notification — sent to the Weekly Admin Summary recipients | Off | |
| Overdue Admin Subject | Overdue Assignment Submissions | |
| Overdue Admin Run Time (daily) | 09:00 | |
| Overdue Student Email | Overdue Student Email Subject | Overdue Assignment Notification |
| Assessment Quiz Reminders | Assessment Quiz Reminder | Off |
| Quiz Reminder Days (1–30) | 3 | |
| Quiz Reminder Subject | Assessment Quiz Due Date Reminder | |
| Assessment Quiz Resubmissions | Auto-extend on fail | On |
| Extension length (days) (1–365) | 14 |
Each email also has an editable template. See 15 — Assessment Quizzes and Assignment Due Dates.
Debug & Maintenance tab
| Section | What it contains |
|---|---|
| Maintenance Tools → Automated Maintenance | Scheduled Integrity Cleanup — “Automatically remove orphaned records weekly”. Default off. |
| Referential Integrity Check | Scan for Orphaned Records finds records that point to a student, course, session, roster or action plan that no longer exists. Remove Orphaned Records deletes them. |
| Database Index Audit | Run Index Audit checks the plugin’s database indexes and adds any that are missing. Safe to run more than once. |
| Cron Schedules | Next run and status for the Upcoming Tutorials Email, Weekly Admin Summary and Clinic Reminders jobs. The Next Run time is shown in UTC, not your site’s timezone. “Not Scheduled” is normal for an email you haven’t turned on. |
| Upcoming Tutorials Data Check / Upcoming Clinic Sessions Data Check | Shows which sessions the next scheduled email would include, with their trainer and Zoom details. Useful when someone says “I didn’t get my reminder”. |
| Performance Diagnostics | Cache statistics, and a Load DTHUB_PERF Entries button that reads timing entries from the server’s PHP error log (if one is readable). |
Clinic Settings tab
The heading on this tab reads Clinic Roster Settings.
Booking Policy
| Setting | What it does | Default | Allowed values |
|---|---|---|---|
| Auto-Approve — “Automatically approve clinic bookings” | Student booking requests are approved without review. | Off | On/Off |
| Auto-Promote from Waitlist | When an allocation is cancelled, the next waitlisted student is offered the spot. | On | On/Off |
| Cancellation Days | Minimum notice a student must give to cancel a booking. | 7 | 0–30 |
Auto-approval can also be set per course from the clinic roster screens. See 05 — Clinic Rosters.
Cancellation Reasons
The reasons a student can choose when cancelling. They’re also used to group the cancellation report. Defaults: Illness, Personal, Schedule Conflict, Clinical Placement Conflict, Other. Use Add Reason, the remove button, or Reset to Defaults.
Pro-only tabs
🔒 Pro feature — the tabs in this section require Dantian Training Hub Pro.
Modules tab
Activate and deactivate the licence for each Pro module. Nothing on this tab uses Save Settings — each module has its own Activate or Deactivate button. See 29 — Licensing and Updates.
Assignments tab
Shown when Pro is active and your LMS provides assignments (TutorLMS with Tutor LMS Pro, or LifterLMS with assignments available). The heading reads Assignments & Recording Claims.
| Section | Setting | Default |
|---|---|---|
| Extension Requests Setup Helper | A checklist: requests enabled? request page set? plus a link to the Review Extensions queue | — |
| Action Plans | Action Plan Task Title Trigger Word — task titles in action plans are trimmed to start at this word. Blank = full title. | Task |
| Instructor Extension Granting | Instructor Grant Extensions — let instructors grant extensions from the front-end page | Off |
| Student Extension Requests | Student Extension Requests — enable the [dthub_extension_request] form |
Off |
| Extension Request Page — URL of the page with that shortcode | Blank | |
| Default Extension Days (1–90) | 14 | |
| Declaration Text — students must tick to agree before submitting. Blank restores the built-in wording. | Built-in declaration | |
| Admin Notification | On | |
| Extension Request Notification Email | Site admin email | |
| Trainer Notification on Submission | Off | |
| Trainer Notification on Approval | Off | |
| Extension Request Webhook / Extension Request Webhook URL | Off / Blank | |
| Advanced Extension Request Email Templates | Extension Approved Subject / template | Extension Request Approved |
| Extension Declined Subject / template | Extension Request Declined | |
| Student Feedback | Feedback Topics | Learning Management System, College Operations, Course, Logbook, Trainer |
| Action Required Options | Course Administration, Administration, Course, Learning Management System, Other Category | |
Assignment Hub Tabs (which tabs [dthub_assignment_hub] shows) |
Show Grading Queue tab · Show Extension Reviews tab · Show Declarations tab · Show Assignment Due Dates tab | On |
| Show Overdue Assignments tab · Show Assignment Setup tab | Off |
Analytics tab
Shown when Pro is active and the Progress Tracking & Analytics module is licensed. The heading reads Analytics & Reporting.
| Setting | What it does | Default | Allowed values |
|---|---|---|---|
| In-Person Requirement (%) | Attendance rate expected for in-person tutorials before a course is flagged | 80 | 0–100 |
| Online Requirement (%) | Attendance rate expected for online tutorials before a course is flagged | 100 | 0–100 |
| Lesson Count Mode | Which lessons count towards expected progress | Video lessons only | Video lessons only · All published lessons |
| Highly Engaged (%) | At or above this participation rate = highly engaged | 75 | 1–99 |
| Moderate (%) | At or above this (but below highly engaged) = moderate | 50 | 1–99 |
| Low / Disengaged (%) | Below this = disengaged; between this and Moderate = low | 33 | 1–99 |
Rubric Grading Suite tab
Shown when the Rubric Grading Suite module is licensed. Activating that licence turns the module on automatically. The heading reads Rubric Grading Suite Settings.
| Section | Setting | Default |
|---|---|---|
| Grading — Labels and Feedback Requirements | Pass label / Fail label | Pass / Fail |
| Require overall feedback | On | |
| Enable criterion feedback column | Off | |
| Enable internal notes on marking | On | |
| Enable feedback templates (Comment Bank) | On | |
| Show descriptions on marking · Show regulatory tags on marking · Show guidance on marking (tooltip) | On | |
| Roles allowed to delete evaluations | Administrator | |
| Grading — Marking Window | Expected marking window (days) | 21 |
| Amber trigger (days) | 14 | |
| Grading — Resubmission Deadline Extension | Auto-extend on fail | On |
| Extension length (days) | 14 | |
| PDF & Export | Show scores on results sheet | Off |
| Show score on Assessment Result PDF | Off | |
| Notifications — Late Submission Notifications | Enable late-submission notifications | On |
| Subject | Course: {course} — {assignment} — New Submission | |
| Email body (optional) · Button label | Blank · View submission | |
| Notifications — Due Date Summary Notifications | Enable daily summary | Off |
| Subject | Assignment Due Date Summary — {date} | |
| Intro text (optional) · Button label | Blank · View submissions | |
| Notifications — Student Grading Notifications | Enable student grading email | Off |
| Subject | {assignment} — Your submission has been graded | |
| Email body (optional) · Button label | Blank · View your feedback | |
| Integrations — Webhook Delivery | Enable webhook export · Webhook URL · Signing secret | Off · Blank · Blank |
| Authenticity Checklist | Enable authenticity checklist | Off |
| Checklist items | One built-in declaration item | |
| Retention period (months) | 84 | |
| Store IP address | On | |
| Access — Backend Access Control | Roles allowed backend access | Administrator |
| Roles allowed to unlock for re-grading | Administrator |
PDF headers and logos for rubric documents come from Pages & Reports → PDF Reports, not from this tab.
Files & Storage tab
For administrators. It has its own Save storage settings button.
| Section | Setting | Default |
|---|---|---|
| Connections | A Google Drive connection, shared by everything on this tab | Not connected |
| Assignment file security & video storage (Rubric Grading Suite only) | Video storage provider — Local secure storage · Bunny.net · Google Drive | Bunny.net |
| Bunny Storage Zone, Access Key, CDN Hostname, Storage Hostname, Token Secret (can be locked by your host’s configuration file) | Blank | |
| Video Retention (days) (1–3650) | 180 | |
| After migrating to local — keep or delete the remote copy | Keep the remote copy (recommended) | |
| Secure assignment files — move new Tutor assignment submissions into private storage | On | |
| Encrypted backup | Backup settings for confidential files | — |
| Student records archive | Archive settings | — |
Video migration tools (Migrate to local storage, Move to off-server storage) are also on this tab.
Timetable Planner tab
Shown when the Timetable Planner module is licensed. It holds Subjects, Resources and availability, Session format compatibility and Trainer review settings (Trainer review page, Require trainer login — default off). It has its own save buttons.
Settings without an on-screen control
A few values are stored but don’t appear on the Settings screen. They use these fixed defaults:
| Behaviour | Value |
|---|---|
| Email Log retention — entries older than this are deleted daily | 90 days |
| Recording claim limits per student | 10 per hour, 30 per day |
| Weekly Admin Summary — assignment look-ahead | 3 days, no extra 7-day preview |
Troubleshooting
- “I changed a setting but nothing happened.” Check you clicked Save Settings at the bottom of the screen. It saves every shared tab together. A WordPress notice confirms the save.
- A scheduled email shows “Not Scheduled” on Debug & Maintenance. That’s expected while the email is turned off. Once you turn it on and save, the schedule is created. If your site has WordPress’s built-in scheduler (WP-Cron) disabled, ask your host to make sure a real server cron job calls
wp-cron.phpregularly. - A student doesn’t appear in any picker. Their role probably isn’t in Student Roles (Access & Privacy). Tick their role and save.
- A trainer isn’t in the Trainer dropdown. Their role isn’t in Backend Access (Trainers).
- The Assignments or Analytics tab is missing. Assignments needs Pro plus an LMS that provides assignments. Analytics needs a licensed Progress Tracking & Analytics module. See 29 — Licensing and Updates.