Začátek cesty vývojem pluginů pro WordPress znamená, že získáváte schopnost přidávat nové funkce, automatizovat procesy a vytvářet jedinečnou hodnotu pro miliony webových stránek po celém světě. Ať už jde o řešení konkrétních obchodních požadavků nebo o sdílení svých výtvorů s komunitou, pochopení jeho základní architektury a principů je prvním krokem k úspěchu. Pluginy jsou v podstatě soubory kódu napsaného v jazyce PHP, které dodržují pravidla a API WordPressu a beze problémů se integrují do jeho základního systému. Pomocí hooků (Hooků) a filtrů (Filters) mohou měnit nebo vylepšovat chování platformy.
Nastavení vývojového prostředí a vytvoření základních pluginů
Než začnete psát první řádek kódu, je zásadní mít izolované a profesionální vývojové prostředí. Doporučujeme použít lokální vývojové nástroje, jako jsou Local by Flywheel, DevKinsta nebo MAMP, které umožňují rychle nastavit prostředí obsahující PHP, MySQL a WordPress.
Vytvořte první soubor plug-inu.
Vše začalo s jedním PHP souborem. V případě WordPressu… wp-content/plugins V adresáři vytvořte novou složku pro váš nový plugin. Například, vytvoříme složku s názvem… my-first-plugin Složku. Poté v této složce vytvořte hlavní soubor, který obvykle nese stejné jméno jako složka:my-first-plugin.php。
Doporučujeme k přečtení. Od nuly ke jedničce: Kompletní průvodce vývojem WordPress pluginů a praktické tutoriály。
Hlavičkové poznámky v této hlavní souboru slouží jako “identifikátor” pluginu a poskytují WordPress všechny potřebné metadaty pro jeho rozpoznání. Níže je uvedena základní struktura tohoto souboru:
<?php
/**
* Plugin Name: 我的第一个插件
* Plugin URI: https://example.com/my-first-plugin
* Description: 这是一个用于学习 WordPress 插件开发的示例插件。
* Version: 1.0.0
* Author: Your Name
* Author URI: https://example.com
* License: GPL v2 or later
* Text Domain: my-first-plugin
* Domain Path: /languages
*/Po uložení souboru se přihlaste do svého WordPress administrátorského účtu a přejděte na stránku “Příslušenství” (Plugins). Měli byste tam vidět nový příslušenství s názvem “Moje první příslušenství” (My First Plugin). Ačkoli zatím nemá žádné funkce, můžete ho aktivovat nebo deaktivovat. Tím dokazujete, že jste úspěšně vytvořili základní strukturu příslušenství.
Pochopení základních konceptů: Akční háčky a filtry
Jádrem vývoje pluginů pro WordPress je mechanismus hooků. Hooky umožňují vašemu kódu, aby se “vložil” do základního procesu WordPressu v určitéch časech a prováděl vaši logiku.
Akční hook
Akční háčky (Action Hooks) spouštějí kód při nastání určitých událostí, např. při zveřejnění článku, při přihlášení uživatele nebo při načtení šablony. Používáte je k realizaci specifických funkcí v rámci vašeho aplikace. add_action() Funkce váže vaši callback funkci na daný „hook“.
Například chceme na vrchní část stránky pro úpravu článků v administračním panelu zobrazit vlastní zprávu. K tomu můžeme použít… edit_form_top Tento akční hook.
Doporučujeme k přečtení. Jak vybrat a vytvořit kvalitní WordPress plugin: Průvodce od začátku až po pokročilou úroveň。
// 在文章编辑页面顶部添加自定义提示
add_action( 'edit_form_top', 'myplugin_edit_form_top_message' );
function myplugin_edit_form_top_message( $post ) {
if ( 'post' === $post->post_type ) {
echo '<div class="notice notice-info"><p>Toto je vlastní upozornění od ‘Mého prvního pluginu“!</p></div>';
}
}Filter hook
Filtrační háčky (Filter Hooks) slouží k úpravě dat. Umožňují vám změnit jejich hodnoty před tím, než budou použita (např. uložena do databáze nebo zobrazena v prohlížeči). add_filter() Funkce.
Klasickým příkladem je úprava posledních slov obsahu článku. Můžeme k tomu použít… the_content Filtr.
// 在文章内容末尾附加版权信息
add_filter( 'the_content', 'myplugin_add_copyright_to_content' );
function myplugin_add_copyright_to_content( $content ) {
if ( is_single() ) {
$content .= '<p><small>© 2026 Všechna práva vyhrazena. Tento text byl optimalizován pomocí mého pluginu.</small></p>';
}
return $content;
}Vytvořit stránku pro správu pluginů a jejich nastavení
Aby uživatelé mohli konfigurovat váš plugin, je potřeba pro ně vytvořit stránku nastavení. WordPress poskytuje bohaté API pro přidávání stránek do správního menu a pro zpracování jejich obsahu.
Přidat správní menu
Použití add_menu_page() 或 add_options_page() Funkce vám umožňují přidat do vašeho pluginu horní nebo podřízené menu. Obvykle se jednoduché pluginy přidávají do menu “Nastavení” jako podstránky.
Nejprve potřebujeme při inicializaci administrátora připojit funkci, která bude sloužit k registraci menu.
// 在管理后台添加设置菜单
add_action( 'admin_menu', 'myplugin_add_admin_menu' );
function myplugin_add_admin_menu() {
add_options_page(
'我的插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 所需权限
'myplugin-settings', // 菜单别名 (slug)
'myplugin_render_settings_page' // 用于输出页面内容的回调函数
);
}Stránka se nastaveními renderování a možnostmi ukládání
Dále potřebujeme definovat… myplugin_render_settings_page Funkce slouží k vytvoření HTML formuláře na stránce a k zpracování uložení dat z tohoto formuláře. Pro bezpečné registrování, ověřování a ukládání nastavení použijeme WordPress Settings API.
Doporučujeme k přečtení. Jak vybrat a vytvořit kvalitní WordPress plugin: Od začátků až po pokročilé úrovně。
// 渲染设置页面
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
// 输出必要的安全字段和隐藏字段
settings_fields( 'myplugin_settings_group' );
// 输出设置章节和字段
do_settings_sections( 'myplugin-settings' );
// 输出提交按钮
submit_button();
?>
<input type="hidden" name="trp-form-language" value="cs"/></form>
</div>
<?php
}
// 初始化设置
add_action( 'admin_init', 'myplugin_settings_init' );
function myplugin_settings_init() {
// 注册一个设置组和字段
register_setting(
'myplugin_settings_group', // 设置组名
'myplugin_option_message' // 选项名，将保存在 wp_options 表中
);
// 添加一个设置章节
add_settings_section(
'myplugin_section_basic',
'基础设置',
null, // 章节描述回调函数，可以为空
'myplugin-settings' // 页面别名
);
// 向章节添加一个字段
add_settings_field(
'myplugin_field_message',
'自定义消息',
'myplugin_field_message_render', // 渲染字段 HTML 的函数
'myplugin-settings',
'myplugin_section_basic'
);
}
// 渲染 ‘自定义消息’ 字段
function myplugin_field_message_render() {
$option = get_option( 'myplugin_option_message' );
?>
<input type='text' name='myplugin_option_message' value='<?php echo esc_attr( $option ); ?>'>
<p class="description">Zprávy zde vložené budou zobrazeny na předním panelu.</p>
<br /><?php
}Nyní můžete vidět stránku nastavení v sekci “Nastavení” -> “Moje doplňky”, kde najdete textové pole pro vložení zprávy, a můžete tuto zprávu uložit. Chcete-li tuto funkci použít, můžete to provést na uživatelské straně („frontend“). get_option( 'myplugin_option_message' ) Získáme jeho hodnotu.
Implementace vlastních zkratkových kódů
Shortcodes umožňují uživatelům používat jednoduché značky v podobě hranatých skřítků (např. [ ]), aby snadněji přistupovali k určitým funkcím nebo obsahu. [my_shortcode]Vložení dynamického obsahu do článků, stránek nebo doplňků je uživatelsky přívětivý způsob, jak pluginy poskytují složitější funkce.
Zaregistrujte si krátký kód.
Použití add_shortcode() Funkce slouží k registraci vašeho zkratkového kódu. Přijímá dva parametry: označení zkratkového kódu a funkci, která bude prováděna při jeho použití.
Například můžeme vytvořit zkrácený kód. [display_greeting]Může zobrazovat různá pozdravy v závislosti na čase a volitelně přijímat nějaký vstup (např. textový pozdrav). name Parametry.
// 注册自定义短代码
add_shortcode( 'display_greeting', 'myplugin_render_greeting_shortcode' );
function myplugin_render_greeting_shortcode( $atts ) {
// 设置默认属性值
$attributes = shortcode_atts(
array(
'name' => '访客',
),
$atts,
'display_greeting'
);
// 获取当前小时
$hour = date( 'H' );
$greeting = '';
if ( $hour < 12 ) {
$greeting = '早上好';
} elseif ( $hour < 18 ) {
$greeting = '下午好';
} else {
$greeting = '晚上好';
}
// 构建输出
$output = sprintf(
'<div class="myplugin-greeting"><p><strong>%s, %s!</strong> Vítejte na našich webových stránkách.</p></div>',
esc_html( $greeting ),
esc_html( $attributes['name'] )
);
return $output;
}Uživatelé nyní mohou v editoru zadávat text. [display_greeting name="张三"]Během renderování stránky bude toto místo nahrazeno osobním pozdravem.
Závěr
Vývoj pluginů pro WordPress je silný a flexibilní proces, jehož podstata spočívá v pochopení a využití systému hooků a základních API. Začnete vytvořením PHP souboru se standardním záhlavím, poté rozšíříte funkce pomocí hooků akcí a filtrů, vytvoříte uživatelsky přívětivé rozhraní pro nastavení pomocí API a nakonec poskytnete pohodlné zkratky kódů. Tím vytvoříte plugin s základní strukturou a běžnými funkčními moduly. Když tyto základní moduly kombinujete, dále vylepšujete a dodržujete standardy kódování WordPressu a nejlepší postupy z hlediska bezpečnosti, budete schopni vytvořit robustní pluginy, které splňují různé požadavky.
Časté dotazy
K vývoji pluginů pro WordPress jsou potřebné následující základní znalosti:
Potřebujete mít základní znalosti programovacího jazyka PHP, protože pluginy jsou převážně napsány v PHP. Zároveň vám pomůže základní porozumění HTML, CSS a JavaScript při vytváření uživatelského rozhraní a interaktivních funkcí. Nejdůležitější je však obeznámenost s klíčovými koncepty WordPressu, jako jsou hooky, The Loop a hierarchie šablon.
Jak ladit WordPress plugin, který právě vyvíjíte?
Doporučujeme zapnout režim ladění (debugging mode) v WordPressu ve vašem lokálním vývojovém prostředí. wp-config.php V dokumentu budou uvedeny následující informace: WP_DEBUG Konstanta je nastavena na trueMůžete také nainstalovat doplňky pro sledování databázových dotazů (např. Query Monitor), které vám pomohou sledovat provádění databázových dotazů, spouštění hooků a načítání skriptů. To je velmi užitečné pro optimalizaci výkonu a kontrolu logiky.
Jak můj plugin podporovat internacionalizaci?
WordPress využívá framework GNU gettext pro internacionalizaci. Definujte to v hlavičce hlavního souboru svého pluginu. Text Domain 和 Domain PathV kódu se to používá… __()、_e() Funkce jako `str_replace` nebo `str_replace_all` obalují všechny řetězce, které je potřeba přeložit. Poté se pomocí nástrojů jako Poedit vytvoří přeložená verze těchto řetězců. .pot Šablony pro překladatele k vytvoření .po 和 .mo Dokumenty.
Jak bezpečně odeslat svůj plugin do oficiálního adresáře pluginů WordPress?
Nejprve si musíte vytvořit účet na stránkách WordPress.org a následně odeslat svůj plugin. Váš kód musí splňovat standardy kódování WordPressu a nesmí obsahovat žádný šifrovaný nebo zkomplikovaný kód. adresář s pluginy, hlavní soubor pluginu, snímky obrazovky a soubor README musí být uspořádány podle určitých pravidel. Tým příslušných posuzovatelů prověří kvalitu kódu, jeho bezpečnost a licenční podmínky (plugin musí být kompatibilní s licencí GPL).
Jaký je další krok? Co bych měl udělat dál?
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.
- Předmluva: Proč zvolit WordPress pro vývoj
- Proč jste si vybrali WooCommerce jako své řešení pro e-shop?
- Kompletní průvodce WooCommerce: Vytvoření vašeho online obchodu a prodejní strategie od nuly
- 10 nejlepších nutných WordPress pluginů pro komplexní zlepšení výkonnosti a bezpečnosti webových stránek
- Od nuly: Celý proces vývoje moderních WordPress temat a osvědčené postupy
Čeština