Добавляем параметры в настройки WordPress

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

Наиболее очевидным механизмом для хранения переменных является использование API опций (options). Здесь мы рассмотрим как наиболее просто создать дополнительные поля для редактирования опций прямо в админке WordPress.

Терминология

Но для начала надо разобраться с терминологией.

В «Настройках» есть отдельные страницы или группы опций (Общие, Написание, Чтение, …), которые могут быть поделены на секции. А в определенные секции мы уже прикрепляем опции.

Т.е. есть иерархия — группа-секция-опция.

Регистрация опций

Предварительно опция должна быть зарегистрирована функцией register_setting(). Затем специальный метод add_settings_field() позволяет описать опцию и прикрепить её в нужную секцию страницы настроек.

Если выполнить add_settings_field() без register_setting(), то хоть опция и появится в шаблоне страницы, но при сохранении её изменения не будут зафиксированы.

Как определить имя страницы (группы)?

Имя группы настроек можно подсмотреть в uri соответствующей страницы. Например, страница «обсуждение» имеет следующий адрес:

Здесь имя группы будет — discussion.

Как определить имя секции?

Полный список зарегистрированных секций можно получить из глобальной переменной — $wp_settings_sections.

Новые секции регистрируются функцией add_settings_section($id, $title, $callback, $page).

Если имена секций неизвестны (лень подсматривать), то можно использовать ‘default’.

Чтение/изменение опций

Т.к. настройки — это часть options API, то чтение и запись производится методами get_option() и update_option().

Что касается работы с опцией в админ панели, то сохранение зарегистрированных настроек WP производит сам.

Пример

Добавим несколько опций на страницу Настройки -> Общие. Это будет телефон, email и адрес офиса — переменные, которые потом (по легенде) будут выводится в шаблоне. Специально для них создадим секцию — ‘Контакты’.

Регистрация лучше произвести во время admin_init:

Надеюсь, пример поможет вам сориентироваться и уже дальше развить его в то, что вам нужно на практике. Читайте также мануалы к функциям на https://developer.wordpress.org/.

Написать комментарий

Мало букафф? Читайте есчо !

Добавление поля с картинкой в редактор таксономии WP

Июль 4, 2017 г.

Таксономия (словари) Wordpress может быть модифицирована под любые нужды проекта. Для этого CMS предоставляет мощное API, благодаря которому есть готовые ...

Читать

Переводим Ninja Forms в WP

Ноябрь 27, 2017 г.

Ninja Forms это крутой модуль-конструктор для создания пользовательских форм в WP. Это впечатление не покидает вас даже когда вы переходите к изучению API этого плагина. Сегодня я покажу приемы, как сделать ваши (ниндзя) формы мультиязычными. О ...

Читать

 

Комментарии к «Добавляем параметры в настройки WordPress»

Понравилась статья? Есть вопросы? - пишите в комментариях.



Комментарий:

Много комментариев в “Добавляем параметры в настройки WordPress”

  1. Berserk:

    Ошибки в коде

  2. Olga:

    Рабочий код без ошибок:

    add_action(‘admin_init’, ‘add_option_fields_to_general_admin_page’);

    function add_option_fields_to_general_admin_page() {
    //список опций, которые будем добавлять
    $options = array(
    ‘my-tel’ => ‘Телефон’,
    ‘my-email’ => ‘Email’,
    ‘my-addr’ => ‘Адрес’
    );

    //создаём секцию
    add_settings_section(
    ‘my_setting_section’, //ID секции
    ‘Контакты’, //заголовок
    ‘my_setting_section_cb_func’, //callback шаблона
    ‘general’ //ID группы опции
    );

    //проводим регистрацию и настройку опций
    foreach ($options as $ID => $label) {
    // регистрация на странице general («Общие»)
    register_setting( ‘general’, $ID);
    // выполняем настройки поля
    add_settings_field(
    $ID, //ID поля
    $label, //метка
    ‘my_setting_cb_func’, //функция, выводящая шаблон поля
    ‘general’, //ID группы опций
    ‘my_setting_section’, //ID секции
    array(
    ‘id’ => $ID,
    ‘option_name’ => $ID
    )
    );
    }
    }

    //кол-бэк ф-ция вывода шаблона поля
    function my_setting_cb_func( $val ){
    $name = $val[‘option_name’];
    echo »;
    }

    function my_setting_section_cb_func($arg){
    // вывод шаблона секции,
    // заголовок уже выведен, тут можно добавить описание
    // arg содержит параметры, которые были заданы при добавлении секции
    echo ‘id: ‘ . $arg[‘id’] . »; //ID секции
    echo ‘title: ‘ . $arg[‘title’] . »; //заголовок
    echo ‘callback: ‘ . $arg[‘callback’] . »; // имя текущей функции
    }