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

Подготовка и настройка окружения

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

Выбор и настройка локальной среды разработки

Самым важным шагом является создание локального сервера, в котором интегрированы PHP, MySQL, а также серверы Apache/Nginx. Вы можете выбрать любой из доступных вариантов для реализации этого.MAMP、XAMPPТакие интегрированные пакеты обеспечивают простой способ установки как для Windows, так и для macOS. Для более опытных пользователей доступны дополнительные настройки и возможности использования.DockerКонтейнеризация вашей среды разработки является современной наилучшей практикой, поскольку она обеспечивает единообразие среды и упрощает её копирование. Независимо от выбранного способа, убедитесь, что версия PHP соответствует стандартам, требуемым вашими плагинами (например, PHP 7.4 и выше), и что необходимые PHP-расширения (такие как MySQLi или PDO) активированы.

Установите и настройте WordPress.

После настройки локальной серверной среды вам необходимо установить основную часть системы WordPress (корень WordPress). Скачайте последнюю стабильную версию с официального сайта WordPress.org, распакуйте её в корневой каталог веб-директории вашего сервера (например, в директорию `/www`).htdocsилиwwwФайл должен находиться в одной из папок, расположенных в указанном пути. Затем откройте эту папку в браузере и выполните настройки согласно известным “пяти минутным инструкциям по установке”. Рекомендуется создать специальную базу данных для разработки плагинов и запомнить её имя, имя пользователя и пароль. После установки перейдите в интерфейс WordPress и измените стандартную структуру фиксированных ссылок на нестандартный формат (например, на название статьи). Это поможет проверить совместимость плагина с постоянными ссылками (перманентными ссылками).

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

Рекомендации по необходимым инструментам для разработки

Эффективное развитие программного обеспечения невозможно без подходящих инструментов. Во-первых, вам понадобится редактор кода — например, бесплатный и мощный редактор, который обладает всеми необходимыми функциями для работы с программным кодом.Visual Studio CodeУстановите плагины, подходящие для PHP, WordPress и функций интеллектуального распознавания кода, а также инструменты для управления версиями программного обеспечения.GitЭто инструменты, необходимые для управления изменениями в коде и ведения истории изменений. Рабочие инструменты браузеров (Chrome DevTools или Firefox Developer Edition) играют ключевую роль в отладке кода на стороне пользовательского интерфейса (frontend). Наконец, рассмотрите возможность установки инструмента для проверки качества кода.PHP_CodeSnifferколлокацияWordPress-Coding-StandardsНабор правил, который поможет вам соблюдать официальные стандарты кодирования WordPress.

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

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

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

Основная структура плагина и ключевые файлы

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

Основная структура главного файла и его функции

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

<?php
/**
 * Plugin Name:       我的首个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于演示的WordPress插件。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

// 防止直接文件访问
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

Plugin NameЭто единственное обязательное поле, используемое для отображения списка плагинов в бэкенде. Рекомендуется его определить.ABSPATHНеобходимо проверить систему, чтобы предотвратить прямой доступ злонамеренных пользователей к ключевым файлам плагина.

Для добавления функционального основного кода в плагин…

После добавления комментариев в начале файла вы можете приступить к написанию кода, реализующего функционал плагина. Самый простой пример — это добавление сообщения “Hello World” в интерфейс административной панели. Для этого вы можете воспользоваться соответствующими инструментами и методами, предоставленными системой.add_actionХук позволяет подключить пользовательский функционал к определённым точкам выполнения кода в WordPress.

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

/**
 * 在管理后台顶部显示欢迎信息
 */
function myfp_display_admin_notice() {
    echo '<div class="notice notice-success is-dismissible"><p>Добро пожаловать к использованию моего первого плагина!</p></div>';
}
add_action( 'admin_notices', 'myfp_display_admin_notice' );

Для поддержания организованности кода и предотвращения конфликтов в названиях все функции и классы должны использовать уникальные префиксы.myfp_(Аббревиатура от «My First Plugin»).

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

Плагин с более сложными функциями обычно состоит из нескольких файлов. Рациональная структура каталогов значительно повышает удобство его обслуживания и сопровождения. Распространенные способы организации файлов в плагинах включают следующее:
- /assets/Здесь хранятся статические ресурсы, такие как CSS-файлы, JavaScript-код, изображения и шрифты.
- /includes/Здесь хранятся основные PHP-классы и файлы с функциями.
- /admin/Здесь хранятся файлы на языке PHP, CSS и JS, которые относятся исключительно к интерфейсу администратора.
- /public/Здесь хранятся файлы, связанные с пользовательским интерфейсом веб-сайта.
- /languages/Место для хранения файлов с международными переводами (.po, .mo).

Всегда помните, что основной файл плагина находится в корневой директории плагина. При ссылке на ресурсные файлы в коде следует использовать соответствующие пути.plugin_dir_url( FILE )илиplugin_dir_path( FILE )Необходимо динамически получить правильный URL или путь к серверу.

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

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

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

Механизм хуков взаимодействует с основными API (Application Programming Interfaces).

Душой разработки плагинов для WordPress является механизм так называемых “хуков” (Hooks). Этот механизм позволяет вставлять ваш код в определенные моменты работы ядра системы, тем или других плагинов и выполнять его там.

Понимание действий-хуков (action hooks) и фильтров-хуков (filter hooks)

Хаки делятся на две основные категории: действия (Action) и фильтры (Filter). Действия-хаки используются для выполнения вашего кода при наступлении определенного события, например, после публикации статьи или перед загрузкой страницы. Они не возвращают никаких значений, а просто выполняют свою функцию. Основной функцией, используемой в таких случаях, является…add_action()иdo_action()Фильтровые хенки (filter hooks) предназначены для изменения данных. Вы можете перехватить данные перед их использованием, сохранением или отображением и внести в них необходимые изменения. При этом фильтровый хенк обязан возвращать определенное значение. Основной функцией, используемой в этом контексте, является…add_filter()иapply_filters()。

Подключение пользовательских функций к стандартным хукам

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

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

// 使用过滤器修改文章内容
function myfp_add_copyright_to_content( $content ) {
    if ( is_single() ) {
        $copyright_text = '<p><em>При перепечатке обязательно укажите источник.</em></p>';
        $content .= $copyright_text;
    }
    return $content;
}
add_filter( 'the_content', 'myfp_add_copyright_to_content' );

// 使用动作在文章保存时执行操作
function myfp_log_post_publish( $post_id ) {
    // 记录日志或执行其他后处理
    error_log( "文章 ID {$post_id} 已发布。" );
}
add_action( 'publish_post', 'myfp_log_post_publish' );

Создание и предоставление пользовательских хуков (custom hooks) для расширения функционала системы

Хорошо спроектированный плагин также должен позволять другим разработчикам его расширять. Вы можете это сделать, создав собственные пользовательские хэнки (custom hooks). Это не только демонстрирует открытость архитектуры плагинов, но и соответствует философии самого WordPress.

// 定义一个自定义动作钩子
function myfp_process_data() {
    $data = '一些初始数据';
    // 其他开发者可以通过 ‘myfp_before_action’ 在此处插入代码
    do_action( 'myfp_before_action', $data );

// 插件的主要处理逻辑...

// 其他开发者可以通过 ‘myfp_after_action’ 在此处插入代码
    do_action( 'myfp_after_action', $data );
}

// 定义一个自定义过滤器钩子
function myfp_get_output() {
    $output = '默认输出';
    // 允许其他开发者过滤最终的输出
    return apply_filters( 'myfp_filter_output', $output );
}

Создание интерфейса управления плагинами и настройочных параметров

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

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

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

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

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

WordPress API для настроек представляет собой безопасную систему для обработки форм, проверки данных, их хранения и отображения пользователю. Он автоматически обрабатывает защитные поля типа nonce и выполняет проверки прав доступа. Основные шаги для создания страницы настроек включают в себя: 1) регистрацию новой настройки, 2) добавление блоков для хранения настроек и 3) добавление отдельных полей для ввода пользовательских данных. Приведённый ниже код демонстрирует, как зарегистрировать простую настройку:

function myfp_register_settings() {
    register_setting(
        'myfp_settings_group', // 选项组名
        'myfp_option_name',    // 选项名（存储在wp_options表中）
        array( 'sanitize_callback' => 'myfp_sanitize_callback' ) // 消毒回调函数
    );

add_settings_section(
        'myfp_settings_section', // 区块ID
        '基本设置',               // 区块标题
        'myfp_section_callback', // 区块回调函数（可输出描述）
        'myfp-settings-page'     // 设置页面Slug
    );

add_settings_field(
        'myfp_text_field',      // 字段ID
        '示例文本输入',         // 字段标签
        'myfp_text_field_callback', // 字段回调函数（输出HTML表单域）
        'myfp-settings-page',   // 页面Slug
        'myfp_settings_section' // 所属区块ID
    );
}
add_action( 'admin_init', 'myfp_register_settings' );

Создание страниц меню и подменю в различных местах сайта

Вам необходимо добавить ссылку на страницу настроек в меню управления WordPress. Для этого выполните следующие шаги:add_menu_page()Можно создать верхний уровень меню (топ-меню) и использовать его для организации структуры интерфейса.add_submenu_page()Можно создавать подменю (подменю).

function myfp_add_admin_menu() {
    // 添加顶级菜单
    add_menu_page(
        '我的插件设置',        // 页面标题
        '我的插件',            // 菜单标题
        'manage_options',     // 权限能力
        'myfp-settings-page', // 菜单Slug
        'myfp_render_settings_page', // 渲染页面的回调函数
        'dashicons-admin-generic', // 图标（可选）
        80                    // 菜单位置
    );

// 添加子菜单（指向同一个页面，但菜单标题不同）
    add_submenu_page(
        'myfp-settings-page', // 父菜单Slug
        '关于此插件',         // 页面标题
        '关于',              // 菜单标题
        'manage_options',    // 权限能力
        'myfp-about-page',   // 菜单Slug
        'myfp_render_about_page' // 渲染回调
    );
}
add_action( 'admin_menu', 'myfp_add_admin_menu' );

Корректирующая (обратная) функция для отображения страницы с пользовательскими настройками

myfp_render_settings_pageФункция-обратный вызов отвечает за формирование HTML-структуры страницы настройок. Внутри этой функции необходимо выполнить соответствующие вызовы (то есть использовать нужные методы или функции для генерации HTML-кода).settings_fields()иdo_settings_sections()Выполните вывод полей, зарегистрированных с помощью API настроек (Settings API).

function myfp_render_settings_page() {
    // 检查用户权限
    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( 'myfp_settings_group' );
            do_settings_sections( 'myfp-settings-page' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="ru"/></form>
    </div>
    &lt;?php
}

резюме

Разработка плагинов для WordPress – это процесс превращения идей в функциональные решения. Ее успех зависит от четкого понимания основной структуры системы, умелого использования механизмов взаимодействия между различными компонентами («хаков»), а также постоянного внимания к вопросам безопасности и пользовательского опыта. Начиная с создания среды разработки и написания основных файлов плагина, через интеграцию с системой с помощью специальных механизмов (акций и фильтров), и до создания профессионального интерфейса управления с использованием API, каждый шаг выполняется в соответствии с установленными стандартами и рекомендациями. Ключевыми аспектами являются модульность, читаемость и расширяемость кода; использование уникальных префиксов для предотвращения конфликтов между компонентами, а также приоритет безопасности. Благодаря изучению и практике по этому руководству вы теперь способны создавать полнофункциональные плагины для WordPress, соответствующие всем стандартам.

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

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

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

Существует несколько способов настройки и отладки плагинов. Во-первых,wp-config.phpФайл открыт в приложенииWP_DEBUGиWP_DEBUG_LOGЭто позволит записывать ошибки и предупреждения PHP в соответствующий файл./wp-content/debug.logФайлы хранятся внутри системы и не отображаются пользователю на переднем интерфейсе. Для отладки JavaScript-кода и сетевых запросов используйте инструменты разработчика браузера (например, Chrome DevTools). Для более сложных логических операций могут применяться дополнительные методы отладки.var_dump()илиerror_log()Функции могут выводить значения переменных в логи или на страницу. Кроме того, установка профессиональных дебаггеров PHP, таких как Xdebug, и их интеграция с вашим кодовым редактором позволяют использовать функцию остановки выполнения программы на определённых точках (дебагging with breakpoints) – это наиболее эффективный способ отладки кода.

Как моему плагину реализовать многоязычную интернационализацию?

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

Как бесплатно разместить свой плагин в официальном каталоге плагинов WordPress?

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