Разработка плагинов WordPress от новичка до мастера: пошагово научим вас создавать собственные уникальные функции

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

Среда разработки плагинов и основы её работы

Прежде чем начинать разработку плагина для WordPress, необходимо создать стабильную и эффективную локальную среду разработки. Мы рекомендуем использовать такие инструменты, как Local by Flywheel, Laragon или Docker, чтобы быстро настроить среду, поддерживающую PHP, MySQL, Apache или Nginx. Это позволит вам выполнять тестирование и отладку в безопасной, изолированной среде.

Создайте свой первый файл плагина.

Плагин может быть настолько простым, что состоит всего из одного файла, но ради соблюдения стандартов мы начнем с базовой структуры. Зайдите в каталог установки WordPress… wp-content/plugins Создайте новую папку, например, назовите её «New Folder». my-first-plugin。

Рекомендуемое чтение Руководство по разработке плагинов для WordPress: создание вашего первого функционального расширения с нуля.。

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

Ультахост (UltaHost) – хостинг-провайдер, предоставляющий услуги хостинга для сайтов, построенных на платформе WordPress.

Гарантия возврата средств в течение 30 дней, неограниченная пропускная способность интернет-канала и объем баз данных, бесплатная защита от DDoS-атак. При покупке на срок 3 лет предоставляется скидка в размере 501 ТБ до 4 ТБ.

страница доступа

<?php
/**
 * Plugin Name: 我的第一个插件
 * Plugin URI:  https://yourwebsite.com/my-first-plugin
 * Description: 这是一个用于学习 WordPress 插件开发的基础插件。
 * Version:     1.0.0
 * Author:      你的名字
 * License:     GPL v2 or later
 * Text Domain: my-first-plugin
 */

После сохранения файла перейдите на страницу “Плагины” в интерфейсе управления WordPress. Ваш плагин должен появиться в списке доступных плагинов. Вы можете активировать его так же, как и другие плагины. Хотя на данный момент у него нет никаких функций, вы уже сделали первый важный шаг на пути к его разработке. Для удобства дальнейшей работы рекомендуется создать четкую структуру каталогов внутри папки с плагином. admin/(Код, связанный с работой бэкенда)public/(Код, связанный с фронтенд-частью программы)includes/(Основные функции и библиотеки), а также места для хранения ресурсов JavaScript и CSS assets/ Папка.

Основные концепции разработки: хаки (hooks) и действия (actions)

После того, как мы поняли основную структуру плагинов, нам необходимо погрузиться в суть системы плагинов WordPress — в так называемые “хуки” (Hooks). Хуки делятся на два типа: действия (Actions) и фильтры (Filters). Они являются основой событийно-ориентированной архитектуры WordPress и позволяют нашему коду вступать в основной процесс работы WordPress в определенные моменты времени для выполнения нужных действий.

Понимание действий, связанных с использованием хуков (action hooks)

Действия-хаки (action hooks) позволяют выполнять пользовательский код в определенные моменты жизненного цикла WordPress. Например, после публикации статьи или при входе пользователя в систему WordPress запускаются соответствующие действия-хаки.

пользоваться add_action() Функция позволяет подключить вашу функцию к определенному “хаку” (hook). Ее базовый синтаксис следующий:add_action( ‘hook_name’, ‘your_function_name’, priority, accepted_args );Давайте добавим строку с пользовательским текстом в нижнюю часть страницы веб-сайта.

Рекомендуемое чтение Разработка плагинов WordPress с нуля до профессионального уровня: полное руководство по созданию высоконастраиваемых функциональных модулей。

function myplugin_add_footer_text() {
    echo '<p id="custom-footer">Спасибо за использование нашего сайта! Этот контент был добавлен с помощью моего плагина.</p>'add_action( ‘wp_footer’, ‘myplugin_add_footer_text’ );

После активации плагина с указанным кодом вы увидите, что этот текст будет добавлен в область футера на веб-сайте. Это типичный пример использования действий-хуков (action hooks): код выполняется в определенном месте без изменения исходных данных; происходит лишь его вывод или выполнение.

Овладение фильтрующими хуками (filter hooks)

В отличие от действий (actions), фильтры-хаки (filter hooks) предназначены для изменения данных. Они позволяют вам модифицировать данные перед тем, как они будут использованы (например, сохранены в базе данных или отображены в браузере). WordPress передает данные вам через фильтры, и вы можете их изменить перед тем, как вернуть их обратно.

пользоваться add_filter() Функции предназначены для применения фильтров. Например, мы хотим изменить конец заголовка статьи, добавив к нему пользовательский суффикс.

hosting.com Общий хостинг

Высокая производительность благодаря процессорам AMD EPYC, SSD-накопителям NVMe и LiteSpeed, круглосуточная экспертная поддержка, передовые меры безопасности, включая SSL, защиту от грубой силы, вредоносных программ и DDoS, экономия до 73%

страница доступа

function myplugin_modify_title( $title ) {
    // 确保只在主循环且在前端单篇文章页面修改
    if ( is_single() && in_the_loop() ) {
        return $title . ‘ - 精彩内容’;
    }
    return $title;
}
add_filter( ‘the_title’, ‘myplugin_modify_title’ );

В этом примере…the_title Фильтр отображает заголовок текущей статьи. $title Функция, передаваемая вам myplugin_modify_titleПосле того, как вы измените и вернёте новый строковый значений, WordPress использует это изменённое значение для отображения. Понимание и умелое применение функций действий (actions) и фильтров (filters) является ключом к раскрытию неограниченных возможностей настройки WordPress.

Реализация функций плагина: добавление меню управления и параметров

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

Создание верхнего уровня меню управления

Вы можете использовать add_menu_page() Функция добавляет в ваш плагин верхний элемент меню. Она определяет заголовок меню, необходимые права для доступа к нему, URL-адрес и связывает его с обратным вызовом (callback-функцией), который отвечает за отображение содержимого страницы.

Рекомендуемое чтение Руководство по разработке плагинов для WordPress: Создание вашего первого функционального расширения с нуля。

function myplugin_add_admin_menu() {
    add_menu_page(
        ‘我的插件设置’, // 页面标题
        ‘我的插件’, // 菜单标题
        ‘manage_options’, // 所需权限（管理员）
        ‘myplugin-settings’, // 菜单 Slug
        ‘myplugin_display_settings_page’, // 显示页面的函数
        ‘dashicons-admin-generic’, // 菜单图标（Dashicon）
        100 // 菜单位置
    );
}
add_action( ‘admin_menu’, ‘myplugin_add_admin_menu’ );

function myplugin_display_settings_page() {
    ?>
    <div class="“wrap”">
        <h1></h1>
        <form action="/ru/“options.php”/" method="“post”" data-trp-original-action="“options.php”">
            <br />
        <input type="hidden" name="trp-form-language" value="ru"/></form>
    </div>
    &lt;?php
}

Добавьте данный код в свой плагин. После его активации на левой стороне панели управления WordPress появится новый пункт меню под названием “Мои плагины”. Нажмите на него, чтобы перейти в раздел, отвечающий за управление вашим плагином. myplugin_display_settings_page Страница, отображаемая с помощью функций.

Использование API настроек для регистрации параметров

Ручная обработка отправки и проверки форм является затруднительной и небезопасной процедурой. WordPress предоставляет мощный API Settings для упрощения этого процесса. Этот API отвечает за проверку подлинности пользователей (nonce-проверку), проверку их прав на доступ к данным формы, а также за хранение собранных данных.

Общий хостинг InterServer

Общий хостинг $2.50 USD в месяц, первый месяц $0.1 USD промо-код tryinterserver, 461 скрипт облачных приложений, установка в один клик.

страница доступа

Во-первых, вам нужно использовать register_setting() Зарегистрируйте свои группы настроек и поля, используя… add_settings_section() Добавьте область настроек и используйте её. add_settings_field() Добавьте конкретные поля.

function myplugin_register_settings() {
    // 注册一组设置，数据将保存在 `myplugin_options` 选项中
    register_setting(
        ‘myplugin_options_group’, // 设置组名，与 settings_fields() 对应
        ‘myplugin_options’, // 选项名
        ‘myplugin_sanitize_callback’ // 数据清理回调函数（可选但推荐）
    );

// 添加一个设置区域
    add_settings_section(
        ‘myplugin_main_section’,
        ‘主要设置’,
        null, // 区域描述的回调函数
        ‘myplugin-settings’ // 页面 Slug
    );

// 在区域中添加一个文本字段
    add_settings_field(
        ‘myplugin_text_field’,
        ‘欢迎语’,
        ‘myplugin_text_field_render’, // 渲染字段输入框的函数
        ‘myplugin-settings’,
        ‘myplugin_main_section’
    );
}
add_action( ‘admin_init’, ‘myplugin_register_settings’ );

function myplugin_text_field_render() {
    $options = get_option( ‘myplugin_options’ );
    $value = $options[‘myplugin_text_field’] ?? ‘’;
    ?>
    <input type=“text” name=“myplugin_options[myplugin_text_field]” value=“<?php echo esc_attr( $value ); ?>”>
    <?php
}

function myplugin_sanitize_callback( $input ) {
    // 清理和验证输入数据
    $sanitized_input = [];
    if ( isset( $input[‘myplugin_text_field’] ) ) {
        $sanitized_input[‘myplugin_text_field’] = sanitize_text_field( $input[‘myplugin_text_field’] );
    }
    return $sanitized_input;
}

Теперь на вашей странице настроек появилось текстовое поле с функциями проверки и хранения данных. С помощью API настроек (Settings API) вы можете создавать сложные интерфейсы конфигурации безопасным и эффективным способом.

Публикация и обслуживание плагинов

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

Реализация интернационализации плагина

Чтобы ваш плагин был доступен пользователям, не говорящим на китайском языке, необходимо использовать функции интернационализации (i18n) WordPress для обработки всех пользовательских текстов. В основном это касается текстов, отображаемых на сайте. __() Используется для отображения результатов перевода._e() Для прямого вывода перевода.

Во-первых, измените все строковые значения в вашем коде.

\n// В заголовке плагина убедитесь, что Text Domain указан правильно
// В коде
function myplugin_display_settings_page() {
    ?>
    <h1><p><strong>Мои настройки плагина</strong>:   
</p></h1>
    &lt;?php
}

Затем используйте инструменты вроде Poedit для сканирования кода вашего плагина с целью генерации необходимых данных. .pot(Шаблон) Файл, а также создание основного языка (например, английского). .po И после компиляции .mo Файлы. Разместите эти языковые файлы в папке плагина. languages/ Файлы находятся в этом папке. WordPress автоматически загружает соответствующие переводы в зависимости от настроек языка сайта.

Обеспечение безопасности и производительности кода

Перед публикацией обязательно проверьте безопасность кода. Для обработки всех пользовательских вводимых данных и выводимых результатов используйте соответствующие функции очистки, предоставляемые WordPress. esc_html(), esc_attr(), sanitize_text_field() и wp_kses_post()При выполнении запросов к базе данных используется… $wpdb Методы класса или WP_QueryИзбегайте прямого слияния строк SQL-запросов, чтобы предотвратить атаки типа вставки (инъекции).

Кроме того, обратите внимание на оптимизацию производительности. Рационально используйте хаки (hooks), чтобы избежать выполнения большого количества ненужных операций при каждом загрузке страницы. Для результатов сложных запросов рассмотрите возможность использования API временной (транзиентной) кэширования WordPress (WordPress Transients). Например, можно воспользоваться этим API для хранения временных данных, которые не нуждаются в постоянном сохранении в базе данных. set_transient() и get_transient()。

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

резюме

Разработка плагинов для WordPress – это процесс, начинающийся с понимания основной структуры системы, затем переходящий к освоению механизмов работы системы хуков (hooks) и создания пользовательских интерфейсов управления, и в конечном итоге ведущий к созданию надежных, интернационализированных плагинов. В этой статье вы узнали, как создать свой первый плагин с нуля, как расширить его функционал с помощью хуков действий (actions) и фильтров (filters), как использовать API настроек (Settings API) для создания профессиональных страниц управления, а также как подготовить плагин к публикации. Помните: ключ к успеху – в практике. Начните с простой идеи, постепенно улучшайте свой плагин, полностью используя обширный API и ресурсы сообщества WordPress, и вы сможете создать собственный мощный и профессиональный плагин, который позволит глубоко настроить ваш веб-сайт или даже создать ценный продукт.

Часто задаваемые вопросы

Какие знания необходимы для разработки плагинов для WordPress?

Вам потребуются базовые знания PHP-программирования, включая работы с переменными, функциями, массивами и основами объектно-ориентированного программирования. Также важно иметь представление об HTML, CSS и JavaScript, поскольку вам предстоит работать с пользовательским интерфейсом и взаимодействием пользователя. Знание основ работы с WordPress, а также его внутреннего интерфейса, является необходимым для понимания условий работы плагинов.

В чем разница между функциями плагинов и тем (тематических настроек сайта)? Когда стоит разрабатывать плагины?

Темы в основном отвечают за внешний вид и структуру сайта, в то время как плагины предназначены для добавления дополнительных функций. Простое правило для определения того, к какой категории относится определенная функция: если функция тесно связана с визуальным дизайном сайта, то ее лучше включить в состав темы; если функция независима и может использоваться даже после смены темы (например, формы для связи, инструменты для оптимизации SEO, системы кэширования), то ее следует разработать в виде отдельного плагина. Соблюдение принципа разделения функций (плагины) и стилей (темы) облегчает долгосрочное обслуживание и обновление сайта.

Как отладить мой плагин для WordPress?

Во-первых, в wp-config.php В файле включите режим отладки WordPress. WP_DEBUG Константа установлена на trueЭто позволит отображать на странице ошибки PHP, предупреждения и уведомления. Кроме того, используется… error_log() Функция записывает пользовательские сведения о дебагировании в ошибочный журнал сервера. Для сложных логических процессов можно использовать профессиональные инструменты дебагирования, такие как Xdebug, в сочетании с настройками интерфейса разработчика (IDE) для пошагового отладчика. Вкладки Console и Network в инструментах разработчика браузера являются очень полезными для отладки JavaScript-кода на стороне клиента, а также AJAX-запросов.

Как мой плагин может совместно работать с другими плагинами?

Для максимизации совместимости ваш плагин должен использовать уникальные префиксы для именования всех функций, классов, констант, параметров настроек и таблиц базы данных. Это поможет избежать конфликтов в именах. Осторожно используйте глобальные переменные. При добавлении хуков (специальных механизмов обработки событий) устанавливайте параметры приоритета так, чтобы порядок их выполнения соответствовал ожидаемому. Для общих данных, которые могут быть изменены другими плагинами, обеспечьте достаточную надежность вашего кода – он должен быть способен обрабатывать различные варианты входных данных. Перед публикацией тестируйте плагин в различных средах и с комбинациями распространенных плагинов.

Как добавить пользовательские таблицы базы данных в мой плагин?

Хотя WordPress и предоставляет… wp_options Параметры хранения в таблицах подходят для небольших объемов структурированных данных, однако для больших объемов данных использование пользовательских настроек баз данных и таблиц обеспечивает лучшую производительность. Вы можете воспользоваться хуками активации плагинов для настройки этих параметров. register_activation_hook() В разделе регистрации функций необходимо написать SQL-код для создания таблицы. Обязательно используйте соответствующие стандарты и синтаксис языка SQL. $wpdb->prefix Чтобы получить правильный префикс и использовать его… dbDelta() Функция предназначена для выполнения операций создания или обновления таблиц; она способна интеллектуально справляться с различиями в их структуре. Кроме того, необходимо учитывать вопросы очистки данных при удалении плагина, предоставляя пользователю возможность выбора соответствующего способа очистки.