Začněte od nuly s vývojem WordPress pluginů: Kompletní průvodce a praktické tutoriály

Proč se rozhodnout pro vývoj doplňků (pluginů) pro WordPress?

V dnešní webové ekologii dominuje WordPress díky své bezkonkurenční flexibilitě a obrovské uživatelské základně. Tato flexibilita je do značné míry způsobena jeho systémem pluginů. Vývojáři mohou pomocí vlastních pluginů převést své nápady na znovupoužitelné funkční moduly, které mohou sloužit milionům webů po celém světě. To nejenže umožňuje řešit konkrétní obchodní požadavky, ale také umožňuje vytvářet trvalou hodnotu a příjmy prostřednictvím oficiálního katalogu WordPressu nebo třetích stran.

V porovnání s přímou úpravou tématu… functions.php Protože soubory jsou odlišné, plugin odděluje funkční logiku od vzhledu tématu, což zajišťuje udržovatelnost webové stránky. Při změně tématu mohou funkce poskytované pluginem být bezproblémově přeneseny, zatímco kód napsaný přímo v tématu bude nutné znovu upravit. Tento modulární přístup k vývoji je nejlepší praxí při vytváření profesionálních a stabilních webových stránek na platformě WordPress.

Vytvořte si svůj první plugin.

Prvním krokem při vývoji pluginu je vytvoření základní struktury, která splňuje standardy WordPressu. Nejde pouze o vytvoření jediného souboru, ale také o nastolení způsobu organizace kódu, který je udržovatelný a rozšiřitelný.

Doporučujeme k přečtení. Návod k vývoji pluginů pro WordPress: Vytvořte si své první rozšíření s vlastními funkcemi od nuly.。

Vytvoření základního souboru pluginu

Každý plugin pro WordPress musí mít hlavní soubor, který se obvykle jmenuje podle názvu samotného pluginu. my-first-plugin.phpPříspěvek “This file’s header comments are the plugin’s ”ID card’“ vysvětluje, že poznámky umístěné na začátku souboru obsahují metadata o pluginu – informace jako název, popis, verze, autor a další. Tyto informace jsou potřebné pro to, aby systém WordPress mohl plugin rozpoznat a aktivovat. Bez těchto poznámek by WordPress nevěděl, jak s pluginem nakládat.

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
 * Domain Path:       /languages
 */

Implementovat jednoduchou funkci

Po definování hlavy pluginu můžeme začít přidávat funkční kód. Klasickým úvodním příkladem je přidání řádku vlastního textu do patice webové stránky. To vyžaduje využití mechanismu “hooků” v WordPressu, konkrétně použití… wp_footer Tento akční hook.

// 在 wp_footer 钩子上挂接我们的函数
add_action(‘wp_footer’， ‘my_first_plugin_display_footer_text’);

/**
 * 在网站前台页脚输出自定义文本
 */
function my_first_plugin_display_footer_text() {
    echo ‘<p style="“text-align:" center;”>Tento web je technicky podporován mým prvním pluginem.</p>’;
}

Přidejte tento blok kódu do svého hlavního pluginového souboru, uložte ho a poté ho nahrávejte na server. /wp-content/plugins/ Katalog. Poté přejděte na stránku “Příslušenství” v administraci WordPress a uvidíte a aktivujete “Můj první plugin”. Obnovte webové stránky a dole na stránce se objeví text, který jste přidali.

Podrobné pochopení architektury pluginů WordPress

Pro vývoj silných a profesionálních pluginů je nezbytné dobře porozumět základním programovacím rozhraním a architektonickým vzorcům, které WordPress poskytuje. Nejde pouze o psaní PHP funkcí, ale také o naučení se, jak s jádrem WordPressu komunikovat bezpečně a efektivně.

Hook mechanism: Actions and filters

Mechanismus hooků v WordPressu je základem jeho rozšiřitelnosti a skládá se především z akčních hooků (Action Hooks) a filtrovacích hooků (Filter Hooks). Akční hooky vám umožňují “spustit” svůj vlastní kód v určitých okamžicích během provádění webové stránky. Například…init Hooky funkce se spouštějí při inicializaci WordPressu.wp_enqueue_scripts Hooky slouží k bezpečnému přidávání skriptů a stylů.

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

Filtrovací hooky vám umožňují “upravovat” data. Můžete data zachytit a změnit je ještě předtím, než budou použita – například před tím, než se zobrazí na stránce nebo budou uložena do databáze.the_content Filtry vám umožňují upravovat obsah článků.

// 使用过滤器修改文章内容，在末尾添加一段话
add_filter(‘the_content’， ‘my_first_plugin_modify_content’);

function my_first_plugin_modify_content($content) {
    if (is_single()) { // 仅在单篇文章页面生效
        $extra_text = ‘<div class="“plugin-note”">Děkujeme, že jste si tento článek přečetli!</div>’;
        $content .= $extra_text;
    }
    return $content;
}

Bezpečnost pluginů a ověřování dat

Bezpečnost je nedílnou součástí vývoje doplňků (pluginů). Nikdy nesmíte důvěřovat datům pocházejícím od uživatelů nebo jakýchkoli externích zdrojů. WordPress poskytuje řadu funkcí, které vám pomohou při ověřování dat, jejich escapeování a čištění.

Při zpracovávání dat typu $_POST nebo $_GET pocházejících z formulářů je nutné použít určité postupy. sanitize_text_field(), intval(), wp_kses_post() Pročistěte funkce pomocí příslušných nástrojů. Při výstupu dat na HTML stránku je nutné použít správné formáty a způsoby zpracování dat. esc_html(), esc_attr(), esc_url() Funkce jako escape() slouží k označení speciálních znaků, aby se předešlo útokům typu cross-site scripting (XSS).

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_first_plugin_safe_shortcode($atts) {
    // 使用 shortcode_atts 设置默认值并合并用户输入
    $atts = shortcode_atts(
        array(
            ‘message’ => ‘Hello World’,
        )， $atts
    );

// 清理用户输入的 message 属性
    $safe_message = sanitize_text_field($atts[‘message’]);

// 转义后安全输出
    return ‘<div>’ . esc_html($safe_message) . ‘</div>’php
add_shortcode(‘safe_greeting’, ‘my_first_plugin_safe_shortcode’);

Vytvořte plně funkční plugin.

Spojme tedy tyto znalosti a vytvořme trochu složitější, ale praktický plugin: plugin pro odhad doby čtení článku. Tento plugin automaticky vypočítá předpokládanou dobu čtení článku a zobrazí ji pod názvem článku.

Vytvoření struktury třídy pro plugin

Pro pluginy s o něco složitějšími funkcemi je lepší volbou použití objektově orientovaného programování (OOP) a tedy struktury tvořené třídami. To pomáhá organizovat kód, předchází konfliktům názvů funkcí a zvyšuje udržovatelnost.

<?php
/**
 * Plugin Name:       文章阅读时间估算
 */
class Article_Reading_Time {
    /**
     * 构造函数，初始化插件
     */
    public function __construct() {
        // 在文章内容前添加阅读时间
        add_filter(‘the_content’， array($this， ‘add_reading_time_to_content’));
        // 初始化脚本和样式（如果需要）
        add_action(‘wp_enqueue_scripts’， array($this， ‘enqueue_assets’));
    }

/**
     * 计算文章的阅读时间（以分钟计）
     * @param string $content 文章内容
     * @return int 预计阅读分钟数
     */
    private function calculate_reading_time($content) {
        // 去除 HTML 标签，只计算纯文本
        $text = strip_tags($content);
        // 估算中文阅读速度：每分钟约300-500字，这里取400字/分钟
        $word_count = mb_strlen($text， ‘UTF-8’);
        $reading_time = ceil($word_count / 400);
        // 至少1分钟
        return max(1， $reading_time);
    }

/**
     * 在文章内容前添加阅读时间显示
     * @param string $content 原始文章内容
     * @return string 添加阅读时间后的内容
     */
    public function add_reading_time_to_content($content) {
        // 确保只在主循环的单篇文章页面显示
        if (is_single() && in_the_loop() && is_main_query()) {
            $reading_minutes = $this->`calculate_reading_time($content);`  
`$reading_time_html = sprintf(‘`‘<div class="“reading-time”"><strong>Očekávaná doba čtení:</strong>%d minut</div>’,
                esc_html($reading_minutes)
            );
            $content = $reading_time_html . $content;
        }
        return $content;
    }

/**
     * 加载插件所需的CSS样式
     */
    public function enqueue_assets() {
        if (is_single()) {
            wp_enqueue_style(
                ‘article-reading-time-style’,
                plugin_dir_url(__FILE__) . ‘assets/css/style.css’,
                array()，
                ‘1.0.0’
            );
        }
    }
}

// 实例化插件类，启动插件
new Article_Reading_Time();

Přidat stránku pro správu nastavení

Profesionální plugin obvykle vyžaduje stránku pro nastavení v administraci, která umožňuje uživatelům přizpůsobit jeho chování. Můžeme využít “API pro nastavení” (Settings API) WordPressu k vytvoření těchto nastavovacích stránek na standardním způsobu.

Doporučujeme k přečtení. Kompletní průvodce vývojem WordPress temat: Od základů po pokročilé praktické návody。

Nejprve musíme do třídy pluginu přidat novou metodu, která bude sloužit k registraci nabídky nastavení a polí.

// 在构造函数中添加管理菜单钩子
add_action(‘admin_menu’， array($this， ‘add_admin_menu’));
add_action(‘admin_init’， array($this， ‘register_settings’));

public function add_admin_menu() {
    add_options_page(
        ‘阅读时间设置’，          // 页面标题
        ‘阅读时间估算’，          // 菜单标题
        ‘manage_options’，       // 权限
        ‘reading-time-settings’， // 菜单slug
        array($this， ‘render_settings_page’) // 回调函数
    );
}

public function register_settings() {
    register_setting(‘reading_time_settings_group’， ‘reading_time_words_per_minute’);
    add_settings_section(‘reading_time_main’， ‘主要设置’， null， ‘reading-time-settings’);
    add_settings_field(
        ‘words_per_minute’，
        ‘每分钟阅读字数’，
        array($this， ‘render_words_per_minute_field’)，
        ‘reading-time-settings’，
        ‘reading_time_main’
    );
}

public function render_words_per_minute_field() {
    $value = get_option(‘reading_time_words_per_minute’， 400);
    echo ‘<input type="“number”" name="“reading_time_words_per_minute”" value="“’" . esc_attr($value) ‘” />’;
    echo ‘<p class="“description”">Referenční hodnota používaná k výpočtu doby čtení (počet slov za minutu).</p>’;
}

public function render_settings_page() {
    ?&gt;
    <div class="“wrap”">
        <h1>Nastavení odhadu doby čtení článku</h1>
        <form action="/cs/“options.php”/" method="“post”" data-trp-original-action="“options.php”">
            <?php
            settings_fields(‘reading_time_settings_group’);
            do_settings_sections(‘reading-time-settings’);
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="cs"/></form>
    </div>
    &lt;?php
}

// 然后修改 calculate_reading_time 方法，使用用户设置的值
private function calculate_reading_time($content) {
    $text = strip_tags($content);
    $words_per_minute = get_option(‘reading_time_words_per_minute’， 400);
    $word_count = mb_strlen($text， ‘UTF-8’);
    $reading_time = ceil($word_count / $words_per_minute);
    return max(1， $reading_time);
}

Internationalizace pluginů a příprava k jejich vydání

Aby váš plugin mohl být používán uživateli po celém světě, je internacionalizace (i18n) nezbytným krokem. Zároveň je velmi důležité provést důkladné testování a uspořádat dokumentaci před vydáním.

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

Implementace podpory překladu textu

WordPress využívá technologii GNU gettext pro podporu více jazyků. Všechny texty, které jsou přímo vypisovány v doplňcích (plugins), je třeba zabalit do specifických funkcí. Nejčastěji používanou funkcí je… __() Slouží k vracení přeloženého textu, a také… _e() Používá se k přímému výstupu přeloženého textu.

Nejprve změňte veškerý hardkódovaný text v tomto pluginu.

// 在插件头部定义 Text Domain
// Text Domain:       article-reading-time

// 在插件初始化时加载语言文件
add_action(‘init’， array($this， ‘load_textdomain’));

public function load_textdomain() {
    load_plugin_textdomain(
        ‘article-reading-time’，
        false，
        dirname(plugin_basename(__FILE__)) . ‘/languages/’
    );
}

// 修改输出文本的代码，使其可翻译
$reading_time_html = sprintf(
    ‘<div class="“reading-time”"><strong>%s</strong>%d %s</div>’,
    esc_html__(‘预计阅读时间：’， ‘article-reading-time’)，
    esc_html($reading_minutes)，
    esc_html(_n(‘分钟’， ‘分钟’， $reading_minutes， ‘article-reading-time’))
);

Poté budete potřebovat nástroj jako Poedit, abyste skenovali zdrojový kód pluginu a vytvořili potřebné informace. .pot Šablony – podle nichž mohou překladatelé vytvořit další dokumenty. zh_CN.po 和 .mo Přeložený soubor umístěte do pluginu. /languages/ V adresáři.

Testování a následné odeslání do oficiálního adresáře

Před vydáním je nezbytné všechny funkce pluginu otestovat v různých prostředích (různé verze PHP, různé verze WordPress). Zkontrolujte, zda neexistují žádné varování nebo chyby v PHP, a ujistěte se, že plugin nevytváří konflikty s běžně používanými tématy a dalšími pluginy.

Pokud plánujete odeslat svůj plugin do oficiálního repozitáře pluginů WordPress, musíte dodržovat přísné kódové standardy a pokyny. To zahrnuje používání předpon pro názvy funkcí a tříd, které nejsou v konfliktu a které jsou výstižné, zajištění bezpečnosti kódu a poskytnutí podrobných informací o fungování pluginu. readme.txt Soubor musí být ve formátu odpovídajícím oficiálním standardům a všechny ladící kódy (debugging code) musí být odstraněny.

Připravte si jasný a přehledný plán. readme.txt Soubor je klíčový pro úspěšné schválení. Měl by obsahovat popis doplňku, pokyny k instalaci, snímky obrazovky, časté otázky, protokoly o aktualizacích a další relevantní informace.

Závěr

Vývoj pluginů pro WordPress je skvělou dovedností, která umožňuje přeměnit kreativní nápady na distribuovatelné produkty. Začněte tím, že vytvoříte jednoduchý plugin v jediném souboru, a postupně se ponořte do mechanismů hooků, bezpečnostních postupů, objektově orientované architektury, nastavení API a internacionalizace. Tento učební postup vám poskytne pevný základ pro vytváření komerčně použitelných pluginů. Klíčové je pochopit základní způsoby interakce v WordPressu – hooky – a neustále dodržovat zásady bezpečného kódování a ověřování dat. Organizováním kódu modulárním a strukturovaným způsobem, spolu s předem naplánovanou správnou rozhraním a podporou pro překlady, bude váš plugin vykazovat větší profesionalitu, udržovatelnost a přizpůsobivost trhu. Nezapomeňte, že dobrý plugin není pouze souborem funkcí, ale také komplexním projevem uživatelského zážitku, kvality kódu a integrace s celým ekosystémem WordPressu.

Časté dotazy

Jaké jsou předpokládané znalosti potřebné k vývoji pluginů pro WordPress?

Potřebujete mít solidní základy v programování v PHP, protože klíčová logika pluginu je napsána v PHP. Zároveň byste měli mít základní znalosti HTML, CSS a JavaScriptu, abyste mohli pracovat s výstupním zobrazením a interakcemi na straně uživatele. Poznání základních konceptů databáze MySQL (i když WordPress poskytuje pohodlné nástroje pro práci s databází) a objektově orientovaného programování je také velmi užitečné při vývoji složitějších pluginů.

Jaký je rozdíl mezi soubory functions.php v pluginech a tematech?

Přidejte kód do tématu. functions.php Soubory představují rychlý způsob implementace určitých funkcí, avšak tyto funkce jsou úzce vázány na aktuální téma webové stránky. Při změně tématu tyto funkce zmizí. Naopak pluginy jsou nezávislé na konkrétním tématu – jejich funkce zůstávají aktivní bez ohledu na to, které téma je používáno, pokud jsou pluginy aktivovány. To zajišťuje přenositelnost funkcí a flexibilitu při údržbě webové stránky.

Jak zabránit tomu, aby názvy funkcí mých pluginů kolizovaly s názvy funkcí jiných pluginů?

Použití objektově orientovaného programování (OOP) a zabalení vašeho kódu do tříd je nejlepším způsobem, jak předejít konfliktům názvů funkcí. Pokud používáte procedurální programování, musíte pro všechny funkce, konstanty a globální proměnné používat jedinečný předponový systém. Tato předpona by měla být dostatečně jedinečná – např. měla by obsahovat zkratku vaší značky nebo názvu vašeho pluginu. myplugin_ 或 art_rt_。

Jak bych měl ladit plugin, který právě vyvíjím?

Nejprve se ujistěte, že ve WordPressu… wp-config.php Aktivovat režim ladění v souboru: define(‘WP_DEBUG’, true); 和 define(‘WP_DEBUG_LOG’, true);Tímto způsobem budou chyby a varování v PHP zaznamenány do logů. /wp-content/debug.log Ve souboru. Kromě toho můžete použít nástroje pro vývojáře v prohlížeči k kontrole problémů na straně klienta (frontendu) a tyto nástroje vám také pomohou při řešení problémů. error_log() Funkce v kódu vypisuje hodnoty proměnných do logovacího souboru za účelem ladění.

Při vývoji komerčních doplňků je třeba zvážit následující právní otázky:

Nejdůležitějším právním aspektem je dodržování licenčních podmínek WordPressu. Pokud plánujete svůj plugin zveřejnit v oficiálním katalogu WordPressu, musí plugin být licencován pod licencí GPLv2 nebo vyšší. To znamená, že kód vašeho pluginu musí být open-source. Můžete vydělávat prostřednictvím prodeje podpůrných služeb, pokročilých funkcí, dokumentace nebo hostovaných verzí vašeho pluginu. Kromě toho, pokud zpracováváte údaje uživatelů, je nutné věnovat pozornost a dodržovat příslušná pravidla ochrany osobních údajů, jako je GDPR. Doporučujeme v prohlášení o ochraně soukromí vašeho pluginu jasně vysvětlit, jaké údaje shromažďujete a jak je používáte.