Troubleshooting

Solutions to the most common issues, matched to how the plugin actually behaves.

The plugin deactivated itself

The addon deactivates on admin_init if either dependency is missing:

• The active theme is not reign-theme. Activate the Reign theme.
• Tutor LMS (tutor/tutor.php) is not active. Install and activate Tutor LMS.

Fix the missing dependency, then activate the addon again. If activation still fails, confirm the site meets the version floors: WordPress 6.5 and PHP 8.0. See Requirements.

A shortcode shows as plain text

If [reign_tutor_course] or [reign_course_categories] renders literally:

• Confirm the plugin is active.
• Check the spelling and the bracket style. Use [reign_tutor_course], not [reign-tutor-course] or {reign_tutor_course}.
• In a page builder, use a shortcode block or module rather than a raw HTML block.

No courses show

• Confirm courses are published and, for category filters, that the category slug or ID is correct.
• For my_courses="yes", the resolved user must be logged in and enrolled in courses. A logged-out visitor sees a “Please log in to view your courses.” message.
• If a course_status filter returns nothing, you get a status-specific message such as “No completed courses yet.”; this means no courses matched that status, not an error.

The wrong user’s courses show

• Check the parameter spelling: my_courses="yes", not my_course or mycourses.
• On a profile tab the user is detected from the profile being viewed. If detection is off, pass an explicit user_id, or user_id="current" to force the logged-in user.
• Clear page, CDN, and browser caches.

The profile tab does not appear

• Confirm Enable My Courses Tab is checked and saved under the TutorLMS > Profile Integration settings.
• Confirm a supported community platform is active. The Profile Integration screen lists the platforms it detected.
• Some platforms cache their navigation. Clear caches and log out and back in.

Courses look unstyled or broken

• View the page source and confirm the plugin stylesheet is loading (its handle is reign-tutorlms-addon).
• If you use CSS minification or a cache plugin, clear it so the current stylesheet is served.
• Enable SCRIPT_DEBUG to load the unminified stylesheet while you debug styling.

Settings do not save

• Confirm your user has the manage_options capability; the save handler requires it.
• Remember settings live in the shared reign_options record under the tutorlms key, not a plugin-specific option. Check wp_options for reign_options rather than a reign_tutorlms_* option.

Enabling debug logging

Add to wp-config.php while investigating, then remove:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
define( 'SCRIPT_DEBUG', true );

Check /wp-content/debug.log for errors.

Emergency recovery

If the site is inaccessible, disable the plugin by renaming its folder under /wp-content/plugins/, or run wp plugin deactivate reign-tutorlms-addon with WP-CLI.