Многими плагинами можно управлять из админпанели WordPress. Если плагин поддерживает такую возможность, то после его установки и активации в админпанели появляется специальная страница. На ней сгруппированы элементы, которые позволяют изменять настройки плагина и выполнять другие действия связанные с его работой.
Для добавления страницы плагина в админ панель служит стандартная функция add_action. Её синтаксис:
1 |
add_action('admin_menu', 'plugin_admin_menu'); |
Параметр «admin_menu» означает добавление нового пункта в меню админпанели, а параметр plugin_admin_menu содержит название функции, которая собственно и создаёт данный пункт меню и страницу плагина. Название этой функции может быть произвольным.
Рассмотрим процесс создания страницы примере плагина «Total Old Revisions Cleaner», который был разработан мной для удаления неактуальных редакций записей и страниц. Этот плагин предназначался для личного использования, но позднее стал прототипом для плагина «total-old-revisions-cleaner«, который был опубликован в репозитории WordPress.
Этот плагин имеет простейший интерфейс для администрирования, который реализован в главном файле плагина. Программная логика его работы вынесена в отдельный файл в папке includes.
Создание страницы в админпанели у этого плагина реализовано в виде функции plugin_admin_menu.
1 2 3 4 |
function plugin_admin_menu() { add_options_page('Total Old Revisions Cleaner', 'Total Old Revisions Cleaner', 8, basename(__FILE__), 'admin_form'); } |
Внутри неё вызывается ещё одна стандартная функция WordPress, которая добавляет страницу этого плагина в меню настройки админпанели.
Из всех параметров функции add_options_page в данном случае, играют роль только два первых (название плагина) и два последних (имя файла в котором описана страница плагина и имя функции, которая отображает эту страницу (может быть произвольным)).
После того как в главном файле описана функция plugin_admin_menu и вызвана функция add_action работа со стандартными функциями WordPress закончена.
Теперь необходимо реализовать непосредственно саму страницу. Но, для этого её необходимо вначале сверстать.
Вся вёрстка страницы плагина WordPress должна быть размещена в одном контейнере, который имеет CSS класс wrap.
Разместим в нём заголовок с названием плагина и форму с флажком и кнопкой для отправки.
1 |
1 |
Поместим эту вёрстку в функцию admin_form, которая согласно приведённому выше исходному коду должна отобразить страницу плагина.
Ниже представлен полный исходный код создания страницы плагина Total Old Revisions Cleaner в админпанели.
1 2 3 |
<?php function admin_form() { ?> |
1 2 3 4 5 6 7 |
<?php }//Конец admin_form function plugin_admin_menu() { add_options_page('Total Old Revisions Cleaner', 'Total Old Revisions Cleaner', 8, basename(__FILE__), 'admin_form'); } add_action('admin_menu', 'plugin_admin_menu'); ?> |
В результате в админпанели появляются соответствующий пункт меню и страница.
Добавить комментарий