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.

Version: 0.9.26 Creator: Bob Stanley Gardner Requires WordPress: 6.4+ Requires PHP: 7.4+ License: GPL-2.0-or-later

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.

  1. Install and activate Commons LMS. Upload the plugin ZIP through Plugins → Add New → Upload Plugin, or deploy the commons-lms folder through your usual WordPress workflow.
  2. Complete the Commons LMS setup screen. Review student registration, educator registration and default certificate settings.
  3. Create a course. Open Commons LMS → Add Course and use the course builder.
  4. Add modules, lessons and assessments. Structure the course in the order learners should follow.
  5. Configure delivery. Choose self-paced, scheduled cohort or enrollment-relative drip behaviour and set certificate requirements.
  6. Test with a learner account. Enroll, complete lessons and assessments, and verify progress and certificate behaviour before launch.
Pre-1.0 release Commons LMS v0.9.26 is a pre-1.0 build. Use normal WordPress backups and test upgrades on staging before applying new development builds to a production learning site.

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.

Current workspace scope The educator workspace currently focuses on courses and educator profile management. Learner and analytics tabs shown in the workspace are marked as coming later.

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 is an optional external service When a course author supplies a YouTube URL, the learner’s browser may request thumbnails from YouTube and may connect to YouTube or 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.

Administrator-only tools Course and learner-record import/export operations are protected by WordPress administrator capability checks and nonces. Learner-record packages contain personal data and should be handled accordingly.

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.

ShortcodePurpose
[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

Commons LMS documentation for v0.9.26. Copyright © 2026–present Bob Stanley Gardner. Commons LMS is free software distributed under the GNU General Public License, version 2 or later.

Scroll to Top