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

Зачем нужно разрабатывать собственные плагины для WordPress?

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

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

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

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

Рекомендуемое чтение От начала до практики: Полное руководство по разработке плагинов для WordPress и продвинутые техники。

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

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

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

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

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

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

Этот комментарий играет ключевую роль в процессе распознавания плагинов WordPress. Поле “Plugin Name” является обязательным для заполнения; остальная информация предоставляется по желанию. После создания этого файла необходимо поместить его в соответствующее место в системе WordPress. /wp-content/plugins/my-first-plugin/ Вы найдете этот плагин на странице “Плагины” в меню административной панели WordPress и сможете его активировать.

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

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

После комментариев в заголовочном файле вашего плагина добавьте следующий код:

// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
    exit; // 如果ABSPATH未定义，则退出
}

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

Рекомендуемое чтение Руководство по разработке плагинов для WordPress для начинающих.。

Расширение функционала WordPress с помощью хуков

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

Выполнение задач с помощью крючков действий

Действия-хаки (action hooks) позволяют выполнять пользовательские функции при наступлении определенных событий. Например, при публикации статьи, при входе пользователя в систему или при загрузке верхней части веб-страницы. Чтобы использовать действие-хак, необходимо… add_action() Функция.

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

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

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

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

function my_custom_admin_notice() {
    echo '<div class="notice notice-success is-dismissible"><p>Добро пожаловать в панель управления сайтом! Это уведомление было добавлено моим плагином.</p></div>';
}
add_action( 'admin_notices', 'my_custom_admin_notice' );

Добавьте этот код в ваш основной плагин. После активации плагина каждый раз, когда вы заходите в административную панель, вы увидите это сообщение. Функция… my_custom_admin_notice Это обратный вызов (callback-функция), определённый нами.add_action() Соедините это с… admin_notices Связать эти «хватки» (hookы) между собой.

Использование хуков фильтров для изменения данных

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

Классическим примером является изменение текста, находящегося в конце заголовков статей. Например, мы хотим добавить название веб-сайта после заголовков всех статей.

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

function modify_post_title( $title ) {
    // 确保只在主循环的单篇文章页面修改
    if ( is_single() && in_the_loop() ) {
        $title .= ' | 我的网站';
    }
    return $title;
}
add_filter( 'the_title', 'modify_post_title' );

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

Создание страницы управления для плагина

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

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

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

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

Добавить меню высшего руководства.

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

Давайте создадим простую страницу с настройками нашего плагина под названием “Мои настройки плагина”.

function my_plugin_add_menu_page() {
    add_menu_page(
        '我的插件设置',          // 页面标题（浏览器标签）
        '我的插件',              // 菜单标题
        'manage_options',       // 所需权限
        'my-plugin-settings',   // 菜单slug（URL标识）
        'my_plugin_settings_page', // 用于渲染页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        30                      // 菜单位置
    );
}
add_action( 'admin_menu', 'my_plugin_add_menu_page' );

Далее вам необходимо определить функции-обратные вызовы (callback functions), использованные выше. my_plugin_settings_page Вы не предоставили никакого текста для перевода. Пожалуйста, введите содержимое HTML-страницы, и я помогу с его переводом на русский язык.

function my_plugin_settings_page() {
    ?>
    <div class="wrap">
        <h1>Настройки моего плагина.</h1>
        <form method="post" action="/ru/options.php/" data-trp-original-action="options.php">
            <?php
            // 输出设置字段（后续可与设置API结合）
            settings_fields( 'my_plugin_options_group' );
            do_settings_sections( 'my-plugin-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="ru"/></form>
    </div>
    &lt;?php
}

Интеграция с API настроек WordPress

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

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

function my_plugin_settings_init() {
    // 注册一组设置
    register_setting( 'my_plugin_options_group', 'my_plugin_option_name' );

// 添加一个设置区块
    add_settings_section(
        'my_plugin_section_id',
        '主要设置',
        null, // 可选的区块描述回调函数
        'my-plugin-settings'
    );

// 向区块中添加一个字段
    add_settings_field(
        'my_plugin_field_id',
        '示例文本字段',
        'my_plugin_field_callback',
        'my-plugin-settings',
        'my_plugin_section_id'
    );
}
add_action( 'admin_init', 'my_plugin_settings_init' );

// 字段的回调函数，用于输出HTML输入框
function my_plugin_field_callback() {
    $option = get_option( 'my_plugin_option_name' );
    echo '<input type="text" name="my_plugin_option_name" value="' . esc_attr( $option ) . '" />';
}

Теперь на вашей странице настроек появилось поле формы, защищённое API для настроек; значения этого поля будут безопасно сохраняться в системе WordPress. options В таблице базы данных. Через… get_option( 'my_plugin_option_name' ) Это значение можно получить в любом месте — как на фронтенде, так и на бэкенде.

резюме

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

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

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

Для разработки плагинов для WordPress необходимы основные знания языка программирования PHP, поскольку код плагинов в основном написан на PHP. Также важно иметь базовое понимание HTML, CSS и JavaScript для создания пользовательского интерфейса и обеспечения его взаимодействия с пользователем. Кроме того, полезно знать основные концепции WordPress, такие как статьи, страницы, роли пользователей и механизмы обработки данных (например, конструкция The Loop).

Где следует размещать функции плагинов и тем?

Это важный вопрос, касающийся правил разработки. Всей код, связанный с функциональностью веб-сайта, логикой работы серверной части и обработкой данных, следует размещать в плагинах. Код, же напрямую связанный с визуальным представлением сайта, его структурой и стилем (таким как шаблоны страниц, CSS, JavaScript на стороне клиента), должен находиться в темах (theme files). Главное преимущество такого подхода заключается в том, что при смене темы основные функции сайта остаются доступны. Например, код для регистрации пользователей, относящийся к пользовательскому типу статей, следует размещать в плагине, а файлы шаблонов, отвечающие за отображение этих статей, – в теме.

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

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

Как моему плагину реализовать поддержку международных языков (интернационализацию)?

WordPress использует фреймворк GNU gettext для реализации функций интернационализации (i18n) и локализации. В вашем плагине необходимо обернуть все текстовые строки, которые нужно перевести, специальными функциями. Наиболее распространенными из таких функций являются… __() Используется для перевода строк в коде и возврата результатов этого перевода. _e() Для перевода строк необходимо использовать соответствующие инструменты или библиотеки. Перевод должен выполняться непосредственно, без дополнительной обработки текста. Также важно правильно настроить параметры в заголовочных файлах плагинах, чтобы перевод работал корректно. Text DomainИ использовать его при загрузке плагина. load_plugin_textdomain() Функция предназначена для загрузки файлов с переводами. После этого вы сможете использовать такое программное обеспечение, как Poedit, для их обработки и создания готовых переводов. .pot Шаблонные файлы, а также файлы, предназначенные для перевода на разные языки. .po и .mo Переводите документы.