add_submenu_page()

add_submenu_page( string $parent_slug, string $page_title, string $menu_title, string $capability, string $menu_slug, callable $callback = '', int|float $position = null ): string|false

<?php
/**
 * Добавляет подстраницу в меню "Настройки".
 *
 * @return string|false Хук страницы или false, если у пользователя нет необходимых прав.
 */
function wpdocs_add_submenu_page() {
    // Добавляем подстраницу в меню "Настройки"
    $parent_slug = 'options-general.php';
    $page_title = 'Моя подстраница';
    $menu_title = 'Моя подстраница';
    $capability = 'manage_options';
    $menu_slug = 'my-submenu';
    $callback = 'my_submenu_page_callback';
    $position = null;
    
    return add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $callback, $position );
}
add_action( 'admin_menu', 'wpdocs_add_submenu_page' );
/**
 * Функция обратного вызова для вывода содержимого подстраницы.
 */
function my_submenu_page_callback() {
    // Выводим содержимое подстраницы
    echo '<h2>Моя подстраница</h2>';
    echo '<p>Это содержимое моей подстраницы.</p>';
}
?>

add_submenu_page( 'parent_slug', 'Page Title', 'Menu Title', 'capability', 'menu_slug', 'callback_function' );

function my_submenu_page_callback() {
    echo 'This is the content of my submenu page.';
}
add_submenu_page( 'parent_slug', 'Page Title', 'Menu Title', 'capability', 'menu_slug', 'my_submenu_page_callback' );

add_submenu_page( 'parent_slug', 'Page Title', 'Menu Title', 'manage_options', 'menu_slug', 'callback_function' );

add_submenu_page( 'parent_slug', 'Page Title', 'Menu Title', 'capability', 'unique_menu_slug', 'callback_function' );

add_submenu_page( 'parent_slug', 'Page Title', 'Menu Title', 'capability', 'menu_slug', 'callback_function', 10 );

Вопросы и ответы

Как создать подменю в административной панели WordPress?

Для создания подменю в административной панели WordPress используется функция add_submenu_page(). Она позволяет добавить новый пункт меню в существующее меню или создать новое меню.

Для создания подменю необходимо указать следующие параметры:

• $parent_slug — слаг родительского меню или имя файла стандартной страницы административной панели WordPress.
• $page_title — текст, который будет отображаться в заголовке страницы при выборе меню.
• $menu_title — текст, который будет использоваться для отображения пункта меню.
• $capability — требуемая возможность для отображения данного меню пользователю.
• $menu_slug — слаг, по которому можно будет обращаться к данному меню. Должен быть уникальным и содержать только строчные буквы, цифры, дефисы и подчеркивания.
• $callback (опционально) — функция, которая будет вызываться для вывода содержимого страницы. По умолчанию — пустая строка.
• $position (опционально) — позиция пункта меню в порядке отображения. По умолчанию — null.

Функция add_submenu_page() возвращает слаг созданной страницы или false, если у пользователя нет необходимых возможностей.

add_submenu_page( 'parent_slug', 'page_title', 'menu_title', 'capability', 'menu_slug', 'callback', 'position' );

Как изменить заголовок подменю в административной панели WordPress?

Для изменения заголовка подменю в административной панели WordPress необходимо обновить значение параметра $page_title при вызове функции add_submenu_page().

add_submenu_page( 'parent_slug', 'Новый заголовок', 'menu_title', 'capability', 'menu_slug', 'callback', 'position' );

Как изменить текст ссылки подменю в административной панели WordPress?

Для изменения текста ссылки подменю в административной панели WordPress необходимо обновить значение параметра $menu_title при вызове функции add_submenu_page().

add_submenu_page( 'parent_slug', 'page_title', 'Новый текст ссылки', 'capability', 'menu_slug', 'callback', 'position' );

Как изменить требуемую роль для отображения подменю в административной панели WordPress?

Для изменения требуемой роли для отображения подменю в административной панели WordPress необходимо использовать параметр $capability функции add_submenu_page(). Этот параметр определяет, какая роль должна быть у пользователя, чтобы увидеть данное подменю.

Пример кода:

add_submenu_page( 'parent_slug', 'Page Title', 'Menu Title', 'manage_options', 'menu_slug', 'callback_function' );

В данном примере, чтобы увидеть подменю, пользователь должен иметь роль с возможностью управления опциями (manage_options).

Как изменить уникальный идентификатор подменю в административной панели WordPress?

Уникальный идентификатор подменю в административной панели WordPress определяется параметром $menu_slug функции add_submenu_page(). Этот параметр должен быть уникальным для каждого подменю и содержать только строчные буквы, цифры, дефисы и подчеркивания.

Пример кода:

add_submenu_page( 'parent_slug', 'Page Title', 'Menu Title', 'manage_options', 'unique_menu_slug', 'callback_function' );

В данном примере, уникальный идентификатор подменю задан как 'unique_menu_slug'.

Как изменить функцию обратного вызова для вывода содержимого страницы подменю в административной панели WordPress?

Функция обратного вызова для вывода содержимого страницы подменю в административной панели WordPress определяется параметром $callback функции add_submenu_page(). Эта функция будет вызвана для отображения содержимого страницы подменю.

Пример кода:

add_submenu_page( 'parent_slug', 'Page Title', 'Menu Title', 'manage_options', 'menu_slug', 'custom_callback_function' );
function custom_callback_function() {
    echo 'This is the content of the submenu page.';
}

В данном примере, функция custom_callback_function() будет вызвана для вывода содержимого страницы подменю.

Как изменить порядок отображения подменю в административной панели WordPress?

Для изменения порядка отображения подменю в административной панели WordPress необходимо использовать параметр $position функции add_submenu_page(). Этот параметр принимает значение типа int или float и определяет позицию подменю в списке меню.

add_submenu_page( 'parent_slug', 'page_title', 'menu_title', 'capability', 'menu_slug', 'callback', 10 );

В приведенном примере, значение 10 указывает на позицию подменю в списке меню. Чем меньше значение, тем выше будет отображаться подменю.

Как получить хук страницы подменю в административной панели WordPress?

Для получения хука страницы подменю в административной панели WordPress можно использовать функцию add_action(). Эта функция позволяет привязать определенную функцию к указанному хуку.

add_action( 'admin_menu', 'my_submenu_page' );
function my_submenu_page() {
    add_submenu_page( 'parent_slug', 'page_title', 'menu_title', 'capability', 'menu_slug', 'callback' );
}
function callback() {
    // Код для вывода содержимого страницы подменю
}

В приведенном примере, функция my_submenu_page() добавляет страницу подменю с указанными параметрами. Функция callback() содержит код для вывода содержимого страницы подменю.

Как проверить, имеет ли пользователь необходимые права для отображения подменю в административной панели WordPress?

Для проверки, имеет ли пользователь необходимые права для отображения подменю в административной панели WordPress, можно использовать функцию current_user_can(). Эта функция проверяет, имеет ли текущий пользователь указанную возможность.

add_submenu_page( 'parent_slug', 'page_title', 'menu_title', 'capability', 'menu_slug', 'callback' );
function callback() {
    if ( ! current_user_can( 'capability' ) ) {
        wp_die( __( 'You do not have sufficient permissions to access this page.' ) );
    }
    // Код для вывода содержимого страницы подменю
}

В приведенном примере, функция callback() проверяет, имеет ли текущий пользователь указанную возможность. Если пользователь не имеет необходимых прав, выводится сообщение об ошибке.

Функция add_submenu_page() позволяет добавить подменю в административную панель WordPress. Используя параметры функции, можно изменить порядок отображения подменю, получить хук страницы подменю и проверить права пользователя для отображения подменю. Эта функция является полезным инструментом для разработчиков WordPress, позволяющим создавать пользовательские страницы подменю с необходимыми функциональными возможностями.