Commons LMS Documentation
Build, teach and manage learning with Commons LMS.
Feature-accurate documentation for Commons LMS v0.9.26, covering setup, courses, educators, learners, assessments, progress, scheduling, multilingual delivery, certificates, video, portability, privacy and system pages.
Getting started
Commons LMS runs inside WordPress and does not require an external LMS service. After activation, the setup flow creates or reconnects the learner- and educator-facing system pages required by the plugin.
- Install and activate Commons LMS. Upload the plugin ZIP through Plugins → Add New → Upload Plugin, or deploy the
commons-lmsfolder through your usual WordPress workflow. - Complete the Commons LMS setup screen. Review student registration, educator registration and default certificate settings.
- Create a course. Open Commons LMS → Add Course and use the course builder.
- Add modules, lessons and assessments. Structure the course in the order learners should follow.
- Configure delivery. Choose self-paced, scheduled cohort or enrollment-relative drip behaviour and set certificate requirements.
- Test with a learner account. Enroll, complete lessons and assessments, and verify progress and certificate behaviour before launch.
System pages
Commons LMS automatically creates, reconnects and verifies its system pages. The process is designed to be safe to run repeatedly without creating unnecessary duplicate pages.
Courses
Public course directory using [clms_courses].
Student Registration
Learner signup using [clms_registration].
Student Login
Learner sign-in using [clms_login].
My Learning
Learner dashboard using [clms_dashboard].
Verify Certificate
Public credential lookup using [clms_verify].
Educator Workspace
Educator dashboard, login, registration and password pages are also managed automatically.
Administrators can inspect and repair system-page connections from Commons LMS settings. Advanced users may replace automatic system pages with selected WordPress pages.
Courses & the course builder
Commons LMS uses four WordPress content types: Courses, Modules, Lessons and Assessments. Modules organize lessons and assessments inside a course.
Courses
The top-level learning experience. Courses are the top-level learning experience and can be published for learner access through Commons LMS.
Modules
Internal curriculum sections used to group and order lessons and assessments.
Lessons
Learning content with WordPress editor content, featured media, video URL, duration, certificate requirement and downloadable resources.
Assessments
Multiple-choice assessments with passing rules, attempt limits, question pools, randomization and explanations.
The dedicated course builder is the main place to construct a Commons LMS course. Educators with appropriate Commons LMS capabilities can work through their front-end Educator Workspace rather than requiring broad WordPress administrator access.
Educators
Commons LMS v0.9.26 includes a dedicated educator account and workspace system. Educator accounts use normal WordPress users with Commons LMS-specific roles and capabilities.
Registration modes
Educator registration can be Closed, Approval required, or Open. Approval required is the default.
Approval workflow
Administrators can review pending educators and approve, reject, suspend or remove Commons LMS access while preserving the WordPress account and course content where applicable.
Educator Workspace
Educators can see their courses, create/edit courses, access their profile and sign out from a front-end workspace.
Public profiles
Educators can add a professional title, affiliation, biography and profile image and choose whether the profile is public.
Students & enrollment
Learners are ordinary WordPress users. Commons LMS uses WordPress authentication and stores LMS-specific learner profile information alongside the WordPress account.
Student registration
Registration can collect name, email, password and optional institution, current status, city, country and certificate name.
Course enrollment
A learner can enroll in multiple courses. Enrollment records support Active, Completed, Withdrawn and Suspended states.
Manual enrollment
Administrators can enroll an existing WordPress user into a course by email.
Administration
The Students screen supports search/filtering by course, status and cohort, plus CSV export.
The admin Students screen also reports lifetime enrollments, completed enrollments and certificates issued.
Assessments
Commons LMS assessments are multiple-choice assessments attached to course modules. The current assessment engine includes significantly more than a basic quiz.
Passing score
Set the percentage a learner must achieve to pass an assessment.
Attempt limits
Limit attempts, or set the limit to 0 for unlimited attempts.
Question pools
Choose all questions or draw a defined number from a larger question pool.
Randomization
Randomize question order, answer order, and optionally draw a new random set on each attempt.
Required assessments
An assessment can be marked as required for course completion.
Explanations
Each question can include an explanation shown after submission.
Fast assessment creation
Questions can be created manually, added in bulk from structured pasted text, or imported from CSV. CSV import expects Question, Option A, Option B, Option C, Option D, Correct Answer and Explanation columns.
Progress, completion & certificates
Commons LMS records learner progress through lessons and assessment attempts. Required lessons and required assessments contribute to course/certificate completion according to the course configuration.
Lesson progress
Completed lesson state is recorded for the enrolled learner and course.
Assessment progress
Assessment attempts store score, percentage, pass/fail state and attempt time.
Course completion
Commons LMS evaluates required learning items and completion rules before marking a course complete.
Public statistics
Enrollment and completion counts can be shown publicly, with a configurable minimum enrollment threshold.
Scheduling & content drip
Courses can use one of three delivery modes.
Self-paced
Available content follows normal enrollment/access rules without a cohort timeline.
Scheduled cohort
Course, module and item availability can follow scheduled dates/times.
Enrollment-relative drip
Modules or items can unlock a defined number of days after an individual learner enrolls.
Locked-content messages
Learners receive an availability message when scheduled content has not yet unlocked.
Multilingual learning
Commons LMS supports multilingual variants of courses, lessons and assessments while keeping related learning progress shared rather than creating independent learning histories for each translation.
Assessment translations change question wording, answers and explanations while inheriting the correct-answer positions from the primary-language assessment. This keeps the assessment logic aligned across language versions.
Video & lesson resources
Lessons can store a video URL and may also include downloadable or linked resources such as PDFs, slides, documents, images and external links.
Video player modes
Hybrid Commons Player
The recommended mode. It displays a Commons LMS cover first and loads YouTube only when playback starts, while retaining YouTube captions, quality, speed, fullscreen, keyboard and accessibility controls.
Native YouTube Player
Embeds the native YouTube player inside the responsive Commons LMS video frame.
Standard embed
Uses WordPress oEmbed for compatible provider URLs rather than the specialized YouTube player flow.
Resume playback
Optional browser-local resume remembers the last playback position. Resume state does not count toward lesson or certificate completion.
youtube-nocookie.com when the player is
loaded. Commons LMS does not send learner enrollment, assessment, certificate or profile
records to YouTube.
Certificates & public verification
Commons LMS can issue a certificate after the configured course requirements are met. Certificates use a public credential ID so an issued credential can be verified.
Certificate requirements
Courses can define the learning requirements that must be met before a certificate is available.
Signatories
Configure up to three signatories with Name, Position and Affiliation. Signature images are optional, allowing physical-signing workflows.
Defaults & overrides
Global signatory defaults can be inherited by courses and overridden at course level.
Verification
The verification page accepts a credential ID and reports whether the matching certificate is valid.
Certificate records keep snapshot fields for recipient and course names so a historical credential does not have to depend entirely on the continued existence of the original WordPress user or course.
Branding
Learner-facing presentation can use the normal WordPress Site Identity or Commons LMS branding settings. Available controls include LMS identity elements and interface colors.
Commons LMS does not require a public-facing “Powered by Commons LMS” credit in the submitted v0.9.26 build, allowing institutions to use their own learner-facing identity.
Export, import & portability
Commons LMS provides two distinct portability systems because course content and learner records have different privacy and migration requirements.
Course packages
Administrators can export a course as a Commons LMS JSON package containing the course structure and supported course/module/lesson/assessment metadata. Course packages explicitly do not contain learner data.
Course import
Commons LMS validates and sanitizes JSON course packages before creating imported course content. Remote featured images are not fetched during import.
Learner-record packages
A separate privacy-sensitive JSON format can export learners, enrollments, progress, assessment attempts and certificates.
Learner import
Learner records use a separate importer so privacy-sensitive records cannot be accidentally passed through the ordinary course-content importer.
Privacy & data retention
Commons LMS integrates with WordPress’s personal-data export and erasure tools. The plugin can export or erase Commons LMS learner data associated with a WordPress account.
Certificate retention
Administrators can choose what happens to issued certificate records when a learner account is deleted:
- Revoke and retain — the default; the historical certificate record is kept but marked revoked.
- Retain as valid — preserve the certificate as a valid historical credential.
- Delete — remove the certificate record.
When a learner account is removed, Commons LMS removes its enrollment, progress and assessment records for that user. Certificate handling follows the configured retention policy.
WordPress site operators remain responsible for choosing retention settings and privacy practices appropriate to their institution and applicable obligations.
Shortcodes in v0.9.26
The following shortcodes are registered by the submitted Commons LMS build.
| Shortcode | Purpose |
|---|---|
[clms_courses] | Course directory/listing. |
[clms_course] | Render a Commons LMS course. |
[clms_lesson] | Render a lesson. |
[clms_quiz] | Render an assessment. |
[clms_registration] | Student registration. |
[clms_login] | Student login. |
[clms_dashboard] | Student “My Learning” dashboard. |
[clms_certificate] | Render an eligible learner certificate. |
[clms_verify] | Public credential verification. |
[clms_course_stats] | Public enrollment/completion statistics for a course. |
[clms_educator_dashboard] | Educator Workspace. |
[clms_educator_login] | Educator login. |
[clms_educator_register] | Educator registration/application. |
[clms_educator_password] | Educator password reset flow. |
[clms_educator_public_profile] | Render a public educator profile. |
Commons LMS normally creates and manages the required system pages automatically, so most site owners do not need to insert these shortcodes manually.
Troubleshooting
A system page is missing
Use the system-page status/repair controls in Commons LMS settings before manually rebuilding registration, login, dashboard, verification or educator pages.
A learner cannot enroll
Check course scheduling, enrollment availability and the learner’s existing enrollment state.
Content is locked
Check scheduled cohort dates or enrollment-relative drip settings for the course, module or item.
An assessment does not complete
Check the passing score, required status, attempt limit and whether the learner has a valid active enrollment.
A certificate is unavailable
Confirm that all configured certificate/course-completion requirements have been met.
YouTube behaviour differs from the page cover
Once the native YouTube player loads, YouTube controls its own player UI, captions, quality, branding and service-controlled playback behaviour.
An educator cannot manage courses
Check the educator account state. Pending, rejected or suspended educators do not have active Commons LMS course-management access.
Import fails
Confirm that the file is the correct Commons LMS JSON package type. Course packages and learner-record packages use separate import paths.
Project information
Commons LMS was originally created by Bob Stanley Gardner in 2026.
Commons LMS is free software distributed under the GNU General Public License, version 2 or later.
Project website: https://themeridiansociety.in/commons-lms/
Documentation: https://themeridiansociety.in/commons-lms/docs/
WordPress.org contributor: bobstanleygardner