Konečný průvodce vývojem pluginů pro WordPress: Vytvořte si svůj první vlastní plugin od nuly.

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

WordPress se stal nejoblíbenějším systémem pro správu obsahu na světě díky své vysoké rozšiřitelnosti, která je způsobena především jeho architekturou plug-inů. Díky vývoji vlastních plug-inů můžete do svého webu přidat jakékoli funkce, které si představíte, aniž byste museli měnit základní kód WordPressu. To znamená, že tyto funkce mohou existovat nezávisle na použitém tématu a zůstat funkční i po změně tohoto tématu. Ještě důležitější je, že kvalitní plug-in může řešit konkrétní potřeby uživatelů nebo se dokonce stát samostatným produktem či službou.

Ovládnutí vývoje pluginů znamená, že se z uživatele WordPressu stáváte tvůrcem. Ať už to je pro uspokojení vlastních požadavků na personalizaci vašich projektů, nebo pro vytváření příjmů prostřednictvím vývoje komerčních pluginů, pochopení základních principů a osvědčených postupů při vývoji pluginů je nezbytným prvním krokem. Tento průvodce vás provede od nejzákladnějších struktur až po postupné vytvoření plně funkčního a standardního pluginu.

Vytvořte si svou první strukturu pluginu.

Standardní WordPress plugin je složka, která obsahuje jednu nebo více PHP souborů, a její kořenová složka musí obsahovat hlavní soubor. Tento hlavní soubor musí obsahovat specifické informace o pluginu, aby ho WordPress mohl rozpoznat a spravovat.

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.。

Vytvoření hlavního souboru pluginu

První věc, kterou musíte udělat, je vytvořit hlavní soubor pluginu. Tento soubor se obvykle jmenuje podle názvu samotného pluginu, například… my-first-plugin.phpNa začátku tohoto souboru musíte přidat standardní poznámku o hlavičce pluginu.

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

Tento komentář je “občanským průkazem” pluginu. V něm jsou uvedeny důležité informace o tom, co plugin dělá, jak funguje a jaký je jeho účel. Plugin Name(Název pluginu) je jediné povinné pole; ostatní pole slouží k poskytnutí dalších informací. Stránka “Pluginy” v administraci WordPressu tyto informace načte a zobrazí. Po vytvoření tohoto souboru jej potřebujete umístit do adresáře s instalací WordPressu. /wp-content/plugins/ Ve složce můžete přímo vytvořit podsložku s názvem “my-first-plugin” a poté do ní umístit hlavní soubor. Nyní se přihlaste do administrace WordPress a ten plugin uvidíte v seznamu pluginů, kde ho také můžete aktivovat. I když zatím nemá žádné funkce, už jste udělali první krok směrem k úspěchu.

Organizujte své soubory plug-inů.

S přibývajícími funkcemi bude obtížné udržovat veškerý kód v jediném hlavním souboru. Dobrá struktura organizace souborů je velmi důležitá. Typický plugin může obsahovat následující adresáře:
* /includes/Skladuje soubory obsahující definice klíčových funkcí a tříd.
* /admin/Soubory související s administrátorským rozhraním na pozadí.
* /public/Ukládají soubory obsahující front-end funkce určené pro návštěvníky webových stránek.
* /assets/Slouží k uložení statických zdrojů, jako je JavaScript, CSS a obrázky.
* /languages/Slouží k uložení souborů s mezinárodními překlady (.po/.mo).

Tato modulární struktura nejenže činí kód přehlednějším, ale také usnadňuje týmovou spolupráci a další rozšiřování funkcí. V hlavním souboru… my-first-plugin.php V tomto kontextu byste obvykle použili… require_once Přinášíme funkční soubory ze těchto adresářů.

Porozumění základním konceptům vývoje WordPressu: hookům a filtrům

Jádrem vývoje pluginů pro WordPress je mechanismus zvaný “hooky”. Umožňují vašemu kódu v určitých okamžicích “vložit se” do základního prováděcího procesu WordPressu, čímž můžete změnit nebo přidat nové funkce. Hooky existují ve dvou typech: akce (Actions) a filtry (Filters).

Doporučujeme k přečtení. Z nuly k dokonalosti ve vývoji pluginů pro WordPress: realizace pokročilých funkcí a průvodce osvědčenými postupy.。

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

Akční háčky vám umožňují spustit své vlastní funkce v určitý okamžik během provozu WordPress. Například můžete chtít provést nějakou akci při zveřejnění článku nebo přidat menu do postranního panelu administrace.

Níže je jednoduchý příklad použití… wp_footer Tento akční hook vypíše zprávu do společné oblasti na spodní straně webové stránky. Potřebujete přidat následující kód do hlavního souboru svého pluginu.

function myplugin_add_footer_text() {
    echo '<p style="text-align:center;">Děkuji, že jste využili můj první plugin!</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );

Zde,myplugin_add_footer_text Je to funkce, kterou jsme sami definovali.add_action() Funkce “připojí” tuto funkci k nějakému jinému objektu nebo procesu. wp_footer Tato akce je napojena na hooky. Když WordPress dorazí k části podtitulku (footer), naše funkce bude automaticky volána.

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

Upravení obsahu pomocí filtrovacích hooků

Na rozdíl od akčních hooků slouží filtrovací hooky k úpravě dat. Vaše funkce přijme vstupní hodnotu, po zpracování musí vrátit výstupní hodnotu. Například může jít o změnu nadpisu článku nebo úpravu způsobu zobrazení obsahu.

Níže uvedený příklad ukazuje, jak to provést. the_content Filtr: Automaticky přidává na konec všech článků a obsahu stránek určitý text na zakázku.

function myplugin_append_to_content( $content ) {
    $custom_text = '<div class="myplugin-note"><p><em>Tento text je zvýrazněn pomocí mého vlastního doplňku (pluginu).</em></p></div>';
    // 仅在主循环的单篇文章页面添加
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        return $content . $custom_text;
    }
    return $content;
}
add_filter( 'the_content', 'myplugin_append_to_content' );

funkce myplugin_append_to_content Přijměte originální materiál. $contentProstřednictvím podmínekového posuzování zajistíme, že text bude přidán pouze na potřebných místech, a poté vrátíme upravený obsah.add_filter() Funkce dokončila registraci.

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í。

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

Většina pluginů vyžaduje stránku pro konfiguraci, která umožňuje uživatelům nastavit různé parametry. WordPress poskytuje bohaté API pro vytvoření estetického a standardního administrativního rozhraní.

Přidat hlavní správní menu

Můžete přidat nový hlavní menuový příkaz do levého navigačního panelu v administraci WordPressu pro svůj plugin. To se provádí následujícím způsobem: add_menu_page() Funkce jsou implementovány pomocí kódu. Obvykle to děláme… admin_menu Tato funkce je volána v tomto akčním hooku.

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

function myplugin_add_admin_menu() {
    add_menu_page(
        '我的插件设置', // 页面标签
        '我的插件',     // 菜单标题
        'manage_options', // 所需权限
        'myplugin-settings', // 菜单 Slug
        'myplugin_settings_page_html', // 显示页面内容的回调函数
        'dashicons-admin-generic', // 图标（可选）
        80 // 菜单位置（可选）
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

Vytvoření obsahu stránky pro nastavení

Nyní potřebujeme definovat ty výše zmíněné callback funkce. myplugin_settings_page_htmlK zobrazení HTML obsahu stránky se nastaveními slouží určité nástroje nebo skripty. Jednoduchá verze tohoto obsahu může vypadat následovně:

function myplugin_settings_page_html() {
    // 检查用户权限
    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( 'myplugin_options' );
            do_settings_sections( 'myplugin-settings' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="cs"/></form>
    </div>
    <br />&lt;?php
}

Tato funkce vytvoří formulář, který odpovídá stylu WordPress administrace. Pro úplné zpracování nastavení budete také potřebovat použít… register_setting(), add_settings_section() 和 add_settings_field() Funkce jako `defineSetting` slouží k definování konkrétních nastavení, což tvoří kompletní pracovní postup “Settings API”. Jedná se o doporučený způsob pro bezpečné ukládání a vyhledávání možností pluginů.

Implementace funkce skutečného pluginu: statistika počtu prohlídek článků

Spojme tedy výše uvedené koncepty a vytvořme praktickou funkci, která bude sledovat a zobrazovat počet zhlédnutí každého článku.

Vytvořit pole v databázi a uložit do nich data

Nejprve potřebujeme vytvořit místo pro ukládání počtu zhlédnutí při zveřejnění článku. Obvykle k tomu používáme funkci post meta (metadata článků) v WordPressu. Můžeme tak… add_post_meta Funkce je možná řešením, ale elegantnější způsob je ověřit a aktualizovat tuto hodnotu při zobrazení článku.

function myplugin_track_post_views( $post_id ) {
    if ( ! is_single() ) {
        return;
    }
    if ( empty( $post_id ) ) {
        global $post;
        $post_id = $post->ID;
    }
    // 获取当前浏览次数
    $count = get_post_meta( $post_id, 'myplugin_post_views', true );
    // 如果为空，初始化为0
    $count = $count ? absint( $count ) : 0;
    $count++;
    // 更新数据库
    update_post_meta( $post_id, 'myplugin_post_views', $count );
}
// 在模板重定向时触发，确保只对真实访客计数
add_action( 'template_redirect', 'myplugin_track_post_views' );

Zobrazit počet zhlédnutí na straně klienta

Po uložení dat potřebujeme funkci, která je načte a zobrazí. Můžeme vytvořit zkratku (shortcode), která uživatelům usnadní její vložení do obsahu článků nebo do panelů na bocí straně.

function myplugin_display_post_views_shortcode( $atts ) {
    $atts = shortcode_atts( array(
        'id' => get_the_ID(),
    ), $atts, 'myplugin_views' );

$post_id = absint( $atts['id'] );
    $views = get_post_meta( $post_id, 'myplugin_post_views', true );
    $views = $views ? $views : 0;

return '<span class="myplugin-view-count">Počet zhlédnutí: '. esc_html($views)'.'</span>'php
add_shortcode('myplugin_views', 'myplugin_display_post_views_shortcode');

Nyní stačí uživateli pouze zadat krátký kód do editoru článků. [myplugin_views]Nebo můžete pomocí nástroje přidat “krátký kód” a po zadání tohoto kódu se počet zhlédnutí článku zobrazí na stránce. Tento kompletní příklad pokrývá celý proces uložení dat („hooky“), vyhledávání dat a zobrazení na straně uživatele („krátký kód“).

Závěr

Díky této příručce jste dokončili celý proces vytvoření vlastního WordPress pluginu od nuly. Nejprve jsme se seznámili s základní strukturou pluginu a vytvořili hlavní soubor obsahující standardní záhlaví. Poté jsme se podrobněji zabývali základy vývoje WordPress pluginů – háčky (akce a filtry) a naučili se, jak je využívat k přidávání nebo úpravě funkcí. Následně jsme pro plugin vytvořili profesionální administrátorské stránky, které jsou klíčové pro interakci s uživateli. Nakonec jsme teorii aplikovali v praktickém příkladu “sčítání počtu zhlédnutí článků” a realizovali kompletní funkční řetězec od zaznamenávání dat až po jejich zobrazení na stránce.

Pamatujte, že vývoj kvalitních pluginů není pouze o tom, aby funkce fungovaly, ale také o bezpečnosti kódu, jeho udržovatelnosti, výkonu a dodržování standardů kódování WordPressu. Díky neustálé praxi a zkoumání různých funkcí WordPress API budete schopni vytvářet pluginy, které jsou výkonné a které se budou uživatelům líbit.

Časté dotazy

Jaké jsou předpokládané znalosti potřebné k vývoji doplňků (pluginů)?

Potřebujete mít solidní základy v programování v PHP, protože WordPress a jeho pluginy jsou převážně napsány v PHP. Zároveň je velmi důležité mít základní znalosti HTML, CSS a JavaScriptu, které vám pomohou vytvářet uživatelské rozhraní a interaktivní funkce. Porozumění některým základním konceptům databáze MySQL také pomůže pochopit způsob, jakým WordPress ukládá data.

Jak ladit můj WordPress plugin?

Nejprve se ujistěte, že ve vašem… wp-config.php V souboru zapněte režim ladění WordPressu. WP_DEBUG Konstanta je nastavena na trueTo zobrazí chyby a varování PHP na obrazovce. Dále se používá… error_log() Funkce zapisuje informace o ladění do chybového logu serveru, což je velmi spolehlivý způsob ladění. U složitých proměnných lze tento postup kombinovat s dalšími nástroji. print_r() 或 var_dump() 与 error_log()Kromě toho použijte nástroje pro vývojáře v prohlížeči (např. F12) k ladění problémů s JavaScriptem a CSS na straně klienta.

Jak je možné, aby můj plugin byl kompatibilní s různými verzemi WordPressu?

Během vývoje byste měli pravidelně sledovat oficiální vývojovou příručku WordPressu, abyste byli informováni o změnách funkcí a hooků v různých verzích. function_exists() 或 version_compare() Používejte podmínkové výrazy k ověření, zda je určitá funkce nebo vlastnost dostupná, a tak poskytněte záložní řešení pro kompatibilitu s staršími verzemi. V popisu pluginu jasně uveďte rozsah verzí WordPress, se kterými je kompatibilita zajištěna. Nejlepší praxí pro zajištění kompatibility je průběžné testování v různých verzích prostředí WordPress.

Na co je třeba dát pozor při vývoji komerčních doplňků (pluginů)?

Při vývoji komerčních pluginů musí být bezpečnost, kvalita kódu a uživatelský zážitek na prvním místě. Je nutné implementovat spolehlivý a bezpečný systém ověřování oprávnění (např. pomocí licenčních klíčů). Je velmi důležité poskytovat jasné a včasné uživatelské dokumentace a technickou podporu. Ujistěte se, že dodržujete oficiální pokyny WordPress pro vývoj pluginů a licenční dohodu GPL. Zvažte použití profesionálních platform, jako jsou Freemius nebo Easy Digital Downloads, pro správu prodejů, distribuci aktualizací a zpracování požadavků na podporu.