lw-lms-drip-progression

LW LMS drip and linear progression

Use the plugin's progression model and diagnostic command. Do not reproduce the schedule in frontend code.

Model

• free: any accessible lesson can open in any order; stored drip rules are dormant.
• linear: the prior lesson must be complete, then course, section, and lesson time constraints are combined. The latest opening time wins.
• Course delay supports enrollment mode.
• Section and lesson rules support none, enrollment, and previous.
• Units are hour, day, week, and month; the integer delay is 0..999.
• previous with delay zero remains an active rule: open as soon as the prior prerequisite is complete.

The course outline places sectionless lessons first, then ordered sections and their lessons. Orphan lessons that name a missing section are omitted from the drip sequence until the assignment is corrected.

Configure from WP-CLI

wp lw-lms course set-drip 42 --progression=linear --delay=2 --unit=day
wp lw-lms lesson set-drip 101 --mode=enrollment --delay=1 --unit=week
wp lw-lms lesson set-drip 102 --mode=previous --delay=3 --unit=day
wp lw-lms lesson set-drip 103 --mode=none

A lesson rule saved on a free course stays dormant and the command warns about it. Switch the course to linear to enforce sequence and schedule.

Inspect one learner:

wp lw-lms drip status alice 42
wp lw-lms drip status alice 42 --format=json

The rows contain position, lesson_id, title, section, rule, state, reason, available_at, and completed_at.

Control the learner's course clock only for administrative correction or testing:

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

Clearing means the next access creates a new clock. It does not restore an earlier grant timestamp manually removed from user meta.

Clock rules

The clock is stored in _lw_lms_course_start_{course_id}. The first grant wins. For an existing stored enrollment, LW LMS recovers the earliest grant time. Runtime-only subscription or membership access starts on first visit because no access row exists.