De ultieme handleiding voor het ontwikkelen van WordPress-plug-ins: van nul tot een expert in het bouwen van krachtige, op maat gemaakte plug-ins.

WordPress-pluginontwikkelingsomgeving en voorbereidende stappen

Voordat je met het schrijven van code begint, is het belangrijk om een professionele en efficiënte ontwikkelingsomgeving op te zetten. Dit is de eerste stap naar succes. Het zal niet alleen je ontwikkelingsefficiëntie verbeteren, maar ook de kwaliteit en onderhoudbaarheid van de code garanderen.

Opzetten van een lokale ontwikkelingsomgeving

Het wordt aanbevolen om een lokale serveromgeving te gebruiken, zoals Local by Flywheel, XAMPP of Laragon. Met deze tools kun je snel een WordPress-omgeving op je lokale computer opzetten waar Apache/Nginx, MySQL en PHP zijn geïnstalleerd. De voordelen hiervan zijn dat je kunt testen en debuggen in een afgescheiden, veilige omgeving, zonder dat je de online website beïnvloedt.

Essentiële tools voor het ontwikkelen van plugins

Naast de serveromgeving heb je ook een aantal tools nodig. Een krachtige code-editor of een integreerde ontwikkelomgeving (IDE) is essentieel; voorbeelden hiervan zijn Visual Studio Code of PhpStorm. Deze tools bieden onder andere syntax-highlighting, codevoorstellen en mogelijkheden voor het oplossen van fouten (debugging). Het is ook belangrijk om kennis te hebben van en te gebruiken van een versiebeheerssysteem, zoals Git, om codeveranderingen te beheren en met anderen te kunnen samenwerken. Ten slotte moet je ervoor zorgen dat je lokale PHP-versie overeenkomt met de versie in de productieomgeving, om compatibiliteitsproblemen te voorkomen.

Aanbevolen leesmateriaal Volledig handboek voor het ontwikkelen van WordPress plugins: maak je eerste functionaliteitsplugin van scratch。

Het begrijpen van de basisstructuur van een plug-in.

Een standaard WordPress-plugin heeft een duidelijke structuur voor de bestanden en de code. Het volgen van deze structuur zorgt ervoor dat je plugin correct wordt herkend en geladen door het WordPress-core, en is ook een vereiste voor het publiceren in de officiële plugin-directory.

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

De samenstelling van het hoofdbestand van een plugin

Elk plugin moet een hoofdbestand hebben. Dit bestand heet meestal dezelfde naam als het plugin, bijvoorbeeld... my-awesome-plugin.phpDe kop van het bestand moet een specifiek blok met annotaties over de plugin bevatten, waarmee je WordPress vertelt wat de plugin doet.

/**
 * Plugin Name:       我的强大插件
 * Plugin URI:        https://example.com/my-awesome-plugin
 * Description:       这是一个用于演示插件开发指南的强大定制插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-awesome-plugin
 */

Naast deze informatieblock kunt u met de schrijfwerkzaamheden voor het belangrijkste deel van de plugincode beginnen. Alle kernfuncties kunnen rechtstreeks in deze bestand worden opgenomen. Voor complexere plugins is het echter aan te raden om de code te modulariseren, oftewel op te delen in verschillende onderdelen.

Codeorganisatie en modularisatie

Om de onderhoudbaarheid van het codebeheer te verbeteren, moet men zich houden aan de principes van modularisatie. Naast de hoofdfile kan je plugin-map ook de volgende onderdelen bevatten:
* includes/ Verzeichnis: Hier worden de bestanden met de kernfuncties of -methoden opgeslagen.
* admin/ Inhoud: Bestemd om code te bewaren die te maken heeft met de backend-beheerinterface.
* public/ Verzeichnis: Bevat de code die de front-end-logica van de website verwerkt.
* assets/ Mappen: worden gebruikt om statische bronnen op te slaan, zoals JavaScript, CSS en afbeeldingen.
* languages/ Verzeichnis: Hier worden de internationale vertaalmogelijkheden (bestanden met de extensies .po en .mo) opgeslagen.
Deze structuur zorgt ervoor dat de code overzichtelijk is, waardoor het gemakkelijk kan worden onderhouden en functies kunnen worden uitgebreid op de lange termijn.

Core development: Hooks en API's

De kernfilosofie van WordPress-pluginontwikkeling is “hooks”. Hierdoor kun je je eigen code op specifieke momenten in de kernprocessen van WordPress invoegen, waardoor je functies kunt veranderen of toevoegen. Dit vormt de basis voor de flexibiliteit en uitbreidbaarheid van WordPress.

Aanbevolen leesmateriaal Volledig handboek voor het ontwikkelen van WordPress plugins: van nul tot een hoogkwalitatieve uitbreiding voor WordPress。

Het gebruik van action hooks

Action Hooks bieden je de mogelijkheid om je eigen code uit te voeren op bepaalde momenten tijdens het werken met WordPress. Denk hierbij aan momenten als wanneer een artikel wordt gepubliceerd of wanneer het menu in het administratiepaneel wordt geladen. add_action() Een functie die een zelfgemaakte functie monteert op een bepaald actie-hook.

function myplugin_send_notification_on_publish( $post_id ) {
    // 获取文章信息
    $post = get_post( $post_id );
    // 模拟发送邮件通知
    wp_mail( '[email protected]', '新文章已发布！', '文章标题：' . $post->post_title );
}
// 将函数挂载到 `publish_post` 这个动作钩子
add_action( 'publish_post', 'myplugin_send_notification_on_publish' );

Het gebruik van filterhooks

Filter hooks worden gebruikt om gegevens te bewerken. Voorafgaand aan het gebruik van de gegevens (bijvoorbeeld het opslaan in een database of het weergeven aan een gebruiker) kun je hun waarden veranderen met behulp van filters. add_filter() Deze functionaliteit is gerealiseerd door een function.

function myplugin_modify_excerpt_length( $length ) {
    // 将文章摘要的默认字数从55改为30
    return 30;
}
add_filter( 'excerpt_length', 'myplugin_modify_excerpt_length' );

Belangrijke globale API-functies

Naast de mogelijkheden om hooks te gebruiken, biedt WordPress een groot aantal handige API-functies, waaronder die voor het bewerken van de database. wpdb Klassen, verwerkingsopties get_option() 和 update_option()‘Create a custom data table’ dbDelta() Functionen en dergelijke. Het behouden van voldoende kennis van deze API's is essentieel voor efficiënt ontwikkelen.

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 compleet plugin-functies realiseren

Laten we de bovenstaande kennis toepassen op een praktisch voorbeeld en een simpel plugin maken voor het schatten van de lees tijd van een artikel. Dit plugin toont de geschatte lees tijd voordat de inhoud van het artikel wordt weergegeven.

Creëer een plugin-framewerk en een hoofdbestand

Allereerst: /wp-content/plugins/ Maak een nieuwe map in de map en geef deze de naam post-reading-timeIn deze map moet je een hoofdbestand (main file) maken. post-reading-time.phpVul ook de standaard-pluginheader-informatie in.

De kernfunctie voor het berekenen en weergeven van de lees tijd

Volgens de opgegeven instructies moet je nu de kernfuncties toevoegen aan het hoofdbestand van het plugin. We hebben een functie nodig om de leestijd te berekenen, en deze moet worden geïntegreerd in het plugin. the_content Op de filter zodat we onze informatie kunnen toevoegen voordat de inhoud van het artikel wordt weergegeven.

Aanbevolen leesmateriaal Volledig handboek voor het ontwikkelen van WordPress plugins: van het begin tot het bouwen van professionele uitbreidingen。

function prt_calculate_reading_time( $content ) {
    // 1. 只有在单篇文章页面才生效
    if ( ! is_single() ) {
        return $content;
    }

// 2. 获取文章内容，去除短代码和HTML标签，计算字数
    $text_content = strip_shortcodes( wp_strip_all_tags( $content ) );
    $word_count   = str_word_count( $text_content );

// 3. 假设平均阅读速度为每分钟200字
    $reading_time = ceil( $word_count / 200 );

// 4. 生成显示HTML
    $reading_time_html = sprintf(
        '<div class="post-reading-time"><p><strong>Verwachte leesduur:</strong>Ongeveer %d minuten.</p></div>',
        $reading_time
    );

// 5. 将阅读时间信息放在文章内容之前
    return $reading_time_html . $content;
}
add_filter( 'the_content', 'prt_calculate_reading_time' );

Een simpel ontwerp toevoegen aan een plugin

Om een mooiere weergave te krijgen, kunnen we wat CSS toevoegen. Een goede praktijk is om de stijlen op een bepaalde volgorde te laden (te ‘queueen’). wp_enqueue_style() Deze functie zorgt ervoor dat de stijlblaadjes correct worden geladen en dat er geen conflicten ontstaan met andere plugins.

function prt_enqueue_styles() {
    wp_enqueue_style(
        'prt-style',
        plugin_dir_url( __FILE__ ) . 'assets/css/prt-style.css', // 假设CSS文件路径
        array(), // 依赖
        '1.0.0' // 版本号
    );
}
add_action( 'wp_enqueue_scripts', 'prt_enqueue_styles' );

En daarna... assets/css/prt-style.css Een simpel style toevoegen aan een bestand:

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

.post-reading-time {
    background-color: #f0f8ff;
    border-left: 4px solid #3498db;
    padding: 10px 15px;
    margin-bottom: 20px;
    font-size: 0.95em;
}

Hiermee is een compleet plugin met de basisfuncties gemaakt. Je kunt het activeren en controleren of er een aantrekkelijk indicatie van de leesduur bovenop de inhoud van een artikel wordt weergegeven.

Samenvatting

Het ontwikkelen van WordPress plugins is een proces waarbij je creativiteit omtovert in krachtige functionaliteiten. Door een professionele omgeving op te zetten, de standaardstructuur van plugins te begrijpen, en het mechanisme van hooks en de kern-API's goed te beheersen, ontwikkel je de basisvaardigheden om allerlei maatgeschikte plugins te bouwen. In dit artikel wordt een duidelijke leerweg beschreven, van de voorbereiding van de omgeving tot de structuur van het code, van de theoretische kernprincipes tot praktische voorbeelden. Het belangrijkste is om te gaan experimenteren: begin met een eenvoudige functionaliteit zoals “lees tijd” en verhoog de complexiteit steeds verder. Uiteindelijk zul je in staat zijn om krachtige WordPress plugins te ontwikkelen die precies voldoen aan de behoeften van je klanten.

Veelgestelde vragen (FAQ)

Is het nodig om vloeiend PHP te beheersen om plugins te ontwikkelen?

Ja, een solide basis in PHP is een vereiste voor het ontwikkelen van WordPress-plug-ins. De kern van WordPress, evenals de meeste van zijn plug-ins en thema's, is namelijk geschreven in PHP. Je moet de basis van de PHP-syntax begrijpen, zoals variabelen, functies, klassen, arrays, cycli en conditionele bewerkingen, evenals de fundamentele concepten van objectgericht programmeren (OOP), om veilige en efficiënte plug-in-koden te kunnen schrijven.

Hoe kan ik zorgen dat de plugin die ik ontwikkeld heb veilig is?

Om de veiligheid van plugins te garanderen, zijn verschillende maatregelen nodig. Allereerst is het belangrijk om alle door gebruikers ingevoerde gegevens streng te verifiëren, te reinigen en te ontsnappen (escapen). Hierbij kunnen functies van WordPress worden gebruikt, zoals… sanitize_text_field(), esc_html(), wp_kses_post() Ten tweede: wanneer je database-operaties uitvoert, moet je altijd gebruikmaken van… $wpdb Methoden van een klasse prepare() Maak gebruik van statements om SQL-injecties te voorkomen. Volg ook het principe van minimale bevoegdheden: geef de plugin alleen de vereiste toegang om zijn functies uit te voeren.

De plugin die ik heb ontwikkeld, kan worden geüpload in het officiële WordPress-directory?

Ja, dat is mogelijk, maar er zijn een aantal strenge vereisten die moeten worden vervuld. Je plugin-code moet voldoen aan de WordPress-编码standaarden, gebruikmaken van een licentie zoals GNU GPL v2 of een hogere versie, en mag geen schadelijke code, betaalde links of inhoud bevatten die de directorygidsen overtreden. Voor het indienen van je plugin is het aan te raden om de officiële pluginontwikkelingshandleidingen en de submit-guides grondig te lezen, en om je code te controleren en te testen.

Hoe voeg ik een beheeringspagina toe aan mijn plugin?

Het toevoegen van een instellingenpagina voor een plugin betekent meestal dat je de “Menu Page API” van WordPress gebruikt. Je kunt dit doen door... add_menu_page() Een functie om een hoogste niveau-menu-item te creëren, of om dit te gebruiken... add_submenu_page() Creer een subpagina onder een bestaande menu (bijvoorbeeld “Instellingen”). In de callback-functie van de instellingenpagina moet je een HTML-formulier weergeven en deze gebruiken om gegevens in te vullen. settings APIInclusief register_setting, add_settings_section, add_settings_field Functies als deze worden gebruikt om het registreren, opslaan en weergeven van opties op veilige en gemakkelijke manier te bewerkken.