Создаём простой плагин для WordPress за 5 минут

Дата публикации: 19.10.2016/Рубрика: Программирование/Автор: Kei

В процессе работы с сайтом на 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/

Создаём простой плагин для WordPress за 5 минут