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

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

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

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

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

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

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

Создание локального сервера разработки

Рекомендуется использовать такие инструменты, как MAMP, XAMPP или Local by Flywheel, чтобы быстро настроить локальный сервер с поддержкой PHP и MySQL. После установки и настройки WordPress у вас будет идеальная среда для тестирования. Обязательно убедитесь, что версия PHP совпадает с версией, используемой на хостинг-серверах, и включите функцию отладки ошибок.wp-config.phpВ файле можно задать необходимые параметры.WP_DEBUGДля…trueЭто поможет вам быстро находить проблемы в процессе разработки.

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

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

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

Понимание основной структуры каталогов

Плагины для WordPress находятся в следующем месте:/wp-content/plugins/Все плагины находятся в этом каталоге; каждый плагин представляет собой отдельную папку, в которой находится основной PHP-файл. Вы можете создавать новые папки в этом каталоге напрямую с помощью FTP, SSH или локального файлового менеджера. Например, чтобы создать папку для вашего первого плагина, назовите её…my-first-pluginОткройте нужную папку и создайте внутри неё главный файл.my-first-plugin.phpЭто точка входа для плагина; WordPress идентифицирует плагин, считывая определенную информацию, содержащуюся в комментариях в начале этого файла.

Создание первого базового файла плагина

В этом разделе мы пошагово создадим базовую структуру плагина – это основа, на которой WordPress будет распознавать и управлять вашим плагином.

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

Каждый плагин для WordPress должен содержать стандартизированные заголовочные комментарии в начале своего основного PHP-файла. Эта информация отображается на странице управления плагинами в области администрирования сайта. Создайте новый файл и назовите его…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
 */

Этот комментарий является обязательным.Plugin NameОпределено имя, под которым плагин будет отображаться в бэкэнде.Text DomainДля использования в процессе интернационализации переводов: после сохранения файла поместите его в то место, где он будет доступен для дальнейшей работы./wp-content/plugins/my-first-plugin/Папка была создана. Теперь, войдя в интерфейс WordPress через панель управления “Плагины”, вы увидите, что новый плагин находится в состоянии “Неактивирован”.

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

Добавьте простую функцию.

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

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

function myfp_add_footer_text( $content ) {
    // 检查是否在单个文章页面
    if ( is_single() ) {
        $custom_text = '<p><em>Спасибо, что прочитали эту статью! Это сообщение было сгенерировано плагином “Мой первый пользовательский плагин”.</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
add_filter( 'the_content', 'myfp_add_footer_text' );

Этот код определяет функцию.myfp_add_footer_textОно делает это следующим образом:add_filterХук (hook) был подключен к системе WordPress.the_contentФильтр находится внутри функции; он используется внутри самой функции.is_single()Для того чтобы текст добавлялся только на страницы отдельных статей и не влиял на главную страницу или архив, используется условное проверение. В названиях функций применяется краткое префикс.myfpЭто сокращение от «My First Plugin» (Мой первый плагин), и это хорошая практика, позволяющая избежать конфликтов с названиями функций других плагинов.

Погружение в основные технологии разработки плагинов

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

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

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

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

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

Акционные хуки (Action Hooks) и фильтрные хуки (Filter Hooks) являются основой разработки плагинов для WordPress. Акционные хуки позволяют выполнять код в определенные моменты времени — например, при публикации статьи.publish_post) или при загрузке страницы администрирования (backend management page).admin_initФильтры позволяют вам “изменять” данные, как в примере с изменением содержимого статей, который мы рассматривали ранее.

Создание страницы меню управления является типичным примером использования действий-хуков (action hooks). Вы можете разместить соответствующий код в нужных местах системы.admin_menuНа крючке. Ниже приведен пример создания страницы с простыми настройками:

function myfp_create_admin_menu() {
    add_menu_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限能力
        'myfp-settings-page', // 菜单slug
        'myfp_settings_page_html', // 回调函数，用于输出页面HTML
        'dashicons-admin-generic', // 图标
        80 // 菜单位置
    );
}
add_action( 'admin_menu', 'myfp_create_admin_menu' );

function myfp_settings_page_html() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1></h1>
        <p>Это страница настроек моего первого плагина.</p>
    </div>
    &lt;?php
}

Реализация параметров плагина и хранения данных

Большинство плагинов требуют хранения пользовательских настроек. WordPress предоставляет для этого необходимые инструменты.Options APIДля безопасного хранения и поиска данных вы можете использовать…add_option()、get_option()иupdate_option()Для создания интерактивной формы настройок вам потребуется использовать HTML-формы в сочетании с безопасными функциями WordPress.wp_nonce_field()Для генерации и проверки безопасных случайных чисел, а также…sanitize_text_field()Используется для очистки пользовательского ввода.

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

Ниже приведен пример упрощенного процесса обработки и сохранения данных:

if ( isset( $_POST['myfp_submit'] ) ) {
    // 验证安全随机数
    if ( ! wp_verify_nonce( $_POST['myfp_nonce'], 'myfp_save_settings' ) ) {
        wp_die( '安全校验失败！' );
    }

// 清理并保存数据
    $user_text = sanitize_text_field( $_POST['custom_text'] );
    update_option( 'myfp_custom_text', $user_text );

echo '<div class="notice notice-success"><p>Настройки сохранены!</p></div>';
}

Включение скриптов и таблиц стилей

Для того чтобы не влиять на производительность веб-сайта, файлы JavaScript и CSS, включенные в плагины, должны использоваться правильным образом.wp_enqueue_script()иwp_enqueue_style()Функции. Это позволяет системе WordPress управлять зависимостями между различными модулями и предотвращать конфликты между ними. Правильно выбранные моменты для выполнения определенных действий (так называемые «хаки» для монтирования модулей, или «mount hooks») играют ключевую роль в корректной работе системы.wp_enqueue_scripts(Используется на фронтенде) иadmin_enqueue_scripts(Используется в бэкенде.)

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

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

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

function myfp_enqueue_frontend_assets() {
    wp_enqueue_style(
        'myfp-frontend-style',
        plugins_url( 'assets/css/frontend-style.css', __FILE__ ),
        array(),
        '1.0.0'
    );
}
add_action( 'wp_enqueue_scripts', 'myfp_enqueue_frontend_assets' );

Лучшие практики публикации и обслуживания плагинов

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

Безопасность и проверка кода

Безопасность является одним из главных приоритетов при разработке плагинов. Все данные, вводимые пользователями, должны рассматриваться как ненадежные; для их обработки необходимо использовать соответствующие меры защиты.esc_html()、esc_url()、sanitize_text_field()Необходимо использовать функции для эскапирования или очистки данных перед тем, как выводить их в браузер или сохранять в базу данных. При прямом использовании SQL-запросов обязательно следует соблюдать соответствующие правила обработки данных.$wpdbКлассы и их…prepare()Существуют методы предотвращения атак типа SQL-инъекций. Регулярное использование инструментов для анализа кода WordPress помогает соблюдать стандарты программирования и выявлять потенциальные уязвимости.

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

Если вы хотите, чтобы ваш плагин использовался пользователями по всему миру, интернационализация (i18n) является обязательной. Это означает, что вам необходимо перевести все пользовательские текстовые элементы на различные языки.()или_e()Создайте функции для обработки операций ожидания (например, проверки на готовность ресурсов) и оберните их в отдельные модули. Например:echo (‘Hello World!‘， ‘my-first-plugin‘);Определено в заголовочной части плагина.Text Domain（my-first-pluginЭтот текст должен полностью совпадать с областью текста, используемой в функции перевода. Затем вы можете воспользоваться таким инструментом, как Poedit, для создания перевода..potШаблонный файл, предназначенный для создания переводов на разные языки переводчиками..moДокумент.

Обновление версий и совместимость

Когда вы добавляете новые функции или исправляете ошибки в плагине, необходимо выпустить его новую версию. Обязательно обновите содержимое заголовочного файла основного файла плагина (main file header).VersionИнформация: Рекомендуется предусмотреть путь для обновления программного обеспечения. При активации плагина необходимо проверять версию программы и, в случае необходимости, выполнять её обновление.register_activation_hookВыполните необходимые обновления в базе данных или миграцию данных. Кроме того, в это же время…readme.txtВ файле четко записаны логи обновлений, совместимые версии WordPress и инструкции по установке; это особенно важно, если вы планируете отправить плагин в официальный каталог WordPress.

резюме

От понимания основных концепций плагинов до создания собственных плагинов, включающих функциональные модули, управляющие элементы интерфейса и механизмы загрузки ресурсов, вы уже вступили в мир разработки плагинов для WordPress. Ключевыми аспектами являются использование хуков действий и фильтров, безопасное обработка данных и настроек пользователей, а также соблюдение международных стандартов и правил безопасности. Разработка плагинов – это процесс постоянного обучения; постоянные тестирования, изучение исходного кода ядра системы WordPress и других качественных плагинов помогут вам создавать более мощные и профессиональные инструменты. Теперь, опираясь на полученные знания, вы можете начать разрабатывать собственные уникальные функции, соответствующие вашим требованиям.

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

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

Можно ли давать любое имя главному PHP-файлу плагина?

Можно, но обычно рекомендуется использовать название, совпадающее с именем папки с плагинами или содержащее четкое описание функций файла. Самое важное – независимо от имени файла, в его верхней части должны находиться комментарии (аннотации), содержащие информацию о плагине.Plugin NameЭтот комментарий должен быть абсолютно точным, поскольку WordPress именно на основе этой информации идентифицирует плагины.

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

Лучшей практикой является использование уникального префикса для названия всех ваших функций, классов, переменных и констант. Этот префикс должен быть достаточно уникальным и, как правило, связан с аббревиатурой вашего плагина или брендом. Например, если название вашего плагина — “Super SEO Tools”, вы можете использовать префикс, отражающий это название.sset_илиsst_В качестве префикса, например…sst_generate_meta_descriptionИспользование пространств имен в PHP (в средах, поддерживающих это) представляет собой ещё один более современный и эффективный способ решения подобных задач.

Могу ли я создать таблицы в базе данных внутри плагина?

Можно, но следует быть крайне осторожным. Создавайте пользовательские таблицы базы данных только в крайних случаях, поскольку API Options и встроенные таблицы Posts/Post Meta в WordPress обычно достаточно гибки и позволяют удовлетворить большинство потребностей в хранении данных. Если вам все же необходимо создать новую таблицу, пожалуйста, используйте…$wpdbОбъект, и убедитесь, что хук активации плагина (используемый для…)register_activation_hookВ процессе создания таблиц необходимо учитывать возможность их удаления при удалении соответствующего приложения.

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

Для индивидуальных или клиентских проектов рекомендуется выполнять пакетирование непосредственно.zipДостаточно просто отправить файл. Если вы хотите опубликовать его публично, самый официальный способ — это отправить его в официальный каталог плагинов WordPress. Для этого вам потребуется создать плагин, соответствующий требованиям качества и структуре каталога.readme.txtПожалуйста, загрузите файл и убедитесь, что код соответствует условиям лицензии открытого программного обеспечения (например, GPL). Перед отправкой обязательно тщательно протестируйте совместимость и безопасность плагина в различных средах.