Completion Manager Documentation

Documentation — Tutor LMS Completion Manager
Tutor LMS Completion Manager — Documentation
Get the Plugin — $59 →
Plugin Documentation

Tutor LMS
Completion Manager

A dedicated admin interface for manually marking student course progress as complete — at the lesson, topic, or full course level — without requiring any action from the student.

📦 Version 1.0.0 🔌 Requires: Tutor LMS ✅ Works with Tutor LMS Free & Pro

Ready to get started?

One-time payment of $59 · Lifetime updates · Secure checkout via WooCommerce

Purchase the Plugin — $59 →
Section 1

Overview

Tutor LMS Completion Manager gives administrators full manual control over student course completion. It adds a dedicated admin page under the Tutor LMS menu where you can browse all enrolled students, view their progress across every course, and mark lessons, topics, or entire courses as complete with a single click.

This is built for situations where you need to credit students for offline work, correct a completion tracking error, or grant completion status to students who completed a course through a non-standard path.

📄

Lesson Level

Mark individual lessons complete for precise, one-at-a-time control.

📂

Topic Level

Mark all lessons within a topic complete in a single click.

🎓

Course Level

Mark an entire course complete, triggering all Tutor LMS completion hooks including certificates.

✅

Native compatibility. The plugin uses Tutor LMS’s own completion functions — certificates, notifications, and grade records are all updated exactly as they would be if the student completed the course themselves.

Section 2

Requirements

Minimum requirements

ComponentMinimum version
WordPress5.8 or higher
PHP7.4 or higher
Tutor LMS2.0 or higher (Free or Pro)

Recommended environment

ComponentRecommendation
WordPressLatest version
PHP8.0 or higher
Tutor LMSLatest version (Pro recommended for advanced features like certificates)

Required plugin

Section 3

Installation

Method 1: WordPress admin upload (recommended)

  1. Log in to your WordPress admin dashboard
  2. Navigate to Plugins → Add New
  3. Click Upload Plugin
  4. Select the tutor-lms-completion-manager.zip file
  5. Click Install Now, then Activate Plugin

Method 2: Manual FTP installation

  1. Unzip the tutor-lms-completion-manager.zip file
  2. Upload the tutor-lms-completion-manager folder to /wp-content/plugins/
  3. Navigate to Plugins → Installed Plugins in WordPress admin
  4. Find “Tutor LMS Completion Manager” and click Activate

Post-installation steps

  1. Verify Tutor LMS is active and fully configured
  2. Navigate to Tutor → License and enter your license key
  3. Navigate to Tutor → Student Completion Manager to confirm the interface loads correctly
  4. Test by locating an enrolled student and manually marking a lesson as complete
Section 4

Admin Interface

Navigate to Tutor → Student Completion Manager in the WordPress admin to access the plugin. The page is only accessible to users with administrator capabilities.

Student list

The main page lists all students who are enrolled in at least one Tutor LMS course. Each row shows the student’s display name, email address, and a View Progress button that opens their individual progress page.

A search box at the top of the list accepts partial name or email matches. When a search is active, the page shows the search query and result count, and a Clear Search button appears to reset the list back to all students.

Student progress page

Clicking View Progress for any student opens their dedicated progress page showing every course they are enrolled in. Each course is displayed as a collapsible card — click the toggle arrow to expand it and reveal the topics and lessons inside.

A message area at the top of the page displays confirmation notices after each action. A back link returns you to the full student list.

Understanding the interface at a glance

ElementWhat it means
✓ Completed (green, course header)The entire course is marked complete
Mark Course Complete buttonMarks all topics and lessons complete and fires Tutor LMS hooks
All Lessons Complete (topic button, disabled)Every lesson in this topic is already done
✓ Completed (green, lesson row)This individual lesson is complete
Complete (lesson button, disabled)This lesson has already been marked complete
⚠️

Completion is one-directional. The plugin marks items as complete but does not provide an undo or “mark incomplete” action. To reset a completion record, use Tutor LMS’s native tools or modify the database directly.

Section 5

Marking a Lesson Complete

Use this for precise, one-at-a-time control when you need to credit a student for a specific lesson without affecting anything else in the course.

  1. Navigate to Tutor → Student Completion Manager and click View Progress for the student
  2. Expand the relevant course card by clicking the toggle arrow
  3. Locate the topic containing the lesson
  4. Click Mark Complete next to the desired lesson
  5. The lesson’s status column updates to ✓ Completed, the button is disabled, and a success message appears at the top of the page
ℹ️

All actions use WordPress AJAX — the page does not reload. The UI updates instantly after each action and buttons for already-completed items are disabled to prevent accidental double-marking.

Section 6

Marking a Topic Complete

Use this to complete all lessons within a topic in a single action — useful when a student has finished an entire section of a course offline or through a non-tracked path.

  1. Expand the relevant course card
  2. Locate the topic section you want to complete
  3. Click Mark Topic Complete in the topic header
  4. All lessons within the topic are marked complete simultaneously
  5. Every lesson row updates to show ✓ Completed with disabled buttons, and the topic button is relabeled “All Lessons Complete” and disabled
Section 7

Marking a Course Complete

Use this to grant a student full completion status for an entire course, including triggering all downstream effects like certificates and completion notifications.

  1. Locate the course card on the student’s progress page
  2. Click Mark Course Complete in the course header
  3. All topics and lessons in the course are marked complete
  4. Tutor LMS’s course completion hooks fire automatically — certificates are generated, notifications sent, and grade records updated just as they would be for a student who completed the course normally
  5. The course card shows ✓ Completed and the button is disabled
✅

Because the plugin calls Tutor LMS’s own completion functions, all downstream effects work automatically — you do not need to manually trigger certificates or notifications separately.

Section 8

Frequently Asked Questions

Yes. If your Tutor LMS setup issues certificates on course completion, marking a course complete via this plugin triggers those same completion hooks — including certificate generation. The plugin uses Tutor LMS’s native completion functions, so all downstream effects work exactly as they would for a student who completed the course themselves.
Yes. The plugin includes a Reset Progress feature that allows admins to undo completion markings directly from the student progress page. Resetting a lesson removes its completion record and also clears the topic and course completion. Resetting a topic removes all its lessons’ completion records and clears the course completion. Resetting a course removes all completion records within it. No database access or third-party tools are needed.
No. The plugin only displays students who are already enrolled in at least one Tutor LMS course, and completion can only be recorded for valid, active enrollments. To mark a student as complete in a course, they must first be enrolled in it.
The plugin works with both Tutor LMS Free and Pro. Some downstream effects of course completion — such as certificate generation — may require Tutor LMS Pro, as certificates are a Pro feature. The completion marking itself works with either version.
Lesson completion is recorded at the lesson level. Whether completing all lessons automatically triggers course completion depends on your Tutor LMS settings — specifically whether quizzes or assignments are also required. If your course requires quiz completion, use the Mark Course Complete button to bypass those requirements and grant full course completion directly.
Yes. All completion data is stored in Tutor LMS’s native database tables, not in any tables created by this plugin. Uninstalling this plugin only removes its own license-related options and has no effect whatsoever on any student completion records.
Section 9

Troubleshooting

Before contacting support, enable WordPress debug logging by adding define('WP_DEBUG', true); and define('WP_DEBUG_LOG', true); to your wp-config.php. Plugin log entries are prefixed with [TLCM].

! No students appearing in the list

The student list only shows users actively enrolled in at least one course. If the list is empty:

  • Confirm Tutor LMS is active and has courses with enrollments
  • Verify that students are enrolled with an active status — students with cancelled or pending enrollments will not appear
  • Confirm the logged-in admin has the manage_options capability
! Mark Complete button has no effect

If clicking a button shows no response at all:

  • Open the browser developer tools Console tab and check for JavaScript errors
  • Confirm that jQuery is loading on the admin page — the plugin’s JavaScript depends on it
  • Enable WP_DEBUG_LOG and check debug.log for PHP errors from the AJAX handler
! Course not showing as complete after marking

If the completion badge does not appear after clicking Mark Course Complete:

  • Open the browser console and check whether the AJAX response contains success: true — if not, a PHP error may be interrupting the handler
  • Confirm the student is actively enrolled in the course (enrollment status must be active, not cancelled)
  • Check debug.log for [TLCM] entries that indicate what happened during the request
! Lessons still show as “Not Complete” after marking topic or course

The UI updates are driven by JavaScript after a successful AJAX response. If the displayed status does not update:

  • Reload the page — if lessons now show as complete after a fresh load, the backend recorded correctly and only the live JavaScript update failed
  • Check the browser console for JavaScript errors in the post-AJAX DOM update code
! “No topics or lessons in this course” shown unexpectedly

This message appears when the plugin cannot retrieve any topics for a course. Verify:

  • Confirm the course has published topics with published lessons as children in Tutor LMS
  • Enable debug logging and check debug.log for any errors when the course card is loaded
Section 10

Support

💬

Need help? Visit the support portal

If you’re experiencing an issue not covered in this documentation or the troubleshooting section, submit a support request through the portal. Please include the details below to help resolve your issue as quickly as possible.

Open Support Portal →
Your WordPress version
Your PHP version
Your Tutor LMS version (Free or Pro)
Relevant lines from debug.log prefixed with [TLCM]
A clear description of the issue and the steps to reproduce it
Any JavaScript console errors visible in your browser’s developer tools