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

Середовище розробки плагінів для WordPress та базові підготовчі кроки

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

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

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

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

Кожен плагін для WordPress має мати головний файл, який є входом до самого плагіна. Цей файл необхідно розмістити у відповідному місці системи WordPress. wp-content/plugins Файл слід розмістити у окремій папці в каталозі та назвати його унікальною назвою. Наприклад, якщо ви хочете створити плагін під назвою “Привітання”, ви можете створити файл з назвою „GreetingsPlugin.js“. my-first-plugin Фолдер, і у ньому створіть головний файл. my-first-plugin.php。

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

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

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

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

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

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

Основна структура плагіна та механізм хуків (hooks)

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

Розуміння механізмів дії хуків (action hooks) та фільтрувальних хуків (filter hooks)

Хаки (hooks) поділяються на два основні типи: дії (Actions) та фільтри (Filters). Хаки типу „дії“ виконують ваш код під час настання певних подій, наприклад, під час публікації статті чи завантаження інтерфейсу для керування. Ви можете їх використовувати для автоматизації різних процес add_action() Функції використовуються для монтажу (підключення) певних елементів системи. Фільтр-хаки (filter hooks) призначені для модифікації даних; вони дозволяють змінювати їх значення перед тим, як дані будуть надіслані в базу даних чи браузер. Ви можете використ add_filter() Функція для монтування.

Наприклад, щоб додати власний текст у футер сторінки веб-сайту, можна використати… wp_footer Цей акційний хук (action hook):

Функція myplugin_add_footer_text() {
    echo '<p style="text-align:center;">Дякуємо, що використовуєте наш веб-сайт!</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );

Створити сторінку керування плагінами

Багато плагінів потребують наявності сторінок налаштувань у адміністративному інтерфейсі WordPress. Це зазвичай досягається шляхом їх підключення (монтування) до відповідних модулів системи. admin_menu Для реалізації цього потрібно використати дієві хаки (action hooks). Вам потрібно визначити функцію, у якій будуть виконані необхідні дії. add_menu_page() 或 add_options_page() Використовуйте такі функції, як `register_page`, щоб зареєструвати сторінку, а також визначте іншу функцію для виведення HTML-контенту цієї сторінки.

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

function myplugin_add_admin_menu() {
    add_options_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限
        'myplugin-settings', // 菜单别名
        'myplugin_render_settings_page' // 用于显示页面内容的函数
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

function myplugin_render_settings_page() {
    ?>
    <div class="wrap">
        <h2>Налаштування мого плагіна.</h2>
        <form method="post" action="/uk/options.php/" data-trp-original-action="options.php">
            <?php
            settings_fields( 'myplugin_settings_group' );
            do_settings_sections( 'myplugin-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="uk"/></form>
    </div>
    &lt;?php
}

Реалізація функцій плагінів та обробка даних

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

Використовуйте API налаштувань для збереження параметрів.

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

Нижчий приклад демонструє, як налаштувати реєстрацію текстового поля:

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

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

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

function myplugin_settings_init() {
    register_setting( 'myplugin_settings_group', 'myplugin_greeting_text' );

add_settings_section(
        'myplugin_section',
        '基础设置',
        null,
        'myplugin-settings'
    );

add_settings_field(
        'myplugin_field_greeting',
        '问候语',
        'myplugin_field_greeting_render',
        'myplugin-settings',
        'myplugin_section'
    );
}
add_action( ‘admin_init’， ‘myplugin_settings_init’ );

function myplugin_field_greeting_render() {
    $value = get_option( ‘myplugin_greeting_text’， ‘你好，世界！’ );
    echo ‘<input type=“text” name=“myplugin_greeting_text” value=“’ . esc_attr( $value ) . ‘” />’;
}

Створення власних таблиць у базі даних

Для плагінів, які потребують зберігання складних реляційних даних, може знадобитися створення власних таблиць бази даних. Це зазвичай виконується під час активації плагіна. Вам потрібно написати функцію та під’єднати її до механізму реєстрації та активації WordPress. dbDelta() Функція виконує SQL-запити для створення або оновлення таблиць та інтелектуально реагує на зміни в їхній структурі.

По-перше, зареєструйте функцію активації (activation hook) у вашому основному плагінному файлі:

register_activation_hook( __FILE__， ‘myplugin_create_database_table’ );

Потім визначте функцію для створення таблиці:

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

function myplugin_create_database_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . ‘myplugin_data’;
    $charset_collate = $wpdb->get_charset_collate();

$sql = “CREATE TABLE $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT，
        name varchar(100) NOT NULL，
        email varchar(100) NOT NULL，
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL，
        PRIMARY KEY (id)
    ) $charset_collate;”;

require_once( ABSPATH . ‘wp-admin/includes/upgrade.php’ );
    dbDelta( $sql );
}

Безпека плагінів, їх інтернаціоналізація та підготовка до публікації

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

Впровадження найкращих практик безпеки

Безпека є найважливішим аспектом розробки плагінів. Завжди перевіряйте введені користувачем дані (перевіряйте їх формат) та очищуйте їх (видаляйте шкідливі елементи). Використовуйте функції, які надає WordPress. esc_html()、esc_attr()、sanitize_text_field() Використовується для отримання чи обробки даних. Під час виконання запитів до бази даних. $wpdb->prepare() Існують методи для запобігання атакам типу SQL-ін’єкцій. Крім того, слід використовувати належні засоби безпеки та практики програмування. current_user_can() Перевіряйте права користувачів, щоб переконатися, що лише авторизовані особи можуть виконувати секретні операції.

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

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

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

Інтернаціоналізація плагінів

Щоб ваш плагін міг використовуватися користувачами по всьому світу, необхідно підготувати його до інтернаціоналізації (i18n). Це означає, що всі текстові повідомлення, призначені для користувачів, не повинні записуватися безпосередньо у коді, а мають бути обгорнуті відповідними функціями WordPress для перекладу. Найпоширенішою з таких функцій є… () Використовується для відображення результатів перекладу.() Для отримання перекладеного рядка, а також… _e() Використовується для безпосереднього виведення результатів перекладу.

У вашому коді слід писати ось так:

$greeting = __( ‘你好，世界！’， ‘my-first-plugin’ );
echo esc_html( $greeting );

_e( ‘设置已保存。’， ‘my-first-plugin’ );

Зверніть увагу: другий параметр функції перекладу – “Text Domain” – має відповідати значенню, визначеному у коментарях на початку плагіна. Text Domain Повністю згоден. Потім ви можете використовувати такі інструменти, як Poedit, для створення потрібних файлів. .pot Шаблонний файл, призначений для створення перекладів фахівцями. .po 和 .mo Переклад файлу.

підсумок

Розробка плагінів для WordPress – це процес перетворення ідей на функціональні рішення, який ґрунтується на глибокому розумінні основної архітектури WordPress, особливо системи хуків (hooks). Від налаштування середовища розробки, написання основних файлів плагіна, використання хуків дій (actions) та фільтрів (filters), до обробки даних за допомогою API налаштувань та API бази даних – кожен крок відповідає чітким стандартам. Тільки дотримуючись суворих правил безпеки та забезпечуючи повну підтримку міжнародної локалізації, ваш плагін зможе перетворитися з особистого проекту на готовий до публікації продукт. Опанувавши ці основи, ви зможете досліджувати більш складні аспекти розробки, такі як налаштування власних типів статей, інтеграція з REST API та розробка блоків Gutenberg, що дозволить створювати ще потужніші та сучасніших розширень для WordPress.

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

Чи обов’язково для розробки плагінів для WordPress потрібно досконало володіти мовою програмування PHP?

Так, PHP є основною мовою програмування для розробки WordPress та його плагінів. Вам потрібно оволодіти основами граматики PHP, функціями, масивами, концепціями об’єктно-орієнтованого програмування тощо. Крім того, важливо мати базові знання HTML, CSS та JavaScript, адже ви будете працювати з переднім інтерфейсом та взаємодією користувача.

Як налаштовувати та виправляти помилки у плагіні WordPress, який знаходиться у стадії розробки?

Рекомендується увімкнути режим налагодження (debugging mode) у WordPress. wp-config.php У файлі буде… WP_DEBUG Стала величина встановлена як trueЦе виведе всі PHP-помилки, попередження та сповіщення на екран. Крім того, є можливість їх використання (наприклад, для аналізу чи відстеження). error_log() Функція записує інформацію про налагодження до журналу помилок сервера або використовує інструменти розробника браузера для налагодження коду JavaScript на стороні клієнта.

Як уникнути конфліктів імен функцій у плагінах з іменами функцій інших плагінів?

Щоб уникнути конфліктів імен функцій, класів чи констант, завжди слід використовувати унікальні префікси. Найкращою практикою є використання назв плагінів чи їх скорочень як префіксів. Наприклад, якщо ваш плагін називається “Awesome Slider”, можна використовувати префікс на кшталт “AwesomeSlider-”. as_ 或 awesome_slider_ Як префікс для усіх користувацьких функцій. Для імен класів також слід дотримуватися того ж принципу.

Чи можна надсилати платні плагіни до офіційного каталогу плагінів WordPress?

Неможливо. Офіційний каталог плагінів WordPress приймає лише плагіни, які дотримуються ліцензії GPL та є повністю безкоштовними. Якщо ви розробляєте платні (продвинуті) плагіни, вам доведеться розповсюджувати та продавати їх на власному веб-сайті. Однак багато платних плагінів пропонують безкоштовну версію з базовими функціями для подання до офіційного каталогу як спосіб просування та тестування їхньої продвинутої версії.