рис. начало/связанные со знаниями/WordPress/Содержание Подробности

Полное руководство по разработке плагинов для WordPress: создание профессиональных PHP-плагинов с нуля.

3-минутное чтение
2026-03-13
2026-06-05
2,064
Я получаю комиссионные, когда вы совершаете покупки по ссылкам ниже, без дополнительных затрат для вас.

Основная структура и файлы плагинов для WordPress

Стандартный плагин для WordPress должен содержать по меньшей мере один главный файл. Этот файл обычно называется так же, как и сам плагин. Например: my-first-plugin.phpВ начале этого файла должна быть содержаться специальная заголовочная строка (аннотация), предназначенная для сообщения системе WordPress о метаданных плагина. К этим данным относятся название плагина, описание, версия, автор и другая информация, которая будет отображаться на странице управления плагинами в бэкенде.

Помимо основного файла, полнофункциональный плагин обычно включает в себя другие каталоги и файлы для организации кода. Распространенной структурой каталогов является наличие отдельных разделов для хранения файлов CSS и JavaScript./assetsКаталог, содержащий файлы PHP-классов/includesКаталог, а также материалы, используемые для шаблонов пользовательского интерфейса./templatesКаталог. Такая модульная структура облегчает обслуживание кода и сотрудничество в команде.

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

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

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

Давайте начнем с создания самого простого плагина “Hello World”, чтобы ознакомиться с процессом создания плагинов и их основным жизненным циклом.

Ультахост (UltaHost) – хостинг-провайдер, предоставляющий услуги хостинга для сайтов, построенных на платформе WordPress.
Гарантия возврата средств в течение 30 дней, неограниченная пропускная способность интернет-канала и объем баз данных, бесплатная защита от DDoS-атак. При покупке на срок 3 лет предоставляется скидка в размере 501 ТБ до 4 ТБ.
UltaHost ЛОГО страница доступа

Определение информации о плагинах и основной функции

Во-первых, в каталоге установки WordPress на вашем компьютере…/wp-content/plugins/В пути создайте новую папку с названием “hello-world”. Внутри этой папки создайте файл с названием… (название файла не указано в исходном тексте).hello-world.phpФайл.

В начале этого файла необходимо добавить информацию о заголовке плагина. Типичный заголовок плагина выглядит следующим образом:

<?php
/**
 * Plugin Name:       你好世界示例插件
 * Plugin URI:        https://yourwebsite.com/hello-world
 * Description:       这是一个用于演示的简单WordPress插件。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       hello-world
 * Domain Path:       /languages
 */

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

function hello_world_add_footer_text( $content ) {
    // 仅在单篇文章页面添加
    if ( is_single() ) {
        $footer_text = '<p><em>Данный текст был создан с помощью плагина “Hello World”.</em></p>';
        $content .= $footer_text;
    }
    return $content;
}
add_filter( 'the_content', 'hello_world_add_footer_text' );

Обработка активации и деактивации плагинов

Профессиональные плагины должны правильно обрабатывать логику активации и деактивации. Например, при активации плагина могут потребоваться создание таблиц в базе данных или настройка параметров по умолчанию; при деактивации – удаление временных данных. Мы используем…register_activation_hookиregister_deactivation_hookФункция предназначена для регистрации соответствующих хуков (hook functions).

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

Добавьте этот код в основной файл.

// 插件激活时执行的操作
function hello_world_activate() {
    // 例如：添加一个选项到数据库
    if ( ! get_option( 'hello_world_installed' ) ) {
        add_option( 'hello_world_installed', time() );
    }
    // 可以在这里刷新固定链接规则，以确保新注册的URL结构生效
    flush_rewrite_rules();
}
register_activation_hook( __FILE__, 'hello_world_activate' );

// 插件停用时执行的操作
function hello_world_deactivate() {
    // 例如：删除我们创建的临时选项（谨慎操作，用户数据通常不删除）
    // delete_option( 'hello_world_installed' );
    // 清理重写规则
    flush_rewrite_rules();
}
register_deactivation_hook( __FILE__, 'hello_world_deactivate' );

После выполнения вышеуказанных шагов вы сможете увидеть и активировать плагин “Пример плагина ”Здравствуй, мир!“” на странице «Плагины» в меню административной панели WordPress. После активации, при просмотре любой статьи, вы увидите добавленный текст в нижней части её содержимого.

Использование основного API WordPress для расширения функционала

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

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

Использование действий-хуков и фильтров

Акционные хуки (Action Hooks) позволяют вам в определенные моменты времени вставлять и выполнять собственный код. Например, когда статья публикуется, WordPress запускает соответствующие хуки.save_postДействия. Вы можете выполнить их следующим образом:add_action()Функция монтирует свою собственную функцию на этот хук (hook).

function hello_world_on_post_publish( $post_id, $post, $update ) {
    // 检查是否不是修订版本，并且是发布操作
    if ( wp_is_post_revision( $post_id ) || $post->post_status != 'publish' ) {
        return;
    }
    // 发送邮件通知或执行其他逻辑
    // wp_mail( '[email protected]', '新文章已发布', '文章标题：' . $post->post_title );
}
add_action( 'save_post', 'hello_world_on_post_publish', 10, 3 );

Фильтровые хуки (Filter Hooks) позволяют вам изменять данные.the_contentПримером типичного применения фильтров может служить система обработки данных. Еще одним распространенным примером является изменение заголовков статей.

function hello_world_modify_title( $title ) {
    return '【推荐】' . $title;
}
// add_filter( 'the_title', 'hello_world_modify_title' ); // 谨慎使用，这会修改所有标题

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

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

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

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

// 步骤1：向管理后台添加一个菜单项
function hello_world_add_admin_menu() {
    add_menu_page(
        '你好世界设置',       // 页面标题
        '你好世界插件',       // 菜单标题
        'manage_options',     // 所需权限
        'hello-world-settings', // 菜单slug
        'hello_world_settings_page', // 用于渲染页面的回调函数
        'dashicons-admin-generic', // 图标（可选）
        80                    // 菜单位置
    );
}
add_action( ‘admin_menu‘， ‘hello_world_add_admin_menu’ );

// 步骤2：定义设置页面的HTML内容
function hello_world_settings_page() {
    ?&gt;
    <div class="”wrap”">
        <h1>Настройки плагина “Hello World”</h1>
        <form method="”post”" action="/ru/”options.php”/" data-trp-original-action="”options.php”">
            <?php
                settings_fields( ‘hello_world_settings_group’ ); // 输出设置字段和非ce字段
                do_settings_sections( ‘hello-world-settings’ ); // 输出设置部分
                submit_button(); // 输出提交按钮
            ?>
        <input type="hidden" name="trp-form-language" value="ru"/></form>
    </div>
    &lt;?php
}

// 步骤3：注册设置、字段和章节
function hello_world_settings_init() {
    // 注册一个新的设置项到“hello_world_settings_group”组
    register_setting( ‘hello_world_settings_group’， ‘hello_world_custom_message’ );

// 在页面中新增一个章节
    add_settings_section(
        ‘hello_world_settings_section’,
        ‘自定义消息设置’，
        ‘hello_world_settings_section_callback’，
        ‘hello-world-settings‘
    );

// 向章节中添加一个字段
    add_settings_field(
        ‘hello_world_message_field’,
        ‘前台显示的消息’，
        ‘hello_world_message_field_render’，
        ‘hello-world-settings’,
        ‘hello_world_settings_section’
    );
}
add_action( ‘admin_init’， ‘hello_world_settings_init’ );

// 章节描述的回调函数
function hello_world_settings_section_callback() {
    echo ‘<p>Здесь вы можете настроить содержимое сообщений, которые отображаются на фронтенде с помощью плагина.</p>’;
}

// 字段渲染的回调函数
function hello_world_message_field_render() {
    $option = get_option( ‘hello_world_custom_message’， ‘这是默认消息’ );
    echo ‘<input type="”text”" name="”hello_world_custom_message”" value="”‘" . esc_attr( $option ) ‘“ size ="”40”" />’;
}

С помощью приведённого кода на сервере была создана страница настроек, соответствующая стандартам WordPress и обеспечивающая безопасное хранение данных.

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

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

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

Следуйте лучшим практикам безопасности.

Безопасность является главным приоритетом при разработке плагинов. Основное правило заключается в следующем: никогда не доверяйте вводимым пользователями данным. Все данные, поступающие от пользователей или из внешних источников, должны подвергаться тщательной проверке на наличие вредоносного кода или других угроз.$_GET， $_POST， $_COOKIEПеред использованием в запросах к базе данных, выводе на страницу или выполнении системных команд все данные необходимо проверить, очистить или обработать специальными символами (эскапировать).

Для контента, выводимого в HTML, используйте следующие методы/инструменты:esc_html()， esc_attr()илиwp_kses_post()Необходимо экранировать такие функции, как print и input.

эхо ‘<div class="”“‘" . esc_attr( $user_provided_class ) ‘“>’. esc_html($user_provided_content)‘.‘</div>’;

При выполнении запросов к базе данных ни в коем случае не следует непосредственно объединять значения переменных с текстом SQL-запроса. Для этого необходимо использовать специальные методы или конструкции, обеспечивающие безопасность и надежность работы с данными.$wpdb->prepare()Метод используется для предварительной обработки данных.

global $wpdb;
$user_id = 123;
$query = $wpdb->prepare(
    “SELECT * FROM {$wpdb->prefix}my_table WHERE user_id = %d”，
    $user_id
);
$results = $wpdb->get_results( $query );

Кроме того, все доступные для пользователей функции обратного вызова (будь то через AJAX на фронте или через бэкенд-операции) должны использовать определенные стандарты или протоколы для обмена данными.current_user_can()илиcheck_ajax_referer()Функции, используемые для проверки прав доступа и безопасности.

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

Плагины с плохой производительностью могут негативно сказаться на пользовательском опыте всего веб-сайта. Оптимизация может быть проведена с нескольких сторон: рациональное использование кэша, избежание выполнения сложных запросов к базе данных или удаленным API-сервисам при каждом загрузке страницы. WordPress предоставляет функции, позволяющие использовать так называемые «мгновенные API» (instant APIs).（Transients API）Это позволяет удобно хранить временные данные.

// 尝试从缓存获取数据
$data = get_transient( ‘my_plugin_expensive_data’ );
if ( false === $data ) {
    // 缓存中没有，执行昂贵操作
    $data = expensive_database_query();
    // 将结果缓存12小时
    set_transient( ‘my_plugin_expensive_data’， $data， 12 * HOUR_IN_SECONDS );
}

Во-вторых, убедитесь, что файлы CSS и JavaScript загружаются только на тех страницах, где они действительно необходимы. Для этого можно использовать такие методы, как условная загрузка или использование технологий, позволяющих контролировать процесс загрузки ресурсов.wp_enqueue_script()иwp_enqueue_style()Функции позволяют точно контролировать процесс загрузки ресурсов и управлять их взаимозависимостями. Что касается ресурсов, используемых на серверной стороне, их можно монтировать (то есть добавлять в систему для использования) в соответствующие места.admin_enqueue_scriptsХук (hook); в случае с ресурсами фронтенда, они монтируются (mount) на соответствующие места.wp_enqueue_scriptsКрючок.

Подготовка к интернационализации и публикации

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

Перевести строки из плагина с:

echo “Hello World!”；

Изменить на:

echo __( ‘Hello World!’, ‘hello-world’ );

среди них‘hello-world’Это вы определили в заголовочном файле плагина.Text DomainЗатем вы можете использовать такие инструменты, как Poedit, для генерации нужного контента..potШаблонный файл, с помощью которого переводчики могут создавать тексты на разных языках..poи.moФайлы. Разместите эти переводные файлы в заголовочном файле плагина.Domain PathУказанный каталог (например…)/languagesПросто нажмите на кнопку «Следующий».

Перед публикацией обязательно подготовьте подробное описание или руководство по использованию продукта.readme.txtФайл должен соответствовать официальным требованиям WordPress и включать описание плагина, инструкции по установке, ответы на часто задаваемые вопросы и другую полезную информацию. Это обязательное условие для подачи плагина в каталог плагинов WordPress. Кроме того, в коде плагина необходимо добавлять подробные PHP-документационные комментарии (DocComments). Это не только поможет другим пользователям лучше понять ваш код, но и подчеркнет ваш профессионализм.

резюме

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

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

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

Для разработки плагинов для WordPress необходимы прочные знания PHP-программирования, поскольку код плагинов в основном состоит из кода на этом языке. Также важно иметь базовое понимание HTML, CSS и JavaScript для работы с пользовательским интерфейсом и взаимодействия с пользователем. Самое важное – хорошо ознакомиться с основными концепциями WordPress, такими как хуки (Hooks), шорткоды (Shortcodes), пользовательские типы статей (Custom Post Types, CPT) и операции с базой данных.$wpdbИспользование…

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

Одним из эффективных методов отладки является включение функций отладки в WordPress.WP_DEBUGРежим… В вашем случае…wp-config.phpВ документе будет указано, что...define( ‘WP_DEBUG’， false );превратиться вdefine( ‘WP_DEBUG’， true );Вы также можете включить несколько функций одновременно.WP_DEBUG_LOGЗаписывайте ошибки в файлы журнала или включите эту функцию.WP_DEBUG_DISPLAYОшибки отображаются на странице (только в разработческой среде). Кроме того, использование инструментов разработчика браузера (вкладки “Консоль”, “Сеть”) является необходимым средством для отладки кода на стороне клиента (JavaScript) и AJAX-запросов.

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

Ключом к обеспечению хорошей совместимости является соблюдение стандартов кодирования WordPress, а также осторожное использование глобальных переменных и имен функций. Лучшей практикой для предотвращения конфликтов в именах является присвоение уникальных префиксов функциям, классам и константам вашего плагина. Например, можно использовать такие префиксы…myplugin_Или используйте аббревиатуры разработчиков в качестве префиксов. При изменении контента, который может влиять на работу других плагинов (например, текста статей, их заголовков), убедитесь, что ваша функция-фильтр имеет соответствующий уровень приоритета.add_filterТретий параметр… Обратите внимание на формат возвращаемого значения. Кроме того, используйте его разумно.class_exists()илиfunction_exists()Чтобы проверить, был ли определён определённый класс или функция, можно реализовать механизм условной загрузки кода или предусмотреть альтернативный вариант его использования.

Необходимо ли владеть принципами объектно-ориентированного программирования (OOP) для разработки плагинов?

虽然使用传统的面向过程编程方式也可以开发功能完整的插件，但强烈推荐学习和使用面向对象编程（OOP）。OOP能够更好地组织代码，通过类（Class）来封装功能，提高代码的可复用性和可维护性。对于中大型插件项目，使用OOP结合命名空间（Namespaces）和自动加载（Autoloading）是行业内的标准做法，它能让你更清晰地区分不同模块，并显著降低代码的耦合度。

Что дальше, что дальше?

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

Расширенное чтение и практические знания

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

Теги.