WordPress: Создаём виджет (часть 1 из 3-х)
18 октября, 2008Метки: WordPress
Создание виджетов для WordPress на самом деле не представляет никакой сложности. По крайней мере, создать простой виджет дело нескольких минут. В этом я убедился, когда решил сделать вывод дополнительной информации в сайдбар между использующимися виджетами. О чём и расскажу в этой статье.
Открываем свой любимый текстовый редактор с поддержкой UTF-8 и делаем первое важное действие – придумываем название для виджета и файла, в котором он будет храниться. Поскольку виджеты – это плагины и хранятся они в одной папке, то придуманное название не должно совпадать с именами других плагинов.
Отлично. Я для примера выбрал название dm-example-widget. Сохраняем файл с расширением php. Теперь самоё время начать что-нибудь писать в этот файл. Начинаться файл, как и все файлы плагинов, должен с описания.
<?php
/*
Plugin Name: Название плагина
Plugin URI: Адрес страницы плагина
Description: Описание плагина
Version: Номер версии плагина
Author: Имя автора
Author URI: Адрес страницы автора
*/
?>
Заполнив описание будущего виджета, самое время поговорить о структуре самого виджета. В общем случае структура включает в себя две функции – функцию инициализации, функцию вывода виджета и вызов функции add_action для регистрации плагина.
Рассмотрим инициализацию нашего виджета. Создадим функцию dm_example_widget_nit и вызовем в ней register_sidebar_widget. В данной функции указываются два параметра – название плагина и имя функции, которая будет вызываться для вывода виджета.
<?php
function dm_example_widget_init() {
register_sidebar_widget("dm-example-widget", "dm_example_widget_show");
}
?>
Отлично. Осталось совсем чуть-чуть, собственно необходимо сделать вывод того, что бы мы хотели вывести. Для этого создаём функцию имя которой мы указали в качестве второго параметра при вызове register_sidebar_widget и выводим то, что нам нужно.
<?php
function dm_example_widget_show () {
echo '<li id="dm_example_widget" class="widget dm_example_widget"><h2 class="widgettitle">Пример виджета!</h2><ul><li>Очень простой виджет…</li></ul></li>';
}
?>
WordPress производит вывод виджетов в виде списка. Каждый виджет оформляется как элемент этого списка. В данном примере создаётся элемент списка с присвоенным идентификатором для возможности применить к виджету стили оформления, выводится текст со стилем виджетов и в качестве содержимого виджета так же выводится простой текст.
Ну вот, практически всё закончено. Осталось только вызвать функцию add_action для регистрации плагина.
<?php
add_action("plugins_loaded", "dm_example_widget_init");
?>
Сохраняем наш виджет в папке с плагинами и заходим в административную панель. В разделе плагины находим наш виджет и активируем его. Переходим в раздел дизайн и в настройках виджетов перетаскиваем наш виджет на сайдбар. Сохраняем и смотрим результат.
Ссылки:
О создании виджетов на сайте WordPress.org
Описание функции register_sidebar_widget
Описание функции add_action
:: Рубрика - WordPress ::
