lw_lms_after_grant, lw_lms_after_revoke, lw_lms_pre_grant, lw_lms_has_course_access, AccessChecker, AccessRepository, AccessQueries, ProgressRepository, ProgressQueries, CompletionTracker, wp_lms_progress, wp_lms_access, _lw_lms_* meta, or WooCommerce Memberships/Subscriptions access.\nmetadata:\nwp-skills-author: \"Soczó Kristóf\"\nwp-skills-contact: \"mailto:lonsdale201@hotmail.com\"\nwp-skills-plugin: \"lw-lms\"\nwp-skills-plugin-version-tested: \"1.6.0\"\nwp-skills-php-min: \"8.2\"\nwp-skills-last-updated: \"2026-07-20\"For companion plugins or themes extending LW LMS from PHP: enrollment automation, certificates, progress writes, access checks, custom settings tabs, analytics, admin tooling, and integrations with WooCommerce, WooCommerce Subscriptions, or WooCommerce Memberships.
\n\n\nBETA NOTICE. The plugin README says the plugin is under active development and not recommended for production use. Pin a tested version and review
\nCHANGELOG.mdbefore upgrading. This skill is verified against local lw-lms v1.6.0.
lw_lms_has_course_access is reachable again as the final logged-in paid-course decision after all built-in checks. AccessRepository::revoke_by_source() adds source-scoped stored-access revocation. Minimum PHP is now 8.2._lw_lms_membership_plan_ids. Active members get access at read time through MembershipChecker; no DB schema change and no access row is written.lw-lms-wp-cli-operations for those commands.lw_lms_settings_tabs filter and SettingsPage::get_settings_group() added for companion settings tabs and shared options.php saving.content is public; only lesson content remains access-gated.lw_lms_pre_grant, lw_lms_after_grant, lw_lms_after_revoke, ProgressRepository::mark_course_completed(), read/write splits.AccessChecker::has_course_access() now reaches lw_lms_has_course_access after the complete built-in paid-course cascade: access rows, parent subscriptions, variation subscriptions, WooCommerce Memberships, then legacy purchases. The callback receives the aggregate built-in result and has final say, so it can grant or deliberately deny logged-in paid-course access.
The filter is not universal:
\nopen returns true before the filter;free or paid access returns false before the filter;free access for a logged-in user lazily grants source='free' and returns true before the filter;paid access reaches the filter after all built-in checks.Preserve a built-in grant unless the integration intentionally implements a denial policy:
\nadd_filter(\n 'lw_lms_has_course_access',\n static function ( bool $has_access, int $course_id, int $user_id ): bool {\n if ( $has_access ) {\n return true;\n }\n\n return MyMembership::has_course_access( $user_id, $course_id );\n },\n 10,\n 3\n);\nThis is a runtime decision only: returning true does not create an access row and does not fire grant/revoke actions. Keep the callback deterministic, side-effect-free, and fast. CourseTransformer::transform_full() currently calls has_course_access() directly and again through get_access_info(), so the filter runs twice while producing one full paid-course response. A time-varying result can make access.has_access disagree with lesson/attachment gating.
Use AccessRepository::grant() instead when the entitlement should be durable, auditable, expirable, or should fire enrollment automation.
lw_lms_has_lesson_access is more useful, but it is still not universal: it fires for open-course lessons and the normal course-access branch, but preview lessons return before that filter.
Read references/backend-contract-details.md when the task needs the plugin identity, CPT/taxonomy/table/meta map, exact repository read/write examples, settings-tab implementation, or expanded wrong/right examples. The access-filter, hook, workflow, and safety rules needed for normal extension work remain below.
\n| Hook | \nArgs | \nFires | \n
|---|---|---|
lw_lms_after_grant | \n$user_id, $course_id, $source, $source_id, $expires_at (5) | \nAfter AccessRepository::grant() inserts or updates successfully | \n
lw_lms_after_revoke | \n$user_id, $course_id, $source (3) | \nAfter revoke() changes its first active row, or once after revoke_by_source() changes one or more matching rows | \n
lw_lms_lesson_completed | \n$lesson_id, $user_id (2) | \nWhen ProgressRepository::upsert() transitions a lesson to completed | \n
lw_lms_course_completed | \n$course_id, $user_id (2) | \nOnce, when CompletionTracker::maybe_record() writes the completion snapshot | \n
lw_lms_attachment_downloaded | \n$attachment_id, $user_id (2) | \nAfter a protected attachment download passes access checks | \n
| Hook | \nArgs | \nCaveat | \n
|---|---|---|
lw_lms_pre_grant | \n$allow, $user_id, $course_id, $source, $source_id, $expires_at (6) | \nReturn false to abort AccessRepository::grant() before DB write | \n
lw_lms_has_course_access | \n$has_access, $course_id, $user_id (3) | \nFinal logged-in paid-course result in v1.6.0; open/free/anonymous paths return before it; may execute more than once per request | \n
lw_lms_has_lesson_access | \n$has_access, $lesson_id, $user_id (3) | \nNot reached for preview-lesson short-circuit | \n
lw_lms_settings_tabs | \narray<TabInterface> $tabs (1) | \nAdd/remove/reorder settings tabs; non-TabInterface values are dropped | \n
Always register callbacks with the right accepted-args value:
\nadd_action( 'lw_lms_after_grant', 'my_enrollment_handler', 10, 5 );\nadd_action( 'lw_lms_after_revoke', 'my_revoke_handler', 10, 3 );\nadd_filter( 'lw_lms_pre_grant', 'my_pre_grant_guard', 10, 6 );\n| Path | \nStored row? | \nFires lw_lms_after_grant? | \n
|---|---|---|
WooCommerce completed order through AccessGranter | \nyes, source='woocommerce' | \nyes | \n
| Admin user-profile grant | \nyes, source='manual' | \nyes | \n
| Free course first access by logged-in user | \nyes, source='free' | \nyes | \n
Programmatic AccessRepository::grant() | \nyes | \nyes | \n
| Parent WC subscription active check | \nno | \nno | \n
| Variation-level WC subscription active check | \nno | \nno | \n
| WooCommerce Memberships active member check | \nno | \nno | \n
| Legacy WooCommerce purchase fallback | \nno | \nno | \n
If downstream automation must react to subscriptions or memberships, hook WooCommerce Subscriptions or WooCommerce Memberships lifecycle events directly, or write an access row yourself through AccessRepository::grant() when your integration decides access should become durable.
add_action(\n 'lw_lms_after_grant',\n static function ( int $user_id, int $course_id, string $source, ?int $source_id, ?string $expires_at ): void {\n MyAnalytics::track( 'lms_enrolled', compact( 'user_id', 'course_id', 'source' ) );\n MyDripScheduler::start( $user_id, $course_id );\n },\n 10,\n 5\n);\nThis catches Woo completed orders, admin manual grants, free-course lazy grants, and your own AccessRepository::grant() calls. It does not catch live subscription, membership, or legacy purchase access checks.
add_filter(\n 'lw_lms_pre_grant',\n static function ( bool $allow, int $user_id, int $course_id, string $source, ?int $source_id, ?string $expires_at ): bool {\n if ( ! $allow ) {\n return false;\n }\n\n if ( MySeats::is_full( $course_id ) ) {\n return false;\n }\n\n return true;\n },\n 10,\n 6\n);\nReturning false prevents the DB write and prevents lw_lms_after_grant.
add_action( 'lw_lms_course_completed', static function ( int $course_id, int $user_id ): void {\n MyCertificateGenerator::issue( $user_id, $course_id );\n}, 10, 2 );\nThe completion snapshot makes this a one-shot event per user/course pair.
\nadd_filter(\n 'lw_lms_has_course_access',\n static function ( bool $has_access, int $course_id, int $user_id ): bool {\n return $has_access || MyMembership::has_course_access( $user_id, $course_id );\n },\n 10,\n 3\n);\nUse this only for a fast, deterministic live check. It affects logged-in paid access but writes no enrollment row and fires no enrollment lifecycle action.
\nif ( MyMembership::user_joined_plan( $user_id, 'pro' ) ) {\n \\LightweightPlugins\\LMS\\Access\\AccessRepository::grant(\n $user_id,\n $course_id,\n 'my_membership',\n MyMembership::membership_id( $user_id ),\n null\n );\n}\nWhen that membership ends, revoke only the row owned by the integration:
\n\\LightweightPlugins\\LMS\\Access\\AccessRepository::revoke_by_source(\n $user_id,\n $course_id,\n 'my_membership',\n MyMembership::membership_id( $user_id )\n);\nAccessRepository::grant() and revoke_by_source() for integration-owned stored access changes. The broad revoke() changes only the first active row regardless of origin. Direct SQL skips hooks.ProgressRepository::upsert() and mark_course_completed() for progress changes. Direct SQL skips completion hooks and snapshots.AccessQueries and ProgressQueries.lw_lms_after_grant needs 5 accepted args; lw_lms_pre_grant needs 6; lw_lms_after_revoke needs 3.grant() lookup ignore source; use a stable, collision-resistant non-null source_id for external grants.expires_at is enforced on read by AccessQueries::has_active_access(). No expiry cron fires lw_lms_after_revoke.ProgressRepository::delete() does not delete completion snapshots. If an admin reset must also undo completion, call ProgressSnapshotRepository::delete() deliberately.lw_lms_has_course_access is the final logged-in paid-course decision in v1.6.0, but open/free/anonymous paths bypass it. Keep it deterministic, side-effect-free, and cheap.revoke_by_source( ..., $source, null ) revokes every active row for that source, not only null-source-ID rows.lw_lms_settings_tabs plus SettingsPage::get_settings_group(), not a second unrelated form.lw-lms-rest-frontend for learner-facing /wp-json/lms/v1 consumers.lw-lms-abilities for admin/agent lw-lms/* Abilities API calls.lw-lms-wp-cli-operations for operational CLI commands added in v1.4.0.lw-lms-learndash-migration for the one-time LearnDash migration.WooCommerceChecker, SubscriptionVariationChecker, or MembershipChecker as stable public services. Prefer AccessChecker or a stored grant.lw-lms.php.includes/Plugin.php.includes/Activator.php, includes/Access/AccessTable.php, progress table classes.includes/Access/AccessChecker.php.includes/Access/AccessRepository.php.includes/Access/AccessQueries.php.includes/Access/AccessGranter.php.includes/Access/WooCommerceChecker.php, SubscriptionVariationChecker.php, MembershipChecker.php.includes/Progress/ProgressRepository.php, CompletionTracker.php.includes/Admin/SettingsPage.php, includes/Admin/Settings/TabInterface.php.CHANGELOG.md.wp-content/plugins/lw-lms/includes/Options.phpwp-content/plugins/lw-lms/includes/Admin/UserProfile.phpwp-content/plugins/lw-lms/includes/Admin/UserProfile/EnrollmentHandler.phpwp-content/plugins/lw-lms/includes/Meta/CourseMeta.phpwp-content/plugins/lw-lms/includes/Meta/LessonMeta.phpwp-content/plugins/lw-lms/includes/Meta/SubscriptionVariationMeta.phpwp-content/plugins/lw-lms/includes/Progress/ProgressQueries.phpwp-content/plugins/lw-lms/includes/Progress/ProgressCalculator.phpwp-content/plugins/lw-lms/includes/Progress/ProgressSnapshotRepository.phpwp-content/plugins/lw-lms/includes/Progress/ProgressSnapshotTable.phpwp-content/plugins/lw-lms/includes/Progress/ProgressSnapshotMigration.phpwp-content/plugins/lw-lms/includes/Api/Controllers/ProgressController.phpwp-content/plugins/lw-lms/includes/Api/Controllers/DownloadController.phpwp-content/plugins/lw-lms/includes/SiteManager/Integration.php