WordPress-pluginontwikkeling: van het begin tot de volmaaktheid: bouw je eerste eigen plugin

Waarom zijn plugins het hart van de WordPress-ecosysteem?

De sterke uitbreidbaarheid van WordPress is in grootte deel te danken aan het plugin-systeem. Met plugins kunnen ontwikkelaars functies toevoegen aan een website zonder de kerncode van WordPress te hoeven aanpassen; van eenvoudige contactformulieren tot complexe e-commerce-systemen. Het begrijpen van het ontwikkelen van plugins betekent dat je de sleutel in hand hebt om WordPress te kunnen aanpassen om aan alle behoeften te voldoen. WordPress hanteert het principe “afspraken zijn belangrijker dan instellingen” en communiceert met de kerncode via een duidelijk gestructureerd systeem van levenscyclus-haken (life-cycle hooks).

Een standaard plugin is in feite één of meerdere onderdelen die zich bevinden op een bepaalde plek (of locatie)./wp-content/plugins/De PHP-bestanden in de map moeten bevaten een specifieke commentaar bovenin de code, waarmee de plugin wordt beschreven voor WordPress. Dit modulaire ontwerp zorgt voor de isolatie van de verschillende functies en de stabiliteit van het systeem, waardoor het veilig en controolbaar is om plugins in te schakelen, uit te schakelen of te uninstallen.

Maak je eerste plugin: de basisstructuur

Om een plugin te creeren, is het eerst nodig om de basisbestanden en structuur van het plugin op te zetten. Dit gaat niet alleen om het schrijven van code, maar ook om een solide basis te leggen voor de toekomstige onderhoud en uitbreiding van het plugin.

Aanbevolen leesmateriaal WordPress-pluginontwikkeling vanaf nul: maak unieke functies en genereer efficiënt omzet。

Allereerst: in je lokale WordPress-ontwikkelomgeving…/wp-content/plugins/In de map moet een nieuwe map worden gemaakt. De naam van de map moet uniek zijn en de functionaliteit van het plugin beschrijven, in kleine letteren en in het Engels. Een voorbeeld is:my-first-greeting-pluginIn deze map moet je een hoofd-PHP-bestand maken. De naam van het bestand is meestal dezelfde als de naam van de map.my-first-greeting-plugin.php。

UltaHost WordPress-hosting

30-daagse garantie voor het terugbetalen van het geld, onbeperkt bandbreedte- en databestand, gratis DDoS-beveiliging, en een prijsvoordeel van 50% bij een aankoop van 3 jaar.

toegangspagina

Plugin Information Header Statement

Het hoofdbestand van het plugin moet beginnen met een specifiek commentaarblok; dit is essentieel voor WordPress om het plugin te herkennen. Plaats de volgende code in je hoofdPHP-bestand:

<?php
/**
 * Plugin Name:       我的第一个问候插件
 * Plugin URI:        https://example.com/my-greeting-plugin
 * Description:       这是一个演示插件，用于在网站页脚添加一句自定义问候语。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-greeting-plugin
 * Domain Path:       /languages
 */

Deze commentaar bevat de definitie van alle informatie die wordt weergegeven op de “Plugins”-pagina in het WordPress-administratiecentrum (backend).Plugin NameDit is een verplicht onderdeel; de overige onderdelen zijn optioneel. Nadat je het bestand hebt gesaved, zie je deze nieuwe plugin in de lijst met plugins in het WordPress-administratiepaneel en kun je deze net zoals andere plugins “activeren”.

Functies toevoegen met action-hooks

Nadat de plugin is geactiveerd, doet deze voorlopig nog niets. Om de plugin te laten werken, moeten we gebruikmaken van de “hooks” in WordPress. Hooks worden onderverdeeld in “actions” en “filters”. Actions bieden de mogelijkheid om zelfgemaakte code uit te voeren op bepaalde momenten, bijvoorbeeld wanneer een pagina wordt geladen of wanneer een artikel wordt gepubliceerd.

Voeg een groet toe in de voetnoot.

Een veel voorkomend verzoek is om content toe te voegen in de voetnoot van een website. WordPress biedt hiervoor verschillende mogelijkheden.wp_footerDeze actie-haak (action hook): we kunnen een aangepaste functie “maken” en deze koppelen aan deze haak.

Aanbevolen leesmateriaal Ultimatumgids voor het ontwikkelen van WordPress-plug-ins: van nul beginnen met het maken van je eerste eigen plug-in。

Under de commentaren aan het begin van het hoofdPHP-bestand, voeg de volgende code toe:

// 声明一个自定义函数，用于输出问候语
function my_greeting_display() {
    echo '<p style="text-align: center; color: #666; padding: 10px;">Hallo wereld! Welkom bij mijn eerste WordPress-plugin.</p>';
}
// 使用 add_action 函数将我们的自定义函数挂载到 wp_footer 钩子上
add_action( 'wp_footer', 'my_greeting_display' );

add_actionFuncties vormen de brug tussen aangepaste code en het kernbestand van WordPress. De eerste parameter is de naam van de hook.‘wp_footer’De tweede parameter is de naam van de door ons gedefinieerde functie.‘my_greeting_display’Sla de bestand op en vernieuw de website. Dan zie je deze groettekst in het voetnootgedeelte van de pagina.

Door filters te introduceren wordt de flexibiliteit verhoogd.

Action-hooks zorgen ervoor dat we “dingen kunnen doen”, terwijl filter-hooks ervoor zorgen dat we “gegevens kunnen bewerken”. Ze bieden ons de mogelijkheid om gegevens te veranderen voordat deze worden gebruikt of naar de browser worden gestuurd. Dit maakt de functionaliteit van plugins flexibeler en beter te configureren.

hosting.com gedeelde hosting

Hoge prestaties met AMD EPYC CPU's, NVMe SSD opslag en LiteSpeed, 24/7 deskundige interne ondersteuning, geavanceerde beveiligingsmaatregelen waaronder SSL, bescherming tegen brute kracht, malware en DDoS, besparingen tot 73%

toegangspagina

Een voorbeeld van het wijzigen van de titel van een artikel.

Stel dat we willen dat de tekst “【Recommendation】” automatisch voorafgaat aan alle artikeltitels. We kunnen dit doen met…the_titleFilteren.

Voeg de volgende nieuwe functies en filters toe in het hoofdbestand van je plugin:

// 声明一个函数，用于修改文章标题
function my_prefix_post_title( $title, $post_id = null ) {
    // 确保只在主循环且是文章页面添加前缀
    if ( is_single() && in_the_loop() ) {
        $title = '【推荐】' . $title;
    }
    // 必须返回修改后的值
    return $title;
}
// 使用 add_filter 函数，挂载到 the_title 过滤器
add_filter( 'the_title', 'my_prefix_post_title', 10, 2 );

add_filterDe derde parameter10Het gaat om de prioriteit: hoe kleiner het getal, des eerder wordt de actie uitgevoerd; de vierde parameter…2Dit betekent dat de waarde wordt overgedragen aan de function.my_prefix_post_titleHet aantal parameters. De filterfunctie moet de gewijzigde waarde teruggeven, in plaats van alleen de uitvoer. Dit zorgt ervoor dat je code met andere plugins of filters van thema's kan worden gecombineerd (in een keten).

Aanbevolen leesmateriaal Volledig in de kunst van WordPress-pluginontwikkeling: van nul tot een aangepaste functie bouwen。

Een pagina voor plug-inbeheer maken

Als een plugin bepaalde opties vereist die de gebruiker zelf kan instellen, moet er een administratieve pagina worden gecreëerd. Dit wordt gerealiseerd door gebruik te maken van de WordPress-managementmenu-API.

Een instellingenpagina toevoegen aan het beheerderspaneel

We zullen een simpel topmenu toevoegen aan de linkerkant van het navigatiegebied in het WordPress-beheerpaneel.

InterServer gedeelde hosting

Shared hosting $2.50 USD per maand, eerste maand $0.1 USD promo code tryinterserver, 461 cloud apps scripts, een klik te installeren.

toegangspagina

Voeg de volgende code toe in het hoofdbestand van je plugin:

// 注册管理菜单
function my_greeting_add_admin_menu() {
    add_menu_page(
        '问候插件设置',       // 页面标题
        '问候插件',           // 菜单标题
        'manage_options',     // 权限（管理员）
        'my-greeting-plugin', // 菜单slug
        'my_greeting_admin_page', // 回调函数，用于显示页面内容
        'dashicons-admin-generic', // 菜单图标（WordPress Dashicons）
        80                    // 菜单位置
    );
}
add_action( 'admin_menu', 'my_greeting_add_admin_menu' );

// 定义设置页面的HTML内容
function my_greeting_admin_page() {
    // 安全检查
    if ( !current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
        <form action="/nl/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段（后续可扩展）
            settings_fields( 'my_greeting_options' );
            do_settings_sections( 'my-greeting-plugin' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="nl"/></form>
        <p>Welkom op de instellingenpagina van mijn eerste plugin. In de toekomst kunnen hier nog meer opties worden toegevoegd.</p>
    </div>
    &lt;?php
}

add_menu_pageFuncties vormen de kern van het maken van een topmenu. Na het opslaan, log je in als beheerder in het WordPress-administratiepaneel en zie je aan de linkerkant een nieuwe menuoptie genaamd “Groet Plugin”. Als je daarop klikt, kom je op de pagina met de basisinstellingen die we hebben gedefinieerd. Dit is de eerste stap in het bouwen van een complexere plugin: op deze pagina kun je later instellingen, formulieren en andere functionaliteiten integreren.

Samenvatting

Door een simpel groetplugin te maken, hebben we de belangrijkste stappen van het ontwikkelen van WordPress-plugins behandeld: we begonnen met het maken van de basisbestanden en de header-informatie, en vervolgens gebruikten we…add_actionDe hook uitvoert code op een specifieke plek en gebruikt deze daarna vervolgens.add_filterDe uitgebreide inhoud wordt als volgt gewijzigd: ten slotte wordt via de API van het beheermenu een backend-configuratie-interface toegevoegd voor het plugin. De vier belangrijkste elementen – de bestandsstructuur, actie-haken, filter-haken en de beheerinterface – vormen de basis voor bijna alle WordPress-plugins. Door deze concepten te begrijpen en vloeiend te kunnen toepassen, stapt u van een beginner-niveau naar een niveau van expertise. Hierdoor kunt u complexere en krachtigerere custom-toepassingen bouwen en het volledige potentieel van WordPress realiseren.

Veelgestelde vragen (FAQ)

Wat is de minimale structuur van een plugin, zoals ###?
Een plug-in kan slechts één onafhankelijk PHP-bestand bevatten. Zolang als dit bestand de juiste WordPress-plug-in header-opmerkingen bevat (d.w.z.Plugin Name…) en plaatst deze op…/wp-content/plugins/In de map of een submap herkent WordPress de plugin en kan deze weergeven. Complexere plugins organiseren hun code meestal in meerdere bestanden en submappen om de onderhoudbaarheid te verbeteren.

Wat is het fundamentele verschil tussen action-hooks en filter-hooks?

Action-hooks worden gebruikt om op een bepaald moment een actie uit te voeren; ze vereisen geen terugkeerwaarde van je functie. Het belangrijkste is dat de betreffende code wordt uitgevoerd. Filter-hooks worden gebruikt om gegevens te bewerken; ze eisen dat je functie een terugkeerwaarde opgeeft (meestal de gewijzigde invoerwaarde), zodat de gegevens verder kunnen worden doorgegeven in de filterketen. Met andere woorden: action-hooks worden gebruikt om iets te doen, terwijl filter-hooks worden gebruikt om dingen te veranderen.

Hoe kan ik zorgen dat mijn plugin-code geen conflicten veroorzaakt met andere plugins?

Om conflicten met functionnamen, klassenamen of constantenamen te voorkomen, is het beste om namenruimten (aan te raden) te gebruiken of unieke prefixen te toevoegen aan alle identificatoren. In de voorbeelden in dit artikel worden bijvoorbeeld voor alle functies unieke prefixen gebruikt.my_或my_greeting_Als prefix: Sinds PHP 5.3 is het gebruik van namenruimten (namespaces) een modernere en uitgebreidere manier om structuur aan te brengen in code.

Hoe kun je bij het ontwikkelen van een plugin debuggen?

Allereerst moet je zorgen dat…wp-config.phpHet bestand is geopend inWP_DEBUG：define( ‘WP_DEBUG’, true );Gebruikerror_log()De functie schrijft de debug-informatie in het foutenlog van de server. Voor het controleren van variabelen kan dit worden gebruikt.print_r()或var_dump()Combineerwp_die()De inhoud moet veilig op de pagina worden weergegeven. Daarnaast kunnen ontwikkelaarsplugins zoals Query Monitor gebruiken om de afstelling van het systeem aanzienlijk te verbeteren.