Hlavní stránka/Znalosti/WordPress/Podrobnosti o obsahu

Vývoj pluginů pro WordPress od začátku až po pokročilou úroveň: kompletní návod k vytváření vlastních funkcí.

Čtení za 2 minuty.
2026-03-15
2026-06-03
2,035
Získávám provize, když nakupujete prostřednictvím níže uvedených odkazů, aniž by vás to něco stálo navíc.

Nastavení vývojového prostředí pro pluginy WordPressu.

Než začnete psát kód, je velmi důležitá stabilní a efektivní vývojová prostředí. To nejen zvyšuje efektivitu vývoje, ale také zajišťuje kompatibilitu pluginů v různých prostředích. Nejprve si musíte na svém lokálním počítači nastavit prostředí pro spuštění WordPressu. Doporučujeme použít integrované balíčky pro lokální servere, jako jsou XAMPP, MAMP nebo Local by Flywheel, které umožňují jednoduchou instalaci Apache, MySQL a PHP.

Dále budete potřebovat editor kódu. Visual Studio Code, PhpStorm nebo Sublime Text jsou vynikající volby – poskytují výrazové zvýraznění kódu, doporučení při psaní kódu a funkce pro ladění. Ujistěte se, že vaše verze PHP odpovídá požadavkům cílového prostředí WordPress; obvykle WordPress doporučuje stabilní verzi PHP.

Klíčovou přípravou pro vývoj je vytvoření základní struktury pluginu. V adresáři vaší instalace WordPressu…wp-content/pluginsV té složce vytvořte pro svůj plugin novou, výhradní složku – například:my-first-pluginV této složce musíte vytvořit hlavní soubor pluginu, který se obvykle jmenuje podle názvu samotného pluginu.my-first-plugin.phpTento soubor je vstupním bodem pro váš plugin a informace v komentářích na jeho začátku jsou velmi důležité. WordPress se na tyto informace spoléhá při identifikaci a zobrazení vašeho pluginu.

Doporučujeme k přečtení. Kompletní návod k vývoji pluginů pro WordPress: vytvořte svůj první plugin od nuly do jedné.。

<?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
 */

Tento komentář definuje informace, které se zobrazí v administračním rozhraní WordPressu pro pluginy. Po dokončení tohoto kroku budete moci svůj plugin vidět a aktivovat na stránce “Pluginy” v administraci WordPressu, i když zatím nemá žádné funkce.

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.
LOGO UltaHostu přístupová stránka

Porozumění základnímu fungování pluginů pro WordPress

Síla WordPressu spočívá v jeho vysoce rozšiřitelné architektuře, která je především dosažena díky mechanismu zvanému “hooky”. Porozumění hookům je klíčové pro ovládnutí vývoje doplňků (pluginů). Hooky se dělí na dvě hlavní typy: akční hooky (Action Hooks) a filtrovací hooky (Filter Hooks).

Akční háčky vám umožňují “vložit” a spustit svůj vlastní kód v určitém okamžiku. Například, když je přidán článek, nebo když uživatel navštíví hlavní stránku webu, WordPress spustí příslušné akční háčky. Můžete je využít k provedení různých úkolů, jako je zobrazení upozornění, aktualizace obsahu nebo provedení dalších činností.add_action()Funkce “nasadí” vaši vlastní funkci na tyto „hooky“ (speciální místa v kódu, kde mohou být volány).

function my_custom_function() {
    // 你的代码逻辑
}
add_action( 'wp_head', 'my_custom_function' );

Výše uvedený kód bude použit na webových stránkách.<head>Částečné provedenímy_custom_functionFunkce.

Filtrovací háčky slouží k úpravě dat. Umožňují vám data upravit ještě před tím, než budou použita – např. před uložením do databáze nebo zobrazením na stránce. Můžete je využít k různým účelům, jako je např. filtrování, přidávání nových informací nebo odstraňování nepotřebných datadd_filter()Funkce slouží k aplikaci filtrů. Filtrační funkce musí přijmout vstupní hodnotu a vrátit upravenou hodnotu.

Doporučujeme k přečtení. Praktický návod pro začátečníky bez předchozích znalostí: naučíme vás krok za krokem, jak vyvíjet pluginy pro WordPress.。

function modify_content( $content ) {
    $new_content = $content . “<p>Tento text byl přidán mým pluginem.</p>”;
    return $new_content;
}
add_filter( 'the_content', 'modify_content' );

Tento kód přidá na konci obsahu každého článku určitý vlastní text.

Dalším klíčovým mechanismem je shortcode. Shortcode umožňují uživatelům používat jednoduché značky (tagy) k…[my_shortcode]Vložte dynamický obsah do článku nebo stránky. Můžete k tomu použít…add_shortcode()Funkce slouží k registraci funkce pro zpracování zkratkových kódů.

Vytvoření kompletně funkčního příkladu pluginu

Nyní spojme všechny výše uvedené znalosti a vytvoříme jednoduchý plugin pro odhad doby čtení článků. Tento plugin bude automaticky vypočítávat dobu potřebnou k přečtení článku a zobrazovat ji před samotným obsahem.

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.
LOGO hosting.com přístupová stránka

Nejprve v hlavním souboru pluginu vytvoříme funkci pro výpočet doby čtení. Předpokládejme, že průměrná rychlost čtení je 200 slov za minutu.

function calculate_reading_time( $content ) {
    // 去除HTML标签，只计算纯文字
    $text = strip_tags( $content );
    // 计算单词数
    $word_count = str_word_count( $text );
    // 计算阅读分钟数（向上取整）
    $reading_time = ceil( $word_count / 200 );

// 创建显示信息
    $reading_time_html = ‘<div class="“reading-time”">Očekávaná doba čtení: ’. $reading_time . ‘ minut</div>’;

// 将阅读时间信息附加到文章内容之前
    return $reading_time_html . $content;
}
// 使用过滤器将函数应用到文章内容
add_filter( ‘the_content’, ‘calculate_reading_time’ );

Avšak možná nechceme, aby doba čtení byla zobrazena všude (např. v abstraktech, na RSS zdrojích). To můžeme optimalizovat přidáním podmínek.

function calculate_reading_time( $content ) {
    // 仅在主循环的单篇文章页面显示
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        $text = strip_tags( $content );
        $word_count = str_word_count( $text );
        $reading_time = ceil( $word_count / 200 );

$reading_time_html = ‘<div class="“reading-time”"><strong>📖 Doba čtení:</strong>Přibližně $reading_time… minut.</div>’;
        return $reading_time_html . $content;
    }
    // 如果不是单篇文章，返回原内容
    return $content;
}
add_filter( ‘the_content’, ‘calculate_reading_time’ );

Aby vzhled byl ještě krásnější, můžeme přidat také trochu CSS kódu. Můžeme to provést pomocí…wp_enqueue_style()Funkce slouží k bezpečnému načítání šablon stylů. Nejprve vytvořte soubor v adresáři s pluginy.style.cssSoubor je poté přidán do fronty pomocí akčního háčku (action hook).

Doporučujeme k přečtení. Návod pro začátečníky k vývoji pluginů pro WordPress: Vytvořte si svůj první funkční plugin od nuly.。

function my_plugin_styles() {
    wp_enqueue_style(
        ‘my-plugin-style’,
        plugin_dir_url( __FILE__ ) . ‘style.css’,
        array(),
        ‘1.0.0’
    );
}
add_action( ‘wp_enqueue_scripts’, ‘my_plugin_styles’ );

Best Practices for Plugin Internationalization and Security

Profesionální plugin určený pro globální uživatele musí podporovat internacionalizaci (i18n), což umožňuje jeho překlad do dalších jazyků. Pro implementaci internacionalizace je nutné využít funkce pro překlady poskytované WordPressem. Nejprve je třeba správně nastavit tyto nastavení v poznámkách na začátku pluginu.Text DomainJak jsme již dříve nastavili…my-first-plugin。

V kódu by měly být všechny řetězce, které je třeba přeložit, označeny speciálními značkami nebo konvencemi určenými k identifikaci překladatelných textových úseků.()、_e()或esc_html()A poté zabalíme tyto funkce.

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.
Logo InterServeru přístupová stránka 
$reading_time_html = ‘<div class="“reading-time”"><strong>’
    . esc_html__( ‘📖 Reading Time:’, ‘my-first-plugin’ )
    . ‘</strong>’
    . sprintf(
        esc_html__( ‘about %d minutes’, ‘my-first-plugin’ ),
        $reading_time
    )
    . ‘</div>’;

Poté potřebujete použít nástroj (např. Poedit) k vytvoření….potŠablony souborů – podle nichž mohou vytvářet překladatelé..po和.moTyto soubory by měly být umístěny do složky určené pro pluginy.languagesV složce.

Bezpečnost je životně důležitá součástí vývoje doplňků (plug-inů). Musíte dodržovat následující základní bezpečnostní postupy:
1. 数据验证：对所有来自用户或外部来源的输入数据进行严格检查。使用函数如sanitize_text_field()、absint()Přijďte vyčistit data.
2. 数据转义：在将任何数据输出到HTML、JavaScript或URL之前，必须进行转义。使用esc_html()、esc_attr()、esc_url()和wp_kses_post()Funkce jako…
3. 非ce验证：对于涉及数据更改（如表单提交、AJAX请求）的操作，必须使用wp_nonce(Cyklický číselný token) slouží k ověření legitimity a účelu požadavku, aby bylo zabráněno útokům typu CSRF.
4. 能力检查：在执行管理操作前，使用current_user_can()Funkce zkontroluje, zda má aktuální uživatel dostatečná oprávnění (např.‘manage_options’）。

Závěr

Vývoj pluginů pro WordPress je procesem, při kterém se kreativní nápady přeměňují na funkční řešení. Jádrem tohoto procesu je hluboké pochopení a flexibilní využití mechanismů zvaných „hooky“. Začínáte vytvořením potřebného prostředí a základních souborů, poté prostřednictvím akcí a filtrů navazujete intenzivní interakci s jádrem WordPressu a postupně vytváříte užitečné funkční moduly. Zralý plugin musí nejenom poskytovat kompletní funkce, ale také splňovat vysoké standardy internacionalizace a bezpečnosti, aby byl stabilní, bezpečný a mohl být používán uživateli po celém světě. Díky neustálé praxi a výuce se budete moci postupně posouvat od vývoje jednoduchých funkčních pluginů k vytváření složitějších, komerčně využitelných rozšíření pro WordPress.

Časté dotazy

Je nutné být zdatným v PHP, abyste vytvářeli doplňky pro WordPress?

Ano, dokonalá znalost PHP je základem pro vývoj doplňků (pluginů) pro WordPress. Samotný jádro WordPressu je napsáno v PHP a logické zpracování všech doplňků a témat závisí na PHP. Musíte být obeznámeni s gramatikou PHP, funkcemi, objektovým programováním a s tím, jak komunikovat s databází MySQL. Kromě toho je důležité také dobře porozumět HTML, CSS a JavaScript, protože to je nezbytné pro vývoj interaktivních funkcí na straně uživatele.

Jak ladit plugin pro WordPress, který jsem sám vytvořil?

WordPress nabízí řadu nástrojů pro ladění kódu. Za prvé můžete…wp-config.phpV souboru je zapnut režim ladění (debugging mode).WP_DEBUGKonstanta je nastavena natrueTo zobrazí na stránce chyby, varování a upozornění PHP. Pro složitější ladění lze použít…error_log()Funkce zaznamenává informace do chybového logu serveru, nebo lze použít profesionální ladící nástroje, jako je Query Monitor, k zobrazení detailních údajů o databázových dotazech, provedení hooků, načítání skriptů atd.

Jak mohu svůj vytvořený plugin zveřejnit do oficiálního adresáře pluginů WordPress?

Chcete-li svůj plugin zveřejnit v oficiálním katalogu WordPress.org, musíte nejprve vytvořit účet na stránkách WordPress.org a následně svůj plugin tam odeslat. Váš plugin musí splňovat oficiální kódové standardy a pravidla – měl by být licencován pod licencí GPLv2 nebo vyšší, dodržovat bezpečnostní best practice a obsahovat kompletní dokumentační poznámky. Po odeslání bude váš plugin posouzen týmem příslušných recenzentů a po schválení bude moci být zveřejněn. Poté ho uživatelé mohou snadno najít, nainstalovat a aktualizovat přímo z svého administrátorského panelu WordPress.

Jak vytvořit stránku pro správu nastavení pro můj plugin?

Můžete využít “Settings API” v WordPressu k vytvoření standardních a bezpečných správních stránek. Hlavní kroky zahrnují:add_menu_page()或add_submenu_page()Funkce registruje novou menu stránku a poté ji použije.add_settings_section()和add_settings_field()Definujte oblasti nastavení a pole. Nakonec použijte…register_setting()Přijďte se registrovat, nastavit a aktivovat funkce automatického ukládání a ověřování. Tento proces zajišťuje bezpečnost stránek s nastaveními a jejich soulad s administrátorským rozhraním WordPressu.

Jaký je další krok? Co bych měl udělat dál?

Pokud právě vytváříte nebo optimalizujete webové stránky pomocí WordPressu, doporučujeme vám pokračovat ve čtení o optimalizaci výkonu, konfiguraci pluginů a přizpůsobování témat.

Další čtení a praktické znalosti

Následující obsah souvisí s tématem tohoto článku a je vhodný k dalšímu prostudování. Obvykle je lepší začít čtením článku, který je nejblíže vašemu aktuálnímu problému, a poté postupně přecházet k souvisejícím tématům.

Štítky: