learndash-group-access

LearnDash group access

Use this when code needs to enroll users into groups, attach courses to groups, manage group leaders, or answer "does this user get course access through a group?"

LearnDash groups are not just taxonomy terms and not just post meta on a group. In 5.1.9 the access model is three separate relationships:

• User -> group membership.
• Group -> course access.
• Group leader -> administrated group.

Course access through a group exists only when the user is in the group and the group is attached to the course, then the group product start/end rules allow access.

When to use this skill

Trigger when ANY of these appears:

• ld_update_group_access(), ld_update_course_group_access(), ld_update_leader_group_access(), learndash_is_user_in_group(), learndash_user_group_enrolled_to_course(), or learndash_get_users_group_ids().
• Usermeta keys learndash_group_users_{$group_id}, group_{$group_id}_access_from, learndash_group_{$group_id}_enrolled_at, or learndash_group_leaders_{$group_id}.
• Course postmeta keys learndash_group_enrolled_{$group_id} or learndash_group_{$group_id}_enrolled_at.
• Custom group dashboards, group leader portals, imports, CRMs, Woo bridges, memberships, cohort sync, or REST endpoints.

Relationship map

User -> group

The direct user-group relation is stored on the user:

• learndash_group_users_{$group_id} stores the group ID.
• group_{$group_id}_access_from stores the access start timestamp.
• learndash_group_{$group_id}_enrolled_at is historical enrollment time.

Use:

ld_update_group_access( $user_id, $group_id );        // grant
ld_update_group_access( $user_id, $group_id, true );  // revoke

Or use the model wrapper:

use LearnDash\Core\Models\Product;

$group_product = Product::find( $group_id );

if ( $group_product ) {
    $group_product->enroll( $user_id );
}

ld_update_group_access() creates access activity for courses currently attached to the group, fires ld_added_group_access or ld_removed_group_access, and clears user group/course transients.