Wordpress: С чего начинаются плагины

С самой первой версии WordPress разрабатывался как открытая платформа. Об этом свидетельствует не только то что он лицензирован как open source, но и его открытая архитектура поддержки плагинов, предоставляющая сторонним разработчикам возможность написания собственных расширений, удовлетворяя все возрастающие потребности пользователей WordPress.

Хотя базовая комплектация WordPress предоставляет довольно широкую функциональность, которая, кстати продолжает расширяться от версии к версии, пользователи часто хотят большего. Вот тут в игру вступают WordPress плагины.

Секретный ингредиент, который позволяет WordPress плагинам быть настолько мощными насколько они есть - это использование т.н. callback-механизма: функций обратного вызова, которые привязываются к так называемым хукам (hook - зацепка). Хуки это не более чем обычные события, предопределенные в движке WordPress и инициируемые в определенные моменты при определенных условиях. Таким образом хуки можно рассматривать как события WordPress, а callback-функции, привязываемые к хукам - как обработчики этих событий.

Хуки бывают двух видов, action hooks и filter hooks. Хуки позволяют плагинам добавлять, изменять или удалять данные страниц перед тем, как они будут показаны пользователю. WordPress имеет сотни хуков, к которым могут привязываться пользовательские функции. При помощи хуков можно воздействовать на все процессы WordPress, будь то формирование главной страницы или страницы статьи или даже функционал панели администратора.

Первым шагом создания плагина WordPress является создание PHP-файла и добавление в него необходимой информации, чтобы WordPress признал его как родного. Это первый рецепт из цикла покажет, как создать основной файл WordPress плагина и как увидеть и активировать его из интерфейса админки.

Предполагается, что Вы уже немного знакомы с WordPress и имеете настроенную локальную версию сайта на движке WordPress или удаленную с возможностью передать необходимые файлы на сервер. Итак, давайте выполним несколько простых шагов...

1. Найдите директорию плагинов движка WordPress: wp-content/plugins
2. Создайте там новую директорию и назовите её plugin-header
3. Зайдите внутрь директории и создайте новый текстовый файл. Назовите его plugin-header.php
4. Откройте ваш новый файл в текстовом редакторе и добавьте следующий код:

    <?php
    /*
        Plugin Name:    Plugin header
        Plugin URI:
        Description:    Мой первый плагин
        Version:        1.0
        Author:         Самый лучший автор
        Author URI:     http://xxxxxxx.xx/
        License:        GPLv2
    */
    ?>

Данный блочный комментарий в основном файле плагина играет практическую роль. Из него движок WordPress получает всю необходимую для начала информацию о плагине. Эти значения мы с вами можем видеть в информации о плагине, в панели администратора. Ниже я постарался привести разъяснения.

• Plugin Name - Имя плагина
• Plugin URI - Адрес странички плагина
• Description - Описание, которое увидит администратор в панели Plugins
• Version - Версия например 1.0
• Author - Имя автора
• Author URI - Адрес странички автора
• License - Тип лицензии например GPLv2

ВАЖНО! Перенос строк в значениях в комментарии недопустим!

Теперь давайте сохраним файл, откроем админку нашего сайта на базе WordPress и пройдем на вкладку Plugins. Здесь мы можем увидеть, что WordPress распознал наш плагин и мы можем его активировать.

Активируйте наш плагин, кликнув по ссылке "Activate" непосредственно под именем плагина.

Теперь мы можем наблюдать, что внешний вид строки информации о плагине изменился, отражая тот факт, что теперь плагин активирован и находится в рабочем состоянии.

Файлы плагинов могут располагаться как непосредственно в директории wp-content/plugins так и в её поддиректориях. Когда вы заходите на вкладку Installed Plugins административной панели, то WordPress сканирует все потенциальные расположения плагинов, просматривая PHP файлы на предмет содержания комментариев требуемого формата. Если он находит таковые, то информация о данных плагинах появляется в списке, в панели Plugins.

Когда Вы активируете плагин, WordPress проверяет содержимое PHP файла, на корректность. В последствии он будет подключать код этого плагина каждый раз при запросе любой страницы, будь то Фронтенд или админка. По этой причине предпочтительно, активировать плагины только тогда, когда они действительно ипользуются, чтобы избежать тормозов.

Конечно, на данный момент, наш новый плагин не делает ничего, но для начала мы и так сделали достаточно. Продолжение следует.