LLMS_Achievements::get_achievements_by_post( array|int $post_ids, bool $include_children = true )
Get a list of achievement Achievement Template IDs for a given post.
Parameters Parameters
- $post_ids
-
(array|int) (Required) Post IDs or single post ID to look for achievements by.
- $include_children
-
(bool) (Optional) If true, will include course children (sections, lessons, and quizzes).
Default value: true
Return Return
(array)
Source Source
File: includes/class.llms.achievements.php
public function get_achievements_by_post( $post_ids, $include_children = true ) { if ( ! is_array( $post_ids ) ) { $post_ids = array( $post_ids ); } $original_post_ids = $post_ids; if ( $include_children ) { foreach ( $post_ids as $post_id ) { if ( 'course' === get_post_type( $post_id ) ) { $course = llms_get_post( $post_id ); $post_ids = array_merge( $post_ids, $course->get_sections( 'ids' ), $course->get_lessons( 'ids' ), $course->get_quizzes() ); } } } /** * Filters the query args to retrieve the achievements by post. * * @since 5.3.3 * * @param array $args The query args to retrieve the achievements by post. * @param array|int $post_ids Post IDs or single post ID to look for achievements by. * @param bool $include_children If true, will include course children (sections, lessons, and quizzes). */ $query_args = apply_filters( 'llms_achievements_by_post_query_args', array( 'post_type' => 'llms_engagement', 'meta_query' => array( array( 'key' => '_llms_engagement_type', 'value' => 'achievement', ), array( 'compare' => 'IN', 'key' => '_llms_engagement_trigger_post', 'value' => $post_ids, ), ), 'posts_per_page' => 500, ), $original_post_ids, $include_children ); $query = new WP_Query( $query_args ); $achievements = array(); foreach ( $query->posts as $engagement ) { $achievements[] = get_post_meta( $engagement->ID, '_llms_engagement', true ); } return $achievements; }
Expand full source code Collapse full source code View on GitHub
Changelog Changelog
Version | Description |
---|---|
5.3.3 | Set the query limit to 500. |
3.24.0 | Introduced. |