lw-lms-wp-cli-operations
Use the LW LMS v1.6.0 operational WP-CLI commands added in v1.4.0. Covers `wp lw-lms course create|list|delete|set-section`, `wp lw-lms lesson create|list|assign`, `wp lw-lms enroll`, `wp lw-lms revoke`, `wp lw-lms force-complete`, argument resolution by ID/slug/login/email, enro
Install
npx skills add https://github.com/Lonsdale201/wp-agent-skills/tree/main/lw-plugins/lw-lms-wp-cli-operations
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install lonsdale201-wp-agent-skills@llmmart
git clone https://github.com/Lonsdale201/wp-agent-skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole lonsdale201/wp-agent-skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
LW LMS WP-CLI operations
Use the registered commands for repeatable administration. Use lw-lms-learndash-migration for migrate-learndash.
Reference resolution
- Course and lesson: numeric post ID or slug.
- User: numeric ID, login, or email.
- Resolution errors stop the command through
WP_CLI::error().
Command catalog
| Command | Purpose |
|---|---|
course create |
Create course; access type defaults to the configured default_access_type |
course list |
List by access type/status and machine format |
course delete |
Trash or force-delete the course post |
course set-section |
Create/update a section |
course set-drip |
Set free/linear progression and course enrollment delay |
lesson create |
Create and assign a lesson |
lesson list |
List lessons for a course/section |
lesson assign |
Reassign course, section, and order |
lesson set-quiz |
Replace quiz from JSON |
lesson get-quiz |
Output the stored quiz, including correct answers |
lesson delete-quiz |
Delete current quiz; preserve attempts |
lesson set-drip |
Set none/enrollment/previous rule |
enroll |
Durable access grant through the repository |
revoke |
Revoke every active stored access row for user/course |
force-complete |
Complete all published course lessons |
drip status |
Diagnose one learner's lock map |
drip set-start |
Set, reset-to-now, or clear one course clock |
Course and lesson examples
wp lw-lms course create --title="Course" --status=draft --porcelain
wp lw-lms course list --status=any --format=json
wp lw-lms course set-section 42 --id=intro --title="Introduction" --order=0
wp lw-lms lesson create --title="Welcome" --course=42 --section=intro --order=1 --porcelain
wp lw-lms lesson assign welcome --course=42 --section=intro --order=2
wp lw-lms lesson list --course=42 --format=json
wp lw-lms course delete 42 --force
course delete removes the course post only. It does not cascade-delete lessons, access, progress, completion snapshots, or attempts. Plan cleanup deliberately.
Section IDs passed through CLI are normalized with sanitize_key(). Use lowercase identifiers consistently; an uppercase ID created through another interface will not compare equal after CLI normalization.
Enrollment and completion
wp lw-lms enroll alice 42 --source=manual --expires="2026-12-31 23:59:59"
wp lw-lms revoke alice 42
wp lw-lms force-complete alice 42
enroll calls AccessRepository::grant() and fires grant hooks. The expiry is stored in the access table's UTC contract. Repeating a null-source-ID grant is idempotent within the same source in 2.0.0.
revoke is broad in 2.0.0: it revokes all active stored rows for that user/course and fires lw_lms_after_revoke for each row. It cannot remove live subscription, membership, or legacy-purchase entitlement. Use PHP revoke_by_source() when only one integration-owned row should end.
force-complete writes progress and completion hooks. It does not grant access and intentionally overrides learner pacing and quiz gates.
Quiz commands
wp lw-lms lesson set-quiz 99 --file=quiz.json
cat quiz.json | wp lw-lms lesson set-quiz intro --file=-
wp lw-lms lesson get-quiz 99 --format=json
wp lw-lms lesson delete-quiz 99 --yes
The JSON normalizer is strict. set-quiz replaces the whole quiz. get-quiz exposes correct answers; do not send its output to learner logs. Deletion preserves attempt history.
Drip commands
wp lw-lms course set-drip 42 --progression=linear --delay=2 --unit=day
wp lw-lms lesson set-drip 101 --mode=previous --delay=1 --unit=week
wp lw-lms drip status alice 42 --format=json
wp lw-lms drip set-start alice 42 --date="2026-09-01 09:00:00"
wp lw-lms drip set-start alice 42 --now
wp lw-lms drip set-start alice 42 --clear
Supported units are hour, day, week, and month; delays are 0..999. A lesson rule on a free-progression course stays dormant. Read lw-lms-drip-progression before changing a real learner's clock.
Automation rules
- Use
--porcelainfor created IDs. - Use
--format=json,csv,yaml,count, oridswhere the command supports it; do not parse human tables. - Capture IDs before destructive cleanup.
- Build a dry-run around your orchestration because operational commands have no common
--dry-runflag. - Do not run
get-quizin a public CI log. - Verify frontend state after writes; command success proves persistence, not the complete learner experience.
Cross-references
- Use
lw-lms-drip-progressionfor schedule semantics and known 2.0.0 timezone behavior. - Use
lw-lms-quiz-integrationfor quiz schema and learner submissions. - Use
lw-lms-backend-extendfor repository/hook semantics. - Use
lw-lms-learndash-migrationforwp lw-lms migrate-learndash. - Use
lw-lms-rest-frontendto verify learner responses.
References
- Official repository: https://github.com/lwplugins/lw-lms
- Verified source paths:
includes/Plugin.phpincludes/CLI/CliResolver.phpincludes/CLI/*Command.phpincludes/CLI/DripArgs.phpincludes/Access/AccessRepository.phpincludes/Progress/ProgressRepository.php
Files (wp-agent-skills)
-
SKILL.md 5.8 KB
--- name: lw-lms-wp-cli-operations description: Operates LW LMS 2.0.0 with WP-CLI. Use for `wp lw-lms course`, `lesson`, `enroll`, `revoke`, `force-complete`, `drip status|set-start`, quiz import/export/delete, course or lesson drip settings, reference resolution, automation output formats, and understanding enrollment, completion, quiz, or lock side effects. Excludes the LearnDash migration workflow. metadata: wp-skills-author: "Soczó Kristóf" wp-skills-contact: "mailto:lonsdale201@hotmail.com" wp-skills-plugin: "lw-lms" wp-skills-plugin-version-tested: "2.0.0" wp-skills-wp-version-tested: "7.1.2" wp-skills-php-min: "8.0" wp-skills-last-updated: "2026-09-26" --- # LW LMS WP-CLI operations Use the registered commands for repeatable administration. Use `lw-lms-learndash-migration` for `migrate-learndash`. ## Reference resolution - Course and lesson: numeric post ID or slug. - User: numeric ID, login, or email. - Resolution errors stop the command through `WP_CLI::error()`. ## Command catalog | Command | Purpose | |---|---| | `course create` | Create course; access type defaults to the configured `default_access_type` | | `course list` | List by access type/status and machine format | | `course delete` | Trash or force-delete the course post | | `course set-section` | Create/update a section | | `course set-drip` | Set free/linear progression and course enrollment delay | | `lesson create` | Create and assign a lesson | | `lesson list` | List lessons for a course/section | | `lesson assign` | Reassign course, section, and order | | `lesson set-quiz` | Replace quiz from JSON | | `lesson get-quiz` | Output the stored quiz, including correct answers | | `lesson delete-quiz` | Delete current quiz; preserve attempts | | `lesson set-drip` | Set none/enrollment/previous rule | | `enroll` | Durable access grant through the repository | | `revoke` | Revoke every active stored access row for user/course | | `force-complete` | Complete all published course lessons | | `drip status` | Diagnose one learner's lock map | | `drip set-start` | Set, reset-to-now, or clear one course clock | ## Course and lesson examples ```bash wp lw-lms course create --title="Course" --status=draft --porcelain wp lw-lms course list --status=any --format=json wp lw-lms course set-section 42 --id=intro --title="Introduction" --order=0 wp lw-lms lesson create --title="Welcome" --course=42 --section=intro --order=1 --porcelain wp lw-lms lesson assign welcome --course=42 --section=intro --order=2 wp lw-lms lesson list --course=42 --format=json wp lw-lms course delete 42 --force ``` `course delete` removes the course post only. It does not cascade-delete lessons, access, progress, completion snapshots, or attempts. Plan cleanup deliberately. Section IDs passed through CLI are normalized with `sanitize_key()`. Use lowercase identifiers consistently; an uppercase ID created through another interface will not compare equal after CLI normalization. ## Enrollment and completion ```bash wp lw-lms enroll alice 42 --source=manual --expires="2026-12-31 23:59:59" wp lw-lms revoke alice 42 wp lw-lms force-complete alice 42 ``` `enroll` calls `AccessRepository::grant()` and fires grant hooks. The expiry is stored in the access table's UTC contract. Repeating a null-source-ID grant is idempotent within the same source in 2.0.0. `revoke` is broad in 2.0.0: it revokes all active stored rows for that user/course and fires `lw_lms_after_revoke` for each row. It cannot remove live subscription, membership, or legacy-purchase entitlement. Use PHP `revoke_by_source()` when only one integration-owned row should end. `force-complete` writes progress and completion hooks. It does not grant access and intentionally overrides learner pacing and quiz gates. ## Quiz commands ```bash wp lw-lms lesson set-quiz 99 --file=quiz.json cat quiz.json | wp lw-lms lesson set-quiz intro --file=- wp lw-lms lesson get-quiz 99 --format=json wp lw-lms lesson delete-quiz 99 --yes ``` The JSON normalizer is strict. `set-quiz` replaces the whole quiz. `get-quiz` exposes correct answers; do not send its output to learner logs. Deletion preserves attempt history. ## Drip commands ```bash wp lw-lms course set-drip 42 --progression=linear --delay=2 --unit=day wp lw-lms lesson set-drip 101 --mode=previous --delay=1 --unit=week wp lw-lms drip status alice 42 --format=json wp lw-lms drip set-start alice 42 --date="2026-09-01 09:00:00" wp lw-lms drip set-start alice 42 --now wp lw-lms drip set-start alice 42 --clear ``` Supported units are `hour`, `day`, `week`, and `month`; delays are `0..999`. A lesson rule on a free-progression course stays dormant. Read `lw-lms-drip-progression` before changing a real learner's clock. ## Automation rules - Use `--porcelain` for created IDs. - Use `--format=json`, `csv`, `yaml`, `count`, or `ids` where the command supports it; do not parse human tables. - Capture IDs before destructive cleanup. - Build a dry-run around your orchestration because operational commands have no common `--dry-run` flag. - Do not run `get-quiz` in a public CI log. - Verify frontend state after writes; command success proves persistence, not the complete learner experience. ## Cross-references - Use `lw-lms-drip-progression` for schedule semantics and known 2.0.0 timezone behavior. - Use `lw-lms-quiz-integration` for quiz schema and learner submissions. - Use `lw-lms-backend-extend` for repository/hook semantics. - Use `lw-lms-learndash-migration` for `wp lw-lms migrate-learndash`. - Use `lw-lms-rest-frontend` to verify learner responses. ## References - Official repository: <https://github.com/lwplugins/lw-lms> - Verified source paths: - `includes/Plugin.php` - `includes/CLI/CliResolver.php` - `includes/CLI/*Command.php` - `includes/CLI/DripArgs.php` - `includes/Access/AccessRepository.php` - `includes/Progress/ProgressRepository.php`
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.