add_theme_page()
Добавляет подменю в меню "внешний вид" (Appearance) в админ-панели.
Заметка: функцию нужно вешать на хук admin_menu. Если у вас выходит ошибка "You do not have sufficient permissions to access this page." это значит, что вы вызываете функцию слишком рано.
Работает на основе: add_submenu_page()
Хуков нет.
Возвращает
Строку|false. Вернет hook_suffix вставленной страницы (пункта меню). То что возвращает функция add_submenu_page().
Использование
add_theme_page( $page_title, $menu_title, $capability, $menu_slug, $callback, $position );
- $page_title(строка) (обязательный)
- Текст тега
<title>для страницы меню, когда вы будите на ней. - $menu_title(строка) (обязательный)
- Текст пункта меню.
- $capability(строка) (обязательный)
- Возможность пользователя необходимая, чтобы он увидел эту страницу меню.
- $menu_slug(строка) (обязательный)
- Идентификатор меню (slug), по которому можно обращаться к меню. Должен быть уникальным.
- $function(строка/массив)
- Callback функция, выводящая HTML код страницы пункта меню.
По умолчанию: '' - $position(число)
- Позиция подпункта меню, относительно других подпунктов. Добавлено в WP 5.3.0.
По умолчанию: null
Примеры
#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() add theme page WP 7.1
function add_theme_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
return add_submenu_page( 'themes.php', $page_title, $menu_title, $capability, $menu_slug, $callback, $position );
}