add_menu_page()

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

Как добавить верхний уровень меню?

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

add_menu_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $callback = '', string $icon_url = '', int|float $position = null ): string

В результате выполнения функции будет создано верхнее меню, доступное пользователю.

Как изменить текст в заголовке меню?

Чтобы изменить текст в заголовке меню, нужно передать соответствующий параметр $menu_title при вызове функции add_menu_page().

add_menu_page( 'New Page Title', 'New Menu Title', 'manage_options', 'my-menu', 'my_menu_callback' );

В данном примере текст в заголовке меню будет изменен на «New Menu Title».

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

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

add_menu_page( 'Page Title', 'Menu Title', 'edit_posts', 'my-menu', 'my_menu_callback' );

В данном примере меню будет отображаться только пользователям с правами доступа «edit_posts».

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

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

Пример:

add_menu_page(
    'Page Title', // Заголовок страницы
    'Menu Title', // Заголовок меню
    'manage_options', // Необходимая роль пользователя
    'my-menu', // Уникальный идентификатор меню
    'my_menu_callback', // Функция для вывода содержимого страницы меню
    'dashicons-chart-pie', // Иконка меню
    10 // Позиция в меню
);

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

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

Пример:

function my_menu_callback() {
    echo 'This is the content of my menu page.';
}
add_menu_page(
    'Page Title',
    'Menu Title',
    'manage_options',
    'my-menu',
    'my_menu_callback',
    'dashicons-chart-pie',
    10
);

Как добавить иконку к меню?

Для добавления иконки к меню используется параметр $icon_url функции add_menu_page(). Вы можете использовать URL-адрес иконки или указать имя класса Dashicons для использования шрифтовой иконки.

Пример:

add_menu_page(
    'Page Title',
    'Menu Title',
    'manage_options',
    'my-menu',
    'my_menu_callback',
    'dashicons-chart-pie', // Использование Dashicons
    10
);
add_menu_page(
    'Page Title',
    'Menu Title',
    'manage_options',
    'my-menu',
    'my_menu_callback',
    'https://example.com/icon.svg', // Использование URL-адреса иконки
    10
);

Как изменить порядок отображения меню?

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

Например, чтобы установить порядок отображения меню на третьем месте, можно использовать следующий код:

add_menu_page( 'Page Title', 'Menu Title', 'manage_options', 'menu-slug', 'callback_function', '', 3 );

Как удалить иконку из меню?

Для удаления иконки из меню в WordPress можно использовать параметр $icon_url функции add_menu_page(). Этот параметр принимает значение типа string и позволяет указать URL иконки или класс Dashicons для иконки.

Чтобы удалить иконку из меню, нужно передать пустую строку в качестве значения параметра $icon_url. Например:

add_menu_page( 'Page Title', 'Menu Title', 'manage_options', 'menu-slug', 'callback_function', '', null );

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

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

Например, чтобы получить идентификатор страницы меню, можно использовать следующий код:

$menu_page = add_menu_page( 'Page Title', 'Menu Title', 'manage_options', 'menu-slug', 'callback_function' );
$menu_page_hook = $menu_page;

Функция add_menu_page() в WordPress позволяет добавить верхний уровень меню. Она принимает несколько параметров, включая заголовок страницы, заголовок меню, требуемую возможность для отображения меню, уникальный идентификатор меню и функцию для вывода содержимого страницы. С помощью параметров $position и $icon_url можно изменить порядок отображения меню и удалить иконку из меню соответственно. Возвращаемое значение функции представляет собой хук страницы меню, который можно использовать для дальнейшей работы с этой страницей.