WordPress — это не просто движок для блогов. Это огромная экосистема, где плагины играют ключевую роль. Хотите добавить функционал, которого нет в стандартной поставке? Или, может быть, вы хотите создать свой собственный плагин и поделиться им с миром? Тогда эта статья для вас. Мы разберём, как устроены плагины WordPress, как их правильно писать на PHP и какие подводные камни вас ждут.

Digital-студия WNDER

Что такое плагин WordPress и зачем он нужен

Плагин — это как конструктор LEGO для вашего сайта. Вы берёте готовый WordPress и добавляете к нему кусочки, которые расширяют функциональность. Хотите форму обратной связи? Пожалуйста. Нужен интернет-магазин? Легко. Всё это делается через плагины.

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

Правило: Никогда не редактируйте файлы ядра WordPress. Все изменения — только через плагины или тему. Это спасёт вас от головной боли при обновлениях.

Анатомия плагина: структура и первый запуск

Любой плагин начинается с главного файла. Обычно он называется так же, как и папка плагина. Например, папка my-first-plugin, а внутри файл my-first-plugin.php. В этом файле должна быть специальная шапка с комментариями, которая сообщает WordPress информацию о плагине.

<?php
/*
Plugin Name: Мой Первый Плагин
Description: Просто пример плагина для обучения.
Version: 1.0
Author: Ваше Имя
*/

// Дальше идёт код плагина
?>

Эта шапка — обязательна. Без неё WordPress не увидит ваш плагин в админке. После активации плагина можно писать код, который будет выполняться.

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

Хуки: события и фильтры

Хуки — это основа гибкости WordPress. Они позволяют вам «вклиниться» в работу системы в нужный момент. Есть два типа хуков: действия (actions) и фильтры (filters).

Действия позволяют выполнить код в определённый момент. Например, когда пользователь публикует пост, вы можете отправить уведомление в Telegram. Фильтры позволяют изменять данные. Например, добавить свою ссылку в конце каждого поста.

Пример использования действия:

add_action('wp_footer', 'my_footer_message');
function my_footer_message() {
    echo '<p>Спасибо за визит!</p>';
}

Этот код добавит сообщение в подвал сайта. Просто, правда? А теперь пример фильтра:

add_filter('the_content', 'add_signature');
function add_signature($content) {
    return $content . '<p>С уважением, ваш сайт.</p>';
}

Этот фильтр добавит подпись к каждому посту. Обратите внимание: фильтр должен вернуть изменённое значение, а не просто вывести его.

Лайфхак: Используйте префиксы для имён функций, чтобы избежать конфликтов с другими плагинами. Например, myp_ (от My Plugin).

Безопасность прежде всего: проверка данных и экранирование

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

Во-первых, всегда проверяйте права пользователя. Если действие должно быть доступно только администратору, используйте current_user_can().

Во-вторых, экранируйте вывод. Если вы выводите данные, полученные от пользователя, используйте esc_html(), esc_attr() и другие функции экранирования.

В-третьих, используйте nonce для защиты форм. Nonce — это одноразовый токен, который проверяет, что запрос пришёл от вашего сайта.

Пример безопасной обработки формы:

// В форме добавляем nonce
wp_nonce_field('my_action', 'my_nonce');

// При обработке проверяем
if (!isset($_POST['my_nonce']) || !wp_verify_nonce($_POST['my_nonce'], 'my_action')) {
    die('Ошибка безопасности');
}

Не пренебрегайте этим. Лучше потратить лишние пять минут, чем потом чистить сайт от вирусов.

Практический пример: плагин для вывода цитаты дня

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

Создайте папку quote-of-the-day и файл quote-of-the-day.php.

<?php
/*
Plugin Name: Цитата дня
Description: Выводит случайную цитату в подвале сайта.
Version: 1.0
Author: Ваше Имя
*/

add_action('wp_footer', 'qotd_display_quote');
function qotd_display_quote() {
    $quotes = array(
        'Будь собой, прочие роли уже заняты.',
        'Сложнее всего начать действовать, все остальное зависит только от упорства.',
        'Лучший способ предсказать будущее — создать его.'
    );
    $random_quote = $quotes[array_rand($quotes)];
    echo '<div style="text-align:center; padding:10px; background:#f9f9f9;">' . esc_html($random_quote) . '</div>';
}
?>

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

Совет: Всегда тестируйте плагин на локальном сервере, прежде чем ставить на живой сайт. Можно использовать Local by Flywheel или XAMPP.

Таблица основных функций WordPress для плагинов

Вот несколько ключевых функций, которые вам пригодятся:

Функция Описание
add_action() Прикрепляет функцию к событию
add_filter() Прикрепляет функцию к фильтру
get_option() Получает значение настройки
update_option() Обновляет настройку
wp_enqueue_script() Подключает JavaScript
wp_enqueue_style() Подключает CSS

Эти функции — базовый набор. Изучите их, и вы сможете писать более сложные плагины.

Заключение

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

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

И не забывайте: сообщество WordPress огромно. Если что-то не получается, ищите ответы в документации или на форумах. Удачи в разработке!

Студия WNDER