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 ::