Van nul tot held: een volledige gids en praktische tutorial voor het ontwikkelen van WordPress-plug-ins.

Forbereidende werkzaamheden voordat je een WordPress-plugin begint te ontwikkelen:

Voor het schrijven van de eerste regel code is een goede voorbereiding van belang voor het succes van het project. Dit omvat niet alleen het opzetten van de technische omgeving, maar ook een duidelijke analyse van de vereisten en een goed plan voor het project.

Allereerst heb je een lokale ontwikkelomgeving nodig. Het wordt aanbevolen om tools als Local by Flywheel, MAMP, XAMPP of Docker te gebruiken om snel een omgeving op te zetten waarin WordPress met PHP, MySQL en Apache/Nginx kan worden uitgevoerd. Zorg ervoor dat je PHP-versie voldoet aan de meest recente vereisten van WordPress; in de meeste gevallen is PHP 7.4 of een hogere versie nodig.

Ten tweede: bepaal duidelijk welk probleem je plugin gaat oplossen. Wil je een specifieke functie toevoegen aan een website of een bestaande proces verbeteren? Een duidelijke beschrijving van het plugin en een lijst met de beschikbare functies vormen de basis voor de verdere ontwikkeling. Het kan handig zijn om tools als Trello of eenvoudige documenten te gebruiken om de versieontwikkeling en de te realiseren functies te plannen.

Aanbevolen leesmateriaal Handboek voor het ontwikkelen van WordPress-plug-ins: van nul tot het publiceren van je eigen plug-in。

Ten slotte hebt u een code-editor of een integreerde ontwikkelomgeving nodig. Visual Studio Code, PhpStorm en Sublime Text zijn allemaal uitstekende keuzen en bieden goede ondersteuning voor het ontwikkelen van PHP en WordPress, waaronder syntaxhighlighting, codevoorstellen en debugfuncties. Zodra u deze hebt voorbereid, kunt u de basis van het plugin maken: de hoofdfile.

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

Maak je eerste WordPress-plugin.

Alles is moeilijk in het begin, maar het maken van een basis-WWordPress-plugin is eigenlijk erg simpel. In deze paragraaf wordt je geleid door het opzetten van de basisstructuur van het plugin, het toevoegen van een beveiligingsverklaring en het activeren van het plugin.

Maak een nieuwe map met een unieke naam die de functie van het plugin beschrijft in het Engels. Voorbeeld:my-first-pluginIn deze map moet je een hoofdplugin-bestand maken, dat meestal de extensie `.plugin` heeft.plugin-name.phpWe moeten deze bestand een naam geven. Dit bestand vormt de ingangspunt voor het plugin, en WordPress herkent het plugin door de specifieke commentaren die zich in het begin van het bestand bevinden te lezen.

Bovenin deze hoofdfile moet je een commentaar met een plugin-head toevoegen die voldoet aan de WordPress-standaarden. Hier is een eenvoudig voorbeeld:

<?php
/**
 * Plugin Name: 我的第一个插件
 * Plugin URI:  https://example.com/my-first-plugin
 * Description: 这是一个用于演示的简单WordPress插件。
 * Version:     1.0.0
 * Author:      你的名字
 * Author URI:  https://yourwebsite.com
 * License:     GPL v2 or later
 * Text Domain: my-first-plugin
 */

In deze commentaar is “Plugin Name” verplicht; alle andere informatie is optioneel. Het is echter sterk aan te raden om alle gegevens in te vullen. Nadat dit is gedaan, moet u de plugin-map uploaden naar het installatieverkeer van WordPress./wp-content/plugins/De plugin zit in de juiste map. Ga naar de “Plugins”-pagina in het WordPress-administratiepaneel en daar zie je je plugin. Je kunt de plugin activeren. Op dit moment heeft de plugin nog geen functies, maar je hebt met succes een plugin gecreëerd die door WordPress wordt herkend.

Aanbevolen leesmateriaal Het ontwikkelen van WordPress plugins begint van nul en leidt tot een tool dat wereldwijd het populairste contentmanagement-systeem is.。

Een eenvoudige functie implementeren

Laten we de eerste echte functionaliteit toevoegen aan deze lege plugin: automatisch toevoegen van een copyright-verklaring aan het eind van het artikel. Dit zal je helpen om de werking van de hook-mechanisme in WordPress te begrijpen.

Allereerst moeten we een functie maken om de logica voor het toevoegen van auteursrechtaanwijzingen te implementeren. We noemen deze functie…myplugin_add_footer_text。

function myplugin_add_footer_text($content) {
    // 确保只在网站前端的主文章循环中执行
    if (is_single() && in_the_loop() && is_main_query()) {
        $footer_text = '<p><em>Deze tekst wordt u aangeboden door mijn eerste plugin.</em></p>';
        $content .= $footer_text;
    }
    return $content;
}

Vervolgens moeten we deze functie “monteren” op een specifieke uitvoeringspunt in WordPress. Dit proces heet “hangen van een hook” (hooking). Hier gebruiken we…the_contentFilter-haken: Voeg de volgende code toe in het hoofdbestand van je plugin:

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

add_filter('the_content', 'myplugin_add_footer_text');

Na het opslaan van het bestand, moet je de pagina van een artikel op je website opnieuw laden. Je ziet dat er aan het eind van de inhoud de door jou gedefinieerde auteursrechtaanmerking is toegevoegd. Met dit simpele voorbeeld hebt je de kernprincipes van pluginontwikkeling begrepen: functies maken en gebruiken.add_action或add_filterDe hook zorgt ervoor dat de functie wordt geïntegreerd in het levenscykel van WordPress.

De kern van het verhaal: WordPress-hooks en API's

Het hookmechanisme vormt de kern van het ontwikkelen van WordPress-plug-ins. Het biedt de mogelijkheid om je code op specifieke momenten of op bepaalde plaatsen uit te voeren. Het begrijpen en behendig gebruiken van hooks is essentieel voor het bouwen van complexe functionaliteiten.

WordPress-haakjes (hooks) worden voornamelijk in twee categorieën ingedeeld: acties (Actions) en filters (Filters). Actie-haakjes worden geactiveerd wanneer bepaalde kern-evenementen van WordPress plaatsvinden, bijvoorbeeld wanneer een artikel wordt gepubliceerd of wanneer de beheeromgeving wordt geladen. Je functie kan dan iets doen. Filter-haakjes worden gebruikt om gegevens te bewerken; ze bieden de mogelijkheid om de waarden van gegevens te veranderen voordat deze worden gebruikt of opgeslagen, bijvoorbeeld de inhoud of de titel van een artikel.

Aanbevolen leesmateriaal WordPress-pluginontwikkeling: van het begin tot de volmaakte beheersing: stap voor stap leert u hoe u eigen functies maakt。

Een actie-haakfunctie (action hook function) maken:

function myplugin_log_post_published($ID, $post) {
    // 当文章发布时，在错误日志中记录一条信息（仅用于演示）
    error_log("文章 {$post->post_title} (ID: {$ID}) 已发布。");
}
// 将函数挂载到 `publish_post` 这个动作钩子上
add_action('publish_post', 'myplugin_log_post_published', 10, 2);

Maak een filterhook-functie:

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

function myplugin_excerpt_length($length) {
    // 将默认的摘要长度从55个词修改为20个词
    return 20;
}
// 将函数挂载到 `excerpt_length` 这个过滤器钩子上
add_filter('excerpt_length', 'myplugin_excerpt_length');

Wanneer je dit gebruikt...add_action或add_filterDe derde en vierde parameter staan respectievelijk voor de prioriteit en het aantal parameters. Door deze op juiste manier in te stellen, kan de uitvoeringsvolgorde van meerdere callback-functies precies worden beheerd.

Het instellen van de API voor WordPress

Om gebruikers van plugins de mogelijkheid te geven hun eigen gedrag te instellen, moet je een configuratiepagina maken. WordPress biedt een settings-API aan om dit proces te versoepelen. Hiervoor worden meestal drie belangrijke functies gebruikt:register_settingGebruikt voor het registreren van een groep instellingen.add_settings_sectionOm een instellingengebied op de pagina te toevoegen:add_settings_fieldVerwend om specifieke velden in deze regio toe te voegen.

Maak een functie voor het creeren van een optiepagina:

function myplugin_settings_page() {
    add_options_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限
        'myplugin-settings', // 菜单 Slug
        'myplugin_render_settings_page' // 用于输出页面内容的回调函数
    );
}
add_action('admin_menu', 'myplugin_settings_page');

Vervolgens moet je dit implementeren.myplugin_render_settings_pageEen functie die een formulier weergeeft en gebruikt...settings_fields和do_settings_sectionsEen functie om de veldwaarden van een formulier uit te geven die automatisch worden verwerkt door de WordPress API.get_optionIn de plugincode kun je eenvoudig de waarden van de door de gebruiker opgeslagen opties opvragen, op welke plek dan ook.

Advanced practices for plugin development en publicatie

Als de functionaliteit van je plugin steeds beter wordt en de hoeveelheid code toeneemt, wordt een goede organisatie van de code, bescherming tegen beveiligingsrisico's en ondersteuning voor internationale gebruikers (internationalization) van cruciaal belang.

Om de code overzichtelijk te houden, is het verstandig om de code voor verschillende functies in aparte bestanden op te slaan. Bijvoorbeeld kunnen de regels voor het registreren van hooks en de core-functies in het hoofdbestand worden opgeslagen, terwijl de code die te maken heeft met de instellingenpagina in een apart bestand wordt opgeslagen.admin/Subdirectory: hier wordt de front-end-functiecode opgeslagen.public/Submappen worden gebruikt, en functies worden op basis van bepaalde condities geladen. Het toepassen van objectgericht programmeren (OOP) is ook een goede praktijk voor het beheersen van complexe plugins, aangezien dit de data en functionaliteiten beter kan opsluiten (of ‘encapsuleren’).

Veiligheid is van vitaal belang voor het ontwikkelen van plugins. Alle gegevens die van gebruikers worden verzameld (zoals…)$_GET， $_POST， $_COOKIEAlles moet worden gevalideerd en desinfecteerd. WordPress biedt een groot aantal functies voor dit doel.sanitize_text_field， wp_kses_post， intvalEtc. Wanneer je gegevens naar de browser of een database stuurt, is het ook nodig om deze te ontsluiten (of te 'escape'). Hierbij worden bepaalde tekens omgezet in andere vormen, zodat ze correct worden weergegeven.esc_html， esc_attr或wp_ksesFuncties: Voor database-operaties moet u de functies van WordPress gebruiken.$wpdbKlassen en hun…prepareManieren om SQL-injecties te voorkomen.

Internationalisatie van plugins realiseren

Om je plugin beschikbaar te maken voor gebruikers overal ter wereld, is internationalisatie een essentieel stap. Dit omvat voornamelijk twee stappen:__()或_e()Deze functies omvatten alle strings die moeten worden vertaald, evenals het correct laden van de tekstvelden.

In de plugin-head hebben we de tekstdomain (Text Domain) al gedefinieerd. Tijdens het initialiseren van de plugin (meestal in het hoofdbestand) moet de taalbestand worden geladen.

function myplugin_load_textdomain() {
    load_plugin_textdomain('my-first-plugin', false, dirname(plugin_basename(__FILE__)) . '/languages/');
}
add_action('init', 'myplugin_load_textdomain');

Daarna kun je gebruikmaken van iets wat op dit lijkt.__('Hello World', 'my-first-plugin')De schrijfwijze wordt gebruikt om strings te markeren. Vertalers kunnen tools gebruiken zoals Poedit om dit te doen, afhankelijk van de genereerde inhoud..potTemplatefile creation.po和.moVertaal het bestand en plaatst het in het plugin./languages/Catalogus.

Ten slotte, wanneer de functionaliteit van het plugin stabiel is, kun je het indienen in de officiële WordPress-plugincatalogus, zodat meer mensen het kunnen gebruiken. Hiervoor moet je de code van het plugin pakken en een uitgebreide beschrijving van het plugin schrijven.readme.txtDeze bestanden dienen te worden gebruikt in overeenstemming met de ontwikkelingsregels van de community.

Samenvatting

Het ontwikkelen van WordPress-plug-ins is een praktische ervaring waarbij je ideeën omtovert naar krachtige functionaliteiten. Je begint met het opzetten van een omgeving en het maken van basisplug-inbestanden, werkt vervolgens verder met de kernmechanismen en API-instellingen, en komt uiteindelijk ook bij geavanceerde onderwerpen als codeorganisatie, veiligheid en internationalisering. Het belangrijkste bij dit proces is om de eventgedreven architectuur van WordPress te begrijpen, zodat je de kernfuncties op een soepe manier kunt uitbreiden met behulp van acties en filter-hooks. Vergeet niet: door met een kleine functionaliteit te starten, deze steeds te verbeteren, en altijd de veiligheid van de code en de gebruikerservaring voorop te stellen, wordt je een succesvolle plug-inontwikkelaar.

Veelgestelde vragen (FAQ)

Welke programmeeringsvaardigheden zijn nodig om een WordPress-plugin te ontwikkelen voor ###?
Om plugins voor WordPress te ontwikkelen is het belangrijk om de PHP-sprache onder de knie te hebben, aangezien het core van WordPress zelf in PHP is geschreven. De front-end-functies omvatten meestal HTML, CSS en JavaScript. Voor het communiceren met databases is basiskennis van SQL handig, maar WordPress biedt ook eigen tools en methoden om dit te doen.$wpdbDe klassen bevaten de meeste operationen.

Hoe debug ik mijn WordPress-plugin?

Tijdens de ontwikkelingsfase is het aan te raden om de debug-modus van WordPress aan te zetten.wp-config.phpIn het bestand wordt…WP_DEBUGDe constante is ingesteld op...trueJe kunt ook gebruikmaken van...error_log()De functie slaat de informatie op in het foutenlog van de server. Voor een uitgebreidere afstelling (debugging) kunnen professionele plugins zoals Xdebug of Query Monitor worden gebruikt om de uitvoering van het code en de database-opvragen te volgen.

Hoe kan mijn plugin met derde-partijdiensten of APIs communiceren?

Plugins kunnen worden gebruikt via de HTTP API van WordPress.wp_remote_get()， wp_remote_post()WordPress biedt een veilige en stabiele communicatie met externe services via zijn HTTP-API. De HTTP-API bevat onder andere functies voor tijdslimitering en SSL-verificatie, waardoor het beter te gebruiken is dan de PHP-functies curl of file_get_contents. Bij het verwerken van antwoordgegevens is het belangrijk om fouten te controleren en deze op de juiste manier te verwerken.

Hoe kan ik een aangepaste database-tabel toevoegen aan mijn plugin?

Hoewel de optiekaart van WordPress voldoende is om de meeste configuraties op te slaan, zijn gestructureerde gegevens misschien beter op te slaan in aangepaste tabellen. Je kunt dit doen door gebruik te maken van de hookpen voor het activeren van plugins.register_activation_hookDe SQL-opdracht voor het maken van de tabel wordt uitgevoerd in de procedure voor function registratie. Het is vereist om deze opdracht te gebruiken.$wpdb->prefixZorg ervoor dat de tabelprefix correct is en gebruik dit prefix.dbDeltaEr bestaan functies om de structuur van een tabel veilig te creëren of te updaten. Elke query op een aangepaste tabel dient te worden uitgevoerd via deze functies.$wpdbDe objecten worden verwerkt.

Hoe zorg ik ervoor dat mijn plugin compatibel is met andere plugins of thema's?

De beste manier om compatibiliteit te garanderen, is door de WordPress-kern-API en standaardhooks te gebruiken; unieke voorvoegsels (zoals plug-in afkortingen) toe te voegen aan functies, klassen en optienamen; functies in klassen of naamruimten te verpakken om namenconflicten te voorkomen; directe wijzigingen van globale variabelen te vermijden; en te controleren of er al iets bestaat voordat je acties uitvoert die van invloed kunnen zijn op de globale status, zoals het registreren van shortcodes of aangepaste artikeltypen. Test voor de release zoveel mogelijk in verschillende omgevingen.