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.

Contents

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

Top ↑

Return Return

(array)

Top ↑

Source Source

File: includes/class.llms.achievements.php

95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
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

Top ↑

Uses Uses

Uses
Uses Description
includes/class.llms.achievements.php: llms_achievements_by_post_query_args

Filters the query args to retrieve the achievements by post.
includes/llms.functions.core.php: llms_get_post()

Retrieve the LLMS Post Model for a give post by ID or WP_Post Object

Top ↑

Changelog Changelog

Changelog
Version Description
5.3.3 Set the query limit to 500.
3.24.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.