Kompletní průvodce vývojem pluginů pro WordPress: vytvořte profesionální PHP plugin od nuly.

Základní struktura a soubory WordPress pluginů

Standardní WordPress plugin musí mít alespoň jednu hlavní soubor. Tato hlavní soubor se obvykle jmenuje podle názvu samotného pluginu, například… my-first-plugin.phpNa začátku tohoto souboru musí být obsažena specifická hlavičková poznámka, která slouží k oznámení metadat pluginu systému WordPress. Tyto informace zahrnují název pluginu, popis, verzi, autora atd. a budou zobrazeny na administrativní stránce “Pluginy”.

Kromě hlavního souboru obsahuje funkčně vybavený plugin obvykle i další adresáře a soubory určené k organizaci kódu. Běžná struktura adresářů zahrnuje adresáře určené k uložení souborů CSS a JavaScript./assetsObsah, zahrnující soubory s PHP třídami/includesKatalog, stejně jako šablony pro uživatelské rozhraní/templatesObsah. Tato modulární struktura usnadňuje údržbu kódu a spolupráci týmu.

Hlavní soubor pluginu je vstupním bodem pro všechny funkce tohoto pluginu. Kromě deklarace metadat má také za úkol registrovat a aktivovat či deaktivovat potřebné „hooky“ (funkce, které jsou spouštěny v určitých okamžicích během provozu aplikace), načíst potřebné závislé soubory a inicializovat klíčové funkce pluginu. Díky správné organizaci souborů lze zajistit, aby i plugin s komplexními funkcemi zachovával přehlednou strukturu.

Doporučujeme k přečtení. Průvodce začátkem vývoje pluginů pro WordPress。

Vytvořte svůj první základní plugin.

Začněme vytvořením nejjednoduššího “Hello World” pluginu, abychom se seznámili s procesem vytváření pluginů a jejich základním životním cyklem.

UltaHost – hosting služby pro weby postavené na platformě WordPress

Záruka vrácení peněz do 30 dnů, neomezený šířka pásma a databáze, bezplatná ochrana proti DDoS útokům. Sleva 501 TP4T při nákupu na 3 roky.

přístupová stránka

Definování informací o pluginu a hlavní funkce

Nejprve, ve složce s instalací WordPressu na vašem lokálním počítači…/wp-content/plugins/V cestě vytvořte novou složku s názvem “hello-world”. Uvnitř této složky vytvořte soubor s názvem…hello-world.phpSoubor „“.

Na začátku tohoto souboru musíte přidat informace o hlavičce pluginu. Typická hlavička pluginu vypadá následovně:

<?php
/**
 * Plugin Name:       你好世界示例插件
 * Plugin URI:        https://yourwebsite.com/hello-world
 * Description:       这是一个用于演示的简单WordPress插件。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       hello-world
 * Domain Path:       /languages
 */

Dále přidáme tomuto pluginu jednoduchou funkci: automatické vložení textového úryvku na konci obsahu článku. To můžeme dosáhnout pomocí…the_contentFiltraci lze implementovat pomocí filtrů. Přidejte následující kód za informace v hlavičce hlavního souboru:

function hello_world_add_footer_text( $content ) {
    // 仅在单篇文章页面添加
    if ( is_single() ) {
        $footer_text = '<p><em>Tento text byl generován pluginem “Hello World”.</em></p>';
        $content .= $footer_text;
    }
    return $content;
}
add_filter( 'the_content', 'hello_world_add_footer_text' );

Zpracování aktivace a deaktivace pluginů

Profesionální pluginy by měly správně zpracovávat logiku při jejich aktivaci a deaktivaci. Například při aktivaci pluginu může být potřeba vytvořit databázové tabulky nebo nastavit výchozí nastavení; při deaktivaci může být nutné smazat dočasné data. Používáme…register_activation_hook和register_deactivation_hookFunkce slouží k registraci odpovídajících „hooků“ (dodatečných funkcí, které jsou spouštěny při určitých událostech).

Doporučujeme k přečtení. Vývoj pluginů pro WordPress od začátku až po pokročilou úroveň: vytváření vlastních funkcí a efektivní rozšiřování。

Přidejte tento kód do hlavního souboru:

// 插件激活时执行的操作
function hello_world_activate() {
    // 例如：添加一个选项到数据库
    if ( ! get_option( 'hello_world_installed' ) ) {
        add_option( 'hello_world_installed', time() );
    }
    // 可以在这里刷新固定链接规则，以确保新注册的URL结构生效
    flush_rewrite_rules();
}
register_activation_hook( __FILE__, 'hello_world_activate' );

// 插件停用时执行的操作
function hello_world_deactivate() {
    // 例如：删除我们创建的临时选项（谨慎操作，用户数据通常不删除）
    // delete_option( 'hello_world_installed' );
    // 清理重写规则
    flush_rewrite_rules();
}
register_deactivation_hook( __FILE__, 'hello_world_deactivate' );

Po dokončení výše uvedených kroků budete moci vidět a aktivovat “Příkladový plugin Hello World” na stránce “Příslušenství” (Plugins) v administraci WordPress. Po aktivaci se při návštěvě jakéhokoli článku zobrazí přidaný text na dně obsahu.

Využití základní API WordPressu k vylepšení funkcionalit

WordPress poskytuje velmi bohatou sadu API, která umožňuje vývojářům pluginů bezpečně a standardně komunikovat s jádrem systému. Znalost těchto API je klíčová pro profesionální vývoj.

Shared hosting na hosting.com

Vysoký výkon, vybavený procesorem AMD EPYC, úložištěm NVMe SSD a LiteSpeedem, nepřetržitá interní podpora odborníků 24 hodin denně a 7 dní v týdnu, pokročilá bezpečnostní opatření včetně SSL, ochrany proti útokům hrubou silou, malwaru a DDoS, úspora až 731 TB/měsíc.

přístupová stránka

Použití akčních háčků a filtrů

Akční háčky (Action Hooks) vám umožňují “vložit” a spustit svůj vlastní kód v určitých okamžicích. Například, když je článek zveřejněn, WordPress spustí příslušné akce.save_postAkce. Můžete to provést pomocí…add_action()Funkce si sama nasadí svou vlastní funkci na tento „hák“ (hook).

function hello_world_on_post_publish( $post_id, $post, $update ) {
    // 检查是否不是修订版本，并且是发布操作
    if ( wp_is_post_revision( $post_id ) || $post->post_status != 'publish' ) {
        return;
    }
    // 发送邮件通知或执行其他逻辑
    // wp_mail( '[email protected]', '新文章已发布', '文章标题：' . $post->post_title );
}
add_action( 'save_post', 'hello_world_on_post_publish', 10, 3 );

Filtrační háčky (Filter Hooks) vám umožňují upravovat data.the_contentPříkladem typické aplikace filtrů je například systém pro filtrování dat. Dalším běžným příkladem je úprava nadpisů článků.

function hello_world_modify_title( $title ) {
    return '【推荐】' . $title;
}
// add_filter( 'the_title', 'hello_world_modify_title' ); // 谨慎使用，这会修改所有标题

Vytvořte stránku s nabídkou správního menu a možností.

Mnoho pluginů vyžaduje backendové rozhraní pro konfiguraci nastavení. WordPress poskytuje funkce, které umožňují snadno přidávat hlavní nebo podmenü do administrace.

Doporučujeme k přečtení. Naučte se vyvíjet pluginy pro WordPress: vytvářejte efektivní přizpůsobené funkční moduly od nuly.。

Následující kód ukazuje, jak přidat jednoduchou stránku s možnostmi výběru a pomocí API pro nastavení WordPressu bezpečně uložit zvolenou možnost.

// 步骤1：向管理后台添加一个菜单项
function hello_world_add_admin_menu() {
    add_menu_page(
        '你好世界设置',       // 页面标题
        '你好世界插件',       // 菜单标题
        'manage_options',     // 所需权限
        'hello-world-settings', // 菜单slug
        'hello_world_settings_page', // 用于渲染页面的回调函数
        'dashicons-admin-generic', // 图标（可选）
        80                    // 菜单位置
    );
}
add_action( ‘admin_menu‘， ‘hello_world_add_admin_menu’ );

// 步骤2：定义设置页面的HTML内容
function hello_world_settings_page() {
    ?>
    <div class="”wrap”">
        <h1>Nastavení pluginu „Hello World“</h1>
        <form method="”post”" action="/cs/”options.php”/" data-trp-original-action="”options.php”">
            <?php
                settings_fields( ‘hello_world_settings_group’ ); // 输出设置字段和非ce字段
                do_settings_sections( ‘hello-world-settings’ ); // 输出设置部分
                submit_button(); // 输出提交按钮
            ?>
        <input type="hidden" name="trp-form-language" value="cs"/></form>
    </div>
    &lt;?php
}

// 步骤3：注册设置、字段和章节
function hello_world_settings_init() {
    // 注册一个新的设置项到“hello_world_settings_group”组
    register_setting( ‘hello_world_settings_group’， ‘hello_world_custom_message’ );

// 在页面中新增一个章节
    add_settings_section(
        ‘hello_world_settings_section’,
        ‘自定义消息设置’，
        ‘hello_world_settings_section_callback’，
        ‘hello-world-settings‘
    );

// 向章节中添加一个字段
    add_settings_field(
        ‘hello_world_message_field’,
        ‘前台显示的消息’，
        ‘hello_world_message_field_render’，
        ‘hello-world-settings’,
        ‘hello_world_settings_section’
    );
}
add_action( ‘admin_init’， ‘hello_world_settings_init’ );

// 章节描述的回调函数
function hello_world_settings_section_callback() {
    echo ‘<p>Zde nakonfigurujete obsah zpráv, které se zobrazují na předním panelu pomocí pluginů.</p>’;
}

// 字段渲染的回调函数
function hello_world_message_field_render() {
    $option = get_option( ‘hello_world_custom_message’， ‘这是默认消息’ );
    echo ‘<input type="”text”" name="”hello_world_custom_message”" value="”‘" . esc_attr( $option ) ‘“ size ="”40”" />’;
}

Prostřednictvím výše uvedeného kódu jste v pozadí vytvořili nastavení stránky, která splňuje standardy WordPress a umožňuje bezpečné ukládání dat.

Shared hosting od InterServeru

Sdílený hosting za 1 TB + 5 TB měsíčně za 2,50 USD, slevový kód tryinterserver pro první měsíc za 1 TB + 5 TB za 0,1 USD, a 461 skriptů cloudových aplikací k jednoduché instalaci.

přístupová stránka

Bezpečnost pluginů, jejich výkon a příprava k vydání

Před tím, než sdílíte plugin s ostatními nebo ho odevzdáte do oficiálního katalogu, je zásadní zajistit, aby byl bezpečný, efektivní a snadno použitelný.

Dodržovat osvědčené bezpečnostní postupy

Bezpečnost je nejdůležitějším aspektem při vývoji doplňků. Základním pravidlem je: nikdy nespoléhejte na data zadaná uživateli. Všechna data pocházející od uživatelů nebo z externích zdrojů musí být před použitím pečlivě ověřena.$_GET， $_POST， $_COOKIEPřed použitím pro databázové dotazy, výstup na stránky nebo spuštění systémových příkazů je nutné vše ověřit, očistit nebo escapeovat.

Pro obsah vypisovaný do HTML se použije…esc_html()， esc_attr()或wp_kses_post()Použijte funkce jako escape() k odstranění speciálních znaků.

`echo ‘`‘<div class="”“‘" . esc_attr( $user_provided_class ) ‘“>’ . esc_html( $user_provided_content ) . ‘</div>’;

Při dotazování databází nikdy nesmíte přímo spojovat proměnné do SQL příkazů. Musíte používat vhodné způsoby jejich vložení do dotazů.$wpdb->prepare()Předzpracování se provádí pomocí určité metody.

global $wpdb;
$user_id = 123;
$query = $wpdb->prepare(
    “SELECT * FROM {$wpdb->prefix}my_table WHERE user_id = %d”，
    $user_id
);
$results = $wpdb->get_results( $query );

Kromě toho musí všechny volatelné funkce, které jsou přístupné všem uživatelům (ať už jde o front-end AJAX nebo o operace na straně serveru), využívat…current_user_can()或check_ajax_referer()Funkce jako tyto provádějí ověřování oprávnění a zabezpečení.

Optimalizace výkonnosti pluginů

Pluginy s špatným výkonem mohou negativně ovlivnit uživatelský zážitek na celém webu. Optimalizace může začít hned z několika aspektů: rozumné využívání mezipaměti (caching), aby se při každém načtení stránky neprováděly složité dotazy do databáze nebo volání vzdálených API. WordPress nabízí funkci „Transient API“.（Transients API）umožňuje snadné ukládání dočasných dat.

// 尝试从缓存获取数据
$data = get_transient( ‘my_plugin_expensive_data’ );
if ( false === $data ) {
    // 缓存中没有，执行昂贵操作
    $data = expensive_database_query();
    // 将结果缓存12小时
    set_transient( ‘my_plugin_expensive_data’， $data， 12 * HOUR_IN_SECONDS );
}

Zadruhé, ujistěte se, že soubory CSS a JavaScript jsou načítány pouze na stránkách, kde jsou skutečně potřebné. To lze dosáhnout pomocí…wp_enqueue_script()和wp_enqueue_style()Funkce umožňují přesně ovládat načítání zdrojů a jejich závislosti. U zdrojů na pozadí je možné je připojit („mount“) k potřebným částem aplikace.admin_enqueue_scripts„Hook“; u front-end zdrojů se jedná o proces jejich připojení („mountování“) k systému.wp_enqueue_scriptsHák.

Připravit se na internacionalizaci a vydání.

Aby bylo možné používat pluginy uživatelům po celém světě, je internacionalizace (i18n) nezbytným krokem. To znamená, že všechny textové stránky určené pro uživatele musíte obalit do speciálních funkcí.

Převeďte řetězce z pluginu z:

echo “Hello World!”；

Změněte to na:

echo __( ‘Hello World!’, ‘hello-world’ );

Z toho‘hello-world’Bylo to vydefinováno vás v hlavičce pluginu.Text DomainPoté můžete použít nástroje, jako je Poedit, k vytvoření požadovaných souborů..potŠablony souborů – překladatelé mohou na základě nich vytvářet verze dokumentů v různých jazycích..po和.moSoubory. Umístěte tyto překladové soubory do části hlavy pluginu.Domain PathUrčená složka (např.)/languagesStačí kliknout na „Dolů“.

Před zveřejněním si prosím vždy pečlivě připravte podrobný popis produktu nebo obsahu.readme.txtSoubor musí být v souladu s oficiálními požadavky WordPressu a obsahovat popis pluginu, postupy instalace, časté otázky a další důležité informace. Toto je povinné podmínky pro předložení pluginu do adresáře s pluginy WordPressu. Kromě toho je do kódu pluginu nutné přidat podrobné PHP Doc poznámky – to nejen pomáhá ostatním lépe pochopit váš kód, ale také je projevem profesionality.

Závěr

Tento článek systematicky popisuje celý proces vývoje profesionálního WordPress pluginu od nuly. Začali jsme porozuměním základní struktuře pluginů a poté jsme vytvořili první jednoduchý plugin s logikou aktivace/deaktivace. Následně jsme se podrobněji zabývali silným systémem akcí a filtrů v WordPressu a způsoby, jak je efektivně integrovat s jádrem systému, a vytvořili jsme standardní stránky pro správu nastavení pluginu. Na závěr jsme zdůraznili nezbytná bezpečnostní pravidla, metody optimalizace výkonu a přípravy pluginu na mezinárodní vydání. Získáním těchto základních znalostí a dovedností budete schopni vytvářet bezpečné, efektivní a snadno udržovatelné profesionální WordPress pluginy, které uspokojí nejen osobní potřeby, ale také širší skupiny uživatelů.

Časté dotazy

K vývoji pluginů pro WordPress je potřeba ovládat následující základní znalosti:

Pro vývoj pluginů pro WordPress je nezbytná solidní znalost programování v PHP, neboť kód pluginů je většinou napsán v tomto jazyce. Je také důležité mít základní povědomí o HTML, CSS a JavaScriptu, abyste mohli správně zpracovávat vzhled a interakce na straně uživatele. Nejdůležitější však je dobře se seznámit s klíčovými koncepty WordPressu, jako jsou „hooky“, „shortcodes“, vlastní typy článků (Custom Post Types – CPT) a operace s databází.$wpdbPoužití…

Jak ladit WordPress plugin, na kterém pracujete?

Jednou z efektivních metod ladění je zapnutí funkce ladění (debugging) v WordPressu.WP_DEBUG„Režim.“ Ve vašem…wp-config.phpV dokumentu budou uvedeny následující informace:define( ‘WP_DEBUG’， false );Změňte to na:define( ‘WP_DEBUG’， true );Můžete také aktivovat obojí najednou.WP_DEBUG_LOGZaznamenejte chyby do souboru protokolů, nebo je aktivujte.WP_DEBUG_DISPLAYNa stránce se zobrazují chyby (pouze v vývojovém prostředí). Kromě toho je použití nástrojů pro vývojáře v prohlížeči (karta Konzola, karta Síť) nezbytným nástrojem pro ladění front-end JavaScriptu a AJAX požadavků.

Jak může můj plugin komunikovat a spolupracovat s ostatními pluginy?

Klíčem k zajištění dobré kompatibility je dodržování standardů kódování WordPressu a opatrné používání globálních proměnných a názvů funkcí. Nejlepší praxí při předcházení konfliktům při jménování je přidávání jedinečných předpon k funkcím, třídám a konstantám vašeho pluginu. Například:myplugin_Nebo použijte zkratky vývojářů jako předpony. Při úpravách obsahu, který může být související s jinými pluginy (např. obsahu článků, nadpisů), ujistěte se, že vaše funkce na zpracování filtrů má odpovídající prioritu.add_filterTřetí parametr…) a všímejte si formátu jeho návratové hodnoty. Používejte ho také rozumně.class_exists()或function_exists()K ověření, zda byla určitá třída nebo funkce již definována, lze implementovat podmíněné načítání dat nebo poskytnout náhradní řešení.

Je nutné ovládat objektově orientované programování (OOP) pro vývoj pluginů?

虽然使用传统的面向过程编程方式也可以开发功能完整的插件，但强烈推荐学习和使用面向对象编程（OOP）。OOP能够更好地组织代码，通过类（Class）来封装功能，提高代码的可复用性和可维护性。对于中大型插件项目，使用OOP结合命名空间（Namespaces）和自动加载（Autoloading）是行业内的标准做法，它能让你更清晰地区分不同模块，并显著降低代码的耦合度。