editable_roles │ хук-фільтр │ WP 2.8.0

Дозволяє змінити список із ролями користувачів сайту, що запитується функцією editable_roles() .

Використання

add_filter( 'editable_roles', 'wp_kama_editable_roles_filter' );

/**
 * Function for `editable_roles` filter-hook.
 *
 * @param array[] $all_roles Array of arrays containing role information.
 *
 * @return array[]
 */
function wp_kama_editable_roles_filter( $all_roles ){

	// Filter...
	return $all_roles;
}

$all_roles (масив)

Масив масивів, що містять інформацію про ролі. Де ключі масиву – це назва ролі (administrator, editor і т.д.), а значення – ім’я ролі, що відображається, і її можливості.

Приклад обробки даних дивіться в описі функції editable_roles() .

Приклади

#1 Виключимо зі списку ролей конкретні ролі

Нехай ми створили кілька додаткових ролей:

add_role('project_expert', 'Експерт');
add_role( 'project_moderator', 'Модератор');
add_role( 'project_tracker', 'Трекер');
add_role( 'project_tracker_fake', 'Трекер (непідтверджений)');
add_role('project_leader', 'Керівник');

Це спрощений приклад реєстрації ролей, у ньому опущений момент присвоєння ролям повноважень. Як правильно створювати ролі WordPress дивіться на add_role() .

Тепер під час роботи з користувачами будуть виводитися такі списки:

Вибір ролі під час створення користувача

Изменение роли при редактировании пользователя

Изменение роли пользователя в списке пользователей

Якщо у вас індивідуальний проект та дефолтні ролі WordPress не використовуються, то вони в цих списках тільки заважають – прихуємо їх.

add_filter( 'editable_roles', 'hide_some_roles' );

function hide_some_roles( $all_roles ) {
	unset($all_roles['editor']);
	unset( $all_roles['author'] );
	unset($all_roles['contributor']);
	unset( $all_roles['subscriber'] );

	return $all_roles;
}

Отримаємо список без цих ролей: