add_theme_page()
Додає підменю в меню “Зовнішній вигляд” (Appearance) в адмін-панелі.
Примітка: функцію потрібно вішати на хук admin_menu. Якщо у вас виходить помилка ” Ви не маєте значних можливостей для використання цієї сторінки. ” Це означає, що ви викликаєте функцію занадто рано.
Працює на основі:
add_submenu_page()
add_submenu_page()
Хуків немає.
Повертає
Строку|false. 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() add theme page WP 6.0.2
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 );
}