Een geavanceerde handleiding voor het ontwikkelen van WordPress-plug-ins: van nul naar het bouwen van professionele plug-ins.

Voor ontwikkelaars die hun kennis van WordPress willen verder uitbreiden, is het een belangrijke stap om van het schrijven van simpele scripts over te gaan naar het bouwen van professionele plugins die volledig functioneren, veilig zijn en voldoen aan standaarden. Deze ontwikkelingsprocedure omvat niet alleen de kernmechanismen van WordPress (zoals de hook-systemen), maar ook aspecten als veiligheid, codeorganisatie, gebruikersinterface en publicatieprotocollen.

Developmentomgeving en projectinitalisatie

Voor het beginnen met coderen is het van cruciaal belang om een efficiënte en standaard ontwikkelingsomgeving op te zetten. Dit zorgt voor een hoge kwaliteit van de code en maakt het gemakkelijker om de code in de toekomst te onderhouden en met het team samen te werken. Een goed georganiseerde projectmap vormt de basis voor het gebruik van professionele plugins.

Het wordt aanbevolen om een lokale ontwikkelingsomgeving te gebruiken.

Het wordt aanbevolen om tools als Local by Flywheel, DevKinsta of Docker te gebruiken om een lokale WordPress-omgeving op te bouwen. Dit zorgt voor een geisoleerde testomgeving, waardoor de online-site niet wordt beïnvloed. Zorg ervoor dat je ontwikkelomgeving overeenkomt met de PHP-versie (bijvoorbeeld PHP 7.4 of 8.0 of later) en de WordPress-versie die wordt gebruikt door je doelgroep.

Aanbevolen leesmateriaal Hoe kies je een high-performance WordPress-thema en hoe pas je dit thema aan om het nog beter te gebruiken?。

Een standaard map met plugins en een hoofdbestand maken

Het belangrijkste bestand van een plugin is het hoofdbestand (main file), waarschijnlijk genaamd zoals de naam van de plugin-map is.my-advanced-plugin.phpDe rol van deze bestand is niet alleen om plugins te activeren, maar nog belangrijker: via de commentaren in het begin van de plugin worden de basisgegevens van de plugin aan WordPress gemeld.

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-advanced-plugin
 * Description:       这是一个演示WordPress高级插件开发的功能性插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-advanced-plugin
 * Domain Path:       /languages
 */

Een veilig mechanisme voor toegang tot bestanden opzetten

Om te voorkomen dat slechte gebruikers direct toegang krijgen tot de interne bestanden van je plugin, moet er een beveiligingscontrole worden toegevoegd aan het begin van elke kern-PHP-bestand. Dit wordt meestal gedaan door te controleren...ABSPATHDit wordt gerealiseerd met constante waarden.

// 在 my-advanced-plugin/includes/class-core.php 等文件顶部
defined( 'ABSPATH' ) || exit;

Core architecture en object-oriented programming

Het gebruik van een objectgerichte (OOP) architectuur is essentieel voor het bouwen van onderhoudsgevende en uitbreidbare professionele plugins. OOP helpt je om complexe functionaliteiten te organiseren in duidelijke, onafhankelijke modules door middel van encapsulatie, vererving en polymorfie.

Implementeren van het Master Controller Pattern

Meestal creëren we een hoofdklasse die fungeert als de controller van het plugin. Deze klasse wordt initialiseerd wanneer het plugin wordt activeerd en is verantwoordelijk voor het laden van andere componenten. We noemen deze klasse…My_Advanced_PluginEn er wordt gebruik gemaakt van het singleton-patroon om te zorgen dat er maar één instans op het hele systeem is.

// File: includes/class-my-advanced-plugin.php
class My_Advanced_Plugin {
    private static $instance = null;

public static function get_instance() {
        if ( null === self::$instance ) {
            self::$instance = new self();
        }
        return self::$instance;
    }

private function __construct() {
        $this->define_constants();
        $this->load_dependencies();
        $this->init_hooks();
    }

private function define_constants() {
        define( 'MY_ADVANCED_PLUGIN_VERSION', '1.0.0' );
        define( 'MY_ADVANCED_PLUGIN_PATH', plugin_dir_path( __FILE__ ) );
        define( 'MY_ADVANCED_PLUGIN_URL', plugin_dir_url( __FILE__ ) );
    }

private function load_dependencies() {
        require_once MY_ADVANCED_PLUGIN_PATH . 'includes/class-admin.php';
        require_once MY_ADVANCED_PLUGIN_PATH . 'includes/class-public.php';
        // 加载其他依赖文件...
    }

private function init_hooks() {
        add_action( 'plugins_loaded', array( $this, 'load_textdomain' ) );
        register_activation_hook( __FILE__, array( 'My_Advanced_Plugin_Activator', 'activate' ) );
        register_deactivation_hook( __FILE__, array( 'My_Advanced_Plugin_Deactivator', 'deactivate' ) );
        // 注册其他动作和过滤器钩子...
    }

public function load_textdomain() {
        load_plugin_textdomain(
            'my-advanced-plugin',
            false,
            dirname( plugin_basename( __FILE__ ) ) . '/languages'
        );
    }
}

Separate the front-end and back-end logic.

将管理后台（Admin）和网站前端（Public）的逻辑分离到不同的类中，是良好的实践。例如，My_Advanced_Plugin_AdminDe klassen zijn alleen verantwoordelijk voor het verwerken van de achtergrondmenu's, instellingenpagina's en de stijl van de scripts.My_Advanced_Plugin_PublicDe klassen zijn verantwoordelijk voor de weergave op de front-end, kortcodes en gemeenschappelijke bronnen. Dit is in overeenstemming met het principe van een enkele verantwoordelijkheid (Single Responsibility Principle), waardoor de code eenvoudiger te beheren is.

Aanbevolen leesmateriaal WooCommerce-handboek: Van nul een professionele e-commerce-website bouwen voor gemakkelijk verkopen en beheer。

Advanced features en beveiligingsmaatregelen

Professionele plugins moeten de veiligheid topprioriteit geven en tevens sterke mogelijkheden bieden voor databeheer en gebruikersinteractie.

Het gebruik van WordPress zonder CE (Content Encryption) en beveiliging van toegangrechten

Elke actie die betrekking heeft tot het bewerken van gegevens (bijvoorbeeld het opslaan van instellingen of het verwijderen van onderdelen) moet worden gevalideerd op veiligheid. WordPress biedt hierbij hulpmiddelen om deze processen te beveiligen.wp_nonceEenmalige nummering en een beveiligingsfunctie voor toegangscontrole.

// 在表单中生成 nonce 字段
wp_nonce_field( 'my_plugin_save_action', 'my_plugin_nonce' );

// 在处理表单提交时验证
if ( ! isset( $_POST['my_plugin_nonce'] ) ||
     ! wp_verify_nonce( $_POST['my_plugin_nonce'], 'my_plugin_save_action' ) ) {
    wp_die( __( '安全验证失败，操作已终止。', 'my-advanced-plugin' ) );
}

// 检查用户权限
if ( ! current_user_can( 'manage_options' ) ) {
    wp_die( __( '您没有执行此操作的权限。', 'my-advanced-plugin' ) );
}

Een aangepaste database-tabel maken

Als een plugin complexe relatiegegevens moet opslaan, kan het nodig zijn om een aangepaste tabel te creeren. Dit moet worden gedaan in de activatie-hook van de plugin, en er moet rekening worden gehouden met het beheer van de databaseversie.

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

// File: includes/class-activator.php
class My_Advanced_Plugin_Activator {
    public static function activate() {
        global $wpdb;
        $charset_collate = $wpdb->get_charset_collate();
        $table_name = $wpdb->prefix . 'myplugin_items';

$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 );

// 保存或更新数据库版本号
        update_option( 'my_advanced_plugin_db_version', '1.0.0' );
    }
}

AJAX-handelingen implementeren

Om een soepele gebruikerservaring te bieden, is het vaak nodig om via AJAX met de backend te communiceren op de front-end. WordPress biedt voor geregistreerde gebruikers en niet-geregistreerde bezoekers (bezoekers) aparte mogelijkheden.wp_ajax_*和wp_ajax_nopriv_*Hook.

// 后端：注册AJAX处理器
add_action( 'wp_ajax_my_plugin_fetch_data', 'my_plugin_ajax_fetch_data_handler' );
add_action( 'wp_ajax_nopriv_my_plugin_fetch_data', 'my_plugin_ajax_fetch_data_handler' );

function my_plugin_ajax_fetch_data_handler() {
    // 安全检查
    check_ajax_referer( 'my_plugin_ajax_nonce', 'nonce' );

$data = array( 'message' => '成功获取数据！' );
    wp_send_json_success( $data ); // 自动以JSON格式输出并结束
}

Plugin-optimalisatie en voorbereiding op publicatie

Nadat de functionaliteiten zijn ontwikkeld, zijn de volgende stappen het optimaliseren van het plugin, het internationaaliseren ervan en het voorbereiden van de publicatiebestanden. Dit zijn de laatste stappen op weg naar professionalisatie.

Volledige internationale ondersteuning realiseren

Gebruikload_textdomain()Het laden van de vertaalfail is maar het eerste stap. Het belangrijkste is dat alle strings die in het plugin moeten worden weergegeven aan de gebruiker, moeten worden omhuld met een vertaalfunctie. De meest gebruikelijke methode is…__()Om de vertaalde tekst te verkrijgen:_e()Gebruikt voor direct weergeven.

Aanbevolen leesmateriaal WooCommerce Development in Practice: Build a Professional E-commerce Website from Scratch。

$greeting = __( '你好，世界！', 'my-advanced-plugin' );
_e( '设置已保存。', 'my-advanced-plugin' );
printf(
    /* translators: %s: 用户名称 */
    __( '欢迎，%s！', 'my-advanced-plugin' ),
    $user_name
);

Op maat laden van scripts en style sheets

Gebruikwp_enqueue_script()和wp_enqueue_style()Er zijn functies beschikbaar om resources correct te laden. Zorg ervoor dat de juiste afhankelijkheden worden ingesteld voor scripts en styles, en dat ze alleen worden geladen op de pagina's waar ze nodig zijn. Een veelgebruikte methode is…wp_localize_script()Een PHP-variabele veilig overdragen naar het front-end JavaScript.

Maak een professionele pagina voor het instellen van plugins.

Je kunt de WordPress Settings API gebruiken om instellingenpagina's te creeren. De API verzorgt automatisch de verificatie van de invoer (niet-CSS-verificatie) en het opslaan van de gegevens. Dit is een standaard en veilige manier om instellingen te beheren. Je moet eerst instellingen registreren, vervolgens nieuwe instellingen toevoegen en de vereiste velden invullen.

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

Het schrijven van gedetailleerde documentatie en een readme.txt-bestand.

Voordat je een plugin indient in de officiële WordPress-pluginbibliotheek of het distribueert aan klanten, moet de plugin voldoen aan bepaalde standaarden.readme.txtDe bestand is essentieel. Het moet informatie bevatten over de beschrijving van de plugin, de manier van installeren, instructies voor het gebruik, veelvoorkomende vragen, en logboeken van updates. Daarnaast zijn duidelijke codecommentaren en optionele documentatie voor ontwikkelaars een teken van professionaliteit.

Samenvatting

Een professioneel WordPress-plugin vanaf nul bouwen is een systeematische onderneming die omvat van het plannen van de projectstructuur, het ontwerp van een objectgerichte architectuur, het toepassen van veilige coderingstechnieken, het realiseren van geavanceerde functies, tot de uiteindelijke optimalisatie en voorbereiding op publicatie. Het belangrijkste is om de kerncoderingstandaarden van WordPress te volgen, optimaal gebruik te maken van de beschikbare API's en altijd de principie van veiligheid te nastreven. Door het moduleren van het plugin, het ondersteunen van internationale talen en het schrijven van kwalitatief goede documentatie, zal je plugin niet alleen stabiel werken, maar ook de erkenning van een breder publiek van gebruikers en ontwikkelaars krijgen.

Veelgestelde vragen (FAQ)

Hoe kies je een unieke naam voor een plugin en een prefix voor de functies om conflicten te voorkomen?

In de WordPress-ecosysteem zijn conflicten tussen plugins, functies en klassennamen een veel voorkomend probleem. Om dit te voorkomen, is het aan te raden om een unieke prefix te kiezen voor je plugin. Het is handig om een afkorting te gebruiken die je persoon of je merk vertegenwoordigt, gevolgd door een beschrijving van de functionaliteit van de plugin. Bijvoorbeeld:send_email()Zo'n algemene functionnaam zou beter niet worden gebruikt…myco_send_email()或map_send_email()(Als je het hebt over de afkorting van je plugin, MAP, moeten ook de namen van de klassen zich aan deze regel houden.)MyCo_Email_Manager。

Welke hook moet in het plugin worden gebruikt om de belangrijkste functies in te stellen?

De aanbevolen hook is…plugins_loadedDeze actie-haak wordt uitgevoerd nadat alle plugins zijn geladen en voordat het WordPress-core is geïnitialiseerd. Door de initialisatie van je hoofdplugin-klasse te koppelen aan deze haak, weet je zeker dat de WordPress-omgeving klaar is voor gebruik en dat de functies of klassen van andere plugins (indien je daarvan afhankelijk bent) ook beschikbaar zijn. Dit is beter dan de code rechtstreeks aan het eind van het hoofdbestand uit te voeren.initHet is veiliger en beter om de initialisatie in de hook (die zich meer richt op het verwerken van front-end-verzoeken) te doen.

Hoe kun je kiezen tussen het aanpassen van je eigen database-tabels en het gebruiken van de WordPress Option API of artikeltypen om gegevens op te slaan?

Dat hangt af van de structuur en omvang van de gegevens. Voor eenvoudige configuratiegegevens in de vorm van sleutel-waarde-paren is het gebruik van...add_option()和get_option()Dit is de beste optie. Voor gestructureerde gegevens waarbij CRUD-operaties (creeren, lezen, updaten, verwijderen) nodig zijn en waarbij complexe relaties tussen gegevensbestanden bestaan (bijvoorbeeld bestellingen of klantgegevens), is het vaak sneller en flexibeler om zelf een aangepaste tabel te maken. Voor gegevens met een specifieke aard (bijvoorbeeld producten of portfolio's), is het handig om een aangepaste artikeltype (Custom Post Type of CPT) te gebruiken, omdat deze rechtstreeks gebruikmaken van de bewerkingsschermen, categorieën, commentarsystemen en inbegrepene zoekfuncties van WordPress.

Hoe kun je compatibiliteitsproblemen tussen plugins en verschillende versies van WordPress en PHP oplossen?

Eerst, met betrekking tot de plugin...readme.txtIn het hoofdstuk van het main-bestand moet duidelijk worden aangegeven welke minimale versie van WordPress en PHP je ondersteunt (bijvoorbeeld:Requires at least: 5.6，Requires PHP: 7.4Ten tweede: gebruik in je code conditionele beoordelingen en versiecontroles. Bijvoorbeeld, voordat je een nieuwe versie van WordPress of een PHP-functie probeert op te roepen, moet je eerst controleren of deze versie compatibel is met je systeem.function_exists()或version_compare()Een controle uitvoeren. Als een essentieel functie niet wordt ondersteund, kan een alternatieve oplossing worden aangeboden of een vriendelijke melding voor de beheerder worden weergegeven, waarmee de gebruiker wordt gewaarschuwd om de omgeving te upgraden, in plaats van dat er direct een fatale fout optreedt.