WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

user_has_cap хук-фильтр . WP 2.0.0

Позволяет удалить/добавить новые права (возможности) отдельному пользователю.

Использование

add_filter( 'user_has_cap', 'filter_function_name_7526', 10, 4 );
function filter_function_name_7526( $allcaps, $caps, $args, $user ){
	// filter...

	return $allcaps;
}
$allcaps(массив)
Массив всех возможностей пользователя. Массив пар ключ/значение, где ключи представляют имя возможности и логические значения показывают, имеет ли пользователь эту возможность.
$caps(массив)
Необходимые примитивные возможности для запрашиваемой возможности. То, что возвращает map_meta_cap().
$args(массив)
Дополнительные параметры переданные в current_user_can() или WP_User::has_cap(), обычно это ID объекта (поста/коммента/юзера).
$user(WP_User)
Объект юзера, права которого фильтруются.

Примеры

#1 Добавим названия прав в список прав пользователей на лету

Обычно права ролям выставляются при регистрации роли.

Но иногда удобнее выставлять права для роли на лету. Например на новом проекте где права постоянно добавляются/удаляются по мере роста проекта и обновлять права в базе неудобно. А тут, внёс правки в код и сразу результат. Рассмотрим как это сделать через хук user_has_cap.

Пример ниже проверят роль текущего пользователя и тут же добавляет новые права (возможности) в список прав юзера, в зависимости от роли пользователя (название роли пользователя хранится в общем списке прав пользователя).

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

/**
 * Меняет возможности ролей "на лету".
 *
 * @param array   $allcaps
 * @param array   $caps
 * @param array   $args
 * @param WP_User $user
 *
 * @return array
 */
function kama_user_has_cap( $allcaps, $caps, $args, $user ) {

	// Трекер (неподтверждённый)
	$role = 'project_tracker_fake';
	if ( ! empty( $allcaps[ $role ] ) ) {
		// WordPress
		$allcaps['read'] = true;
	}

	// Руководитель
	$role = 'project_leader';
	if ( ! empty( $allcaps[ $role ] ) ) {
		// WordPress
		$allcaps['read']                 = true;
		$allcaps['edit_posts']           = true;
		$allcaps['edit_published_posts'] = true;

		// + Эксперт
		$allcaps['view_expert_note']    = true; // Видеть метабокс Эксперта
		$allcaps['view_expert_comment'] = true; // Видеть комментарий Эксперта

		// + Модератор
		$allcaps['view_moderator_note'] = true; // Видеть метабокс Модератора
	}

	// Трекер
	$role = 'project_tracker';
	if ( ! empty( $allcaps[ $role ] ) ) {
		// WordPress
		$allcaps['read']                 = true;
		$allcaps['edit_posts']           = true;
		$allcaps['edit_published_posts'] = true;

		// Общее
		$allcaps['view_post_contacts'] = true; // Видеть метабокс с Контактами

		// + Эксперт
		$allcaps['view_expert_note']    = true; // Видеть метабокс Эксперта
		$allcaps['view_expert_comment'] = true; // Видеть комментарий Эксперта
		$allcaps['view_expert_rating']  = true; // Видеть оценку Эксперта

		// + Модератор
		$allcaps['view_moderator_note'] = true; // Видеть метабокс Модератора
	}

	// Эксперт
	$role = 'project_expert';
	if ( ! empty( $allcaps[ $role ] ) ) {
		// WordPress
		$allcaps['read']                = true;
		$allcaps['edit_posts']          = true;
		$allcaps['delete_others_posts'] = false;
		$allcaps['edit_others_posts']   = true;

		// Общее
		$allcaps['view_post_contacts'] = true; // Видеть метабокс с Контактами

		// + Модератор
		$allcaps['view_moderator_note'] = true; // Видеть метабокс Модератора

		// Личное
		$allcaps['view_expert_note']    = true; // Видеть метабокс Эксперта
		$allcaps['view_expert_comment'] = true; // Видеть комментарий Эксперта
		$allcaps['view_expert_rating']  = true; // Видеть оценку Эксперта
		$allcaps['add_expert_note']     = true; // Изменять метабокс Эксперта
		$allcaps['add_expert_comment']  = true; // Изменять комментарий Эксперта
		$allcaps['add_expert_rating']   = true; // Изменять оценку Эксперта
	}

	return $allcaps;
}

Теперь можно проверить, например возможность add_expert_rating у юзера так:

if( current_user_can('add_expert_rating') ){
	echo 'Право есть.';
}

Список изменений

С версии 2.0.0 Введена.
С версии 3.7.0 Added the $user parameter.

Где вызывается хук

WP_User::has_cap()
user_has_cap
wp-includes/class-wp-user.php 768
$capabilities = apply_filters( 'user_has_cap', $this->allcaps, $caps, $args, $this );

Где используется хук (в ядре WP)

wp-includes/default-filters.php 581
add_filter( 'user_has_cap', 'wp_maybe_grant_install_languages_cap', 1 );
wp-includes/default-filters.php 582
add_filter( 'user_has_cap', 'wp_maybe_grant_resume_extensions_caps', 1 );
wp-includes/default-filters.php 583
add_filter( 'user_has_cap', 'wp_maybe_grant_site_health_caps', 1, 4 );
campusboy 3416youtube.com/c/wpplus
Создатель YouTube канала wp-plus, на котором делюсь своим опытом. Активный пользователь wp-kama.ru. WordPress-разработчик. Разработка сайтов и лендингов. Доработка существующих проектов. Сопровождение ресурсов.
Редакторы: Kama 7602
Комментариев нет
    Здравствуйте, !     Войти . Зарегистрироваться