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

add_theme_page() WP 2.0

Добавляет подменю в меню "внешний вид" (Appearance) в админ-панели.

Заметка: функцию нужно вешать на хук admin_menu. Если у вас выходит ошибка "You do not have sufficient permissions to access this page." это значит, что вы вызываете функцию слишком рано.

Работает на основе: add_submenu_page()

Хуков нет.

Возвращает

Строку. hook_suffix вставленной страницы (пункта меню). То что возвращает функция add_submenu_page().

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

add_theme_page( $page_title, $menu_title, $capability, $menu_slug, $function );
$page_title(строка) (обязательный)
Текст тега <title> для страницы меню, когда вы будите на ней.
По умолчанию: нет
$menu_title(строка) (обязательный)
Текст пункта меню.
По умолчанию: нет
$capability(строка) (обязательный)
Возможность пользователя необходимая, чтобы он увидел эту страницу меню.
По умолчанию: нет
$menu_slug(строка) (обязательный)
Идентификатор меню (slug), по которому можно обращаться к меню. Должен быть уникальным.
По умолчанию: нет
$function(строка/массив)
Callback функция, выводящая HTML код страницы пункта меню.
По умолчанию: ''

Примеры

#1. Создание страницы настроек темы

В этом примере мы создадим свой пункт в меню "Внешний вид":

function my_appearance_menu_item() {
	add_theme_page('title заголовок страницы', 'Название пункта меню', 'edit_theme_options', 'my-unique-identifier', 'my_plugin_function');
}
add_action('admin_menu', 'my_appearance_menu_item');

function my_plugin_function(){
	echo "Текст на странице настроект.";
}

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

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

Код add_theme_page() WP 5.5.1

wp-admin/includes/plugin.php
<?php
function add_theme_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $position = null ) {
	return add_submenu_page( 'themes.php', $page_title, $menu_title, $capability, $menu_slug, $function, $position );
}

Cвязанные функции

Из метки: Меню администрирования (admin menu)

Еще из раздела: Админ-панель

3 коммента