Browse: Home / Functions /

learndash_bulk_create_course_access_activities

learndash_bulk_create_course_access_activities( int[] $user_ids,  int[] $course_ids,  int $group_id )

Bulk creates course access activity records for user/course combinations.

Contents

Description #

Handles efficient creation of ‘access’ type activity records:

  1. Queries existing records to avoid duplicates
  2. Filters to find only missing combinations
  3. Bulk inserts in chunks for efficiency

Parameters #

$user_ids

(int[]) (Required) Array of user IDs.

$course_ids

(int[]) (Required) Array of course IDs.

$group_id

(int) (Optional) Group ID for looking up accurate enrollment timestamps. When provided, uses the later of user-group or course-group enrollment dates. When omitted, uses current time.

Return #

(int) Number of activity records created.

Source #

File: includes/course/ld-activity-functions.php

Changelog #

Changelog
Version Description
5.0.1 Introduced.

Uses #

Uses
Uses Description
includes/course/ld-activity-functions.php: learndash_group_access_activity_chunk_size

Filters the chunk size for bulk course access activity creation.
includes/course/ld-activity-functions.php: learndash_bulk_create_course_access_activities_skip

Filters whether to skip bulk creation of course access activities.
src/Core/Utilities/Cast.php: Cast::to_int ()

Casts a value to a int if possible or returns an empty string.
src/Core/Utilities/Cast.php: Cast::to_string ()

Casts a value to a string if possible or returns an empty string.
includes/class-ldlms-db.php: LDLMS_DB::get_table_name ()

Utility function to return the table name. This is to prevent hard-coding of the table names throughout the code files.