WP_Role::has_cap( string $cap ): bool

In this article

Determines whether the role has the given capability.

Parameters

$capstringrequired
Capability name.

Return

bool Whether the role has the given capability.

Source

public function has_cap( $cap ) {
	/**
	 * Filters which capabilities a role has.
	 *
	 * @since 2.0.0
	 *
	 * @param bool[] $capabilities Array of key/value pairs where keys represent a capability name and boolean values
	 *                             represent whether the role has that capability.
	 * @param string $cap          Capability name.
	 * @param string $name         Role name.
	 */
	$capabilities = apply_filters( 'role_has_cap', $this->capabilities, $cap, $this->name );

	if ( ! empty( $capabilities[ $cap ] ) ) {
		return $capabilities[ $cap ];
	} else {
		return false;
	}
}

Hooks

apply_filters( ‘role_has_cap’, bool[] $capabilities, string $cap, string $name )

Filters which capabilities a role has.

Changelog

VersionDescription
2.0.0Introduced.

User Contributed Notes

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