LMS Integration
Dantian Training Hub doesn’t keep its own course catalogue. It reads courses and student enrolments from an enrolment source:
- TutorLMS
- LifterLMS
- Training Hub-native classes (“standalone mode”) — the plugin’s own Classes, for sites with no LMS
Whichever source you use, the enrolled students appear automatically on attendance lists, reports and reminder emails for that course’s sessions.
Who this page is for: the site administrator setting up the plugin, and coordinators who want to know why a student does or doesn’t appear on a list.
Choosing the enrolment source
Training Hub → Settings → Setup & Enrolment → Enrolment Source → Enrolment provider
| Option | When to use it |
|---|---|
| Auto-detect (currently: …) (default) | Almost always. The plugin checks for TutorLMS first, then LifterLMS. If neither is active, it uses Training Hub-native classes. The brackets show which source it found. |
| TutorLMS | Force TutorLMS — for example, if both TutorLMS and LifterLMS are active and you use TutorLMS. |
| LifterLMS | Force LifterLMS. |
| Training Hub-native classes | Run standalone even though an LMS is installed. |
A source whose plugin isn’t installed is listed as “— not installed” and can’t be chosen. If you force a source and its plugin is later deactivated, the plugin falls back to auto-detection.
To change it:
- Choose the option.
- Click Save Settings.
- On the Getting Started tab, the Enrolment Source card shows “Currently using: …”. Click Looks right — confirm to tick the step off.
No API key or connection details are needed — the LMS just has to be active on the same WordPress site.
What each source provides
| Feature | TutorLMS | LifterLMS | Native classes |
|---|---|---|---|
| Course list and enrolled students | Yes | Yes | Yes — each class is a “course” and its members are the students |
| Default trainer role given session access | tutor_instructor |
instructor |
None — administrator only until you grant a role |
| Lesson Completion tab on the Student Report | Yes | Yes | No |
| Quizzes (for quiz counts and Pro assessment quizzes) | Yes (Tutor LMS free) | Yes | No |
| Assignments (for Pro due dates and extensions — see 15) | Only with Tutor LMS Pro | Where LifterLMS provides assignments | No |
| Pro Rubric Grading Suite (21) | Only with Tutor LMS Pro and its Assignments add-on turned on | No | No |
| Qualification and Units of Competency boxes on the course editor | Yes | No | No |
| Course difficulty levels you can rename (Pro) | Yes | Only difficulties named Beginner, Intermediate or Expert | No |
| Import from LMS / scheduled course enrolment on the Classes screen | Yes | Yes | Not applicable |
Tutor LMS free includes an empty assignments placeholder but no working assignment features. The plugin only treats assignments as available when Tutor LMS Pro is active. That’s why the Pro Assignments settings tab and assignment reminders don’t appear on a Tutor LMS free site.
TutorLMS
- Install and activate TutorLMS (and Tutor LMS Pro if you need assignments).
- Leave Enrolment provider on Auto-detect, or choose TutorLMS, and save.
- Create sessions against your TutorLMS courses in Training Hub → Manage Sessions.
Students enrolled in a TutorLMS course appear on the attendance list for every session of that course. When a student enrols in or leaves a course in TutorLMS, the plugin picks up the change automatically — there’s nothing to refresh.
Users with the tutor_instructor role get trainer access by default. You can change this under Settings → Access & Privacy → Backend Access (Trainers) — see 28 — Permissions, Privacy and Maintenance.
LifterLMS
- Install and activate LifterLMS.
- Leave Enrolment provider on Auto-detect (TutorLMS is preferred if both are active), or choose LifterLMS, and save.
Students enrolled in a LifterLMS course appear on attendance lists. New LifterLMS enrolments are picked up automatically. LifterLMS’s instructor role gets trainer access by default.
Standalone mode (Training Hub-native classes)
Use standalone mode if you have no LMS, or your LMS isn’t TutorLMS or LifterLMS. In standalone mode:
- You create Classes at Training Hub → Classes and add students to them. Each class is the “course” you schedule sessions against and report on.
- Only administrators have trainer access until you tick a role under Settings → Access & Privacy → Backend Access (Trainers).
- Lessons, quizzes and assignments aren’t available, so the features that depend on them (Lesson Completion, quiz counts, Pro assignment features, rubric grading) are hidden. Attendance, clinics, reports, dashboards and calendars (25) still work.
Full instructions: 24 — Classes and Standalone Enrolment.
Classes are also useful with an LMS — for example, to enrol a whole intake into a course on a set start date. See Scheduled course enrolments.
Which users count as students
Whatever the source, a user must also have a student role to appear in student pickers (the student report selector, student search, recording claims, ad-hoc attendees). By default the plugin treats student, tutor_student, subscriber and customer as student roles. If your students use another role, tick it under Settings → Access & Privacy → Student Roles.
Switching sources
Switching the enrolment source doesn’t delete any attendance records. However, each session is tied to a course in the source it was created under. A TutorLMS course and a native class are different things, even if they have the same name. After you switch:
- Existing sessions and their attendance stay in the database, but the plugin looks up their course in the new source. They may show as an unknown course or list no students.
- Create new sessions against the new source’s courses.
Treat switching as a one-off decision at setup time, not something to toggle back and forth. If you’re moving from standalone to an LMS mid-year, finish the current term first or ask your developer to plan the move.
Troubleshooting
- A student is enrolled in the course but isn’t on the attendance list. Check (1) the enrolment is active in the LMS, (2) the student’s role is ticked under Student Roles, or is one of the built-in defaults, and (3) they haven’t been excluded from that session.
- “Auto-detect (currently: native)” even though TutorLMS is installed. TutorLMS isn’t active, or is failing to load. Activate it on the Plugins screen.
- The Lesson Completion tab is missing. You’re in standalone mode, which has no lessons.
- The Assignments tab is missing on a TutorLMS site. Assignments need Tutor LMS Pro (and Dantian Training Hub Pro).
Worked example
A college runs a Certificate IV in Massage Therapy on TutorLMS with Tutor LMS Pro. The administrator leaves Enrolment provider on Auto-detect, which shows “(currently: tutorlms)”, and confirms it on Getting Started. Trainers already have the tutor_instructor role, so they can mark attendance straight away. On Course Details the administrator adds the qualification “Certificate IV in Massage Therapy” and its units of competency, then ticks them on each TutorLMS course. Because Tutor LMS Pro is active, the Pro Assignments tab appears and assignment reminders can be added to the weekly upcoming-sessions email.