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

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

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

Основные концепции разработки плагинов для WordPress

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

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

<?php
/**
 * Plugin Name: 我的第一个插件
 * Description: 这是一个用于演示的简单WordPress插件。
 * Version: 1.0.0
 * Author: 你的名字
 */

Как только этот файл будет размещен… /wp-content/plugins/ В каталоге страница “Плагины” в области управления WordPress автоматически распознает этот плагин и отображает его в списке.

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

Механизм работы плагинов основан на двух ключевых концепциях: хуках действий (Action Hooks) и хуках фильтров (Filter Hooks). Хуки действий позволяют вставлять собственный код в определенные моменты выполнения WordPress-системы — например, после публикации статьи или перед загрузкой стилей страницы. Для этого используются функции. add_action() Вашу функцию можно “загрузить” (монтировать) на эти хук-механизмы. Хук-механизмы для фильтров позволяют вам изменять данные перед их использованием или сохранением в базе данных — например, изменять содержимое статей, их заголовки или извлечения. Это достигается с помощью специальных инструментов, предназначенных для работы с такими процессами. add_filter() Реализация функций с использованием системы хуков (hooks) является важным шагом на пути от обычного пользователя WordPress к разработчику. Понимание и умелое применение этой системы позволяет эффективно расширять возможности сайта и улучшать его работу.

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

Создание вашего первого функционального плагина

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

Во-первых, в вашей локальной или тестовой среде… /wp-content/plugins/ Создайте новую папку в каталоге и назовите её my-copyright-noticeВ этой папке создайте основной файл плагина. my-copyright-notice.phpИ введите следующий код:

&lt;?php
/**
 * Plugin Name: 文章版权声明
 * Description: 自动在文章内容末尾附加自定义版权声明。
 * Version: 1.0.0
 * Author: 开发者
 */

// 防止直接访问
if ( ! defined( &#039;ABSPATH&#039; ) ) {
    exit;
}

/**
 * 在文章内容后追加版权声明
 */
function mycn_add_copyright_to_content( $content ) {
    // 确保只在主循环的单篇文章中显示
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        $site_url = get_site_url();
        $current_year = date( &#039;Y&#039; );
        // 构建版权文本，这里用 2026 作为示例，实际开发可动态获取
        $copyright_text = sprintf(
            &#039;<p><em>© 2026 %s. Данное произведение создано компанией %s. <strong>%s</strong> Авторское произведение; при перепечатке обязательно укажите источник.</em></p>',
            esc_html( get_bloginfo( 'name' ) ),
            esc_url( $site_url )
        );
        $content .= $copyright_text;
    }
    return $content;
}
// 将函数挂载到 ‘the_content’ 过滤器
add_filter( 'the_content', 'mycn_add_copyright_to_content' );

Этот плагин демонстрирует основные способы использования фильтров.mycn_add_copyright_to_content Функция принимает содержимое статьи. $contentПосредством условных проверок обеспечивается добавление информации об авторских правах только на странице отдельной статьи и только в рамках основного запроса. Затем содержимое страницы модифицируется и возвращается пользователю.add_filter( ‘the_content’， ‘mycn_add_copyright_to_content’ ) Этот код выполняет процесс внедрения необходимой функциональности.

Добавить интерфейс управления и настройки для плагина.

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

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

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

Измените свой текст. my-copyright-notice.php В файл добавьте следующий код:

// 添加管理员菜单
function mycn_add_admin_menu() {
    add_options_page(
        '版权声明设置', // 页面标题
        '文章版权',     // 菜单标题
        'manage_options', // 权限
        'my_copyright_notice', // 菜单slug
        'mycn_settings_page_html' // 回调函数，用于输出页面HTML
    );
}
add_action( 'admin_menu', 'mycn_add_admin_menu' );

// 初始化插件的设置
function mycn_settings_init() {
    // 注册一个新的设置项到 ‘mycn_settings’ 组
    register_setting( ‘mycn_settings’, ‘mycn_copyright_text’ );

// 在 ‘mycn_settings’ 组内添加一个设置区块
    add_settings_section(
        ‘mycn_settings_section’,
        ‘自定义版权文本’,
        null, // 可选的区块描述回调函数
        ‘mycn_settings’
    );

// 向区块中添加字段
    add_settings_field(
        ‘mycn_copyright_field’,
        ‘版权声明’,
        ‘mycn_copyright_field_html’,
        ‘mycn_settings’,
        ‘mycn_settings_section’
    );
}
add_action( ‘admin_init’， ‘mycn_settings_init’ );

// 设置字段的HTML输出
function mycn_copyright_field_html() {
    $option = get_option( ‘mycn_copyright_text’， ‘© 2026 [site_name]. 本文原创自 [site_url]。’ );
    ?&gt;
    <textarea name="‘mycn_copyright_text’" rows="‘5’" cols="‘50’"><?php echo esc_textarea( $option ); ?></textarea>
    <p class="“description”">Поддерживаются скрытые обозначения: [site_name] — название веб-сайта, [site_url] — адрес веб-сайта.</p>
    <?php
}

// 设置页面的HTML结构
function mycn_settings_page_html() {
    // 检查用户权限
    if ( ! current_user_can( ‘manage_options’ ) ) {
        return;
    }
    ?>
    <div class="“wrap”">
        <h1></h1>
        <form action="/ru/“options.php”/" method="“post”" data-trp-original-action="“options.php”">
            <?php
            settings_fields( ‘mycn_settings’ );
            do_settings_sections( ‘mycn_settings’ );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="ru"/></form>
    </div>
    &lt;?php
}

Далее нам необходимо внести изменения в предыдущий код. mycn_add_copyright_to_content Функция, которая использует пользовательские настроения (сохраненные пользователем параметры) и заменяет в них содержащиеся укороченные коды.

hosting.com Общий хостинг
Высокая производительность благодаря процессорам AMD EPYC, SSD-накопителям NVMe и LiteSpeed, круглосуточная экспертная поддержка, передовые меры безопасности, включая SSL, защиту от грубой силы, вредоносных программ и DDoS, экономия до 73%
ЛОГОС hosting.com страница доступа 
function mycn_add_copyright_to_content( $content ) {
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        $text = get_option( ‘mycn_copyright_text’， ‘© 2026 [site_name]. 本文原创自 [site_url]。’ );
        $text = str_replace(
            array( ‘[site_name]’， ‘[site_url]’ ),
            array( esc_html( get_bloginfo( ‘name’ ) )， esc_url( get_site_url() ) ),
            $text
        );
        $content .= ‘<p><em>’`wp_kses_post($text);`‘</em></p>’;
    }
    return $content;
}

Теперь пользователи могут увидеть подменю “Авторские права на статьи” в меню “Настройки” в бэкенде WordPress и настроить текст объявления об авторских правах по своему усмотрению.

Лучшие практики по безопасности, отладке и интернационализации плагинов

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

Безопасность: никогда не доверяйте вводимым пользователями данным. Все данные, поступающие от пользователей, из базы данных или через сторонние API, должны быть соответствующим образом обработаны (эскапированы или очищены) перед тем, как их отображать на экране, вводить в базу данных или использовать для работы с файлами. WordPress предоставляет множество функций для обеспечения безопасности, включая механизмы обработки HTML-кода. esc_html()Для использования с URL-адресами… esc_url()Использование для HTML-атрибутов esc_attr()Когда необходимо разрешить использование некоторых безопасных HTML-тегов, следует применять соответствующие меры безопасности. wp_kses_post() или wp_kses()В начале плагина обязательно используйте… if ( ! defined( ‘ABSPATH’ ) ) exit; Это сделано для предотвращения прямого доступа к файлам.

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

Отладка: В процессе разработки включается функция отладки программы. WP_DEBUG Константы играют чрезвычайно важную роль. В вашем коде… wp-config.php Настройки, заданные в файле define( ‘WP_DEBUG’， true);Это отобразит все ошибки, предупреждения и уведомления PHP на экране (только в разработческой среде). Кроме того, это можно использовать в сочетании с другими инструментами или настройками. error_log() Функции, а также отладочные инструменты вроде Query Monitor, могут значительно помочь в отслеживании переменных и SQL-запросов.

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

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

Например, измените информацию о предыдущем плагине на следующее:

/**
 * Plugin Name: 文章版权声明
 * Description: 自动在文章内容末尾附加自定义版权声明。
 * Version: 1.0.0
 * Author: 开发者
 * Text Domain: my-copyright-notice
 */

В коде переводимые строки обозначаются с помощью . __( ‘string’， ‘text-domain’ ) или _e( ‘string’， ‘text-domain’ ) Функциональные оболочки (function wrappers). Например, при настройке функций на страницах:

function mycn_settings_page_html() {
    if ( ! current_user_can( ‘manage_options’ ) ) {
        return;
    }
    ?&gt;
    <div class="“wrap”">
        <h1><?php echo esc_html( __( ‘版权声明设置’， ‘my-copyright-notice’ ) ); ?></h1>
        ...
    </div>
    &lt;?php
}

Затем вы можете использовать такой инструмент, как Poedit, чтобы извлечь эти строки и использовать их для создания нужного результата. .pot Шаблонный файл, предназначенный для создания переводов. .po/.mo Языковой файл.

резюме

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

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

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

Вам необходимы хорошие знания PHP-программирования, поскольку плагины в основном написаны на этом языке. Кроме того, важно иметь базовое понимание HTML, CSS и JavaScript для создания пользовательского интерфейса и управления его отображением. Крайне важно освоить основы архитектуры WordPress, включая темы, типы статей, систему категорий, а также систему действий (actions) и фильтров (filters).

Как начать отладку не работающего плагина?

Во-первых, в вашем… wp-config.php Функция включена в файл. WP_DEBUG и WP_DEBUG_LOGЭто позволит записывать сообщения об ошибках в файл журнала, а не отображать их посетителям. Во-вторых, убедитесь, что ваш плагин активирован. Затем проверьте синтаксис кода и проверьте, что все имена функций, имена хуков (hooks) и пути к файлам корректны. Используйте… var_dump() или error_log() Вы можете вывести значения ключевых переменных или установить профессиональные диагностические плагины для WordPress (например, Query Monitor), чтобы облегчить выявление проблем.

Куда следует разместить мой плагин?

Ваш плагин должен быть размещен в каталоге установки WordPress. /wp-content/plugins/ Файл находится внутри папки. Вы можете напрямую создать PHP-файл в этой папке (это подходит для минималистичных плагинов), однако более стандартным способом будет создание отдельной папки для вашего плагина и размещение в ней основного файла плагина, а также других ресурсов (JS-файлов, CSS-файлов, изображений и т. д.). Названия папки и основного PHP-файла должны быть уникальными, чтобы избежать конфликтов с другими плагинами.

Как отправить свой плагин в официальный каталог плагинов WordPress?

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

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

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

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

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

Теги.