С нуля: полное руководство по разработке плагинов для WordPress и практическое обучение.

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

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

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

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

Профессиональная локальная среда разработки необходима, прежде чем вы начнете писать код. Мы рекомендуем использовать такие инструменты, как Local, DevKinsta или Docker, чтобы быстро создать среду с PHP, MySQL и веб-сервером. Убедитесь, что версия PHP (рекомендуется 7.4 или выше) совместима с целевой версией WordPress, и включите отчет об ошибках, который поможет в отладке.

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

Самая основная структура плагина WordPress состоит из главного файла. Этот мастер-файл должен содержать определенные комментарии к заголовку плагина, чтобы WordPress мог его распознать.

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

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

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

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

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

<?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 и сможете активировать его. Хотя сейчас он не обладает никакой функциональностью, вы успешно создали плагин, который распознается WordPress.

Понимание и применение основного механизма WordPress: крючков

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

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

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

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

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

Крючки фильтров позволяют изменять данные, которые WordPress передает в процессе обработки. Например, вы хотите изменить содержимое заголовка поста.the_title это крючок для фильтрации. Вы используете add_filter() функцию для привязки функции-обработчика, которая получает исходные данные и должна возвращать измененные.

Ниже приведен пример использования как действий, так и фильтров:

// 1. 定义一个在文章发布时执行的动作函数
function myplugin_on_post_publish( $post_id ) {
    // 获取文章对象
    $post = get_post( $post_id );
    // 记录日志或执行其他操作
    error_log( "文章《{$post->post_title}》已发布，ID: {$post_id}" );
}
// 将上述函数挂接到 ‘publish_post’ 动作钩子
add_action( 'publish_post', 'myplugin_on_post_publish' );

// 2. 定义一个修改文章标题末尾内容的过滤器函数
function myplugin_add_to_title( $title ) {
    // 仅在主循环的文章标题中生效
    if ( is_single() && in_the_loop() ) {
        return $title . ' - [推荐阅读]';
    }
    return $title;
}
// 将上述函数挂接到 ‘the_title’ 过滤器钩子
add_filter( 'the_title', 'myplugin_add_to_title' );

Практическая работа: создание пользовательских плагинов на страницах администрирования

Полезный плагин обычно требует страницы настроек в бекенде WordPress. Мы создадим пример плагина, который добавит страницу подменю в меню “Настройки” в бекенде и позволит вам сохранить и прочитать некоторые параметры.

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

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

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

Создание меню и страниц внутреннего администрирования

Во-первых, нам нужно использовать add_action('admin_menu', ...) Хуки регистрируют наши собственные пункты меню при инициализации меню администратора. Мы используем add_options_page() чтобы добавить подстраницу в меню “Настройки”.

Обработка данных формы и проверка безопасности

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

Ниже приведен пример кода, реализующий эту функциональность:

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

// Вставьте крючок в admin_menu, чтобы добавить меню.
function myplugin_add_admin_menu() {
    add_options_page(
        'My Plugin Settings', // заголовок страницы
        'Мои плагины', // заголовок меню
        'manage_options', // необходимые права (администратор)
        'myplugin-settings', // название меню
        'myplugin_render_settings_page' // функция обратного вызова для рендеринга страницы
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

// Функция обратного вызова для рендеринга страницы настроек
function myplugin_render_settings_page() {
    // Проверка прав пользователя
    if ( !current_user_can( 'manage_options' ) ) {
        wp_die( 'Недостаточно разрешений.' ); wp_die( 'Недостаточно разрешений.' ); // Проверяем разрешения пользователя. );
    }
    ? >
    <div class="wrap">
        <h1>Настройки моего плагина.</h1>
        <form method="post" action="/ru/options.php/" data-trp-original-action="options.php">
            <?php
            // 输出必要的设置字段和 nonce 字段
            settings_fields( 'myplugin_settings_group' );
            do_settings_sections( 'myplugin-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="ru"/></form>
    </div>
    'myplugin_field_render', // добавляем поле в это поле.
        'myplugin_field_render',
        'myplugin-settings',
        'myplugin_section'
    );
}
add_action( 'admin_init', 'myplugin_settings_init' );

// Рендеринг функции, устанавливающей поле
function myplugin_field_render() {
    $option = get_option( "myplugin_custom_message', 'Hello, visitor!' );
    echo "<input type='text' name='myplugin_custom_message' value='" . esc_attr( $option ) . "' />";
}

// Используйте сохраненную опцию на фронт-энде
function myplugin_display_message() {
    $message = get_option( 'myplugin_custom_message', 'Hello, visitor!' );
    echo '<p class="myplugin-message">' . esc_html( $message ) . '</p>';
}
// Вы можете вызвать эту функцию на фронтенде, например, через шорткод или хук:
add_action( 'wp_footer', 'myplugin_display_message' );

Безопасность плагинов, их интернационализация и подготовка к публикации

Разработанные плагины перед выпуском должны пройти тщательную проверку на безопасность, интернационализацию и упаковку.

Безопасность является главным приоритетом. Все данные, полученные из пользовательского ввода (например, $_GET, $_POST, $_REQUEST), должны быть проверены и очищены. WordPress предоставляет богатый набор функций, таких как sanitize_text_field(), esc_html(), esc_url() и wp_strip_all_tags() Используется для экранирования перед выводом. Никогда не доверяйте вводу пользователя.

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

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

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

Для того чтобы плагин мог использоваться пользователями по всему миру, необходимо подготовить его к интернационализации (i18n). Это означает, что все текстовые строки, выводимые в плагине, должны быть интернационализированы с помощью функции __() или _e() и т.п. функции обернуты и установлен текстовый домен. Таким образом, переводчики могут использовать файлы .po/.mo для перевода вашего плагина.

Наконец, необходимо тщательно прописать файл readme.txt, который должен быть отформатирован в соответствии со спецификацией WordPress.org. Убедитесь, что код вашего плагина соответствует стандартам кодирования WordPress, удалите весь отладочный код и сожмите его в zip-файл. Вы можете распространять его в официальном каталоге плагинов WordPress или на своем личном сайте.

резюме

Разработка плагинов WordPress - это процесс объединения творчества с мощной платформой. Начав с понимания ее важности, мы шаг за шагом создавали среду и конструировали базовые файлы плагина. Благодаря углубленному изучению и отработке двух основных механизмов - крючков действий и крючков фильтров - мы освоили ключ к взаимодействию с WordPress. Затем на практических занятиях был создан полноценный плагин со страницей управления бэкендом, охватывающий весь процесс добавления меню, регистрации настроек, работы с безопасностью данных и отображения фронтенда. Наконец, мы рассмотрели ключевые штрихи, которые влияют на качество и распространение плагина: методы обеспечения безопасности, подготовка к интернационализации и упаковка релиза. Следуя этим шагам и лучшим практикам, вы сможете создавать плагины WordPress профессионального уровня, мощные, безопасные, надежные и легко распространяемые, тем самым по-настоящему раскрывая неограниченный потенциал WordPress.

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

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

Вам необходимо иметь базовые знания языка программирования PHP, поскольку ядро WordPress и его плагины написаны на PHP. Также необходимо базовое понимание HTML, CSS и JavaScript для работы с внешним представлением и взаимодействием. Понимание основных концепций базы данных MySQL (например, запрос, добавление, удаление, изменение) также поможет, поскольку WordPress использует ее для хранения данных.

Должен ли главный файл плагина иметь определенное имя

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

В чем принципиальная разница между крючками действий и крючками фильтров

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

Как сделать так, чтобы мой плагин не конфликтовал с другими плагинами

Добавление уникальных префиксов ко всем именам функций, классов, констант и опций - лучшая практика для предотвращения конфликтов. Например, не используйтеget_data()Вместо общих имен функций, таких какmyplugin_get_data(). Кроме того, инкапсуляция кода в классах или пространствах имен позволяет более эффективно изолировать переменные и функции.