Как сделать плагин wordpress

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

С чего начать

Создайте папку в каталоге wp-content/plugins, а внутри — основной файл, например my-plugin.php. В начале файла добавьте служебный комментарий, без которого WordPress не покажет плагин в списке:

• Plugin Name — название;
• Version — номер версии;
• Author — автор;
• Text Domain — нужно для перевода.

Дальше добавьте простой код, который можно безопасно запустить при активации страницы или записи. Не используйте сразу сложную логику: сначала проверьте, что файл вообще подхватывается системой. Например, можно вывести сообщение через хук admin_notices или зарегистрировать короткий шорткод. Если в списке плагинов он появился, а после активации не вызывает ошибок, база уже готова.

<?php
/*
Plugin Name: My Plugin
Version: 1.0.0
*/
add_action('admin_notices', function () {
    echo '<div class="notice notice-success"><p>Плагин загружен.</p></div>';
});

Если вы ищете, как сделать плагин wordpress не для одной страницы, а с возможностью роста, сразу разделяйте файлы: основной файл оставьте для регистрации, а логику перенесите в папки includes, admin, public. Тогда проще поддерживать код и не смешивать интерфейс с бизнес-логикой.

Добавьте рабочую функцию

Полезный плагин обычно делает одно конкретное действие. Это может быть шорткод, дополнительное поле в записи, изменение текста, собственная настройка или интеграция с REST API. Выберите одну задачу и реализуйте её через подходящий хук:

• add_shortcode — если нужен вывод в контенте;
• add_action — если нужно поведение по событию;
• add_filter — если надо изменить существующие данные;
• register_setting — если нужны настройки.

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

Не забывайте о защите: проверяйте права пользователя, экранируйте вывод и очищайте входные данные. Это особенно важно, если плагин принимает данные из формы, URL или настроек в админке. Без этих проверок даже простой код может создать уязвимость.

Активация, проверка и типичные ошибки

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

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

Когда базовая версия готова, можно добавить страницу настроек, локализацию и документацию для себя. Но сначала убедитесь, что минимальная версия стабильна. Именно так как сделать плагин wordpress превращается из теории в рабочий инструмент: один файл для старта, один хук для логики, одна проверка результата в админке и на сайте.