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

Среда разработки плагинов для WordPress и подготовительные работы.

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

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

Рекомендуется использовать локальную серверную среду, такую как Local by Flywheel, XAMPP или Laragon. Они позволяют быстро создать на локальном компьютере рабочую среду WordPress, включающую Apache/Nginx, MySQL и PHP. Преимущество этого заключается в том, что вы можете свободно тестировать и отлаживать в независимой и безопасной среде, не беспокоясь о том, что это может повлиять на веб-сайт, размещенный в Интернете.

Обязательные инструменты для разработки плагинов.

Помимо серверной среды, вам также понадобится ряд инструментов. Основным является мощный редактор кода или интегрированная среда разработки (IDE), например Visual Studio Code или PhpStorm, которые обеспечивают подсветку синтаксиса, подсказки кода и функции отладки. Кроме того, знание и использование системы контроля версий, такой как Git, крайне важно для управления изменениями кода и совместной работы в команде. Наконец, убедитесь, что ваша локальная версия PHP соответствует целевой производственной среде, чтобы избежать проблем совместимости, вызванных различиями в версиях.

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

Понять базовую структуру плагина.

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

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

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

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

Состав основного файла плагина

Каждый плагин должен иметь главный файл. Этот файл обычно называется именем плагина, например my-awesome-plugin.phpЗаголовок файла должен содержать определённый блок комментариев с информацией о плагине, который будет описывать ваш плагин для WordPress.

/**
 * Plugin Name:       我的强大插件
 * Plugin URI:        https://example.com/my-awesome-plugin
 * Description:       这是一个用于演示插件开发指南的强大定制插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-awesome-plugin
 */

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

Организация кода и модульность.

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

Основная разработка: хуки и API.

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

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

Использование действий-хуков (action hooks)

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

function myplugin_send_notification_on_publish( $post_id ) {
    // 获取文章信息
    $post = get_post( $post_id );
    // 模拟发送邮件通知
    wp_mail( '[email protected]', '新文章已发布！', '文章标题：' . $post->post_title );
}
// 将函数挂载到 `publish_post` 这个动作钩子
add_action( 'publish_post', 'myplugin_send_notification_on_publish' );

Использование фильтрующих хуков

Фильтр-хуки (Filter Hooks) используются для изменения данных. Вы можете изменить значение данных с помощью фильтров, прежде чем они будут использованы (например, при сохранении в базу данных или отображении пользователю). Это делается с помощью add_filter() Это реализовано с помощью функции.

function myplugin_modify_excerpt_length( $length ) {
    // 将文章摘要的默认字数从55改为30
    return 30;
}
add_filter( 'excerpt_length', 'myplugin_modify_excerpt_length' );

Важные глобальные функции API.

Помимо хуков, WordPress предоставляет множество полезных функций API, например, для работы с базой данных. wpdb классы, обрабатывающие опции. get_option() и update_option()создание пользовательских таблиц данных. dbDelta() функции и т. д. Умелое использование этих API является ключом к эффективной разработке.

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

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

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

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

Давайте свяжем вышеуказанные знания с помощью практического примера и создадим простой плагин для “оценки времени чтения статьи”. Этот плагин будет отображать приблизительное время чтения перед содержанием статьи.

\nСоздание плагин-фреймворка и главного файла.

Во-первых, в /wp-content/plugins/ Создайте новую папку в каталоге и назовите её… post-reading-timeВ этой папке создайте главный файл. post-reading-time.phpИ заполните стандартную информацию в заголовке плагина.

Основная функция, вычисляющая и отображающая время чтения.

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

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

function prt_calculate_reading_time( $content ) {
    // 1. 只有在单篇文章页面才生效
    if ( ! is_single() ) {
        return $content;
    }

// 2. 获取文章内容，去除短代码和HTML标签，计算字数
    $text_content = strip_shortcodes( wp_strip_all_tags( $content ) );
    $word_count   = str_word_count( $text_content );

// 3. 假设平均阅读速度为每分钟200字
    $reading_time = ceil( $word_count / 200 );

// 4. 生成显示HTML
    $reading_time_html = sprintf(
        '<div class="post-reading-time"><p><strong>Ожидаемое время чтения:</strong>Около %d минут.</p></div>',
        $reading_time
    );

// 5. 将阅读时间信息放在文章内容之前
    return $reading_time_html . $content;
}
add_filter( 'the_content', 'prt_calculate_reading_time' );

Добавьте простые стили для плагина.

Чтобы сделать отображение более привлекательным, мы можем добавить немного CSS. Хорошей практикой является загрузка стилей по очереди (enqueue). С помощью этого можно добиться того, чтобы стили загружались в нужном порядке и в нужное время. wp_enqueue_style() Функция гарантирует, что таблица стилей загружается правильно и не конфликтует с другими плагинами.

function prt_enqueue_styles() {
    wp_enqueue_style(
        'prt-style',
        plugin_dir_url( __FILE__ ) . 'assets/css/prt-style.css', // 假设CSS文件路径
        array(), // 依赖
        '1.0.0' // 版本号
    );
}
add_action( 'wp_enqueue_scripts', 'prt_enqueue_styles' );

Затем… assets/css/prt-style.css Добавление простого стиля в документ:

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

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

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

.post-reading-time {
    background-color: #f0f8ff;
    border-left: 4px solid #3498db;
    padding: 10px 15px;
    margin-bottom: 20px;
    font-size: 0.95em;
}

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

резюме

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

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

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

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

Как обеспечить безопасность плагина, который я разрабатываю?

Обеспечение безопасности плагинов требует многосторонних усилий. Прежде всего, необходимо тщательно проверять (валидировать), очищать и экранировать (эскейпить) все данные, вводимые пользователями. Для этого следует использовать предоставляемые WordPress функции, такие как sanitize_text_field(), esc_html(), wp_kses_post() и т. д. Во-вторых, при выполнении операций с базой данных обязательно используйте $wpdb Методы класса или prepare() Используйте запросы, чтобы предотвратить SQL-инъекции. Наконец, следуйте принципу минимальных привилегий и предоставляйте плагинам только те возможности, которые необходимы для выполнения их функций.

Можно ли загрузить разработанный мною плагин в официальный каталог WordPress?

Да, но для этого необходимо соблюдать ряд строгих стандартов. Код вашего плагина должен соответствовать стандартам кодирования WordPress, использовать совместимую лицензию GNU GPL v2 или более поздней версии и не содержать вредоносного кода, платных ссылок или контента, нарушающего руководство по каталогу. Перед отправкой рекомендуется внимательно прочитать официальное руководство по разработке плагинов и руководство по отправке, а также провести тщательную самопроверку и тестирование.

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

Добавление страницы настроек для плагина обычно включает использование “API страниц меню” в WordPress. Вы можете использовать add_menu_page() Используйте функцию для создания главного пункта меню или применяйте другой подход. add_submenu_page() Создайте подстраницу внутри существующего меню (например, “Настройки”). В функции обратного вызова (callback function) страницы настроек необходимо отобразить HTML-форму и использовать её для сбора пользовательских данных. settings API(Включая register_setting, add_settings_section, add_settings_field Для безопасного и удобного обработки процессов регистрации, сохранения и отображения параметров используются такие функции.