В WordPress виджеты могут использоваться не только на самом сайте, но и в админпанели.
Эти виджеты располагаются на её главной странице и служат для быстрого доступа к часто используемым функциям.
Помимо стандартных виджетов, которые уже есть в WordPress можно создавать и свои собственные в составе плагинов и тем для сайтов.
Написание виджета для админпанели существенно проще, чем для сайта. Однако, несмотря на это виджеты для админпанели могут реализовывать достаточно сложный функционал. Строить графики и т.д.
В качестве примера, для наилучшего понимания общего механизма работы виджетов для админпанели, создадим простейший виджет.
Вначале создаётся функция, которая будет представлять содержимое виджета.
|
1 2 3 4 |
function dashboard_control() { echo '<br>This is simple test widget'; } |
Далее необходимо написать функцию, которая будет добавлять виджет в админ панель с помощью функции wp_add_dashboard_widget API WordPress.
|
1 2 3 4 5 |
function dashboard_widget() { global $wp_meta_boxes; wp_add_dashboard_widget('test_dashboard_widget', 'Test Widget', 'dashboard_control'); } |
Функция wp_add_dashboard_widget принимает три обязательных параметра (слева направо):
- Уникальный идентификатор виджета в системе;
- Название виджета, которое будет отображаться в заголовке;
- Имя функции, которая представляет содержимое виджета.
На этом процесс создания виджета для админпанели по сути завершён. Для того чтобы он был добавлен в админ панель нужно зарегистрировать его с помощью функции add_action WordPress API.
|
1 |
add_action('wp_dashboard_setup', 'dashboard_widget'); |
Пример готового виджета:
По аналогии с виджетами для сайтов. Если виджет пишется для темы, его код должен располагаться либо в файле funcions.php либо в файле, подключённом к нему (include, include_once, require, require_once). Если же виджет создаётся для плагина, его код необходимо располагать в главном файле или файлах подключённых к нему.
Добавить комментарий