current_user_can always returns true for Super Admins (Doc update)

[finnj]

Codex documentation needs update on current_user_can()

The documentation does not state, that current_user_can("capability") always will return true if user is Super Admin - caused me some grief, that I would like to save others :)

I suggest to add the following to the Notes section:
current_user_can( $capability ) will aways return true if user is Super Admin, unless specifically denied

Below code is from: ​https://developer.wordpress.org/reference/classes/wp_user/has_cap/

// Multisite super admin has all caps by definition, Unless specifically denied.
    if ( is_multisite() && is_super_admin( $this->ID ) ) {
        if ( in_array('do_not_allow', $caps) )
            return false;
        return true;
    }

[ericlewis]

Seems like a good idea to say this in our docs in the right places.

[jeremyfelt]

We do have it noted inline already. Unless we want to be more explicit in the function docs.

@finnj The Codex can be updated by any logged in user if you'd like to make a change there.

[finnj]

@jeremyfelt the inline is on wp_user has_cap, not on current_user_can()

I added a note on the codex (didn't know I could), and tried on the code reference documentation, but I did not formal the link correctly so it does not look good - Most likely this will be captured by moderation, as I cant edit my note...

​https://developer.wordpress.org/reference/functions/current_user_can/

you can close this ticket

[jorbin]

As current_user_can is the API function developers are expected to use, a reference on the inline docs makes sense to me. @DrewAPicture - would you agree?

[jeremyfelt]

Replying to finnj:

@jeremyfelt the inline is on wp_user has_cap, not on current_user_can()

Oops, I read too quickly. :) +1 for a reference on current_user_can().

[DrewAPicture]

Hi @finnj, nice catch :-)

[DrewAPicture]

In 36492:

Docs: Add a note to the DocBlock for current_user_can() to explain that it will always return true for super admins, unless specifically denied.

Props finnj.
Fixes #35551.

[DrewAPicture]

@finnj: Following [36492], I've removed your note from the reference page and have temporarily updated the function description, which will work until the reference is re-parsed for the 4.5 release.