Как добавить настройки в админ-панель WordPress: практическое руководство с примерами

Автор: Игорь Титов | Опубликовано: 02.12.2025

Почему важно добавлять настройки в админ-панель WordPress

Когда вы разрабатываете тему или плагин для WordPress, часто возникает необходимость предоставить пользователю возможность изменять параметры работы вашего продукта. Встроенные возможности WordPress позволяют создавать собственные страницы настроек, которые удобно интегрируются с админ-панелью. Это облегчает управление функционалом и улучшает опыт пользователя.

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

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

Создание страницы настроек: добавляем меню и регистрируем настройки

Для начала нужно добавить пункт меню в админ-панель. Для этого используется хук admin_menu и функция add_options_page (для страницы в разделе «Настройки») или add_menu_page (для отдельного меню).

function wpco_add_settings_page() {
    add_options_page(
        'Настройки WPCO',
        'Настройки WPCO',
        'manage_options',
        'wpco-settings',
        'wpco_render_settings_page'
    );
}
add_action('admin_menu', 'wpco_add_settings_page');

Далее регистрируем настройки и создаём поля с помощью API настроек WordPress. Это позволяет автоматически сохранять и валидировать данные.

function wpco_register_settings() {
    register_setting('wpco_settings_group', 'wpco_option_text', 'wpco_sanitize_text');

    add_settings_section('wpco_main_section', 'Основные настройки', 'wpco_main_section_cb', 'wpco-settings');

    add_settings_field('wpco_option_text', 'Текстовое поле', 'wpco_option_text_cb', 'wpco-settings', 'wpco_main_section');
}
add_action('admin_init', 'wpco_register_settings');

Здесь register_setting связывает опцию с группой настроек и указывает функцию-сантайзер для очистки данных. add_settings_section создаёт секцию на странице, а add_settings_field — поле ввода.

Описание функций обратного вызова

Функция для вывода описания секции:

function wpco_main_section_cb() {
    echo '<p>Настройте основные параметры вашего плагина или темы.</p>';
}

Функция для вывода поля ввода:

function wpco_option_text_cb() {
    $value = get_option('wpco_option_text', '');
    echo '<input type="text" name="wpco_option_text" value="' . esc_attr($value) . '" class="regular-text" />';
}

Сантаизация для очистки введённых данных:

function wpco_sanitize_text($input) {
    return sanitize_text_field($input);
}

Рендеринг страницы настроек с формой

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

function wpco_render_settings_page() {
    ?>
    <div class="wrap">
        <h1>Настройки WPCO</h1>
        <form method="post" action="options.php">
            <?php
            settings_fields('wpco_settings_group');
            do_settings_sections('wpco-settings');
            submit_button();
            ?>
        </form>
    </div>
    <?php
}

Такой подход позволяет полностью интегрировать настройки в стандартный интерфейс WordPress, сохраняя единообразие и удобство.

Добавление различных типов полей: чекбоксы, селекты, текстовые поля

Часто необходимы не только текстовые поля, но и другие типы ввода. Рассмотрим добавление чекбокса и селекта.

Пример чекбокса

function wpco_option_checkbox_cb() {
    $value = get_option('wpco_option_checkbox', false);
    echo '<input type="checkbox" name="wpco_option_checkbox" value="1" ' . checked(1, $value, false) . ' /> Включить опцию';
}

function wpco_register_settings() {
    register_setting('wpco_settings_group', 'wpco_option_checkbox');
    add_settings_field('wpco_option_checkbox', 'Чекбокс', 'wpco_option_checkbox_cb', 'wpco-settings', 'wpco_main_section');
    // остальные регистрации...
}

Пример селекта

function wpco_option_select_cb() {
    $value = get_option('wpco_option_select', 'one');
    $options = [
        'one' => 'Первый вариант',
        'two' => 'Второй вариант',
        'three' => 'Третий вариант'
    ];
    echo '<select name="wpco_option_select">';
    foreach ($options as $key => $label) {
        echo '<option value="' . esc_attr($key) . '" ' . selected($value, $key, false) . '>' . esc_html($label) . '</option>';
    }
    echo '</select>';
}

function wpco_register_settings() {
    register_setting('wpco_settings_group', 'wpco_option_select');
    add_settings_field('wpco_option_select', 'Выбор варианта', 'wpco_option_select_cb', 'wpco-settings', 'wpco_main_section');
    // остальные регистрации...
}

Подобные поля легко расширять, добавлять валидаторы и обрабатывать в коде плагина или темы.

Как использовать сохранённые настройки в коде вашего плагина или темы

После сохранения настроек их можно получить через функцию get_option. Это позволяет динамически изменять поведение и внешний вид вашего продукта.

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

$text = get_option('wpco_option_text', 'значение по умолчанию');
if (get_option('wpco_option_checkbox')) {
    // Выполнить действие, если чекбокс включён
}
switch (get_option('wpco_option_select')) {
    case 'one':
        // Логика для первого варианта
        break;
    case 'two':
        // Логика для второго варианта
        break;
}

Таким образом, вы легко интегрируете настройки в логику работы вашего кода и делаете продукт более гибким.

Полезные плагины для расширения возможностей страниц настроек

Для тех, кто хочет упростить создание настроек, существуют готовые решения:

Redux Framework — мощный фреймворк для создания панелей опций с удобным интерфейсом и множеством типов полей.
CMB2 — библиотека для создания мета-боксов и страниц настроек с большим набором полей.
Options Framework — простой способ добавить панель опций в тему без глубокого программирования.

Использование таких решений ускоряет разработку и обеспечивает современный UI.

Как добавить настройки в админ-панель WordPress