Start with LMS → Status: it checks the most common problems and shows the plugin’s log. Then find your problem below.
The Status screen explains each check. If you are still stuck, contact support.
Links and pages
Course links open the home page.
If course, lesson or catalogue links show your home page instead of the course, WordPress’s stored permalink rules have no rules for courses. This usually happens after another LMS plugin that also uses /courses/ was active: its rules stay behind after it is deactivated.
The plugin notices that its course permalinks are missing and rebuilds them on the next page load. If links still open the home page:
- Go to Settings → Permalinks.
- Press Save Changes without changing anything.
This rebuilds every permalink rule. If another active plugin also uses /courses/ for its own content, the two will keep clashing; deactivate the one you no longer use.
Pages show the wrong person’s details, or a stale cart.
Course and catalogue pages can be cached, because they look the same for every visitor. Pages made for one person, such as the learning area, the checkout, My Learning and the Instructor Dashboard, and any page while a visitor has something in their cart, are kept out of page caches automatically. This works with WP Rocket, W3 Total Cache, LiteSpeed Cache and Cloudflare APO, and with most caches that respect WordPress’s standard no-cache signals.
If one of these pages still shows another person’s details or an old cart:
- Clear the page cache.
- Add the page to your cache plugin’s list of pages never to cache, especially if you put a dashboard or checkout block on a page other than the ones the plugin created.
- If your host has its own server cache, ask them to respect the no-cache headers on these pages.
LMS → Tools → Clear caches empties the plugin’s own cached data. It does not clear your page cache.
A course does not appear to students.
Check that it is Published in the builder, and that its lessons are switched to Published: draft items are hidden from students. See Course settings.
A student cannot open a lesson.
The lesson tells the student why: not enrolled, access ended, not released yet, or a prerequisite or earlier item is not finished. Check the course’s Release content, Courses to complete first and Days of access settings. See Releasing content.
Progress looks wrong after an import or big changes.
Run Recount progress and Rebuild course outlines on LMS → Tools. See Tools.
Files and templates
Private files are not protected on nginx.
Students’ assignment files and protected lesson files are stored in wp-content/uploads/public-learning-management-system/private/, with random file names, and are downloaded through signed links that expire. Apache and LiteSpeed also obey the .htaccess file in that folder, which blocks direct access.
nginx ignores .htaccess files. On nginx, LMS → Status shows Private files as Needs attention, with the exact line for your site. A warning also appears at the top of the LMS screens for administrators (until you fix it or press Dismiss) and above each lesson’s Protected files in the course builder.
Add the line to your site’s server block and reload nginx. For a standard WordPress install it is:
location ^~ /wp-content/uploads/public-learning-management-system/private/ { deny all; }If your uploads folder is somewhere else, use the path that LMS → Status shows. If you cannot edit the nginx configuration yourself, send the line to your host.
With Pro, the plugin checks whether the folder really is closed instead of going by the server’s name: twice a day at most, it writes a small test file there, asks your site for it and deletes it again. A server with the rule passes, and any server that serves the folder gets the warning. If the test request cannot reach your site, it goes by the server’s name.
LMS → Status says template overrides are outdated.
Your theme can change the plugin’s front-end templates by keeping copies in a public-learning-management-system/ folder inside the theme. When the plugin updates one of those templates, your theme’s copy may miss the change, for example the protected files list in learning/lesson.php.
LMS → Status shows Template overrides as Needs attention and lists each outdated file with your theme’s version and the plugin’s version. Compare each file with the plugin’s own copy in its templates/ folder and bring your copy up to date, or delete your copy to use the plugin’s.
Emails
Emails do not arrive.
The plugin sends email through WordPress’s own mailer, like most plugins. Many hosts do not deliver that mail reliably.
- Check that the email is switched on, on LMS → Emails.
- On the same screen, press Edit wording and then Send me a test. If the test does not arrive either, the problem is with your site’s mail, not the plugin.
- Install an SMTP or email-service plugin and connect it to a mail provider. The plugin’s emails then go through it.
- Check the sender on LMS → Settings → Emails. Leave the sender name and sender email address empty to use WordPress’s defaults, or use an address on your own domain.
- Check the recipient’s spam folder.
Students can turn off announcement, question-and-answer, reminder and new-lesson emails in their profile on My Learning. Emails about enrollments, grades, certificates and orders are always sent while they are switched on. See Emails.
Reminders or new-lesson emails are not sent.
- They are off. On sites that had Public LMS before version 1.0.0, Reminder after a quiet spell and New lessons are open start switched off, so an update sends nothing new. Turn them on on LMS → Emails, or with Remind students who stopped learning and Email students when scheduled lessons open (one email a day at most) on LMS → Settings → Emails.
- They go out once a day. Both are sent by the plugin’s daily maintenance task. LMS → Status shows under Scheduled tasks when it runs next. On a site with few visitors, WordPress’s scheduled tasks can run late; a real cron job on the server helps.
- Nobody is due one yet. A reminder needs an active, unfinished enrollment with no progress for the number of days in Send a reminder after this many days without progress (14 by default), and stops after Reminders per course, at most (2). The student’s timeline on LMS → Students shows Reminder sent for each one.
- The course does not release content on a schedule. New-lesson emails are only for courses whose Release content is On a schedule: set dates or days on each item. The first check after you turn the email on only notes the time, so lessons that opened before are not sent.
- The student turned them off in their profile on My Learning.
Calendar
A calendar feed does not update.
The calendar feed on a student’s Schedule is read by their calendar app, which checks subscribed calendars on its own timetable. Google Calendar, for example, can take several hours, sometimes a day, to show changes. The plugin cannot make it check sooner.
- If the student pressed Make a new address (the old one stops working), the old address returns “not found”. Remove the old calendar and subscribe to the new address.
- The feed covers the day before to 90 days ahead, and leaves out completed courses.
- The feed is kept out of page caches automatically. If your host’s server cache still serves an old copy, ask them not to cache addresses that contain
publms_calendar.