add_theme_page

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

Заметка: функцию нужно вешать на хук admin_menu. Если у вас выходит ошибка “You do not have sufficient permissions to access this 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 "Текст на странице настроект.";
}

Код из


wp-admin/includes/plugin.php

WP 4.7.2

<?php
function add_theme_page( $page_title, $menu_title, $capability, $menu_slug, $function = '' ) {
	return add_submenu_page( 'themes.php', $page_title, $menu_title, $capability, $menu_slug, $function );
}