learndash-woocommerce-access

LearnDash WooCommerce access

Use this when WooCommerce products, orders, subscriptions, refunds, or product variations must grant or revoke LearnDash course/group access.

The LearnDash WooCommerce bridge is not just "on completed order call ld_update_course_access()". It tracks product relations, variable product relations, configurable order/subscription statuses, partial refunds, subscription switches, order item mutations, access expiration, silent queued enrollment, and a per-user counter so one access source does not remove another.

When to use this skill

Trigger when ANY of these appears:

• Plugin path/name learndash-woocommerce.
• Product meta _related_course or _related_group.
• User meta _learndash_woocommerce_enrolled_courses_access_counter.
• LearnDash\WooCommerce\Settings\Status_Access.
• Options learndash_woocommerce_enrollment_status_settings, learndash_woocommerce_silent_course_enrollment_queue, or learndash_woocommerce_disable_access_removal_on_expiration.
• Woo hooks around order status, refund, subscription status, subscription switch, order item added/deleted, customer change, or HPOS.

Product relation model

LearnDash WooCommerce stores related LearnDash objects on the Woo product or variation:

• _related_course is an array of LearnDash course IDs.
• _related_group is an array of LearnDash group IDs.
• Simple products store relations on the product ID.
• Variable and variable-subscription parents clear parent-level relations and store relations on each variation.
• Runtime order processing checks the variation ID first; if no variation ID is present, it checks the product ID.

When building a compatible importer/sync, preserve that shape:

update_post_meta( $product_or_variation_id, '_related_course', array_map( 'absint', $course_ids ) );
update_post_meta( $product_or_variation_id, '_related_group', array_map( 'absint', $group_ids ) );

Do not store a scalar ID and do not attach courses only to a variable parent if the product is sold through variations.