Ultimátní průvodce vývojem WordPress pluginů: Vytvořte profesionální plugin od nuly

Přípravné práce a nastavení prostředí.

Než začnete psát kód, je velmi důležitá stabilní a efektivní vývojová prostředí. To zahrnuje nejen lokální vývojové nástroje, ale také pochopení základní architektury WordPressu.

Nastavení lokálního vývojového prostředí.

Doporučujeme použít lokální serverové integrační prostředí, jako je Local by Flywheel, XAMPP nebo MAMP. Tyto nástroje umožňují jednoduchou instalaci a konfiguraci PHP, MySQL a webového serveru. Ujistěte se, že verze PHP je kompatibilní s aktuální verzí WordPress (obvykle je požadována verze PHP 7.4 nebo vyšší) a že je aktivována funkce ladění chyb. V rámci WordPressu…wp-config.phpV dokumentu jsou nastavení.WP_DEBUG为trueBěhem vývojového procesu se tak zobrazí všechna varování a chyby, což vám pomůže rychle lokalizovat problémy.

Základní poznatky o pluginech a plánování jejich struktury

Standardní WordPress plugin je složka, která obsahuje alespoň jednu PHP soubor, a je umístěna v…/wp-content/plugins/V hlavičce hlavního souboru pluginu musí být obsaženy specifické metadatové poznámky, pomocí kterých WordPress rozpoznává a spravuje plugin. Při plánování je důležité jasně definovat hlavní funkce pluginu, datové tabulky, které je potřeba vytvořit (pokud je to nutné), a způsob, jakým bude plugin integrován do systému WordPress – do menu, nástrojů, šablon atd. Jasný plán pomůže předejít následnému strukturálnímu zmatku během vývoje.

Doporučujeme k přečtení. Od základů po mistrovství: Kompletní průvodce vývojem WordPress pluginů a praktické tutoriály。

Vytvoření prvního hlavního souboru pro plugin

Vše začíná hlavním souborem – jedná se o vstupní bod pro plugin, který je zodpovědný za definování základních informací o pluginu a za spouštění jeho klíčových funkcí.

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

Napsat informace o hlavičce pluginu

Hlavička hlavního souboru pluginu musí obsahovat poznámky s informacemi o pluginu ve standardním formátu. Tyto poznámky začínají…/* ... */Balíček obsahuje název pluginu, popis, verzi, autora a další informace. Stránka se seznamem pluginů v administraci WordPressu tyto údaje načte a zobrazí. Například nejjednodušší záhlaví pluginu může vypadat takto:

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

Mezi nimi,Text DomainUrčeno pro mezinárodní překlady; je nutné, aby text byl konzistentní s textovými oblastmi používanými při následných voláních funkcí pro překlad.

Implementace logiky aktivace a deaktivace pluginů

Když uživatel klikne na “Aktivovat” nebo “Deaktivovat” plugin, může být potřeba provést některé inicializační a úklidové operace. Toho je dosaženo registrací hooků pro aktivaci a deaktivaci. Související funkce jsou…register_activation_hook()和register_deactivation_hook()Aktivace hooků se obvykle používá k vytváření vlastních databázových tabulek, inicializaci možností a dalším jednorázovým nastavením. Je důležité si uvědomit, že inicializační kód nemá být psán přímo do hlavního spouštěcího souboru pluginu, ale měl by být uložen do funkcí hooků. Jinak by se tento kód spouštěl pokaždé, když se stránka načte.

// 注册激活钩子
register_activation_hook( __FILE__, 'my_first_plugin_activate' );
function my_first_plugin_activate() {
    // 创建选项或数据库表
    if ( ! get_option( 'my_plugin_options' ) ) {
        add_option( 'my_plugin_options', [ 'default_key' => 'default_value' ] );
    }
    // 可能需要刷新WordPress的重写规则
    flush_rewrite_rules();
}

// 注册停用钩子
register_deactivation_hook( __FILE__, 'my_first_plugin_deactivate' );
function my_first_plugin_deactivate() {
    // 清理临时数据，但通常保留用户设置
    // 例如：删除定时任务
    wp_clear_scheduled_hook( 'my_daily_event' );
    // 注意：一般不在此处删除数据库表或选项，卸载时会处理
}

Praxe vývoje klíčových funkcí

Po zvládnutí základní struktury se podíváme hlouběji do jádra rozšiřovacích možností WordPressu a využijeme akční háčky (action hooks) a filtry (filters) k přidávání nových funkcí.

Doporučujeme k přečtení. Průvodce vývojem WordPress pluginů: Postupné vytvoření vašeho prvního vlastního pluginu。

Přidání funkce pomocí akčních háčků

Akční háčky (Action Hooks) vám umožňují vložit vlastní kód v určitých bodech prováděcího procesu WordPressu. Například, pokud chcete automaticky přidat informace o autorských právech na konci obsahu článku, můžete to provést pomocí akčních háčků.the_contentTento filtr patří mezi speciální typy akcí. Typičtější akce zahrnují např.:wp_enqueue_scriptsSlouží k bezpečnému načítání front-end skriptů a stylů. Používejte…add_action()Funkce slouží k načtení vaší volané funkce (callback function).

// 在文章内容末尾添加自定义HTML
add_filter( 'the_content', 'my_content_filter' );
function my_content_filter( $content ) {
    if ( is_single() ) {
        $custom_html = '<div class="my-copyright">Copyright to this article belongs to this website.</div>';
        $content .= $custom_html;
    }
    return $content;
}

// 正确加载前端资源
add_action( 'wp_enqueue_scripts', 'my_plugin_enqueue_assets' );
function my_plugin_enqueue_assets() {
    wp_enqueue_style(
        'my-plugin-style',
        plugins_url( 'assets/css/style.css', __FILE__ ),
        [],
        '1.0.0'
    );
    wp_enqueue_script(
        'my-plugin-script',
        plugins_url( 'assets/js/script.js', __FILE__ ),
        [ 'jquery' ], // 声明依赖jQuery
        '1.0.0',
        true // 在页面底部加载
    );
}

Vytvoření správní stránky a menu

Aby uživatelé mohli v pozadí konfigurovat váš plugin, je potřeba vytvořit správné menu a stránky. Použijte k tomu odpovídající nástroje a postupy.add_menu_page()或add_submenu_page()Funkce. Tento proces je obvykle také připojen („montován“)…admin_menuAkce je připojena k hooku. V zpětné volání (callback function) potřebujete vypsat HTML obsah stránky a zpracovat data z odeslaného formuláře uživatele (obvykle pomocí API pro nastavení WordPressu).settings_apiZjednodušeně řečeno…

add_action( 'admin_menu', 'my_plugin_create_admin_menu' );
function my_plugin_create_admin_menu() {
    add_menu_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 所需权限
        'my-plugin-settings', // 菜单slug
        'my_plugin_settings_page', // 显示页面的回调函数
        'dashicons-admin-generic', // 图标
        80 // 位置
    );
}

function my_plugin_settings_page() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
        <form action="/cs/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段、非ce等
            settings_fields( 'my_plugin_options_group' );
            do_settings_sections( 'my-plugin-settings' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="cs"/></form>
    </div>
    <br />&lt;?php
}

Bezpečnost, optimalizace a vydávání pluginů

Profesionální plugin kromě kompletní funkčnosti musí také dbát na bezpečnost a výkon, a také musí být dobře připraven před vydáním.

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

Implementace ověřování dat a jejich escapeování

Bezpečnost je při vývoji doplňků nejdůležitějším aspektem. Veškerá data pocházející od uživatelů nebo z externích zdrojů (např.…)$_GET， $_POST， $_REQUESTVšechny tyto zdroje dat nemohou být považovány za důvěryhodné. Před uložením dat do databáze je nutné provést jejich ověření (validation), abyste se ujistili, že data odpovídají očekávanému formátu. Při výstupu dat do HTML, JavaScriptu nebo URL je nutné provést jejich eskalaci (escaping), aby se zabránilo útokům typu XSS (Cross-Site Scripting). WordPress poskytuje řadu pomocných funkcí k tomuto účelu.sanitize_text_field()、esc_html()、esc_url()和wp_kses_post()Atd.

// 处理表单提交示例
if ( isset( $_POST['my_input'] ) ) {
    // 1. 验证和清理输入
    $clean_input = sanitize_text_field( wp_unslash( $_POST['my_input'] ) );

// 2. 处理数据...
    update_option( 'my_saved_input', $clean_input );

// 3. 输出时进行转义
    echo '<p>To, co jste zadali, je: ' . esc_html( get_option( 'my_saved_input' ) ) . '</p>';
}

Příprava na internacionalizaci a lokalizaci

Aby váš plugin mohl být používán uživateli po celém světě, je nutné provést přípravu na internacionalizaci (i18n). To znamená, že všechny textové stránky určené pro uživatele nesmí být přímo zakódovány do kódu, ale musí být obaleny pomocí funkcí pro překlad v WordPressu. Hlavně se používají…()Slouží k zobrazení přeloženého textu._e()Určeno k přímému výstupu.esc_html()Tyto značky (např. „\“) se používají k escapeování speciálních znaků v kódu. Předtím jste je definovali v části hlavy pluginu.Text DomainPoužijte to právě zde. Poté můžete vytvořit soubor pomocí nástrojů, jako je Poedit..potŠablonový soubor, který mají překladatelé použít k vytvoření překladu..po和.moPřekládání dokumentů.

// 在代码中包装可翻译字符串
$greeting = __( 'Hello, world!', 'my-first-plugin' );
_e( 'Settings saved successfully!', 'my-first-plugin' );

// 带占位符的翻译
printf(
    /* translators: %s: User's name */
    __( 'Welcome, %s!', 'my-first-plugin' ),
    esc_html( $user_name )
);

Příprava seznamu pluginů ke zveřejnění

Před tím, než nahráte plugin do oficiální databáze pluginů WordPress nebo ho začnete distribuovat, proveďte následující kontroly: Ujistěte se, že kód splňuje standardy kódování WordPress; napište podrobný…readme.txtSoubory musí být v souladu s oficiálními požadavky na formát. Je nutné provést komplexní funkční testování, včetně kompatibility s různými tématy a dalšími doplňky. Při kompresi složky s doplňky se ujistěte, že zahrnuje pouze nutné soubory a neobsahuje adresáře systému pro správu verzí (např. …)..git) nebo konfigurační soubor IDE.

Doporučujeme k přečtení. Průvodce vývojem pluginů pro WordPress: Postavte si své první funkční rozšíření od nuly。

Závěr

Vývoj profesionálního WordPress pluginu od nuly je systémový proces, který zahrnuje přípravu prostředí, plánování struktury, kódování samotného pluginu a bezpečné jeho vydání. Klíčovým aspektem je hluboké pochopení systému hooků (akcí a filtrů) v WordPressu, který je základním mechanismem pro rozšíření jeho funkcí. Bezpečnost a internacionalizace by měly být považovány za základní požadavky již na počátku vývoje, nikoli za něco, co lze dodatečně přidat až později. Dodržováním osvědčených postupů – jako je používání API poskytovaných WordPressem, přísná validace a escapeování dat, a rozumné plánování struktury kódu – můžete vytvořit nejen funkčně výkonný plugin, ale také zajistit, že bude stabilní, bezpečný a snadno udržovatelný. Tím přispějete k kvalitnímu rozvoji WordPress ekosystému.

Časté dotazy

Jaké programovací znalosti jsou potřebné k vývoji WordPress pluginu ###?
Pro vývoj pluginů pro WordPress je nutné ovládat jazyk PHP, protože samotný WordPress je napsán v PHP. Zároveň je důležité mít základní znalosti HTML, CSS a JavaScriptu, abyste mohli správně zpracovávat vzhled a interakce na straně uživatele. Kromě toho jsou užitečné základní znalosti databáze MySQL při práci s komplexnějšími operacemi s daty.

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

Jak ladit kód mého WordPress pluginu?

Nejúčinnější způsob je…wp-config.phpAktivováno v souboru.WP_DEBUGNastavte to na…define( 'WP_DEBUG', true );Tímto způsobem se zobrazí všechny chyby, varování a upozornění v PHP. Pro složitější ladění lze použít…error_log()Funkce zapisuje informace o proměnných do chybového logu serveru, nebo používá speciální ladící nástroje k sledování dotazů a dalších procesů.

Jak je můj plugin kompatibilní s tématem nebo jinými pluginy?

Nejlepšími postupy pro zvýšení kompatibility jsou: vždy používat API a funkce poskytované oficiálně WordPressem, vyhýbat se používání soukromých funkcí nebo přímému manipulování s databází; přidávat jedinečné předpony k názvům vašich funkcí, tříd a možností, abyste předešli konfliktům při jejich pojmenovávání; a pokud je to možné, poskytovat filtry.apply_filtersDovolte ostatním vývojářům upravovat výstup vašeho pluginu; zároveň se vyhněte vkládání příliš konkrétních stylů do pluginu, aby nedošlo k narušení designu tématu.

Musí být pro plugin vytvořena samostatná databázová tabulka?

Nemusí to být nutné. Ve většině případů by mělo být upřednostněno využití vestavěných způsobů ukládání dat v WordPressu, jako jsou vlastní typy příspěvků (Custom Post Types), taxonomie (Taxonomy) nebo tabulky nastavení (Option Tables).wp_optionsTyto API byly důkladně optimalizovány a jsou plně integrovány s jádrem systému. Vytváření vlastních datových tabulek by mělo být zváženo pouze v případě, že je vaše datová struktura velmi složitá a nelze ji mapovat do stávajících systémů, protože to zvyšuje náročnost na údržbu a migraci dat.

Jak odeslat svůj plugin do oficiálního adresáře pluginů WordPress?

Nejprve si musíte vytvořit účet na stránkách WordPress.org a následně tam odeslat svůj plugin. Váš plugin musí splňovat řadu požadavků, mezi které patří použití licenční smlouvy kompatibilní s verzí GPLv2 nebo vyšší, kód musí odpovídat základním standardům a plugin musí obsahovat správně formátované informace.readme.txtPo odeslání souborů a dalších potřebných materiálů je následován proces manuálního posouzení týmem specialistů na kontrolu pluginů. Tento proces může trvat několik týdnů. Po úspěšném posouzení získáte přístup k oficiálnímu SVN repozitáři, který vám umožní spravovat verze pluginů.