Claude Skill

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

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
Download Lonsdale201-wp-agent-skills-lw-plugins_lw-lms-wp-cli-operations-c51b571.zip · 2 KB

Install

skills CLI npx skills add https://github.com/Lonsdale201/wp-agent-skills/tree/main/lw-plugins/lw-lms-wp-cli-operations
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install lonsdale201-wp-agent-skills@llmmart
Git 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 --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
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.

No comments yet.

Reviews (0)

No reviews yet.