Создаём простой плагин для WordPress за 5 минут
В процессе работы с сайтом на WordPress часто возникает необходимость внесения в логику его работы различных изменений. Собственный плагин — отличное место для хранения всех ваших модификаций.
Базовая структура
Плагин WordPress может состоять всего лишь из одного PHP-файла, однако для удобства и возможности последующего расширения я всегда создаю для него папку, в которую и помещаю этот файл. Папка и файл должны иметь одинаковые имена, за исключением расширения. Давайте создадим плагин My Custom Functions, папку и файл в ней назовём следующим образом:
- my-custom-functions
- my-custom-functions.php
Теперь загрузим только что созданную папку в директорию wp-content/plugins нашего сайта.
Основы структуры файла плагина WordPress
Согласно стандартам WordPress, в наш файл плагина нужно включить множество различных инструкций, однако здесь я ограничусь лишь необходимыми.
Заголовок плагина
Вот всё, что должно быть в файле плагина для того, чтобы WordPress распознал его сразу после загрузки:
<?php
/*
Plugin Name: My Custom Functions
*/
Просто, не правда ли? Для того, чтобы плагин заработал, достаточно перейти в раздел Плагины панели администрирования WordPress и активировать его. Конечно, плагин пока не делает ровным счётом ничего, однако важно то, каким образом мы заложили для него фундамент.
Есть и другие вещи, которые вы можете включить в заголовок плагина: описание, версия, автор и т.д. Прочитать о них подробнее можно в официальной документации WordPress здесь.
Основная часть плагина
Как я уже говорил ранее, в плагин можно поместить множество различных инструкций, но сейчас, на самом базовом уровне, вы можете рассматривать плагин как файл functions.php вашей темы WordPress. Под этим я подразумеваю, что все ваши сниппеты, которые вы, возможно, добавляли в этот файл, можно поместить в файл плагина, и они будут работать точно также.
В качестве примера я помещу в плагин небольшой фрагмент кода, который добавляет произвольный текст в конец основного контента каждой страницы сайта. Для этого я использую хук-фильтр the_content
.
function add_to_content($content){
return $content . '<p>Enjoy!</p>';
}
add_filter('the_content', 'add_to_content');
Несмотря на простоту, с помощью этого сниппета можно сделать множество полезных вещей, например добавить на страницы блога авторскую подпись или рекламный блок Google AdSense.
Теперь давайте взглянем на то, что у нас получилось:
<?php
/*
Plugin Name: My Custom Functions
*/
function add_to_content($content){
return $content . '<p>Enjoy!</p>';
}
add_filter('the_content', 'add_to_content');
Плагин получился довольно простым, но суть в том, что в случае необходимости вы легко сможете его модифицировать или же вовсе отключить, если что-то пойдёт не так. При этом можно быть полностью уверенным в том, что это никак не повлияет на работоспособность сайта.
В итоге
Теперь вы знаете, что в создании плагинов для WordPress нет ничего сложного. Это также просто, как добавлять код в файл functions.php вашей темы (чего на самом деле категорически делать не стоит), и в то же время это намного круче ^^
Источник: http://wpninjas.com/how-to-create-a-simple-wordpress-plugin/