Průvodce vývojem pluginů pro WordPress: Vytvořte si vlastní funkční moduly od nuly

Proč je potřeba vytvářet vlastní pluginy pro WordPress?

Jednou z základních designových filozofií WordPressu je jeho vysoká rozšiřitelnost, a pluginy jsou hlavním nástrojem k dosažení tohoto cíle. Ačkoli oficiální knihovna pluginů nabízí obrovský výběr, vývoj vlastních pluginů přináší jedinečné výhody. Pokud stávající pluginy nedokáží perfektně odpovídat vaší obchodní logice, mají problémy s výkonem nebo obsahují nadbytečné funkce, je nejlepším řešením jejich vlastní vývoj. Díky tomu můžete vytvořit řešení, které plně odpovídá požadavkům vašeho projektu, má kompaktní kód a je snadno udržovatelné.

Díky vývoji pluginů můžete oddělit vlastní funkce od samotného tématu webové stránky. Jedná se o zásadní a důležitou osvědčenou praxi, která zajišťuje, že i po změně tématu zůstanou základní funkce webové stránky funkční. Kromě toho dobře zakódované pluginy lze snadno přenášet mezi různými projekty, což výrazně zvyšuje efektivitu vývoje. Pro vývojáře, kteří chtějí hlouběji pochopit principy fungování WordPressu, zdokonalit své dovednosti v programování PHP nebo plánují vydávat komerční pluginy, je ovládnutí vývoje pluginů nezbytné.

Vytvoření základní struktury vašeho prvního pluginu

Vytvořte WordPress plugin začínáním vytvořením jednoduchého adresáře a hlavního souboru na správném místě. To je výchozí bod pro vývoj jakéhokoli pluginu.

Doporučujeme k přečtení. Od začátku až po praxi: Kompletní průvodce vývojem pluginů pro WordPress a pokročilé tipy.。

Vytvoření hlavního souboru pluginu

Všechny pluginy musí mít hlavní PHP soubor, který obsahuje specifické poznámky („header comments“) určené k deklaraci pluginu systému WordPress. Tento soubor se obvykle nazývá stejně jako název pluginu. Například můžeme vytvořit soubor s názvem… my-first-plugin.php Soubor „“.

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

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

Tento komentář je klíčový pro rozpoznávání pluginů v WordPressu. Pole “Plugin Name” je povinné, ostatní informace jsou volitelné. Po vytvoření tohoto souboru jej umístěte do příslušného adresáře v WordPressu. /wp-content/plugins/my-first-plugin/ V adresáři najdete daný plugin a můžete ho aktivovat na stránce “Pluginy” v administraci WordPressu.

Porozumění bezpečnosti pluginů a osvědčeným postupům při jejich využívání

Před napsáním jakéhokoli funkčního kódu je nezbytné zajistit bezpečnostní ochranu. WordPress poskytuje velké množství globálních proměnných a funkcí; přímý přístup k jáderným souborům je nebezpečný a není povolen. Proto by měl být na začátku všech PHP souborů pluginů přidán kód, který zabraňuje takovému přístupu.

Přidejte následující kód hned za poznámkou v hlavičce vašeho hlavního souboru pluginu:

// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
    exit; // 如果ABSPATH未定义，则退出
}

Konstanta ABSPATH Jedná se o absolutní cestu k kořenovému adresáři WordPressu, která je definována při inicializaci prostředí WordPress. Kontrolou tohoto konstantního proměnného lze efektivně zabránit tomu, aby někdo přímo prostřednictvím URL přistupoval k vašim pluginovým souborům, čímž se eliminují potenciální bezpečnostní rizika. Jedná se o první a zároveň nejdůležitější bezpečnostní postup při vývoji pluginů.

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

Využití hooků k rozšíření funkcí WordPress

Jádrem architektury pluginů v WordPressu je systém “hooků”, který vám umožňuje v určitých okamžicích vložit vlastní kód za účelem úpravy nebo vylepšení základních funkcí bez nutnosti měnit samotné soubory jádra WordPressu. Hooky se dělí především na dvě kategorie: akce (Actions) a filtry (Filters).

Provedení úkolu pomocí akčních háčků

Akční háčky vám umožňují spouštět vlastní funkce při nastání určitých událostí. Například při zveřejnění článku, při přihlášení uživatele nebo při načtení hlavičky webové stránky. Chcete-li použít akční háček, musíte… add_action() Funkce.

Předpokládejme, že chceme na vrchol správního panelu webové stránky přidat vlastní vítací zprávu. Můžeme ji tam připojit. admin_notices Tento „akční háček“ je připojen…

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

function my_custom_admin_notice() {
    echo '<div class="notice notice-success is-dismissible"><p>Vítejte v administraci webové stránky! Toto upozornění bylo přidáno mým pluginem.</p></div>';
}
add_action( 'admin_notices', 'my_custom_admin_notice' );

Přidejte tento kód do svého hlavního pluginového souboru. Po aktivaci pluginu se vám tato upozornění zobrazí pokaždé, když se přihlásíte do administrace. Funkce: my_custom_admin_notice Je to callback funkce, kterou jsme sami definovali.add_action() Připojte to k… admin_notices Závěsy jsou navzájem propojeny.

Upravování dat pomocí filtrovacích hooků

Filtrovací háčky slouží k úpravě dat před jejich uložením, zobrazením nebo použitím. Přijímají data, která jsou poté zpracována vaší funkcí, a nakonec musí vrátit upravená data. To se provádí pomocí… add_filter() Funkce je implementována pomocí programovacího kódu.

Klasickým příkladem je úprava textu na konci nadpisů článků. Například bychom chtěli přidat název webové stránky za název všech článků.

Doporučujeme k přečtení. Začínáme od nuly: Kompletní průvodce vývojem pluginů pro WordPress a sdílení osvědčených postupů.。

function modify_post_title( $title ) {
    // 确保只在主循环的单篇文章页面修改
    if ( is_single() && in_the_loop() ) {
        $title .= ' | 我的网站';
    }
    return $title;
}
add_filter( 'the_title', 'modify_post_title' );

Zde,modify_post_title Funkce přijímá původní text nadpisu jako parametr, po přidání názvu webové stránky jej poté vrací. WordPress použije tento upravený text k zobrazení. Porozumění rozdílu mezi akcemi a filtry (jedna provádí úkol, druhá upraví a vrátí data) je klíčové pro efektivní využití hooků.

Vytvořte správní stránku pro plugin.

Mnoho pluginů vyžaduje interakci s administrátorem, což znamená nutnost přidání vlastních administrátorských menu a nastavovacích stránek. WordPress poskytuje řadu funkcí, které usnadňují rozšíření administrátorského menu.

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

Přidat hlavní správní menu

Použití add_menu_page() Funkce umožňuje přidat vašemu pluginu hlavní položku do nabídky na správní straně (správní panelu). Toto je obvykle vstupní bod pro konfiguraci pluginu.

Vytvořme jednoduchou stránku “Nastavení mých pluginů”.

function my_plugin_add_menu_page() {
    add_menu_page(
        '我的插件设置',          // 页面标题（浏览器标签）
        '我的插件',              // 菜单标题
        'manage_options',       // 所需权限
        'my-plugin-settings',   // 菜单slug（URL标识）
        'my_plugin_settings_page', // 用于渲染页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        30                      // 菜单位置
    );
}
add_action( 'admin_menu', 'my_plugin_add_menu_page' );

Následně potřebujete definovat tyto callback funkce, které byly výše použity. my_plugin_settings_page Zadejte obsah HTML stránky, který chcete přeložit.

function my_plugin_settings_page() {
    ?>
    <div class="wrap">
        <h1>Nastavení mého pluginu</h1>
        <form method="post" action="/cs/options.php/" data-trp-original-action="options.php">
            <?php
            // 输出设置字段（后续可与设置API结合）
            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
}

Integrace s API pro nastavení WordPressu

Manuální zpracování odeslání a ověření formulářů je náročné a náchylné k chybám. WordPress API (Settings API) vám tyto procesy automatizuje, včetně ověřování Nonce, kontroly oprávnění a ukládání dat.

Nejprve musíte registrovat nastavení, přidat bloky nastavení a pole.

function my_plugin_settings_init() {
    // 注册一组设置
    register_setting( 'my_plugin_options_group', 'my_plugin_option_name' );

// 添加一个设置区块
    add_settings_section(
        'my_plugin_section_id',
        '主要设置',
        null, // 可选的区块描述回调函数
        'my-plugin-settings'
    );

// 向区块中添加一个字段
    add_settings_field(
        'my_plugin_field_id',
        '示例文本字段',
        'my_plugin_field_callback',
        'my-plugin-settings',
        'my_plugin_section_id'
    );
}
add_action( 'admin_init', 'my_plugin_settings_init' );

// 字段的回调函数，用于输出HTML输入框
function my_plugin_field_callback() {
    $option = get_option( 'my_plugin_option_name' );
    echo '<input type="text" name="my_plugin_option_name" value="' . esc_attr( $option ) . '" />';
}

Nyní má vaše nastavovací stránka pole formuláře chráněné API pro nastavení, a jeho hodnota bude bezpečně uložena do WordPressu. options V databázové tabulce. Prostřednictvím… get_option( 'my_plugin_option_name' ) Tuto hodnotu lze získat kdekoli na straně klienta (frontendu) nebo na straně serveru (backendu).

Závěr

Vývoj pluginů pro WordPress je proces, při kterém se kreativita proměňuje v silné, funkční nástroje. Začínáme porozuměním toho, proč jsou vlastní pluginy vůbec potřebné, poté postupně vytváříme základní strukturu pluginu a zdůrazňujeme důležitost bezpečného kódu. Klíčovým aspektem je ovládnutí systému hooků v WordPressu – prostřednictvím akcí a filtrů dokážeme bezproblémově interagovat s jádrem systému. Nakonec zkoumáme, jak vytvořit profesionální uživatelské rozhraní pro správu pluginů a jak pomocí API Settings bezpečně zpracovávat uživatelské nastavení. Dodržováním těchto kroků a osvědčených postupů můžete vytvořit pluginy, které jsou strukturované, bezpečné, spolehlivé a snadno udržovatelné, a tím skutečně uvolnit neomezený potenciál WordPressu.

Časté dotazy

Jaké základní znalosti jsou potřebné k vývoji pluginů pro WordPress?

Pro vývoj pluginů pro WordPress jsou zapotřebí základní znalosti programovacího jazyka PHP, neboť kód pluginů je většinou psán v PHP. Stejně tak je důležité mít základní povědomí o HTML, CSS a JavaScript, které slouží k vytváření uživatelského rozhraní a interakcí na stránkách. Rovněž je velmi užitečné porozumět základním konceptům WordPressu, jako jsou články, stránky, uživatelské role a základním vzorcům pro zpracování dat (např. The Loop).

Kde by měly být umístěny funkce pluginů a temat (tém)?

Jedná se o klíčový problém týkajícího se osvědčených postupů v programování. Veškerý kód související s funkcemi webové stránky, zadní částí aplikace (backendem) a manipulací s daty by měl být umístěn do pluginů. Naopak kód, který je úzce spojen s vizuálním zpracováním webové stránky, jejím uspořádáním a stylym (např. s šablonami stránek, CSS a front-end JavaScriptem), by měl být umístěn do temat (themes). Největší výhodou tohoto přístupu je zajištění toho, že při změně temat nebudou ztraceny základní funkce webové stránky. Například kód pro registraci vlastního typu článku by měl být uložen v pluginu, zatímco šablony pro zobrazení tohoto typu článku mohou být umístěny do temat.

Jak ladit plugin, který právě vyvíjíte?

Prvním krokem je povolení režimu ladění (debugging mode) v WordPressu. Ve vašem… wp-config.php V dokumentu budou uvedeny následující informace: WP_DEBUG Konstanta je nastavena na trueTo zobrazí přímo na stránce chyby, varování a upozornění PHP. Současně je možné to využít… error_log() Funkce zapisuje vlastní laděcí informace do chybového logu serveru. Pro složitější ladění lze zvážit použití specializovaných nástrojů pro ladění PHP, jako je Xdebug, nebo instalaci doplňků pro sledování dotazů do databáze (např. Query Monitor), které umožňují sledovat provádění databázových dotazů, hooků a dat o výkonu.

Jak můj plugin implementovat internacionalizaci?

WordPress využívá framework GNU gettext k implementaci internacionalizace (i18n) a lokalizace. Ve svém pluginu musíte všechny textové stránky, které potřebují být přeloženy, obalit pomocí specifických funkcí. Nejčastěji používanou funkcí je… __() Slouží k překladu a návratu řetězců v kódu, stejně jako… _e() K použití při překladu a přímém výstupu řetězců. Je také nutné správně nastavit poznámky v hlavičce pluginu. Text DomainA použít to při načítání pluginu. load_plugin_textdomain() Funkce slouží k načtení souborů s překlady. Poté můžete použít software jako Poedit k vytvoření požadovaných výstupních souborů. .pot Šablony souborů a vytvoření verzí pro různé jazyky .po 和 .mo Překládání dokumentů.