Od nuly ke jedničce: Postupně vás naučíme základním technikám vývoje pluginů pro WordPress

Vítejte ve fascinujícím světě vývoje doplňků pro WordPress. Jako nejpopulárnější systém pro správu obsahu na světě je WordPress známý svou vysokou rozšiřitelností, a právě doplňky jsou klíčem k dosažení této rozšiřitelnosti. Ať už si přejete vytvořit řešení pro konkrétní funkci, nebo plánujete proměnit své nápady na produkty, které mohou ostatní využívat, ovládnutí vývoje doplňků je velmi cennou dovedností. Tento článek vás provede od nejzákladnějšího nastavení prostředí až po vytvoření prvního kompletně funkčního doplňku.

Základní struktura a principy WordPress pluginů

Než začnete psát kód, je velmi důležité pochopit, jak je složen plugin a jak funguje v rámci systému WordPress. Plugin je v podstatě jedna nebo více PHP souborů, které komunikují s jádrem systému prostřednictvím API (Application Programming Interface) poskytovaného WordPressem.

Klíčový soubor pluginu

Každý plugin musí mít hlavní soubor. Tento hlavní soubor se obvykle jmenuje podle názvu pluginu, například… my-first-plugin.phpNa začátku tohoto souboru musí být specifický poznámkový řádek týkající se hlavičky pluginu. WordPress na základě těchto informací rozpozná a zobrazí daný plugin.

Doporučujeme k přečtení. Kompletní průvodce vývojem WordPress pluginů: Od základů až po pokročilé praktické návody。

<?php
/**
 * Plugin Name: 我的第一个插件
 * Plugin URI:  https://example.com/my-first-plugin
 * Description: 这是一个用于演示的简单WordPress插件。
 * Version:     1.0.0
 * Author:      开发者名称
 * License:     GPL v2 or later
 */

Tento komentář definuje metadata pluginu, jako je jeho název, popis, verze atd. V bezpečí těchto informací WordPress tento plugin nebude schopen rozpoznat.

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

Mechanismus „hooků“: Most mezi doplňky a hlavním programem

Hlavním hnacím motorem WordPressu je systém “hooků” (Hooks), který umožňuje pluginům v určitéch okamžicích přidat svůj vlastní kód za účelem změny nebo rozšíření výchozího chování webu. Hooky se dělí především na dvě kategorie: akce (Actions) a filtry (Filters).

Akční háčky vám umožňují spouštět vlastní kód po nastavení konkrétních událostech – například po zveřejnění článku, při přihlášení uživatele nebo před načtením stránky. Můžete je využít k různým účelům, jako je automatizace procesů, zasílání notifikací nebo upravení obsahu add_action() Funkce slouží k načtení a spuštění vaší vlastní funkce.

Filtrovací háčky vám umožňují upravovat data. Než jsou data odeslána do databáze nebo do prohlížeče, můžete je zastavit a změnit. To se dosahuje pomocí… add_filter() Funkce jsou implementovány pomocí těchto „hooků“. Porozumění a obratné používání těchto dvou typů hooků je základem pro vývoj pokročilých pluginů.

Nastavení vývojového prostředí a první plugin

Než začnete s kódováním, je nezbytné mít spolehlivé lokální vývojové prostředí. Díky němu můžete volně provádět testování a ladění, aniž by to ovlivnilo webové stránky v reálném prostředí.

Doporučujeme k přečtení. Technický průvodce celým procesem výstavby webových stránek: Praxe a strategie optimalizace od nuly až po jejich spuštění。

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

Doporučujeme použít integrovaná řešení lokálních serverů, jako je Local by Flywheel, XAMPP nebo MAMP. Tyto nástroje umožňují jednoduchou instalaci prostředí PHP, MySQL a webového serveru potřebného pro WordPress. Po instalaci vytvořte nový WordPress web určený k vývoji pluginů.

Vytvořte a aktivujte jednoduchý plugin.

Na vašem lokálním WordPress webu… wp-content/plugins V adresáři vytvořte nový složek, například… my-first-pluginV této složce vytvořte hlavní soubor. my-first-plugin.phpA zároveň to vložte do poznámky v hlavičce pluginu, o které bylo zmíněno výše.

Po uložení souboru se přihlaste do svého WordPress administrátorského panelu a přejděte do menu “Příslušenství” (Plugins). Měli byste vidět, že “Můj první plugin” (My First Plugin) je zařazen do seznamu pluginů. Klikněte na tlačítko “Aktivovat” (Activate) a váš první plugin bude nyní aktivní. I když zatím nemá žádné funkce, úspěšně jste vytvořili základní strukturu pluginu.

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 klíčových funkcí a bezpečnostních postupů

Smysl nějakého pluginu spočívá v jeho funkcích. Přidejme tomuto pluginu jednu jednoduchou, ale užitečnou funkci: automatické přidávání vlastního textu na konci obsahu článku.

Upravení obsahu článku pomocí filtrů

Využijeme to. the_content Tento filtrovací hook. Do hlavního souboru vašeho pluginu přidejte následující kód:

function myplugin_add_text_to_content( $content ) {
    // 检查是否为单篇文章页面
    if ( is_single() ) {
        $custom_text = '<p><em>Děkuji za přečtení! Tento článek byl přidán k mému prvnímu pluginu.</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
add_filter( 'the_content', 'myplugin_add_text_to_content' );

Tento kód definuje funkci. myplugin_add_text_to_contentPřijímá obsah článku. $content Jako parametr. Uvnitř funkce se to použije. is_single() Použijte značky pro podmínkové vyhodnocování, abyste zajistili, že text bude přidán pouze na stránce konkrétního článku. Nakonec… add_filter() Připojte tuto funkci… the_content Text byl přidán do filtru. Uložte soubor a obnovte stránku blogového článku – poté uvidíte přidaný text.

Doporučujeme k přečtení. Postupně vás naučím, jak od nuly vytvořit profesionální webovou stránku pomocí nástroje WooCommerce.。

Základní aspekty bezpečnosti pluginů

Bezpečnost je při vývoji doplňků (plug-inů) nesmírně důležitá. Nikdy nesmíte slepě důvěřovat datům, která uživatelé zadají, ani datům pocházejícím ze webových stránek.
1. Uvolněný výstup: Při výstupu jakýchkoli dat do prohlížeče je nutné provést jejich uvolnění („escape“), aby se zabránilo útokům typu cross-site scripting (XSS). WordPress nabízí nástroje k tomuto účelu, jako např.… esc_html(), esc_attr(), esc_url() A další pomocné funkce.
2. Ověřování a čištění vstupních dat: Data přijatá z uživatelských formulářů nebo URL parametrů musí být před použitím ověřena (zkontrolováno, zda je formát správný) a vyčištěna (odstraněny neplatné znaky). K tomu lze použít funkce, jako jsou… sanitize_text_field()。
3. Bezpečnost proti neoprávněným změnám: Pokud váš plugin zahrnuje úpravy dat (např. ukládání nastavení), je nutné použít WordPressův mechanismus „Nonce“ k ověření účelu požadavku, aby bylo zabráněno napadení typu Cross-Site Request Forgery (CSRF).

Přidání správního rozhraní pro plugin

Většina pluginů vyžaduje stránku se nastaveními, kterou mohou uživatelé konfigurovat. Vytvoříme jednoduchou stránku s možnostmi, která umožní uživatelům nastavit text, který se má přidat na konec článku.

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

Vytvoření správního menu a stránek

Můžeme to použít. add_menu_page() 或 add_options_page() Funkce slouží k přidání položky menu do backendu WordPressu. Následující kód přidá stránku s možnostmi pod submenu “Nastavení”:

function myplugin_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',              // 菜单标题
        'manage_options',        // 所需权限
        'myplugin-settings',     // 菜单Slug
        'myplugin_render_settings_page' // 用于渲染页面的回调函数
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

Dále potřebujeme definovat funkci volání zpět (callback function). myplugin_render_settings_page Generujte HTML obsah stránky pro nastavení a zpracujte logiku ukládání formulářů. Na stránce by mělo být použito WordPress API pro nastavení (Settings API) k bezpečnému zpracování nastavení, ale jako úvodní příklad je zde uvedena zjednodušená verze:

function myplugin_render_settings_page() {
    ?>
    <div class="wrap">
        <h2>Nastavení mého pluginu</h2>
        <form action="/cs/options.php/" method="post" data-trp-original-action="options.php">
            <?php settings_fields( 'myplugin_settings_group' ); ?>
            <label for="custom_text">Vlastní text:</label><br/>
            <textarea id="custom_text" name="myplugin_custom_text" rows="4" cols="50"><?php echo esc_textarea( get_option( 'myplugin_custom_text' ) ); ?></textarea>
            <p class="submit">
                <input type="submit" name="submit" class="button-primary" value="Uložit změny" />
            </p>
        <input type="hidden" name="trp-form-language" value="cs"/></form>
    </div>
    <br />&lt;?php
}

Zaregistrujte nastavení a zpracujte data.

Potřebujeme registrovat určitou nastavení a zajistit, aby byla bezpečně uložena. To se obvykle provádí při inicializaci pluginu:

function myplugin_register_settings() {
    register_setting(
        'myplugin_settings_group', // 设置分组
        'myplugin_custom_text',    // 选项名称
        'sanitize_textarea_field'  // 清理回调函数
    );
}
add_action( 'admin_init', 'myplugin_register_settings' );

Nakonec upravte funkci, která přidává obsah článků, tak aby vycházela z dat z databáze. myplugin_custom_text Čte text uložený uživatelem, místo aby se používal text zakódovaný v kódu.

Závěr

Tento článek vás provedl celým procesem vývoje WordPress pluginů – od základů až po pokročilé funkce. Začali jsme porozuměním základní struktuře pluginů a mechanismu “hooků” v jádru WordPressu, poté postupně vytvořili lokální vývojové prostředí, vytvořili a aktivovali první plugin. Následně jsme se na příkladu přidávání textu do článků naučili, jak používat filtry, a zdůraznili důležitost bezpečnostních postupů při vývoji pluginů. Nakonec jsme pluginu přidali konfigurovatelnou stránku pro správu nastavení.

Po zvládnutí těchto základních dovedností máte již potřebné znalosti k dalšímu zkoumání hlubších aspektů vývoje pluginů. Následně můžete prozkoumat pokročilá témata, jako jsou vlastní typy článků, metadata (Meta Box), zkratky kódu (Shortcode), REST API endpointy a Ajax volání, abyste vytvořili funkčnější a výkonnější WordPress pluginy.

Časté dotazy

Co jsou předpokládané znalosti potřebné k vývoji plug-inů?

Potřebujete mít základní znalosti programovacího jazyka PHP, protože jádro WordPressu i jeho pluginy jsou napsány v PHP. Rovněž by bylo velmi užitečné mít znalosti HTML, CSS a základních funkcí JavaScriptu, zejména pokud potřebujete vytvářet uživatelské rozhraní. Znalost základních konceptů databáze MySQL je také výhodou.

Jak ladit kód mého pluginu?

Nejčastěji používanou metodou ladění při vývoji v WordPressu je aktivace WP_DEBUGMůžete to udělat na webových stránkách. wp-config.php V dokumentu budou uvedeny následující informace: define(‘WP_DEBUG’， true); Změňte hodnotu v této řádku na… trueTímto se všechny chyby, varování a upozornění v PHP zobrazí na obrazovce a zároveň budou zaznamenány do souboru protokolu (log file). Kromě toho… error_log() Funkce zapisuje informace o proměnných do chybového logu serveru, což je také velmi užitečný nástroj pro ladění kódu.

Jak by měl můj plugin zpracovávat podporu více jazyků?

Pro internacionalizaci vašeho pluginu je třeba použít funkce pro překlad v WordPressu (např. __()， _e()Všechny řetězce určené pro uživatele je třeba obalit pomocí určitých závorek. Poté lze pomocí nástrojů, jako je Poedit, tyto řetězce vytvořit. .pot Šablony souborů – překladatelé mohou na základě nich vytvářet verze dokumentů v různých jazycích. .po 和 .mo Soubor. Nakonec jej použijte v hlavním souboru pluginu. load_plugin_textdomain() Funkce slouží k načtení souborů s překlady.

Po dokončení vývoje, jak nahrát plugin do oficiálního adresáře?

Nejprve se ujistěte, že váš plugin plně dodržuje oficiální kódovací standardy WordPressu a licenci GPL. Poté si na stránkách WordPress.org zažádejte o SVN repozitář určený k ukládání pluginů. K odeslání kódu vašeho pluginu do tohoto repozitáře budete potřebovat nástroje určené k práci s SVN. /trunk Obsah. Zároveň připravte kvalitní materiály. readme.txt Snímky obrazovky souborů, pluginů a jejich ikony. Po odeslání vašeho pluginu ho posoudí oficiální kontrolní tým. Po schválení bude moci být veřejně zveřejněn v oficiálním adresáři.