WordPress-pluginontwikkelingsgids: van nul beginnen met het maken van je eerste plugin

Waarom zou je een WordPress-plugin ontwikkelen?

WordPress is het populairste content management systeem ter wereld en zijn grote uitbreidbaarheid is te danken aan plugins. Door plugins te ontwikkelen, kun je extra functies toevoegen aan je website zonder de kernbestanden te hoeven aanpassen. Dit zorgt voor compatibiliteit wanneer WordPress wordt bijgewerkt. Of het nu om de behoeften van een specifiek project te vervullen, een veel voorkomend probleem op te lossen of je oplossing te delen met de community en geld te verdienen: het ontwikkelen van plugins is een zeer waardevolle vaardigheid.

Door te leren hoe je plugins ontwikkelt, komt je niet alleen dieper te begrijpen hoe WordPress werkt (bijvoorbeeld het Hook-systeem en Shortcodes), maar verbeter je ook je PHP-programmeringskunsten. Van het simpel toevoegen van nieuwe functies tot het integreren van complexe toepassingen: alles is mogelijk.

Maak je eigen omgeving voor het ontwikkelen van plugins.

Voordat je met het schrijven van code begint, is een goede lokale ontwikkelomgeving van belang. Dit zorgt ervoor dat je veilig kunt testen en debuggen, zonder dat de online website wordt beïnvloed.

Aanbevolen leesmateriaal Ultimatumgids voor het ontwikkelen van WordPress-plug-ins: van nul tot een professioneel plug-in bouwen。

Configureren van de lokale serveromgeving

Het wordt aanbevolen om geïntegreerde lokale ontwikkelingshulpmiddelen te gebruiken, zoals Local by Flywheel, DevKinsta of XAMPP. Deze hulpmiddelen kunnen in één stap worden geïnstalleerd en bevatten Apache/Nginx, PHP en MySQL. Zorg ervoor dat je PHP-versie compatibel is met de server waar je de website gaat hosten; het wordt meestal aanbevolen om PHP 7.4 of een hogere versie te gebruiken voor betere prestaties en meer veiligheid.

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

WordPress installeren en instellen

Installeer een nieuwe WordPress-instelling op uw lokale server. Het is aan te raden om het standaardthema (bijvoorbeeld de Twenty Twenty-serie) te gebruiken voor ontwikkeling en testen, om problemen met de compatibiliteit van thema's te voorkomen.wp-config.phpIn het bestand is de optie 'aan' geactiveerd.WP_DEBUGConstanten maken het gemakkelijk om fouten snel op te sporen tijdens het ontwikkelingsproces.

define( 'WP_DEBUG', true );

Prepare a code editor.

Kies een krachtige code-editor, zoals Visual Studio Code, PhpStorm of Sublime Text. Installeer de relevante extensies, zoals PHP IntelliSense en WordPress-code-snippets. Deze extensies kunnen je coderingsefficiëntie aanzienlijk verbeteren.

Maak je eerste pluginbestand.

Een WordPress-plugin is in feite één of meerdere bestanden of code-elementen die zich bevinden in de specifieke map van WordPress waar plugins zijn opgeslagen./wp-content/plugins/De PHP-bestanden in de map. Laten we nu beginnen met de meest fundamentele structuur.

Schrijf commentaren in het hoofddeel van het plugin.

Elk plugin moet een hoofdcommentaar in een standaardformat bevatten, waarmee WordPress de informatie over het plugin kan herkennen. In je pluginmap (bijvoorbeeld...)/wp-content/plugins/my-first-plugin/In ) moet een object met de naam worden gecreëerd.my-first-plugin.phpDe hoofdfile.

Aanbevolen leesmateriaal Van het begin tot de volmaakte beheerder: Een compleet handboek voor het ontwikkelen van WordPress plugins。

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

Deze commentaar bevat de instellingen voor de weergave van de naam, beschrijving en andere informatie van een plugin in het administratieven interface van WordPress.Text DomainVoor internationale vertalingen.

Een basisbeveiligingsframewerk voor het bouwen van plugins

Om directe toegang tot je pluginbestanden te voorkomen, kun je een beveiligingscode toevoegen aan het begin van het bestand. Dit is een goede praktijk bij het ontwikkelen van WordPress-plugins.

// 防止直接访问
if ( ! defined( 'ABSPATH' ) ) {
	exit; // 如果未定义ABSPATH（WordPress根目录的绝对路径），则退出
}

ABSPATHDit is een constante die door WordPress is gedefinieerd en representeert de absolute path waar het WordPress-systeem is geïnstalleerd. Door te controleren of deze constante bestaat, kan het worden voorkomen dat externe gebruikers direct toegang krijgen tot je pluginbestanden via een URL.

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

Realisatie van de kernfuncties: toevoegen van een beheermenu en instellingen

Een compleet plugin moet meestal een configuratieinterface bieden in de WordPress-beheeromgeving. We zullen een eenvoudige beheermenu-pagina toevoegen met behulp van de API die WordPress biedt.

Gebruik een functie om een bovenste beheermenu toe te voegen.

We zullen dit gebruiken.add_action()De functie is gemonteerd.admin_menuOp de haak wordt vervolgens een menu-item toegevoegd in de achtergrond. Voeg de volgende code toe in je hoofdpluginbestand.

// 添加管理菜单
function mfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',           // 菜单标题
        'manage_options',    // 所需权限（管理员）
        'my-first-plugin',   // 菜单slug
        'mfp_settings_page', // 显示页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        80                    // 菜单位置
    );
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );

Hier,add_menu_page()De functie wordt gebruikt om een topmenu te creeren. De parameters bepalen de titel van de pagina, de titel van het menu, de toegangsbereidheid, de unieke identificator (slug), de callback-functie die het inhoud van de pagina weergeeft, het icon en de positie van het menu in de sidebar.

Aanbevolen leesmateriaal Een volledige gids voor het ontwikkelen van WordPress-plug-ins: van nul tot praktische implementatie.。

Een callback-functie voor het maken van een instellingenpagina

Nu moeten we de hierboven genoemde elementen definiëren.mfp_settings_page()Deze functie genereert de HTML-content voor de beheerpagina.

// 设置页面回调函数
function mfp_settings_page() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
        <p>Welkom op de instellingenpagina van mijn eerste plugin! Hier kun je in de toekomst formulieren en opties toevoegen.</p>
        <form action="/nl/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段、非ce等（后续扩展）
            settings_fields( 'mfp_options_group' );
            do_settings_sections( 'my-first-plugin' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="nl"/></form>
    </div>
    &lt;?php
}

Deze functie controleert eerst of de huidige gebruiker beschikt over...manage_optionsRechten (meestal van een beheerder), gevolgd door een simpel framework voor een instellingsscherm.settings_fields()和do_settings_sections()Dit is gereserveerd voor het instellen van API-registratieopties voor later gebruik met WordPress.

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

Een simpel front-end-functie toevoegen aan een plugin

Naast de backend-beheerinterface worden plugins vaak gebruikt om functionaliteiten te bieden voor de frontend van een website. We gaan een simpel shortcode maken, zodat gebruikers deze kunnen oproepen in artikelen of pagina's.

Gebruik een functie om een kort code-snip te registreren.

Shortcodes bieden gebruikers de mogelijkheid om…[shortcode]Zulke eenvoudige labels worden gebruikt om dynamische functies in de inhoud in te bouwen.add_shortcode()De functie wordt geregistreerd.

// 注册一个短代码
function mfp_hello_world_shortcode( $atts ) {
    // 短码属性，设置默认值
    $atts = shortcode_atts(
        array(
            'name' => '访客',
        ),
        $atts,
        'mfp_hello'
    );

// 安全地输出内容
    return '<p>Hallo, '. esc_html($atts['name'])'. ‘! Dit is de groet die door mijn plugin is gecreëerd.</p>'php
add_shortcode('mfp_hello', 'mfp_hello_world_shortcode');

add_shortcode()De functie accepteert twee parameters: de naam van de kortcode-tag (de naam die de gebruiker gebruikt) en de corresponderende verwerkingsfunctie.shortcode_atts()De functie wordt gebruikt om de door de gebruiker ingevoerde eigenschappen te combineren met de standaardwaarden, waardoor de code robuuster wordt.

Front-end-testen van kort code

Na het opslaan van het plugin-bestand, ga je naar de “Plugins”-pagina in het WordPress-administratiepaneel en activeer je “Mijn eerste plugin”. Vervolgens maak je een nieuw artikel of bewerk je een bestaand artikel, en kun je de plugin rechtstreeks in de content-editor gebruiken.[mfp_hello name="小明"]Nadat de artikel is gepubliceerd, zal de front-end-pagina de tekst “Hallo, Xiaoming! Dit is een groet gemaakt door mijn plugin” weergeven. Als de ‘name’-attribuut niet wordt opgegeven…[mfp_hello]Dan wordt de standaardtekst “Hallo bezoeker!” weergegeven.

Samenvatting

Met deze handleiding heb je het volledige proces afgerond om van scratch een basis-WooCommerce-plugin te creeren. Je hebt de basisstructuur van een plugin geleerd, de belangrijkheid van header-commentaren, hoe je een administratieve menukaart toevoegt, en hoe je een simpel maar handig front-end-shortcode maakt. Dit zijn de fundamentele elementen voor het ontwikkelen van WordPress-plugins.

De echte reis van het ontwikkelen van plugins is net begonnen. Verder kun je de krachtige settings-API van WordPress verkennen om opslagbare opties te creeren, en gebruikmaken van action hooks.add_action()En filter-hakenadd_filter()Om de kernfunctionaliteit te wijzigen, moet u leren hoe u internationale ondersteuning aan plugins toevoegt en hoe u op veilige wijze met gebruikersgegevens omgaat. Vergeet niet dat het volgen van de coderingsnormen van WordPress en het focussen op beveiliging essentieel zijn voor het ontwikkelen van hoogwaardige plugins.

Veelgestelde vragen (FAQ)

Welke voorwaartse kennis is vereist om een WordPress-plugin te ontwikkelen?

Je moet basiskennis hebben van PHP-programmering, moet op de hoogte zijn van HTML en CSS, en moet de basisfuncties van WordPress beheersen (zoals het publiceren van artikelen en het installeren van thema's en plugins). Het is niet vereist om vertrouwd te zijn met objectgerichte programmering (OOP), maar dit is zeer handig voor het ontwikkelen van complexe plugins.

De naam van het hoofdbestand van de plugin moet dezelfde zijn als de naam van de map waarin de plugin zich bevindt?

Het is niet verplicht, maar dit is een sterk aanbevolen beste praktijk die de structuur helderder maakt. De PHP-fail van het hoofdplugin kan hebben welk naam dan ook, maar de commentaren in het begin van de file moeten correct zijn, en de file moet zich bevinden in de map waar het plugin zich bevindt. De naam van de map is meestal dezelfde als de ‘slug’ van het plugin.

Hoe debug ik mijn plugin-code?

Naast het activeren...WP_DEBUGJe kunt ook gebruikmaken van...error_log()De functie schrijft de debug-informatie in het foutenlog van de server, of gebruikt deze informatie op een andere manier.var_dump()和wp_die()Controleer de uitvoer (enkel voor de ontwikkelingsomgeving). Het gebruiken van debugging-tools zoals Query Monitor is ook een effectieve optie.

Hoe kan ik de plugin die ik heb ontwikkeld publiceren in de officiële WordPress-plugincatalogus?

Allereerst moet je ervoor zorgen dat je plugin-code voldoet aan de vereisten voor publicatie in WordPress, waaronder een GPL-compatibele licentie, goede codekwaliteit, veiligheid en internationaal gebruik. Daarna moet je op WordPress.org een SVN-repo aanvragen, je code daar op slaan en de review-proces doorlopen. Er is een gedetailleerd handboek beschikbaar voor het indienen van plugins.