Написание своего плагина для WordPress. Часть 2. Страница плагина в админпанели

Многими плагинами можно управлять из админпанели WordPress. Если плагин поддерживает такую возможность, то после его установки и активации в админпанели появляется специальная страница. На ней сгруппированы элементы, которые позволяют изменять настройки плагина и выполнять другие действия связанные с его работой.

Для добавления страницы плагина в админ панель служит стандартная функция add_action. Её синтаксис:

Параметр «admin_menu» означает добавление нового пункта в меню админпанели, а параметр plugin_admin_menu содержит название функции, которая собственно и создаёт данный пункт меню и страницу плагина. Название этой функции может быть произвольным.

Рассмотрим процесс создания страницы примере плагина «Total Old Revisions Cleaner», который был разработан мной для удаления неактуальных редакций записей и страниц. Этот плагин предназначался для личного использования, но позднее стал прототипом для плагина «total-old-revisions-cleaner«, который был опубликован в репозитории WordPress.

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

Создание страницы в админпанели у этого плагина реализовано в виде функции plugin_admin_menu.

Внутри неё вызывается ещё одна стандартная функция WordPress, которая добавляет страницу этого плагина в меню настройки админпанели.

Из всех параметров функции add_options_page в данном случае, играют роль только два первых (название плагина) и два последних (имя файла в котором описана страница плагина и имя функции, которая отображает эту страницу (может быть произвольным)).

После того как в главном файле описана функция plugin_admin_menu и вызвана функция add_action работа со стандартными функциями WordPress закончена.

Теперь необходимо реализовать непосредственно саму страницу. Но, для этого её необходимо вначале сверстать.

Вся вёрстка страницы плагина WordPress должна быть размещена в одном контейнере, который имеет CSS класс wrap.

Разместим в нём заголовок с названием плагина и форму с флажком и кнопкой для отправки.

Поместим эту вёрстку в функцию admin_form, которая согласно приведённому выше исходному коду должна отобразить страницу плагина.

Ниже представлен полный исходный код создания страницы плагина Total Old Revisions Cleaner в админпанели.

В результате в админпанели появляются соответствующий пункт меню и страница.

Плагин в меню

Страница админки

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *