add_users_page()

Добавляет дочерний элемент и страницу к нему в меню Пользователи в админ-панели.

Дочерний элемент пункта меню Пользователи в админке WordPress

Функция аналогична функции add_submenu_page() с первым параметром $parent_slug равным users.php. Однако, если у текущего пользователя нет прав на редактирование других пользователей (edit_users), то ярлык будет другой – profile.php.

Довольно редко встречал реальное использование этой функции, гораздо чаще используют add_options_page() или ту же add_submenu_page().

Возвращает хук созданной страницы, который можно использовать в других функциях, подробнее про то, как использовать этот хук, читайте в этом примере. В случае, если у текущего пользователя нет прав для просмотра добавленной страницы, возвращает false.

add_users_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $position = null )

Параметры

$page_title
(строка) Заголовок, а также тайтл (то, что в теге <title>) страницы.
$menu_title
(строка) Текст ссылки в меню
$capability
(строка) Минимально необходимые права пользователя для доступа к странице.
$menu_slug
(строка) Ярлык страницы.
$function
(строка|массив) Функция или метод класса для вывода содержимого страницы.
$position
(целое) (с версии 5.3.0) Приоритет вывода ссылки на страницу в меню. По умолчанию выводится последней. Чем меньше значение этого параметра = тем выше приоритет = тем раньше выведется ссылка на нашу страницу.

Пример использования add_users_page()

Обратите внимание, что мы не используем функцию напрямую, а вешаем её на хук admin_menu. Функция сработает и для панели «Управление сетью» в WordPress мультисайт, но тогда вам нужно использовать хук network_admin_menu. Не понимаете, что это значит? Смотрите видеоурок по хукам.

Хмм.. а почему бы не использовать два хука сразу?

add_action( 'network_admin_menu', 'true_add_users_page', 25 );
add_action( 'admin_menu', 'true_add_users_page', 25 );
 
function true_add_users_page() {
 
	add_users_page(
		'Какие-то настройки',
		'Ещё страница',
		'manage_options',
		'trueuserspage',
		'true_display_users_page'
	);
 
}
 
function true_display_users_page() {
 
	echo 'Тут выводим какие-то настройки';
 
}

Получим:

Пример использования функции add_users_page()

В мультисайте:

Пример использования функции add_users_page() для сети WordPress мультисайт

Следующий шаг – добавление на эту страницу каких-либо опций, о том, как это сделать, у меня на сайте есть отдельное руководство.

Источник: Блог Миши Рудрастых

Миша Рудрастых

Путешествует по миру и рассказывает всем о WordPress лично, у себя в блогах и на курсах в Санкт-Петербурге. Умеет просто объяснять сложные вещи, делает это красиво. Организовывает неплохие WordCamp's, но совсем не умеет слушать чужие доклады.

Добавить комментарий

%d такие блоггеры, как: