Углублённый анализ разработки плагинов для WordPress: создание вашего первого функционального расширения с нуля до готового продукта.

Первое знакомство с разработкой плагинов для WordPress.

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

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

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

Создание базовой структуры файлов.

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

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

Напишите заголовок плагина.

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

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

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

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

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

Реализовать простую функцию.

Теперь давайте добавим в этот плагин практическую функцию: автоматическое добавление фрагмента пользовательского текста в конец всех статей на сайте. Для этого мы будем использоватьthe_contentЭтоFilter Hook(Хук фильтра).

// 在插件主文件头部信息之后添加以下代码
function myfp_add_footer_text( $content ) {
    // 确保只在主循环的单篇文章页面添加
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $custom_text = '<p><em>Спасибо, что прочитали эту статью. Она представлена вам проектом “Мой первый плагин”.</em></p>'Функция myfp_add_footer_text принимает два параметра: $content — текущий контент и $custom_text — пользовательский текст. Если пользовательский текст не задан, он возвращает нулевой результат. В противном случае он заменяет текущий контент на пользовательский текст и возвращает его.  

function myfp_add_footer_text( $content, $custom_text ) {  
    if ( !$custom_text ) {  
        return $content;  
    }  
    $content = $custom_text;  
    return $content;  
}
// Привязываем нашу функцию к фильтру ‘the_content' с приоритетом 10  
add_filter( 'the_content', 'myfp_add_footer_text' );

Поймите основные понятия: хуки и API.

Хокки действий и хокки фильтров

Архитектура плагинов WordPress построена вокруг двух основных хуков:Action Hooks(Триггеры действий) иFilter Hooks(Фильтры-хуки). Хуки действий позволяют выполнять пользовательский код в определённые моменты (например, при публикации статьи или загрузке страницы). Используйтеadd_action()Функция для монтирования. Хуки фильтров позволяют вам изменять данные (например, содержание статьи, заголовок, аннотацию) перед их выводом на экран, используяadd_filter()Они используются для обработки данных. Основное различие между ними заключается в том, что фильтры должны возвращать изменённое значение, в то время как действия обычно не возвращают никакого значения.

Приложение для основного API WordPress.

WordPress предлагает широкий выборAPIчтобы безопасно выполнять обычные задачи. Например,Options APIИспользуется для хранения и извлечения настроек плагинов в базе данных;Settings APIЭто поможет вам создать стандартизированную страницу настроек в административной панели;Database API\n(В основном)$wpdbКлассы предоставляют безопасный способ взаимодействия с базой данных. Умелое использование этих классов позволит вам эффективно работать с базой данных.APIВместо того, чтобы напрямую писать SQL-запросы или работать с глобальными переменными, разработка стабильных и безопасных плагинов должна основываться на других принципах.

\nСоздание интерфейса управления плагинами.

Создать пункт меню "Администрирование".

Чтобы пользователи могли настроить ваш плагин, обычно необходимо добавить меню в административной панели WordPress. Это можно сделать с помощьюadd_menu_page()илиadd_options_page()Ожидаем реализации функции. Пример кода ниже демонстрирует, как добавить подменю на странице главного меню “Настройки”:

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

function myfp_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',              // 菜单标题
        'manage_options',        // 所需权限
        'my-first-plugin',       // 菜单slug
        'myfp_display_settings_page' // 用于输出页面内容的回调函数
    );
}
add_action( 'admin_menu', 'myfp_add_admin_menu' );

Настройка полей и сохранение данных.

Далее вам необходимо определитьmyfp_display_settings_pageФункция для отображения страницы настроек и её использования.Settings APIРегистрационное поле. Это связано с использованиемregister_setting(), add_settings_section()иadd_settings_field()и другие функции. Это обеспечивает автоматическую обработку проверки данных, проверки безопасности nonce и управления правами пользователей, что намного эффективнее ручной обработки.$_POSTДанные должны быть гораздо более безопасными и надежными.

Выпуск плагинов и лучшие практики

Безопасность кода и интернационализация.

Безопасность является главным приоритетом при разработке плагинов. Всегда проверяйте и очищайте пользовательские вводы, а также экрабируйте выводы в базу данных. Используйтеwp_verify_nonce()иcheck_admin_referer()Чтобы предотвратить атаки CSRF. Кроме того, для подготовки плагина к локализации (i18n) используйте__()и_e()Эта функция обертывает все видимые для пользователя строки, чтобы их можно было перевести.

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

Избегайте выполнения ненужных запросов к базе данных или загрузки ресурсов в плагинах. Используйте их разумно.wp_enqueue_script()иwp_enqueue_style()Загрузите скрипты и стили и убедитесь, что они загружаются только на тех страницах, где это необходимо. Рассмотрите возможность использованияTransients APIЧтобы кэшировать результаты операций, требующих много времени.

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

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

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

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

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

резюме

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

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

Как отладить мой плагин для WordPress?

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

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

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

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

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

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

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

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

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

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

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