Volledig handboek voor het ontwikkelen van WordPress plugins: van het begin tot het maken van functionele plugins

Het ontwikkelen van WordPress-plug-ins is een belangrijke manier om de kernfuncties van WordPress uit te breiden. Het biedt ontwikkelaars de mogelijkheid om op een eenvoudige manier nieuwe functies toe te voegen aan een website, zonder de oorspronkelijke code te hoeven aanpassen. Of het nu gaat om simpele kortcodes of om complexe e-commerce-systemen: alles kan worden gerealiseerd met plug-ins. Als je de technieken van plug-in-ontwikkeling beheerst, kun je WordPress dieper personaliseren om specifieke bedrijfsbehoeften te vervullen, of zelfs je eigen creaties omzetten in verkrijgbare producten.

Basics van WordPress-pluginontwikkeling en het opzetten van een ontwikkelingsomgeving

Voordat je begint met schrijven van code, moet je een geschikte ontwikkelingsomgeving opzetten en de basisstructuur van het plugin begrijpen.

Ontwikkelingsomgeving voorbereiden

Een efficiënte lokale ontwikkelomgeving is essentieel. 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 compatibel is met de vereisten van de meest recente versie van WordPress. Daarnaast zijn een handige code-editor (zoals VS Code of PhpStorm) en browser-developer-tools voor het opsporen en oplossen van fouten ook onmisbaar.

Aanbevolen leesmateriaal Ultimate Guide to WordPress Plugin Development: Build Your First Plugin from Scratch。

De basisstructuur van een plugin en de hoofdfile

Elk plugin moet een hoofdbestand hebben, dat de entreepunt van het plugin is. Dit hoofdbestand heet meestal dezelfde naam als het plugin. my-awesome-plugin.phpDe bestandskop moet specifieke commentaren over de plugin-informatie bevatten; dit is essentieel voor WordPress om de plugin te herkennen.

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

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

Deze commentaar bevat de instellingen voor de weergave van informatie over het plugin in het administratieven menu van WordPress, zoals de naam, beschrijving en versie van het plugin.Text Domain 和 Domain Path Voor internationale vertalingen.

Organisatie van de plugin-map

Een goed georganiseerde map met plugins is handig voor het langdurige onderhoud. Een typisch structuur van de map kan omvatten:
Het hoofdbestand my-awesome-plugin.php (Zit in de rootmap van het plugin)
- includes/ Verzeichnis: Hier worden de bestanden met de kernfuncties of -methoden opgeslagen.
- admin/ Verzeichnis: Bevat de code die betrekking heeft met de backend-beheerinterface.
- public/ Verzeichnis: Bevat de code die betrekking heeft met de front-end-weergave.
- assets/ Verzeichnis: Hier worden CSS-stylesheeten, JavaScript-scripts en afbeeldingen opgeslagen.
- languages/ Verzeichnis: Hier worden de internationale vertaalmogelijkheden (bestanden met de extensies .po en .mo) opgeslagen.

Core development concepts and the Hooks mechanism

De kernfilosofie van het ontwikkelen van WordPress-plug-ins is “hooks en callbacks”. Met hooks kun je je eigen code op specifieke momenten in de uitvoeringsflow van WordPress invoegen.

Action hooks en filter hooks

Er zijn voornamelijk twee soorten hooks: Action en Filter.
Action hooks bieden je de mogelijkheid om zelfgemaakte code uit te voeren wanneer bepaalde gebeurtenissen plaatsvinden, bijvoorbeeld wanneer een artikel wordt gepubliceerd of wanneer de beheerpagina wordt geladen. add_action() Een functie die wordt gebruikt om iets te mounten.

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

function myplugin_send_notification( $post_id ) {
    // 当文章发布时，执行发送通知的代码
    wp_mail( '[email protected]', '新文章发布', "文章ID: $post_id 已发布。" );
}
add_action( 'publish_post', 'myplugin_send_notification' );

De filter-haken bieden je de mogelijkheid om gegevens te bewerken. Je kunt de gegevens aanpassen voordat ze worden gebruikt, bijvoorbeeld voordat ze in een database worden opgeslagen of worden weergegeven in een browser. add_filter() Functie.

function myplugin_modify_title( $title ) {
    // 在所有文章标题前添加文本
    return '【精选】' . $title;
}
add_filter( 'the_title', 'myplugin_modify_title' );

Een custom hook maken

Een uitstekend plugin gebruikt niet alleen de kern-hooks, maar moet ook mogelijkheden bieden voor andere ontwikkelaars om hun eigen hooks aan te passen. do_action() Maak een actie-hook en gebruik dit om... apply_filters() Een filterhook maken.

// 在插件代码的某个位置定义一个动作钩子
do_action( 'myplugin_after_processing', $data );

// 定义一个过滤器钩子，允许其他代码修改 $output
$output = apply_filters( 'myplugin_output_filter', $default_output, $param1, $param2 );

Constructie van plugin-functionaliteiten: opties, shortcodes en interactie met de database

Een compleet plugin moet meestal configuratieopties bieden, een manier om de inhoud op de front-end te weergeven, en mogelijkheden voor het opslaan van data.

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

Creëer een pagina met beheeropties.

Gebruik de WordPress Settings API om veilige, gestandaardiseerde beheerpagina's te creeren. Dit omvat het registreren van instellingen, het toevoegen van instellingsvelden en onderdelen (chapters).

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

// 注册设置、字段和章节的代码...
function myplugin_settings_page() {
    ?>
    <div class="wrap">
        <h1>Mijn plug-ininstellingen</h1>
        <form action="/nl/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            settings_fields( 'myplugin_settings_group' );
            do_settings_sections( 'myplugin-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="nl"/></form>
    </div>
    &lt;?php
}

De functionaliteit van kortere codes implementeren

Shortcodes maken het voor gebruikers gemakkelijk om plug-in-functies in artikelen of pagina's in te bouwen. add_shortcode() De functie wordt geregistreerd.

add_shortcode( 'myplugin_show_message', 'myplugin_shortcode_callback' );
function myplugin_shortcode_callback( $atts ) {
    // 解析短代码属性
    $attributes = shortcode_atts( array(
        'text' => '默认消息',
    ), $atts );

// 返回要显示的内容
    return '<div class="myplugin-message">'`.esc_html($attributes['text'])`.'</div>';
}

Gebruikers kunnen tekst invoeren in de editor. [myplugin_show_message text="你好，世界！"] Ga het gebruiken.

Aanbevolen leesmateriaal Ultimatumgids voor het ontwikkelen van WordPress-plug-ins: van het begin tot de volledige beheersing。

Interactie met de database

Voor plugins die gegevens moeten opslaan, wordt het aanbevolen om de database-API's van WordPress te gebruiken. $wpdbTijdens het maken van een aangepaste tabel moet dit worden uitgevoerd in de hook voor het activeren van de plugin.

register_activation_hook( __FILE__, 'myplugin_create_table' );
function myplugin_create_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'myplugin_data'; // 加上前缀
    $charset_collate = $wpdb->get_charset_collate();

$sql = "CREATE TABLE IF NOT EXISTS $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT,
        name varchar(100) NOT NULL,
        value text,
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
        PRIMARY KEY (id)
    ) $charset_collate;";

require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
    dbDelta( $sql );
}

Tijdens het opvragen van gegevens moet worden gebruikt… $wpdb->prepare() Dit is om SQL-injectie-aanvallen te voorkomen.

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

Plugin-beveiliging, prestaties en voorbereiding op publicatie

De geïmplementeerde plugins moeten worden versterkt op het gebied van security, worden optimaal gestemd in termen van prestaties en worden gestandardiseerd, voordat ze worden uitgebracht voor gebruik door gebruikers.

Beste beveiligingspraktijken

Veiligheid is de belangrijkste overweging. Alles wat van de gebruiker wordt ingevoerd (bijvoorbeeld…) $_GET， $_POST， $_COOKIEAlle verkregen gegevens moeten worden gevalideerd, gereinigd en geëscapeerd.
Validatie: controleren of de gegevens overeenkomen met het verwachte formaat (bijvoorbeeld of het een e-mailadres of een cijfer is).
Sanitering: gegevens opruimen en onveilige tekens verwijderen. Hierbij worden functies gebruikt als sanitize_text_field()， sanitize_email()。
Escapen: voer de gegevens door een escape-procedure voordat ze naar HTML, JavaScript of een URL worden verzonden. Hierbij wordt gebruikgemaakt van functies als esc_html()， esc_js()， esc_url()。

Tegelijkertijd wordt het ingebouwde NonCE-token van WordPress gebruikt.wp_nonceDeze mechanismen worden gebruikt om de legitiemheid van verzoeken te controleren en zo aanvallen met cross-site request forgery (CSRF) te voorkomen.

Tips voor het optimaliseren van de prestaties

Vermeid het uitvoeren van onnodige database-opvragen of zware bewerkingen in plugins. Voor herhaalde query-resultaten is het gebruik van de WordPress-transient-API (Transients) aan te raden om deze resultaten te cacheren.

// 尝试从缓存中获取数据
$data = get_transient( 'myplugin_expensive_data' );
if ( false === $data ) {
    // 缓存中没有，执行耗时操作获取数据
    $data = myplugin_expensive_query_function();
    // 将数据缓存12小时
    set_transient( 'myplugin_expensive_data', $data, 12 * HOUR_IN_SECONDS );
}

Zorg ervoor dat, wanneer een plugin wordt uitgeschakeld of gedownload, de benodigde acties worden uitgevoerd. register_deactivation_hook 和 register_uninstall_hook Verwijder de tijdelijke objecten, geplande taken (Cron Jobs) en eventueel aangepaste database-tabelen die je hebt gecreëerd.

Internationalisatie en de uiteindelijke publicatie

Gebruik ()， _e() De `wrap`-functie omhult al het tekstuele materiaal dat voor de gebruiker zichtbaar is, waardoor meertaligheid wordt ondersteund. Voorbeeld:echo esc_html( ‘Hello World’， ‘my-awesome-plugin’ );Vervolgens wordt met een tool als Poedit een vertaling gemaakt. .pot Templatebestanden en vertaalmappen.

Voor de publicatie moet je ervoor zorgen dat je code voldoet aan de coderingsnormen van WordPress en dat je een duidelijke beschrijving schrijft. readme.txt De plugin moet worden opgeslagen in een bestand. Vervolgens moet de plugin worden verpakt in een ZIP-bestand. Nadat dit is gedaan, kan de plugin worden ingediend in de officiële WordPress-plugincatalogus of via andere kanalen worden verspreid.

Samenvatting

Het ontwikkelen van WordPress-plug-ins is een proces waarbij ideeën worden omgezet in werkelijkheid. Van het begrijpen van de basismechanismen (zoals hooks) tot het bouwen van een gebruikersinterface en het schrijven van kortere code, en van het belangrijke aspect van beveiliging tot het optimaliseren van de prestaties: ieder stap vereist zorgvuldige aandacht. Het volgen van beste praktijken en het schrijven van strak georganiseerde, veilige en betrouwbare code zorgt niet alleen voor krachtige functionaliteiten, maar ook voor de maintainability (onderhoudbaarheid) en compatibiliteit van de plug-in. Het voortdurend leren van de WordPress-core-API en de community-standaarden is essentieel om een goede plug-in-developer te worden.

Veelgestelde vragen (FAQ)

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

Je moet basiskennis hebben van de PHP-programmeringstaal, omdat WordPress en zijn plugins voornamelijk in PHP zijn geschreven. Daarnaast is het handig om enkele basiskennten te hebben van HTML, CSS en JavaScript, om de front-end-weergave en interactie te kunnen beheersen. Het is ook nuttig om vertrouwd te zijn met de basisconcepten van de MySQL-database (zoals toevoegen, bewerken, verwijderen en opvragen van gegevens), aangezien WordPress gebruikmaakt van een MySQL-database. $wpdb Klassen versimpelen de meeste handelingen.

Hoe debug ik mijn WordPress-plugin?

Allereerst, zorg ervoor dat je op wp-config.php Het bestand is geopend in WP_DEBUG 和 WP_DEBUG_LOG Constant: dit zal de foutmelding opslaan in /wp-content/debug.log In het bestand. Daarnaast kan dit worden gebruikt. error_log() De functie outputt aangepaste debug-informatie. Daarnaast kunnen AJAX-verzoeken en JavaScript-fouten worden gedetecteerd en gedetecteerd met de Network- en Console-panelen in de browser-developer-tools. Professionele IDE's (zoals PhpStorm) bieden ook uitstekende mogelijkheden voor het plaatsen van breakpoints en het debuggen van code.

Moet mijn plugin een aangepaste database-tabel maken?

Dat hangt af van de behoeften. Als uw gegevens een zeer persoonlijke structuur hebben en niet effectief kunnen worden opgeslagen met de ingebouwde artikeltypes van WordPress of de Options API, is het verstandig om een aangepaste tabel te maken. Denk hierbij aan het opslaan van complexe loggegevens of relatiegegevens. Als de gegevens echter eenvoudig kunnen worden gemappt naar “artikelen” (met aangepaste metagegevens), is het gebruiken van aangepaste artikeltypes meestal de beste optie, omdat dit automatisch compatibel is met de WordPress-ecosysteem (bijvoorbeeld voor het maken van queries en het beheersen van rechten).

Hoe maak ik mijn plugin compatibel met meer versies van WordPress?

Verwacht niet dat alle functies die beschikbaar zijn ook echt worden gebruikt. Probeer dus niet te veel functies te gebruiken die te nieuw of al verouderd zijn. Tijdens het ontwikkelen is het handig om de officiële WordPress Codex of het Developer Handbook te raadplegen; hierin staan informatie over de versies waarin bepaalde functies zijn geïntroduceerd en wanneer ze zijn verouderd. Je kunt in je code gebruikmaken van conditionele bewerkingen om alleen de functies te gebruiken die op de juiste versie zijn beschikbaar. function_exists() Een plan voor het terugvallen op een eerdere staat moet worden voorbereid. Voorbeeld:if ( function_exists( ‘wp_is_block_theme’ ) ) { ... }Vervolgens moet in de commentaren aan het begin van het hoofdbestand van het plugin duidelijk worden aangegeven welke versies van WordPress de testen hebben doorlopen.