llms_current_user_can( string $cap, int $obj_id = null )

Checks LifterLMS user capabilities against an object


Parameters Parameters

$cap

(string) (Required) Capability name.

$obj_id

(int) (Optional) WP_Post or WP_User ID.

Default value: null


Top ↑

Return Return

(boolean)


Top ↑

Source Source

File: includes/functions/llms.functions.person.php

63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
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
function llms_current_user_can( $cap, $obj_id = null ) {
 
    $caps  = LLMS_Roles::get_all_core_caps();
    $grant = false;
 
    if ( in_array( $cap, $caps, true ) ) {
 
        // If the user has the cap, maybe do some additional checks.
        if ( current_user_can( $cap ) ) {
 
            switch ( $cap ) {
 
                case 'view_lifterlms_reports':
                    // Can view others reports so its okay.
                    if ( current_user_can( 'view_others_lifterlms_reports' ) ) {
                        $grant = true;
 
                        // Can only view their own reports check if the student is their instructor.
                    } elseif ( $obj_id ) {
 
                        $instructor = llms_get_instructor();
                        $student    = llms_get_student( $obj_id );
                        if ( $instructor && $student ) {
                            foreach ( $instructor->get_posts(
                                array(
                                    'posts_per_page' => -1,
                                ),
                                'ids'
                            ) as $id ) {
                                if ( $student->get_enrollment_status( $id ) ) {
                                    $grant = true;
                                    break;
                                }
                            }
                        }
                    }
 
                    break;
 
                // No other checks needed.
                default:
                    $grant = true;
 
            }
        }
    }
 
    /**
     * Filters whether or not the current user can perform the requested action
     *
     * The dynamic portion of this hook, `$cap`, refers to the requested user capability.
     *
     * @since 3.13.0
     *
     * @param bool $grant  Whether or not the requested capability is granted to the user.
     * @param int  $obj_id WP_Post or WP_User ID.
     */
    return apply_filters( "llms_current_user_can_{$cap}", $grant, $obj_id );
 
}


Top ↑

Changelog Changelog

Changelog
Version Description
4.5.0 Use strict array comparison.
3.13.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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