WordPress-pluginontwikkelingsgids: van nul tot één: maak je eerste functionaliteitsmodule

Waarom is het nodig om zelf ontworpen WordPress plugins te ontwikkelen?

Wanneer de ingebouwde functies van WordPress en bestaande plugins niet volledig voldoen aan de specifieke behoeften van een bedrijf, wordt het ontwikkelen van een aangepaste plugin de meest directe oplossing. Met een aangepaste plugin kun je alle functies toevoegen die je nodig hebt aan het kernsysteem van WordPress, zonder de kernbestanden van WordPress te hoeven bewerken. Dit zorgt ervoor dat je functies niet verloren gaan bij updates van WordPress en dat ze modulair zijn opgebouwd, waardoor ze gemakkelijk kunnen worden overgebracht en beheerd op andere websites. Dit is beter dan het bewerken van thema’s.functions.phpBestanden en plugins zijn een betere optie voor het hergebruiken van functies. Ze zorgen ervoor dat je code gescheiden is van het thema, waardoor het project flexibeler en gemakkelijker te onderhouden is.

De voorbereiding van de omgeving en kennis voorafgaand aan de ontwikkeling.

Voordat je begint met schrijven van code, moet je een geschikte ontwikkelomgeving opzetten en de nodige kennisbasis beheersen.

Opzetten van een lokale ontwikkelingsomgeving

Een stabiel en geisoleerd lokale ontwikkelingsomgeving is van groot belang. Het wordt aanbevolen om tools als Local by Flywheel, XAMPP of MAMP te gebruiken om snel een geïntegreerde omgeving op te bouwen met PHP, MySQL en Apache/Nginx. Zorg ervoor dat je PHP-versie hoger is dan 7.4 en je MySQL-versie hoger is dan 5.6, en installeer de meest recente versie van WordPress.wp-config.phpIn dit document wordt het voorgesteld om…WP_DEBUGDe constante is ingesteld op...trueZodat foutmeldingen tijdens het ontwikkelingsproces worden weergegeven.

Aanbevolen leesmateriaal Volledige gids voor het ontwikkelen van WordPress plugins: bouw je eerste functionele plugin van scratch。

Noodige kennis van PHP en de WordPress API

Het ontwikkelen van plugins vereist basiskennis van PHP, waaronder het gebruik van variabelen, functies, klassen en namenruimtes, evenals het veilig bewerken van databases. Het is nog belangrijker om vertrouwd te zijn met de uitgebreide API's die WordPress biedt, zoals action hooks en filter hooks. Action hooks bieden de mogelijkheid om zelfgemaakte code op bepaalde momenten uit te voeren, terwijl filter hooks het mogelijk maken om gegevens te bewerken. De functionaliteit van een plugin is in grote mate afhankelijk van het handig gebruiken van deze hooks.

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

Creëer de basisstructuur voor het eerste plugin.

Volgens gaan we de basisstructuur van een plugin begrijpen door een simpel “Hello World”-plugin te maken.

De basisstructuur van het hoofdpluginbestand

Elk plugin moet een hoofdbestand hebben dat de meta-informatie van het plugin bevat. Plaats dit hoofdbestand in het mapverkeer van je WordPress-installatie.wp-content/pluginsMaak in de map een nieuwe map, bijvoorbeeld met de naam ‘NieuweMap’.my-first-pluginIn deze map moet je een hoofd-PHP-bestand maken. Je kunt het bestand bijvoorbeeld noemen:my-first-plugin.phpBovenin deze bestand moet je een standaard commentaar toevoegen met informatie over het plugin.

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://yourwebsite.com/my-first-plugin
 * Description:       这是一个学习用的示例插件，用于在管理后台显示欢迎信息。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Deze commentaarblock is vereist, zodat WordPress je plugin kan herkennen en weergeven in de lijst met achtergrondplugins.

Een menupagina voor het beheer van de backend creëren

Om de functie zichtbaar te maken in het WordPress-administratiepaneel, moeten we een nieuwe menu-pagina toevoegen. Voer in het hoofdbestand van het plugin de code verder op. We gaan dit gebruiken…add_action()De functie is gemonteerd.admin_menuDeze actie zit vast aan de haak.

Aanbevolen leesmateriaal Van nul tot expert: Een volledig handboek en beste praktijken voor het ontwikkelen van WordPress-plug-ins。

// 添加管理菜单
function mfp_add_admin_menu() {
    add_menu_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限（管理员）
        'my-first-plugin', // 菜单slug
        'mfp_admin_page_content', // 渲染页面内容的函数
        'dashicons-smiley', // 图标（使用Dashicon）
        6 // 菜单位置
    );
}
add_action('admin_menu', 'mfp_add_admin_menu');

// 定义管理页面的内容
function mfp_admin_page_content() {
    ?>
    <div class="wrap">
        <h1>Welkom bij mijn eerste plugin!</h1>
        <p>Dit is een eenvoudig voorbeeld van een WordPress-plugin.</p>
    </div>
    &lt;?php
}

Deze code voegt een bovenste menu-item met de naam “Mijn plugins” toe aan de linkernavigatie in het WordPress-administratiepaneel. Wanneer je op dit menu-item klikt, wordt een welkomstpagina weergegeven. Het is handig om de namen van de functies te voorzien van je eigen prefix (bijvoorbeeld: `my_function`).mfp_Dit is om te voorkomen dat er conflicten ontstaan met de namen van functies in andere plugins of thema's.

Schrijf de eerste simpele functionaliteit.

Nu gaan we een eenvoudige functionaliteit toevoegen aan de website-kant. Bijvoorbeeld: automatisch toevoegen van een aangepaste tekst aan het eind van elke artikel. Hier gaan we gebruikmaken van...the_contentFilter-haken.

// 在文章内容后添加自定义文本
function mfp_append_text_to_content($content) {
    if (is_single()) { // 仅在单篇文章页面生效
        $custom_text = '<p><em>— Dit artikel is versterkt met mijn eerste plugin.</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
add_filter('the_content', 'mfp_append_text_to_content');

Deze functie toont de basis van het gebruik van een filter: het ontvangt de oorspronkelijke inhoud, verwerkt deze en returneert de gewijzigde inhoud. Dit is een zeer krachtig en veelgebruikt model.

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

Advanced Practices and Standards for Plugin Development

Nadat de basisfuncties zijn geïmplementeerd, zorgt het naleven van de beste praktijken ervoor dat je plugin sterker en veiliger wordt.

Handelingen bij het activeren en deactiveren van plugins

Wanneer gebruikers een plugin activeren of verwijderen, kan het nodig zijn om gegevensbestanden te creeren, standaardopties in te stellen of de door de plugin genereerde gegevens te verwijderen. WordPress biedt speciale 'hooks' aan om deze situaties te kunnen hanteren.

De registratie, activering en uninstallatie-haken moeten in het hoofdbestand van het plugin worden gedefinieerd.register_activation_hook和register_uninstall_hookFunction implementatie. Let op: de uninstall-hook moet een statische methode of een aparte function zijn.

Aanbevolen leesmateriaal Volledig handboek voor het ontwikkelen van WordPress plugins: van nul tot een eigen plugin bouwen。

// 插件激活时执行的操作
function mfp_plugin_activation() {
    // 例如：在选项表中添加一个默认设置
    add_option('mfp_default_greeting', '你好，欢迎光临！');
}
register_activation_hook(__FILE__, 'mfp_plugin_activation');

// 插件卸载时执行的操作
function mfp_plugin_uninstall() {
    // 删除插件创建的选项
    delete_option('mfp_default_greeting');
    // 注意：谨慎操作，此处可删除自定义数据库表
}
register_uninstall_hook(__FILE__, 'mfp_plugin_uninstall');

Overwegingen met betrekking tot veiligheid, lokalisatie en prestaties

Security is van het hoogste belang bij het ontwikkelen van plugins. Alle door gebruikers ingevoerde gegevens (zoals formulierinvoer en URL-parameters) moeten worden gevalideerd en gecontroleerd op potentieel schadelijk materiaal. WordPress biedt tal van functies hiervoor.sanitize_text_field(), esc_html(), wp_kses(), prepare()(Dit is bedoeld voor database-verzoeken en helpt je bij het uitvoeren van deze verzoeken.) Vertrouw nooit direct op de invoer van gebruikers, en stuur deze invoer ook nooit rechtstreeks naar de pagina of de database.

Als je plugin is gericht op internationale gebruikers, is het belangrijk om ondersteuning voor lokalisatie (i18n) te bieden.__()和_e()De `wait`-functie omhult alle tekststrings die moeten worden vertaald.

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

Op het gebied van prestaties is het belangrijk om onnodige database-verzoeken of resource-intensieve operaties te voorkomen. Gebruik de cache op een verantwoordelijke manier (bijvoorbeeldTransient API), en zorg ervoor dat scripts en styleheets op de juiste plek zijn opgeslagen.wp_enqueue_script()和wp_enqueue_style()De inhoud wordt correct in de queue geplaatst, zodat deze alleen wordt geladen op de pagina's waar het nodig is.

Packen en distribueren van plugins

Nadat de ontwikkeling is afgerond, kun je de map met de plugin compresseren tot een ZIP-bestand. De gebruiker kan de plugin vervolgens rechtstreeks installeren via de WordPress-beheerpanel op de pagina “Plugins -> Installeren plugins -> Plugin uploaden”.

Als je je plugin wilt indienen in de officiële WordPress-plugincatalogus, moet je de indieningsrichtlijnen strikt naleven. Dit omvat onder andere de codestandaarden van WordPress (het gebruik van de WordPress Coding Standards wordt aanbevolen), volledige documentatie met commentaren, en een verklaring over de compatibiliteit met andere versies van WordPress. Daarnaast moet je ervoor zorgen dat er geen code is opgenomen die in strijd is met de GPL-licentie. Op de dag van 2026 worden de beoordelingscriteria voor de plugincatalogus regelmatig aangepast, in overeenstemming met de ontwikkelingen van het platform. Lees dus voor het indienen altijd de meest recente vereisten goed door.

Samenvatting

Het ontwikkelen van WordPress-plug-ins is een proces waarbij je persoonlijke ideeën omtovert naar krachtige functionaliteiten. We begonnen met het begrijpen van de motivatie achter het ontwikkelen, richtten een lokale omgeving op en oefenden stap voor stap met het maken van de structuur van de plugin-bestanden, het toevoegen van menu's in de backend, het realiseren van basisfuncties, en het hanteren van levenscyclus-evenementen als activeren en ontpakken. Het belangrijkste is dat we ook hebben gesproken over belangrijke ontwikkelingsrichtlijnen als veiligheid, lokalisatie en prestaties; deze vormen de basis voor de kwaliteit en betrouwbaarheid van de plugin. Het belangrijkste voor het maken van de eerste stap in het ontwikkelen is om daadwerkelijk te gaan werken. Door te starten met het “Hello World”-voorbeeld uit dit artikel en te ontdekken hoe het uitgebreide API en het hook-systeem van WordPress werken, kun je steeds complexere en praktische plug-ins bouwen, waarmee je de mogelijkheden van WordPress verder kunt uitbreiden.

Veelgestelde vragen (FAQ)

Ben je verplicht om PHP te beheersen om een WordPress-plugin te ontwikkelen?

Ja, om WordPress-plug-ins te ontwikkelen is een solide kennis van PHP vereist. WordPress is immers opgebouwd uit PHP, en de kernlogica van de plug-ins wordt ook in PHP geschreven. Je moet de PHP-functies, klassen, namenruimten en de basisconcepten van objectgericht programmeren begrijpen. Daarnaast is het handig om basiskennis van HTML, CSS en JavaScript te hebben, zodat je interactieve front-end-functies kunt creeren.

Wat is het essentiële verschil tussen de functies van de files functions.php in plugins en thema's?

De belangrijkste verschillen tussen de twee zijn het doel van de code en de portabiliteit (de mogelijkheid om de code op andere platformen te gebruiken).functions.phpDe code die wordt gebruikt om elementen toe te voegen die sterk gerelateerd zijn aan het uiterlijk en de functionaliteiten van het huidige thema, zal niet meer werken wanneer het thema wordt gewijzigd. Plugins daarentegen zijn functionele modules waarvan de code onafhankelijk is van het thema; hun doel is om een specifiek set functionaliteiten te bieden die op alle thema's kunnen worden gebruikt. Daarom moeten algemene functionaliteiten (zoals contactformulieren of SEO-optimalisatie) als plugins worden ontwikkeld, terwijl functionaliteiten die sterk afhankelijk zijn van het thema's lay-out en stijl, beter worden opgenomen in het thema zelf.functions.phpChina.

Hoe kun je compatibiliteitsproblemen tussen verschillende versies van WordPress oplossen?

Het belangrijkste bij het oplossen van compatibiliteitsproblemen is om API's voorzichtig te gebruiken en conditiecontroles uit te voeren. Tijdens het ontwikkelen moet je de officiële WordPress-handbook raadplegen om te weten in welke versie de functies, klassen of hooks die je gebruikt zijn geïntroduceerd. Als je ondersteuning voor oudere versies nodig hebt, kun je hiermee omgaan op de volgende manier:function_exists()或class_exists()Controleer of een bepaalde functie beschikbaar is; als deze niet beschikbaar is, bied een elegante alternatieve oplossing of toon een vriendelijke waarschuwing. Vergeet ook niet om in de commentaren bovenin het plugin duidelijk aan te geven in welke versies van WordPress de testen zijn uitgevoerd en met succes zijn afgerond.

Hoe maak je een instelbaar controlepaneel voor een plugin?

De standaardmanier om een controlepaneel voor een plugin te creeren, is door gebruik te maken van de WordPress Settings API. De procedure omvat:register_setting()Registreer een instellingengroep en velden en gebruik ze vervolgens.add_settings_section()和add_settings_field()Definieer de secties voor het instellen van de parameters en de specifieke velden, en gebruik deze vervolgens in de callback-functie op de menu-pagina.settings_fields()和do_settings_sections()De Settings API zorgt automatisch voor de verificatie van het nonce bij het indienen van een formulier, de controle van de toegangrechten en het opslaan van de instellingen. Dit is de beste praktijk voor het ontwikkelen van instellingenpagina's.

Welke is de juiste manier om een database te verbinden bij het ontwikkelen van plugins?

Gebruik nooit rechtstreeks de MySQL-functies van PHP. WordPress biedt hiervoor alternatieve oplossingen aan.wpdbGebruik een globale klasse om veilig te interageren met de database. Dit kan worden gerealiseerd door gebruik te maken van globale variabelen.$wpdbBezoek het. Voor vragen, vooral vragen waarbij gebruikersinformatie wordt gebruikt, moet u zeker...$wpdb->prepare()Methoden om SQL-injectieaanvallen te voorkomen: Bij het creeren van een aangepaste databastabel moet de SQL-opdracht voor het maken van de tabel worden uitgevoerd in de hook die wordt geactiveerd door het plugin, en moet gebruik worden gemaakt van…$wpdb->get_charset_collate()Zorg ervoor dat het karakterset overeenkomt met de instellingen van WordPress.