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

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

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

Відмінно від способу, коли виконується пряма модифікація самого теми…functions.phpНа відміну від звичайних файлів, плагіни інкапсулюють свою функціональну логіку у окремих модулях. Це означає, що навіть після зміни теми функції, які надає плагін, продовжують працювати без проблем. Крім того, добре структурований плагін можна легко перенести та повторно використати на різних сайтах, що значно підвищує ефективні

Створення вашого першого плагіна

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

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

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

Ядро плагіна – це основний PHP-файл. Вам потрібно створити нову папку, наприклад…my-first-pluginСтворіть у цьому папці PHP-файл із тим самим ім’ям, що й папка.my-first-plugin.phpКоментарі у відповідному розділі файлу є надзвичайно важливими, адже вони надають 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:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

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

Додати базові функції до плагіна

Після активації плагіна ми можемо почати додавати до нього прості функції. Одним з поширених прикладів є додавання рядка з користувацьким текстом у футер сайту. Це можна зробити, використовуючи…wp_footerЦе реалізується за допомогою хака дії (Action Hook).

Додайте наступний код у основний файл плагіна:

// 在网站页脚输出自定义信息
function my_first_plugin_footer_text() {
    echo '<p style="text-align: center;">Дякуємо, що використовуєте продукти, які підтримуються моїм першим плагіном!</p>';
}
add_action( 'wp_footer', 'my_first_plugin_footer_text' );

Ось тут ми визначили функцію.my_first_plugin_footer_text()Потім використовуйте…add_action()Функція монтує його.wp_footerЦе реалізація механізму “хаків та калебрів” („hooks and callbacks“) у WordPress. Коли система доходить до частини веб-сторінки, присвятованої футеру (footer), вона автоматично викликає нашу функцію, яка виводить запрограмований HTML-контент. Це ілюструє основи використання цього механізму у роботі з WordPress.

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

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

Філософія розробки плагінів для WordPress ґрунтується на так званих “хуках” (Hooks). Існує два типи хуків: хуки дій (Action Hooks) та хуки фільтрів (Filter Hooks). Розуміння їх принципів є ключовим етапом на шляху від початківця до майстра.

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

Акційні хаки (action hooks) дозволяють вам вставляти власний код у певні моменти виконання WordPress. Як у прикладі вище.wp_footerВоно активується під час генерації HTML-коду внизу сторінки (в футері). Ще одним поширеним хаком для додавання додаткових функцій є…initВін виконується після завершення базового завантаження WordPress та перед обробкою запитів користувачів. Зазвичай використовується для ініціалізації налаштувань плагінів, реєстрації власних типів статей тощо.

// 在初始化时执行一些操作
function my_plugin_init_action() {
    // 例如，在这里可以注册一个自定义文章类型
    // if ( ! post_type_exists( 'book' ) ) { ... }
}
add_action( 'init', '_plugin_init_action' );

Опанування фільтрів-хуків (filter hooks)

На відміну від дійових хуків (action hooks), фільтрувальні хуки (filter hooks) використовуються для зміни даних. Вони отримують певне значення, дозволяють вам його модифікувати, а потім повертають оброблене значення. Типовим прикладом є…the_contentФільтр дозволяє вам змінювати основний контент статті чи сторінки.

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

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

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

// 在文章内容末尾自动添加一段提示文字
function my_plugin_content_filter( $content ) {
    if ( is_single() ) {
        $extra_text = '<div class="my-plugin-note">Вміст цієї статті був створений завдяки фільтрації, яку здійснює мій плагін.</div>';
        $content .= $extra_text;
    }
    return $content;
}
add_filter( 'the_content', 'my_plugin_content_filter' );

У цьому прикладі функція…my_plugin_content_filter()Отримати оригінальний$contentПеревірте, чи це сторінка з однією статтею, після чого додайте до неї новий фрагмент HTML-коду. Нарешті, поверніть оновлений вміст. WordPress використає це повернене значення замість початкового вмісту для відображення на сторінці.

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

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

Створення меню керування та відповідних сторінок

Використовуйтеadd_menu_page()或add_options_page()Функція дозволяє додати до вашого плагіна пункт меню та сторінку налаштувань у фоновому режимі. Це зазвичай використовується для…admin_menuВиконано у функції-хакері (action hook).

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

// 添加插件管理菜单
function my_plugin_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 所需权限
        'my-plugin-settings',   // 菜单slug
        'my_plugin_settings_page' // 显示页面的回调函数
    );
}
add_action( 'admin_menu', 'my_plugin_add_admin_menu' );

// 设置页面的HTML内容
function my_plugin_settings_page() {
    ?>
    <div class="wrap">
        <h1>Налаштування мого плагіна.</h1>
        <form method="post" action="/uk/options.php/" data-trp-original-action="options.php">
            <?php
            settings_fields( 'my_plugin_settings_group' );
            do_settings_sections( 'my-plugin-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="uk"/></form>
    </div>
    &lt;?php
}

Налаштування реєстрації, поля та механізми обробки даних з точки зору безпеки

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

// 初始化插件设置
function my_plugin_settings_init() {
    // 注册一个新的设置项到“my_plugin_settings_group”
    register_setting( 'my_plugin_settings_group', 'my_plugin_options' );

// 在设置页面添加一个区域
    add_settings_section(
        'my_plugin_section_id',
        '基础配置',
        null,
        'my-plugin-settings'
    );

// 向该区域添加一个字段
    add_settings_field(
        'my_plugin_text_field',
        '提示文本',
        'my_plugin_text_field_render',
        'my-plugin-settings',
        'my_plugin_section_id'
    );
}
add_action( 'admin_init', 'my_plugin_settings_init' );

// 渲染文本框字段
function my_plugin_text_field_render() {
    $options = get_option( 'my_plugin_options' );
    ?>
    <input type='text' name='my_plugin_options[text_field]' value='<?php echo esc_attr( $options['text_field'] ?? '' ); ?>'>
    <p class="description">Текст, введений тут, буде відображатися на головній сторінці веб-сайту.</p>
    &lt;?php
}

У такий спосіб дані, введені користувачем на фронтенді, проходять вбудовані процедури безпеки WordPress (наприклад, обробку для усунення небезпечних символів типу „\n“ та перевірку користувачських ідентифікаторів), після чого зберігаються у вигляді масwp_optionsУ таблиці. Ваш код плагіна можна використовувати через…get_option( ‘my_plugin_options’ )Отримати ці значення безпечним способом.

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

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

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

Дотримуйтеся найкращих практик під час підготовки до публікації.

Розробка високоякісного, зручного для обслуговування та безпечного плагіна вимагає дотримання низки найкращих практик.

Організація коду та безпека

Ніколи не довіряйте даним, введеним користувачем. Перевіряйте всі дані, які надходять від користувачів, перед тим, як їх використовувати.$_GET、$_POSTДані, отримані або зчитані з бази даних та підготовлені до виведення, потрібно обробити за допомогою функцій, які надає WordPress – зокрема, їх необхідно ескаполювати чи перевірити на коректність.esc_html()、esc_attr()、sanitize_text_field()、wp_kses()Використовуйте тощо.wp_enqueue_script()和wp_enqueue_style()Необхідно правильно завантажувати скрипти та стилі, а також обробляти залежності та механізми контролю версій. Для складних плагінів рекомендується використовувати об’єктно-орієнтоване програмування (OOP) для організації коду – функції слід інкапсулювати у класи, що підвищить модульн

Інтернаціоналізація та локалізація

Щоб ваш плагін міг використовуватися користувачами по всьому світу, інтернаціоналізація (i18n) є обов’язковою. Це означає, що вам потрібно…__()或_e()Функції типу `etc.` обгортають усі рядки, призначені для користувача. Вони визначені у коментарях на початку плагіна.Text Domain(Наприклад…)my-first-pluginВоно має бути узгоджене з текстовими полями, які використовуються тут.

// 错误示例
echo “Settings Saved”;

// 正确示例
echo esc_html__( 'Settings Saved', 'my-first-plugin' );

Потім ви можете використовувати такі інструменти, як Poedit, щоб вилучити ці рядки та створити необхідний продукт..potЦе шаблонний файл, за допомогою якого можна створювати матеріали для різних мов (наприклад, для китайської, англійської тощо).zh_CN.poЦе перекладацький файл для (). Перекладіть ці тексти..moКомпільовані файли знаходяться у каталозі плагінів./languages/У папці WordPress автоматично завантажить відповідні переклади залежно від мови сайту.

Підготовка до публікації у офіційному каталозі

Якщо ви плануєте подати плагін до офіційного каталогу плагінів WordPress.org, вам необхідно переконатися, що код відповідає встановленим стандартам. До цього належить створення детального опису плагіна, який містить всю необхідну інформreadme.txtФайли, які описують ваш плагін (у відповідному форматі), містять скріншоти, інструкції з встановлення, відповіді на поширені запитання (FAQ) та журнали оновлень, підлягають розповсюдженню за умовами ліцензії GPL. Код плагіна слід надсилати до офіційного репозиторію Subversion (SVN). Перед випуском необхідно ретельно перевірити сумісність вашого плагіна з різними версіями WordPress, PHP, популярними темами та іншими плагінами.

підсумок

Розробка плагінів для WordPress – це поступовий процес, що починається зі створення простих функцій та закінчується розробкою складних додатків. Все починається з PHP-файлу, який містить правильні заголовкові коментарі. Ключовим елементом є вміле використання дійових та фільтрувальних хуків для взаємодії з основною частиною системи WordPress. Інтерфейс адміністративного керування можна створити за допомогою API Settings, що робить плагін більш зручним у використанні для користувачів. Дотримання найкращих практик безпеки, підтримка міжнародної локалізації та організованість коду є основою для розробки професійних плагінів. Незалежно від того, чи потрібні вам плагіни для власних проектів чи ви хочете зробити внесок у спільноту відкритого програмного забезпечення, оволодіння цим процесом розробки відкриє перед вами можливості для створення потужних, налаштовуваних рішень.

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

Які необхідні попередні знання для розробки плагінів?

Вам потрібні базові знання програмування на PHP, розуміння HTML та CSS, а також певне ознайомлення з основними функціями та концепціями WordPress (статті, сторінки, плагіни). Буде корисно також знати основи роботи з базою даних MySQL, хоча це не є обов’язковим, оскільки WordPress надає зручні функції для роботи з базою даних.WP_Query、wpdbКлас (class).

У чому різниця між файлами functions.php плагінів та тем?

Розмістіть код у відповідному розділі теми (або модулі програми).functions.phpУ файлі описано спосіб швидкого додавання нових функцій, але ці функції прив’язані до певного тематичного дизайну сайту. Коли ви змінюєте тему, ці функції зникають. Проте плагіни є незалежними від теми модулями – їхні функції залишаються активними незалежно від того, яку тему ви використовуєте. Для функцій, які планується використовувати тривалий час або які потрібно повторно застосовувати на кількох сайтах, розробка плагінів є кращим варіантом

Як налаштувати (діагностувати та виправити) код свого плагіна?

WordPress надає кілька інструментів для налагодження роботи сайту. По-перше, ви можете…wp-config.phpФайл увімкнений.WP_DEBUG“Модель, будь ласка.”define( 'WP_DEBUG', true );Це виведе всі PHP-помилки, попередження та сповіщення на екран. Більш безпечним способом буде налаштувати це одночасно.WP_DEBUG_LOG为trueЗаписати помилку у…/wp-content/debug.logУ файлі. Крім того, використовуйте…error_log()Використання функцій чи встановлення професійних засобів налагодження, таких як Query Monitor, дозволяє ефективніше відстежувати змінні та результати виконання запитів до баз даних.

Як мій плагін може бути сумісним із більш новими версіями PHP?

Щоб гарантувати, що ваш плагін буде коректно працювати у майбутніх версіях PHP, вам слід уникати використання забутих або видалених функцій та синтаксису. У локальному середовищі розробки виконуйте тестування в умовах, що відповідають майбутнім цільовим версіям PHP (наприклад, PHP 8.x). Постійно стежте за оновленнями від WordPress та офіційного проекту PHP, а також вказуйте діапазон сумісних версій PHP у журналі оновлень плагіна – це допоможе користувачам обрати відповідне середовище для роботи з вашим плагіном.