current_user_can() │ WP 2.0.0

// Перевіримо можливість
if( current_user_can('manage_options') ){
	echo "Користувач має право змінювати налаштування";
}

// Визначаємо користувача глобально
global $user;
if( user_can($user->ID, 'manage_options') ){
	// робимо щось, що може користувач з цими правами
};

manage_options – права адміністратора

if( current_user_can('edit_post', 123) ) {
	 echo 'Поточний користувач може редагувати пост 123'.
}

З версії 4.7. Стало можливим перевіряти права окремого терміна. Для цього потрібно використовувати права: edit_term , delete_term , assign_term .

Наприклад, давайте виведемо посилання на редагування елемента таксономії, тільки якщо поточний користувач має таке право.

if( current_user_can('edit_term', $term_id) ){
	echo '<a href="'. get_edit_term_link( $term_id ) .'">Редакт.</a>';
}

Якщо ви хочете перевірити більше двох ролей, ви можете перевірити, чи є роль поточного користувача всередині масиву ролей, наприклад:

$user = wp_get_current_user();
$allowed_roles = array( 'editor', 'administrator', 'author' );

if ( array_intersect( $allowed_roles, $user->roles ) ) {
   // Stuff here for allowed roles
}

Не рекомендується використовувати назву ролі в current_user_can(), тому що код може працювати неправильно.

Приклад, як робити не слід:

// якщо поточний користувач редактор (editor), функція поверне:
current_user_can('administrator') // false
current_user_can('editor') // true
current_user_can('contributor') // false
current_user_can('subscriber') // false

Чому так писати не варто? Наприклад, ми використовуємо перевірку current_user_can('editor'), яка дозволяє редактору робити що-небудь, начебто все добре і користувач з роллю ‘editor’ проходить перевірку, але користувач з роллю ‘administrator’, який також повинен проходити перевірку, її не пройде!

Хак для можливості використовувати імена ролей у перевірці права користувача

Якщо вставити цей хук у файлі теми functions.php, то до списку прав користувача, що перевіряється будуть додаватися всі ролі які вважаються нижче за рівнем доступу, наприклад для користувача за участю автор будуть додані також ролі contributor і subscriber. Таким чином, перевірку current_user_can( 'contributor' )буде також пройдено для будь-якої ролі вище зазначеної – це author > editor > administrator.

add_filter( 'user_has_cap', 'user_lower_roles_to_allcaps', 10, 4);

/**
 * Додайте низку клацань до списку всіх дзвінків поточної перевірки користувача.
 *
 * @param bool[] $allcaps Array of key/value pairs where keys являють собою capability name and
 * boolean values ​​represent whether the user has that capability.
 * @param string[] $caps Потрібні primitive capabilities for the requested capability.
 * @param array $args Arguments that accompany the requested capability check.
 * @param WP_User $user The user object.
 *
 * @return bool[]
 */
function user_lower_roles_to_allcaps( $allcaps, $caps, $args, $user ){

	$roles_chain = ' > administrator > editor > author > contributor > subscriber > ';

	// do nothing if no need
	if( false === strpos( $roles_chain, $args[0] ) ){
		return $allcaps;
	}

	$low_roles = '';
	foreach( $user->roles as $role ){

		$pos = strpos( $roles_chain, " > $role > " );

		if( false === $pos ){
			continue;
		}

		$_low_roles = substr($roles_chain, $pos);

		if( strlen( $_low_roles ) > strlen( $low_roles ) ){
			$low_roles = $_low_roles;
		}
	}

	// add top roles to all caps
	$low_roles = explode('>', trim($low_roles, '>'));
	foreach( $low_roles as $lowrole ){
		$allcaps[ $lowrole ] = 1;
	}

	return $allcaps;
}

Перевіримо як працює хак:

$ user = get_userdata( 141 ); // editor
var_dump( user_can( $user, 'administrator' ) ); // bool (false)
var_dump( user_can( $user, 'contributor' ) ); // bool (true)
echo "---n";

$user = get_userdata(3); // author
var_dump( user_can( $user, 'administrator' ) ); // bool (false)
var_dump( user_can( $user, 'contributor' ) ); // bool (true)
echo "---n";

$ user = get_userdata (1220); // contributor
var_dump( user_can( $user, 'administrator' ) ); // bool (false)
var_dump( user_can( $user, 'contributor' ) ); // bool (true)
var_dump( user_can( $user, 'subscriber' ) ); // bool (true)
echo "---n";

$ user = get_userdata (2486); // subscriber
var_dump( user_can( $user, 'administrator' ) ); // bool (false)
var_dump( user_can( $user, 'contributor' ) ); // bool (false)
var_dump( user_can( $user, 'subscriber' ) ); // bool (true)

Щоб мати можливість надійно перевіряти права точно за ролями, було б зручно перераховувати їх у масиві, але ми не можемо написати так – це викличе нотиси:

current_user_can( [ 'administrator', 'author' ] );

Для такої перевірки я іноді використовую таку функцію:

/**
 * Checks if the specified role is in the roles of the current/specified user.
 *
 * @param string|array $roles Назви role ви збираєтеся за допомогою поточного користувача.
 * @param empty|int|WP_User $user Default: current user
 *
 * @return bool
 */
function is_user_role_in( $roles, $user = false ) {

	$user || $user = wp_get_current_user();

	if( is_numeric( $user ) ){
		$ user = get_userdata ($ user);
	}

	if( empty( $user->ID ) ){
		return false;
	}

	foreach( (array) $roles as $role ){
		if( isset( $user->caps[ $role ] ) || in_array( $role, $user->roles, true ) ){
			return true;
		}
	}

	return false;
}

Приклад використання:

if( is_user_role_in( [ 'new_role','new_role2' ] ) ){
	echo 'Роль поточного користувача new_role або new_role2';
}

if( is_user_role_in( [ 'new_role','new_role2' ], 5 ) ){
	echo 'Роль користувача 5 new_role або new_role2';
}