Kompletní ovládnutí vývoje pluginů pro WordPress: Vytvoření vlastních funkcí od nuly

Proč se rozhodnout pro vývoj pluginů pro WordPress?

WordPress, jako nejpopulárnější systém pro správu obsahu na světě, vděčí své vysoké rozšiřitelnosti především mechanismu pluginů. Díky vývoji vlastních pluginů mohou vývojáři překonat omezení daných temát a přidat na webové stránky jakékoli požadované funkce, aniž by bylo nutné měnit základní soubory systému. Toto zajišťuje nezávislost a udržovatelnost funkcí a zároveň usnadňuje jejich přesun mezi různými webovými stránkami a opakované použití.

Dobře navržený plugin musí být kompatibilní s hlavními aktualizacemi WordPressu a dodržovat jeho kódovací standardy a osvědčené postupy. To nejen zvyšuje bezpečnost webové stránky, ale také poskytuje solidní základ pro budoucí vylepšení a funkční rozšíření. Ať už jde o splnění specifických požadavků podniku, řešení problémů, které stávající pluginy nedokáží správně vyřešit, nebo o vydání produktu na trh, ovládnutí dovedností vývoje pluginů je nezbytnou součástí pokroku pro vývojáře WordPressu.

Vytvořte si svůj první plugin: Základní struktura

Pro vytvoření WordPress pluginu je nejprve nutné pochopit jeho základní strukturu. Každý plugin musí mít alespoň jednu hlavní soubor, která obvykle nese název pluginu. Například: my-first-plugin.phpPoznámky o pluginu umístěné na začátku tohoto souboru jsou nezbytné, protože poskytují systému WordPress základní informace o tomto pluginu.

Doporučujeme k přečtení. Naučte se vyvíjet pluginy pro WordPress: vytvořte svůj první vlastní funkční modul od nuly až po dokončení.。

Vytvoření hlavního souboru pluginu

Hlavní soubor pluginu je vstupním bodem tohoto pluginu. Je nutné do začátku tohoto souboru přidat standardní blok poznámek s informacemi o pluginu. Níže je uveden nejzákladnější příklad kódu:

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://example.com/my-first-plugin
 * Description:       这是一个用于学习WordPress插件开发的示例插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Uložte tento kód do souboru s příponou `.php` a umístěte ho do příslušného adresáře ve vašem webovém prostředí. /wp-content/plugins/ Nová složka v adresáři (například…) my-first-pluginPoté ho uvidíte a můžete ho aktivovat na stránce “Pluginy” v administraci WordPress. I když tento plugin zatím neposkytuje žádné funkce, je již legálním pluginem, který je rozpoznatelný systémem WordPress.

Porozumění struktuře adresáře s pluginy

S rostoucím počtem funkcí pluginů je pro organizaci kódu důležitá vhodná struktura adresářů. Typický adresář pluginu může obsahovat následující části:
– Hlavní soubor pluginu (např.) my-first-plugin.phpNachází se v kořenovém adresáři pluginu a obsahuje informace o samotném pluginu.
- includes/ Katalog: Obsahuje soubory tvořící klíčové funkce nebo samotné funkce.
- admin/ Katalog: Obsahuje kód související s administrátorským rozhraním pro správu systému.
- public/ Katalog: Obsahuje kód související s front-end logikou.
- assets/ Obsah: Obsahuje soubory s CSS styly, JavaScript skripty a obrázky a další zdrojové soubory.
- languages/ Katalog: Slouží k uložení souborů s mezinárodními překlady (.po/.mo).

Tato modulární struktura činí kód jasnějším a usnadňuje týmovou spolupráci i údržbu.

Klíčové koncepty vývoje: Hooky a filtry

Základní filozofie vývoje pluginů pro WordPress je “hooking” (háčkování). Hooking umožňuje vložit vlastní kód v určité časové momenty nebo na konkrétních místech, čímž můžete změnit nebo rozšířit výchozí chování WordPressu. Hooky se dělí především na dvě typy: akční hooky (Action Hooks) a filtrovací hooky (Filter Hooks).

Doporučujeme k přečtení. Vývoj pluginů pro WordPress od začátku až po pokročilou úroveň: naučte se vytvářet vlastní funkce krok za krokem.。

Použití akčních háčků k provádění vlastního kódu

Akční háčky vám umožňují provádět určité kroky v určitých okamžicích během provádění procesu v WordPressu – například odesílat notifikace po zveřejnění článku nebo přidávat kód do hlavičky stránky. add_action() Funkce umožňuje připojit vaši vlastní funkci k některému z akčních hooků (akčních mechanismů).

Například vytvoříme funkci, která zobrazí vlastní informace v podnízkové části hlavní stránky webového stránek. Nejprve musíte definovat funkci na zpracování požadavků (tj. callback funkci), a poté ji použít k vykázání požadovaných dat. add_action() Připojte to k… wp_footer Tento háček.

// Definujte volací funkci
function myplugin_add_footer_text() {
    echo '<p style="text-align:center;">Děkujeme, že používáte tento plugin!</p>'\n';
}
// Připojení funkce k akčnímu háku `wp_footer`
add_action( 'wp_footer', 'myplugin_add_footer_text' );

Když WordPress dorazí k části podtitulku (footer), automaticky provede danou akci. myplugin_add_footer_text() Funkce vypíše text, který jsme definovali.

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

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

Filtrovací hooky vám umožňují “upravit” data ještě před tím, než jsou použita nebo uložena. Například můžete změnit nadpis článku nebo filtrovat obsah komentářů. add_filter() Funkce umožňuje připojit vaši vlastní funkci k některému z „filter hooků“ (úchytků pro filtrování dat).

Předpokládejme, že chceme automaticky přidávat symbol ochranné známky na konec názvů všech článků. Můžeme funkci přiřadit k… the_title Filtr.

// 定义一个回调函数，它接收原始标题作为参数
function myplugin_add_trademark_to_title( $title ) {
    // 仅在前端文章列表和单篇文章页面修改，避免影响后台
    if ( ! is_admin() ) {
        $title .= ' ™';
    }
    // 必须返回修改后的值
    return $title;
}
// 将函数挂载到 `the_title` 过滤器钩子
add_filter( 'the_title', 'myplugin_add_trademark_to_title' );

V tomto příkladu…$title Parametr je původní text nadpisu; funkce po jeho úpravě musí vrátit novou hodnotu. To je klíčový rozdíl mezi filtrem a akcí: filtr musí vrátit hodnotu.

Doporučujeme k přečtení. Úvodní průvodce vývojem WordPress pluginů: Vytvořte si svůj první funkční modul od nuly。

Přidejte pro plugin správnou stránku a možnosti nastavení.

Plug-in s kompletní funkcionalitou obvykle musí poskytovat konfigurační rozhraní v administraci WordPressu. To lze dosáhnout přidáním hlavního správního menu nebo podmení. WordPress nabízí bohatou sadu API pro vytváření těchto stránek.

Vytvořit položku menu pro nastavení pluginu

Použití add_menu_page() 或 add_submenu_page() Funkce mohou vašemu pluginu přidat záložku do nabídky (“menu”) v pozadí aplikace. Obvykle jednoduché pluginy přidají svou stránku nastavení do hlavní nabídky „Nastavení“ jako podnabídku.

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

Následující kód ukazuje, jak přidat stránku s podmenü a definovat funkci, která bude zodpovědná za její zobrazení.

/ V backendu přidejte podnabídku pod “Nastavení”.
function myplugin_add_settings_page() {
    add_options_page(
        'Nastavení mého pluginu', // Název stránky
        'Můj plugin',   // Název menu
        'manage_options', // Požadavek na oprávnění (přístupný pouze pro administrátory)
        'myplugin-settings', // Slug menu
        'myplugin_render_settings_page' // Callback funkce pro zobrazení obsahu stránky
    );
}
// Spusťte funkci při inicializaci backendového menu pomocí akce 'admin_menu'.
add_action( 'admin_menu', 'myplugin_add_settings_page' );

// Definujte callback funkci pro zobrazení nastavení.
function myplugin_render_settings_page() {
    ?>  / Add a submenu under the "Settings" menu in the backend.
function myplugin_add_settings_page() {
    add_options_page(
        'My plugin settings', // Page title
        'My plugin',     // Menu title
        'manage_options', // Permission requirement (only accessible by administrators)
        'myplugin-settings', // Menu slug
        'myplugin_render_settings_page' // Callback function for displaying the page content
    );
}
// Use the `admin_menu` action hook to execute the above function when the backend menu is initialized.
add_action( 'admin_menu', 'myplugin_add_settings_page' );

// Define the callback function for rendering the settings page.
function myplugin_render_settings_page() {
    ?>
    <div class="wrap">
        <h1>Nastavení mého pluginu</h1>
        <form action="/cs/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段、非ce等安全信息
            settings_fields( 'myplugin_settings_group' );
            do_settings_sections( 'myplugin-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="cs"/></form>
    </div>
    <br />&lt;?php
}

Použijte API pro nastavení registračních možností.

Manuální zpracování odeslání a ověření formulářů je náročné a nebezpečné. WordPress Settings API nám poskytuje sadu standardních, bezpečných metod pro vytváření, ověřování a ukládání nastavení.

Potřebujete použít… register_setting(), add_settings_section() 和 add_settings_field() Použijte funkce jako `set` nebo `define` k definování svých nastavení.

// 在插件初始化时注册设置
function myplugin_register_settings() {
    // 1. 注册一个设置组及其数据
    register_setting(
        'myplugin_settings_group', // 设置组名称，需与 settings_fields() 参数一致
        'myplugin_option_name' // 存储在数据库中的选项名
    );

// 2. 添加一个设置区域（Section）
    add_settings_section(
        'myplugin_section_main', // Section ID
        '主要设置', // 标题
        null, // 可选的描述回调函数
        'myplugin-settings' // 所属的页面slug
    );

// 3. 向该区域添加一个设置字段
    add_settings_field(
        'myplugin_field_text', // 字段ID
        '示例文本输入', // 字段标签
        'myplugin_render_text_field', // 渲染字段HTML的回调函数
        'myplugin-settings', // 页面slug
        'myplugin_section_main' // Section ID
    );
}
add_action( 'admin_init', 'myplugin_register_settings' );

// 渲染文本输入字段的回调函数
function myplugin_render_text_field() {
    $option = get_option( 'myplugin_option_name' );
    $value = isset( $option['text'] ) ? $option['text'] : '';
    echo '<input type="text" name="myplugin_option_name[text]" value="' . esc_attr( $value ) . '" />';
}

Prostřednictvím nastavení API lze ovládat odeslání a ověřování formulářů (můžete nastavit…) register_setting Definování funkcí pro ověřování dat a jejich uložení jsou automaticky zpracovány jádrem WordPressu, což výrazně zvyšuje bezpečnost a efektivitu vývoje.

Závěr

Vývoj pluginů pro WordPress je proces přeměny nápadů na funkční řešení, jehož jádrem je pochopení a obratné využívání systému hooků. Začněte vytvořením jednoduchého souboru pluginu a postupně se učte, jak pomocí akčních hooků přidávat nové funkce, pomocí filtrovacích hooků upravovat data a nakonec vytvářet konfigurovatelné, uživatelsky přívětivé pluginy pomocí správných stránek a API pro nastavení. Dodržování standardů kódování WordPressu, modularizace kódu a důraz na bezpečnost jsou základy pro vývoj kvalitních pluginů. Díky praktickému použití výše uvedených kroků budete schopni vytvořit pro jakýkoli web na WordPressu silné a stabilní vlastní funkce.

Časté dotazy

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

Potřebujete mít základní znalosti programovacího jazyka PHP, protože pluginy jsou většinou napsány v PHP. Stejně důležité je mít základní povědomí o HTML, CSS a JavaScriptu, které jsou nezbytné pro vytváření uživatelského rozhraní a interakcí na straně klienta. Rozumění základním konceptům databáze MySQL (i když WordPress poskytuje pohodlné nástroje pro práci s databází) a samotné architektuře WordPressu (jako jsou struktury šablon, cykly atd.) bude také velmi užitečné.

Jak ladit můj WordPress plugin?

Nejprve se ujistěte, že… wp-config.php Aktivováno v souboru. WP_DEBUG 和 WP_DEBUG_LOGTímto budou chyby a varování PHP zaznamenávány do… /wp-content/debug.log Soubory by měly být uloženy v počítači a ne zobrazovány na stránce, aby se nenarušil uživatelský zážitek. Za druhé, lze použít… error_log() Funkce vypisuje vlastní laděcí informace do logů. Pro složitější logiku je nejefektivnější použít funkci ladění pomocí přerušení v integrovaném vývojovém prostředí (IDE), např. Xdebug.

Jak je moje rozšíření kompatibilní s různými verzemi WordPressu?

Při vývoji byste měli vyhýbat se používání zastaralých funkcí a prostudovat oficiální dokumentace, abyste zjistili, ve které verzi WordPressu byly tyto funkce zavedeny. To můžete udělat v hlavním souboru vašeho pluginu. @requires at least 或 @requires PHP Dejte výhradní požadavky najevo v poznámkách v hlavičce pluginu. V kódu je poté možné je použít. function_exists() 或 class_exists() Zkontrolujte, zda je určitá funkce nebo třída dostupná, a připravte tak náhradní řešení pro zajištění kompatibilitě se staršími verzemi.

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

Nejprve se ujistěte, že váš plugin plně dodržuje oficiální pokyny pro vývoj pluginů a kódovací standardy. Poté si na WordPress.org zaregistrujte SVN repozitář. Následně odešlete kód vašeho pluginu (včetně správně strukturovaného souboru README.txt a hlavního skriptu) do tohoto SVN repozitáře. /trunk Po odeslání vašeho pluginu ho oficiální tým zkontroluje. Po úspěšné kontrole bude váš plugin zahrnut do oficiálního katalogu, kde budou moci uživatelé po celém světě stahovat a instalovat ho.