Как создать плагин для WordPress? Подробная инструкция 2022

Создание плагина для Wordpress потребует от вас навыков программирования. Если они есть, тогда написать плагин для  Wordpress будет не так сложно, как это звучит. Главное — делать все по порядку и не спеша. Сегодня мы подробно опишем, как происходит создание плагина Wordpress поэтапно.

Напомним, что плагин для  Wordpress — это некая программа, которая помогает улучшить сайт, созданный на этой CMS. Плагин нужен для того, чтобы разработчик не лазил с корректировками в основной код сайта, а мог тот или иной функционал добавить в несколько кликов. 

С технической стороны, плагин для  Wordpress — это программа, которая собрана из программных скриптов, написанных на языке программирования РНР. Количество скриптов может быть разным, поэтому плагин может быть небольшим и располагаться в одном документе, а может быть собран из сотен разных документов. Масштаб плагина зависит от того, какой функционал для сайта заложен внутри него. Но важно знать, что и небольшой и большой плагины собираются по похожему алгоритму.

Создание плагина  Wordpress

Создание плагина  Wordpress происходит по простому алгоритму действий:

1. Нужно создать папку для плагина в корневой директории  Wordpress. Ваша папка должна располагаться в той папке  Wordpress, где уже содержатся плагины движка. Стандартный путь до вашей папки будет такой: «/wp-content/ plugins/ my-first-plugin». Нетрудно догадаться, что «my-first-plugin» — это название папки для вашего первого плагина.

2. Нужно создать основной файл вашего плагина, куда будут вписаны его основные функции. Тут есть важный момент — название основного файла и папки его расположения должны совпадать. Поэтому должно получиться что-то такое: «/wp-content/ plugins/ my-first-plugin /my-first-plugin.php». 

3. Нужно разобраться с описанием плагина. Описание — это информация о вашем плагине, которая помогает Wordpress определить, что ваш плагин — это действительно плагин, а не просто какой-то код. Если описания нет или оно создано некорректно, тогда ваш плагин работать не будет. Описание плагина добавляется в самое начало основного файла плагина. Оно состоит из заголовков плагина, где каждый из них имеет определенное значение. К примеру, чтобы Вордпресс определил, что плагин это действительно плагин и вы могли его увидеть в административной панели, нужно добавить вот такой заголовок в описание:

   

При создании плагина может быть написано много функций и сценариев. Обычно ими не засоряют основной файл плагина, а пишут в отдельных документах, а потом эти отдельные документы подключают в основном файле. Во-первых, это нужно, чтобы разработанный код был понятен и красив, а во-вторых, так будет легче в дальнейшем обслуживать плагин. Например, за изменение цвета на сайте при помощи плагина отвечает один файл, за изменение шрифта — другой, за отправку формы — третий и т. д. Если всё это «намешать» в одном файле, то вам же будет потом тяжело развивать, обновлять и обслуживать разработанный плагин.

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

Создание плагина Wordpress: заголовки основного файла

Чуть выше мы привели пример одного заголовка, который указывает Wordpress, что весь написанный ниже код — это код плагина. Обычно одним заголовком мало кто ограничивается. Для того чтобы описание было более информативным, разработчики плагинов добавляют много разных заголовков, например:

Обязательным заголовком является «Plugin Name». Остальные заголовки нужны больше для разработчиков и пользователей вашего плагина, но не для Wordpress. Вы же в зависимости от масштаба вашего плагина заполняете те или иные заголовки. Например, если вы делаете небольшой плагин под собственные нужды, тогда нет смысла сильно заморачиваться с описанием. Но если вы планируете написать плагин для Wordpress и потом его продавать или бесплатно предлагать другим пользователям, тогда описание нужно.

Создание плагина Wordpress: хуки

Веб-мастера, использующие Wordpress, уже знакомы с таким понятием как «хуки». Хуки позволяют видоизменять Wordpress, не внося изменений в сам код этой CMS. Хуки «перехватывают» основные функции сайта и добавляют в них то, что нужно именно вам. При этом вам не нужно искать месторасположение функции, которую нужно поменять. Поэтому хуки могут быть использованы вами для создания собственного плагина, но и пользователями вашего плагина, чтобы его «доработать» под собственные интересы.

Хуки бывают двух видов:

• те, которые определяют события (actions) — эти хуки помогают непосредственно изменять функционал Wordpress;

• те, которые отфильтровывают данные(filters) — эти хуки помогают перехватывать и изменять какие-то данные.

Нужно понимать, что хуки в Wordpress очень распространены, поэтому они используются везде: в ядре Wordpress, шаблонах и плагинах. Поэтому при создании собственного плагина без них не обойтись.

При создании собственного плагина Wordpress вам нужно знать о трех основных хуках:

• «register_activation_hook()» — с помощью этого хука происходит регистрация функций, который активируются при установке и активации плагина в Wordpress;

• «register_deactivation_hook()» — с помощью этого хука происходит регистрация функций, которые активируются после деактивации плагина из Wordpress;

• «register_unistall_hook()» — с помощью этого хука происходит регистрация функций, которые активируются после удаления плагина.

Очень часто в процессе работы над собственным плагином вам понадобятся какие-то уникальные хуки. Вы можете их создавать самостоятельно, если воспользуетесь «do_action()» или «do_filters».

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

Создание плагина Wordpress: использование API

Создание плагина Wordpress становится интересней, когда к разработчику приходит осознание, что до него уже было что-то создано. Речь идет об API. В Wordpress существует ряд API, которые могут существенно вам облегчить написание кода плагина.

С помощью API можно подключать к своему плагину какие-то службы, готовые функции и т. д. Для вас это означает следующее: не нужно разрабатывать самостоятельно то, что уже было создано и предлагается к использованию через API.

Поэтому, в зависимости от масштабности и тематике вашего плагина для Wordpress, изучите доступные API, которые подойдут именно вам.

Заключение

Создание плагина Wordpress — дело несложное, если отлично знать язык программирования РНР. В следующих статьях мы на практике покажем, как написать собственный плагин для Wordpress. Если плагин создается для личных целей, тогда трудностей практически нет. Сложнее создавать плагин «для всех», потому что тогда к нему предъявляется куча дополнительных требований.  Например:

• лицензирование;
• организация поддержки;
• совместимость с версиями Wordpress и разными шаблонами сайтов;
• перевод на несколько языков;
• и др.