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

Чому варто обирати розробку додатків для WordPress?

WordPress зміг стати найпопулярнішою у світі системою управління контентом завдяки своїй потужній архітектурі плагінів. Плагіни дозволяють розробникам додавати до сайту майже будь-які функції без необхідності змінювати основний код – від простих форм для зв’язку до складних систем електронної комерції. Вивчення розробки плагінів означає, що ви зможете глибоко налаштувати WordPress відповідно до конкретних бізнес-завдань або перетворити свої ідеї на повторно використовувані продукти.

开发自己的插件，相较于直接修改主题的 functions.php Файли мають значні переваги. Плагіни є незалежними модулями функціоналу, які не зникають під час зміни теми сайту. Це полегшує обслуговування коду, його оновлення та можливість його використання в різних проектах. Розуміння основ механізмів розробки плагінів є обов’язковим етапом на шляху до статусу досвідченого розробника WordPress.

Створення вашого середовища розробки

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

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

Налаштування середовища локального сервера

Рекомендується використовувати інтегровані рішення для локальних серверів, такі як Local by Flywheel, XAMPP або MAMP. Ці інструменти дозволяють одним кліком встановити Apache/Nginx, PHP та MySQL. Обов’язково переконайтеся, що версія PHP сумісна з версією WordPress, яку ви плануєте використовувати; зазвичай рекомендується використовувати PHP 7.4 або вищі версії. Крім того, необхідно встановити нову версію WordPress на локальному сервері для тестування плагінів у “сендбоксі”.

UltaHost – хостинг для сайтів, побудованих на платформі WordPress

Гарантія повернення грошей протягом 30 днів, необмежена пропускна здатність мережі та доступ до баз даних, безкоштовний захист від DDoS-атак; знижка 50% при покупці на термін 3 роки (варіанти об’ємів трафіку: 4 ТБ/5

сторінка доступу

Кодові редактори та інструменти для налагодження програмного забезпечення

Виберіть потужний кодовий редактор, такий як Visual Studio Code або PHPStorm. Ці редактори забезпечують підсвічування синтаксису, підказки щодо коду та інтеграцію з системами керування версіями коду. Для налагодження (дебагування) необхідно увімкнути відповідний режим у WordPress. Для цього потрібно зайти до кореневого каталогу WordPress. wp-config.php Файл, будь ласка. WP_DEBUG Стала величина встановлена як true。

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // 将错误日志保存到 /wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // 不要在页面上显示错误

Після увімкнення режиму налагодження всі PHP-помилки, попередження та сповіщення будуть зберігатися, що допоможе вам швидко виявити проблему.

Створіть свій перший файл плагіна.

Плагін для WordPress може бути дуже простим – складатися лише з одного файлу – проте дотримання правильної структури є надзвичайно важливим. Ми почнемо з найбазовішого плагіна на кшталт “Hello World”.

Структура основного файлу плагіна

По-перше, у WordPress… /wp-content/plugins/ У каталозі створіть нову папку, наприклад, my-first-pluginУ цьому папці створіть головний PHP-файл; його назва зазвичай збігається з назвою папки.my-first-plugin.php。

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

Кожен плагін має містити у вступній частині файлу стандартний блок коментарів з інформацією про плагін. За допомогою цього блоку WordPress ідентифікує плагін та відображає його у інтерфейсі для керування в бекенді.

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

Після збереження файлу увійдіть у свій WordPress-бекенд, перейдіть на сторінку “Плагіни” (Plugins), і ви повинні побачити цей новий плагін у списку плагінів. Тепер ви можете його активувати, хоча наразі він не має жодних функцій.

Додайте першу функцію: керування меню.

Далі давайте додамо до плагіна просту функцію: створимо новий пункт меню у бічній панелі адміністративної панелі WordPress.

hosting.com Віртуальний хостинг

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

сторінка доступу

Ми будемо використовувати add_action() Функція для підключення (монтування) керуючої функції (callback function) admin_menu Цей елемент (Action) знаходиться на цьому „гачку“ (hook).

// 在插件主文件中，插件头部注释块之后，添加以下代码

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

// 钩子到 admin_menu 动作
add_action( 'admin_menu', 'mfp_add_admin_menu' );

/**
 * 注册一个自定义管理菜单
 */
function mfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',          // 菜单标题
        'manage_options',    // 所需权限
        'my-first-plugin',   // 菜单别名 (slug)
        'mfp_display_admin_page', // 显示页面内容的回调函数
        'dashicons-smiley', // 菜单图标 (使用 Dashicon)
        6                    // 菜单位置
    );
}

/**
 * 管理页面的显示内容
 */
function mfp_display_admin_page() {
    ?>
    <div class="wrap">
        <h1><p><strong>  <p><strong></h1>
        <p>Привіт, світ! Це моя перша сторінка керування плагінами для WordPress.</p>
    </div>
    &lt;?php
}

Збережіть файл та оновіть бекенд WordPress. Після цього у лівому меню ви побачите новий пункт під назвою “Мої плагіни”. Натисніть на нього, і відкриється проста сторінка з вітальним повідомленням.

Глибокий аналіз: хаки та фільтри

Основна філософія розробки плагінів для WordPress базується на так званих “хвостках” (Hooks). Хвостки дозволяють вашому коду вступати в процес роботи основної системи WordPress у певні моменти часу, щоб змінювати або додавати нові функції. Хвостки поділяються на два основні типи: дії (Actions) та фільтри (Filters).

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

Розуміння механізмів виконання дій (action hooks)

Акційні хаки (action hooks) у WordPress виконуються у певні моменти – наприклад, під час збереження статті, завантаження верхньої частини сторінки чи виведення нижньої частини сторінки. Ваш плагін може “слідкувати” за цими моментами та виконувати власні функції. Ми використовували цей механізм у прикладі ви admin_menu Це просто хук (hook) для виконання певної дії.

Ще одним поширеним прикладом є автоматичне додавання певного тексту наприкінці статті.

Міжсерверний віртуальний хостинг

Віртуальний хостинг $2.50 USD на місяць, перший місяць $0.1 USD за промокодом tryinterserver, 461 скрипт хмарних додатків, встановлення в один клік.

сторінка доступу

add_action( 'the_content', 'mfp_append_text_to_content' );

function mfp_append_text_to_content( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $append_text = '<p><em>Ця стаття була створена моїм першим плагіном.</em></p>';
        $content .= $append_text;
    }
    return $content;
}

Використання фільтрів для модифікації даних

Фільтрові хаки використовуються для модифікації даних перед їх збереженням у базі даних або надсиланням до браузера. Вони отримують дані, модифікують їх та потім мають повернути оновлені дані. Типовим прикладом є зміна заголовка статті.

add_filter( 'the_title', 'mfp_modify_post_title' );

function mfp_modify_post_title( $title ) {
    // 只在非后台的主查询中修改
    if ( ! is_admin() && in_the_loop() ) {
        $title = '[重要] ' . $title;
    }
    return $title;
}

Розуміння та вміле використання хуків є ключовими факторами для створення гнучких та потужних плагінів. Ядро WordPress надає тисячі хуків, які присутні на всіх етапах життєвого циклу системи.

Безпека плагінів та найкращі практики їх використання

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

Проверка даних та їх ескапування

Ніколи не довіряйте даним, введеним користувачем, або даним з бази даних. Перед виведенням будь-яких даних у браузер (у вигляді HTML, JavaScript чи атрибутів) необхідно їх ескапувати. WordPress надає низку допоміжних функцій для цього.

// 输出到 HTML 内容中
echo esc_html( $untrusted_data );
// 输出到 HTML 属性中
echo esc_attr( $untrusted_data );
// 输出到 URL 中
echo esc_url( $untrusted_data );
// 在 JavaScript 变量中输出
$js_data = wp_json_encode( $untrusted_data );

Перед збереженням даних у базу даних або виконанням логічних операцій необхідно їх перевірити (Validation), щоб переконатися, що вони відповідають очікуваному формату (наприклад, чи є це електронна адреса, число тощо).

Використання просторів імен та класів

Для складних плагінів рекомендується використовувати простори імен PHP та об’єктно-орієнтоване програмування (OOP) для організації коду. Це допоможе уникнути конфліктів імен функцій, а також підвищить модульність та зрозумілість коду.

<?php
namespace MyFirstPluginAdmin;

class Admin_Menu {
    public function __construct() {
        add_action( 'admin_menu', [ $this, 'add_menu_page' ] );
    }

public function add_menu_page() {
        add_menu_page( ... );
    }
}

// 初始化
new Admin_Menu();

Крім того, необхідно додати підтримку інтернаціоналізації до цього плагіна (за допомогою…). __() 和 _e() Функціональність, наявність зручних опцій для видалення та очищення системи, а також дотримання стандартів кодування WordPress є важливими складовими якісного плагіна.

підсумок

Розробка плагінів для WordPress – це процес, який можна пройти поступово, від простих кроків до більш складних. Все починається зі створення базового файлу, який буде розпізнаний системою WordPress. Далі ви використовуєте потужну систему дій (actions) та фільтрів (filters) для розширення функціоналу плагіна. Кожен наступний крок ґрунтується на глибокому розумінні архітектури WordPress. Локальне середовище розробки є вашою „лабораторією“, засоби налагодження (debugging tools) – вашим „мікроскопом“, а безпека та найкращі практики є основою для стабільності та надійності вашого плагіна.

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

Часті запитання

Як мінімум, які файли потрібні для плагіна WordPress?

Для роботи з WordPress-плагіном зазвичай достатньо щонайменше одного PHP-файлу. Якщо цей файл містить правильні коментарі, що визначають структуру плагіна, WordPress зможе його визнати та активувати у списку плагінів у своєму бекенді. Звісно, для плагінів з розширеними функціями код зазвичай розподіляється по кількох файлах та папках для кращого збереження та підтримки.

Як уникнути конфліктів імен функцій під час розробки плагінів?

Існує два основні способи уникнення конфліктів у назвах функцій. Перший – це додавання унікального префікса до всіх ваших функцій; наприклад, використання скорочень чи абревіатур, як це робиться у деяких плагінах. mfp_ 或 myplugin_Другий спосіб – це використання класів та просторів імен у PHP для інкапсуляції ваших функцій у методах класів. Це більш сучасний та рекомендований підхід, який дозволяє ефективно уникнути конфліктів у назвах.

Як додати сторінку з параметрами налаштувань до мого плагіна?

Додавання сторінки налаштувань для плагіна зазвичай передбачає використання певних інструментів чи методів програмування. add_options_page() 或 add_submenu_page() Функція призначена для реєстрації сторінок, а потім використовує API налаштувань WordPress (Settings API) для безпечного створення, підтвердження та зберігання параметрів. API налаштувань містить необхідні інструменти для керування параметрами сайту. register_setting()、add_settings_section() 和 add_settings_field() Функції на кшталт цієї спрощують процес створення форм із стандартизованими налаштуваннями та автоматично забезпечують безпеку та зберігання даних.

Після завершення розробки, як опублікувати плагін у офіційному каталозі WordPress?

Щоб опублікувати плагін у офіційному каталозі WordPress.org, спочатку потрібно зареєструвати SVN-репозиторій для свого плагіна на сайті WordPress.org. Потім переконайтеся, що код вашого плагіна відповідає офіційним вимогам та стандартам: якість коду, безпека, ліцензія (має бути сумісною з GPL), наявність стандартного файлу readme.txt тощо. Після цього використовуйте інструменти для роботи з SVN, щоб завантажити свій код у вказаний репозиторій. Команда WordPress проведе його перевірку, і якщо перевірка пройде успішно, ваш плагін з’явиться у офіційному каталозі для завантаження та встановлення користувачами.