LLMS_Grades::get_grade( WP_Post|int $post_id, LLMS_Student $student, bool $use_cache = true )

Main grade getter function


Description Description

Uses caching by default and can bypass cache when requested


Top ↑

Parameters Parameters

$post_id

(WP_Post|int) (Required) An instance of WP_Post or a WP Post ID.

$student

(LLMS_Student) (Required) A LLMS_Student object.

$use_cache

(bool) (Optional) when true, retrieves from cache if available

Default value: true


Top ↑

Return Return

(float|null)


Top ↑

Source Source

File: includes/class-llms-grades.php

214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
public function get_grade( $post_id, $student, $use_cache = true ) {
 
    $post    = llms_get_post( $post_id );
    $student = llms_get_student( $student );
 
    $grade = $use_cache ? $this->get_grade_from_cache( $post, $student ) : false;
 
    // Grade not found in cache or we're not using the cache.
    if ( false === $grade ) {
 
        $grade = $this->calculate_grade( $post, $student );
 
        // Store in the cache.
        wp_cache_set(
            sprintf( '%d_grade', $post->get( 'id' ) ),
            $grade,
            sprintf( 'student_%d', $student->get( 'id' ) )
        );
 
    }
 
    return apply_filters( 'llms_get_grade', $grade, $post, $student );
 
}


Top ↑

Changelog Changelog

Changelog
Version Description
4.4.4 Don't pass the $use_cache parameter to the calculate_grade() method.
3.24.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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