Добавление подменю в WordPress: функция add_options_page()

# Функция ADD_OPTIONS_PAGE() │ WP 1.5.0

Функция add_options_page() добавляет подменю в главное меню настроек вашего сайта на WordPress. 

## Описание

Эта функция принимает параметр, который определяет права пользователей для доступа к данному меню. Функция, подключенная для обработки выводимого содержимого страницы, также должна проверять, имеет ли пользователь соответствующие права.

### Возврат

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

## Синтаксис

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

```php
add_options_page( $page_title, $menu_title, $capability, $menu_slug, $callback, $position );

Параметры

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

Примеры использования

Пример 1: Добавление подменю (OOP-стиль)

В этом примере показано, как добавить подменю в разделе настроек, используя класс PHP:

class Option_Page {

    function __construct() {
        add_action( 'admin_menu', array( $this, 'admin_menu' ) );
    }

    function admin_menu() {
        add_options_page( 'Заголовок страницы', 'Вход в Circle Tree', 'manage_options', 'options_page_slug', array( $this, 'settings_page' ) );
    }

    function settings_page() {
        ?>
        
Содержимое страницы настроек
        

add_action( 'admin_menu', 'my_plugin_menu' );

function my_plugin_menu() {
    add_options_page( 'Мои настройки', 'Мой плагин', 'manage_options', 'my-plugin', 'my_plugin_page' );
}

function my_plugin_page() {
    echo "Вывод для страницы настроек плагина";
}

function add_options_page( $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null ) {
    return add_submenu_page( 'options-general.php', $page_title, $menu_title, $capability, $menu_slug, $callback, $position );
}