Van het begin tot de praktijk: een uitgebreide gids voor het ontwikkelen van WordPress plugins en geavanceerde technieken

Basics van WordPress-pluginontwikkeling en voorbereiding van de omgeving

Het ontwikkelen van WordPress-plug-ins is een belangrijke manier om de mogelijkheden van een CMS (Content Management System) uit te breiden. Om met het ontwikkelen te kunnen starten, is het eerst nodig om een professionele lokale ontwikkelomgeving op te zetten. Het wordt aanbevolen om tools als XAMPP, MAMP of de modernere Local by Flywheel te gebruiken; deze kunnen snel een volledig functionerende webserveromgeving met PHP, MySQL en Apache op uw computer opzetten. Zorg ervoor dat u ook de meest recente versie van WordPress hebt geïnstalleerd, evenals een efficiënte code-editor die PHP-syntax ondersteunt, bijvoorbeeld Visual Studio Code of PHPStorm.

Het essentieel van het ontwikkelen van een plugin is om de basisstructuur ervan te begrijpen. Een plugin is in feite één of meerdere onderdelen die zich bevinden in...wp-content/plugins/De PHP-bestanden in de map. Het meest fundamentele vereiste is dat er een unieke hoofdbestand wordt gemaakt voor het plugin. Elk plugin moet een specifieke hoofdcommentaar bevatten, waarin informatie over de naam van het plugin, de beschrijving, de versie, de ontwikkelaar en andere details staat. WordPress gebruikt deze metadata om plugins te herkennen en te beheren. Hier is een voorbeeld van een minimale hoofdcommentaar voor een plugin:

<?php
/**
 * Plugin Name: 我的第一个插件
 * Description: 这是一个用于演示的简单插件。
 * Version: 1.0
 * Author: 开发者名称
 */

Naast de PHP-fail met deze annotatie in de juiste map voor plugins te hebben geplaatst, kunt u het vinden en activeren op de “Plugins”-pagina in het WordPress-beheerpaneel.

Aanbevolen leesmateriaal Van nul beginnen: een volledig handboek voor het ontwikkelen van WordPress-plug-ins en tips en beste praktijken。

Plugin-directory en namenconventies

Een goed georganiseerd plugin is van essentieel belang voor het onderhouden en samenwerken. Het is aan te raden om voor complexe plugins aparte mappen te creeren in plaats van één enkele bestand. De namen van deze mappen moeten kort, uniek en alleen in kleine letters zijn, en ze moeten over het algemeen overeenkomen met de naam van het hoofdbestand van het plugin. Bijvoorbeeld, voor een plugin met de naam “my-awesome-plugin”, zou de mapstructuur kunnen bestaan uit het hoofdbestand en eventuele andere onderliggende bestanden.my-awesome-plugin.phpOpslaancss和jsEen map, en een bestand voor het definiëren van hooks.includesMappen, en die ook worden gebruikt voor internationaliseringlanguagesMappen. Het volgen van deze structuur verbetert de leesbaarheid van het code.

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

Core concepts: Action hooks en filters

Het begrijpen van het hook-systeem van WordPress is de basis voor het ontwikkelen van plugins. Hooks bieden de mogelijkheid om op specifieke momenten uw eigen code te toevoegen of gegevens te verwerken, zonder de kerncode van WordPress te hoeven aanpassen. Er zijn twee belangrijke categorieën van hooks: Actions en Filters.

Toepassing van action-hooks

Action hooks bieden je de mogelijkheid om op specifieke momenten in het levenscyclus van WordPress (bijvoorbeeld wanneer een artikel wordt gepubliceerd, een pagina wordt geladen of een gebruiker inlogt) eigen code uit te voeren. Je moet hierbij gebruikmaken van…add_action()Er is een functie beschikbaar om een callback-functie te registreren. Als u bijvoorbeeld wilt dat een bepaalde tekst automatisch wordt toegevoegd aan het begin van elke artikel, kunt u deze functie gebruiken om dit te realiseren.the_contentMet deze actie:

function myplugin_prepend_content($content) {
    $prepend_text = '<p>Dit is content dat is toegevoegd door mijn plugin.</p>';
    return $prepend_text . $content;
}
add_filter('the_content', 'myplugin_prepend_content');

Let op: in het bovenstaande voorbeeld werden in feite filters gebruikt om de inhoud te bewerken. Een echte voorbeeld van een pure actie-hook is…wp_footerDe code wordt weergegeven aan de onderkant van de pagina.

function myplugin_footer_notice() {
    echo '<p>Deze website wordt ondersteund door mijn plugin!</p>';
}
add_action('wp_footer', 'myplugin_footer_notice');

Het gebruikmechanisme van filters

Filters worden gebruikt om gegevens te bewerken voordat deze worden weergegeven of in de database worden opgeslagen. In tegenstelling tot actie-haken (action hooks) ontvangen filters een waarde en moeten een verwerkte waarde teruggeven.add_filter()Er bestaan functies om filters te toevoegen. Een veel voorkomend voorbeeld is het aanpassen van de lengte van de samenvatting van een artikel.excerpt_lengthFilter:

Aanbevolen leesmateriaal Als je de wereld van WordPress-pluginontwikkeling betreedt, betekent dat dat je de technieken beheerst om plugins te maken voor gebruikers overal ter wereld.。

function myplugin_custom_excerpt_length($length) {
    return 20; // 将摘要长度改为20个单词
}
add_filter('excerpt_length', 'myplugin_custom_excerpt_length');

Als je het hook-systeem onder de knie hebt, kunnen je plugins naadloos samenwerken met het kernprogramma van WordPress en andere plugins.

Een volledig functionerend plugin bouwen

Nu gaan we de bovenstaande kennis integreren om een praktische plugin te maken die interactie tussen front- en back-end mogelijk maakt: een plugin voor het bijhouden van het aantal bezoekers aan artikelen. De plugin zal laten zien hoe je een database-tabel kunt maken, de front- en back-end veilig kunt integreren, en hoe je deze functies kunt gebruiken.wp_localize_script()Om PHP-data over te dragen naar JavaScript:

Plugin-initialisatie en creatie van databestanden

De hoofdklasse van het namensp ruimte van het plugin is…Post_View_Counter。
Allereerst, wanneer het plugin wordt aktiveerd (met...)register_activation_hookEen data tabel maken om de leesvolume te bewaren.

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

class Post_View_Counter {
    public function __construct() {
        register_activation_hook(__FILE__, array($this, 'activate'));
        add_action('wp_enqueue_scripts', array($this, 'enqueue_scripts'));
        add_action('wp_ajax_nopriv_record_view', array($this, 'record_view'));
        add_action('wp_ajax_record_view', array($this, 'record_view'));
        add_filter('the_content', array($this, 'display_view_count'));
    }

public function activate() {
        global $wpdb;
        $table_name = $wpdb->prefix . 'post_views';
        $charset_collate = $wpdb->get_charset_collate();
        $sql = "CREATE TABLE $table_name (
            id mediumint(9) NOT NULL AUTO_INCREMENT,
            post_id bigint(20) NOT NULL,
            view_date datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
            PRIMARY KEY (id)
        ) $charset_collate;";
        require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
        dbDelta($sql);
    }

De namen van de database-tabels zijn al gebruikt.$wpdb->prefixDit is om de unieke identiteit van objecten in een multi-sitesomgeving te garanderen.

Interactie tussen front- en back-end en verwerking met AJAX

Om de bezoekersaantallen asynchroon bij het bezoeken van de pagina te kunnen updateen, moeten we JavaScript toevoegen aan de front-end. Eerst gebruiken we...wp_enqueue_script()JS-bestanden veilig laden en vervolgens verwerken…wp_localize_script()Deze vereiste parameters (zoals de ID van het huidige artikel en de AJAX-URL) moeten worden overgedragen aan het script.

    public function enqueue_scripts() {
        if(is_single()) {
            wp_enqueue_script('pvc-script', plugin_dir_url(__FILE__) . 'js/pvc-script.js', array('jquery'), '1.0', true);
            wp_localize_script('pvc-script', 'pvc_ajax', array(
                'ajax_url' => admin_url('admin-ajax.php'),
                'post_id' => get_the_ID(),
                'nonce' => wp_create_nonce('pvc_nonce')
            ));
        }
    }

Vervolgens schrijf je een AJAX-handlingsfunctie.record_view()Om front-end-verzoeken te ontvangen en gegevens veilig in de database op te slaan, is het noodzakelijk om toegangsrechten te controleren en willekeurige cijfers te verifiëren om CSRF-aanvallen te voorkomen.

Aanbevolen leesmateriaal Volledig in de kunst van WordPress-pluginontwikkeling: van nul beginnen met het bouwen van aangepaste functionaliteiten。

    public function record_view() {
        // 安全检查
        check_ajax_referer('pvc_nonce', 'nonce');
        $post_id = intval($_POST['post_id']);
        // 验证文章是否存在
        if(get_post_status($post_id)) {
            global $wpdb;
            $table_name = $wpdb->prefix . 'post_views';
            $wpdb->insert($table_name, array('post_id' => $post_id));
            wp_die('success');
        }
        wp_die('error', 400);
    }

Ten slotte hebben we dit gerealiseerd door…the_contentDe filter toont het aantal bezoekersaantallen aan het eind van het artikel.

    public function display_view_count($content) {
        if(is_single()) {
            global $wpdb, $post;
            $table_name = $wpdb->prefix . 'post_views';
            $view_count = $wpdb->get_var($wpdb->prepare(
                "SELECT COUNT(*) FROM $table_name WHERE post_id = %d", $post->ID
            ));
            $content .= '<p>Deze tekst is al gelezen. <strong>'intval($view_count)';'</strong> De volgende keer.</p>';
        }
        return $content;
    }
}
new Post_View_Counter();

Deze voorbeeldtoepassing omvat de belangrijkste stappen van het ontwikkelen van plugins, waaronder het beheer van het levenscyclusproces, database-operaties, veilige communicatie en het integreren van functies.

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

Geavanceerde technieken en best practices

Als plugins complexer worden, is het van belang om de beste praktijken te volgen. Dit gaat niet alleen om de kwaliteit van de code, maar ook om de veiligheid, prestaties en onderhoudsvriendelijkheid.

Internationalisatie van plugins realiseren

Om uw plugin beschikbaar te maken voor gebruikers wereldwijd, is internationaalization (internationalisering) vereist. WordPress gebruikt hiervoor het GNU gettext-framework. Allereerst moet u in alle tekststringen die worden getoond aan de gebruiker internationale versies van deze teksten gebruiken.__()、_e()Deze functies worden verpakt (wrapped).

$greeting = __('你好，世界！', 'my-plugin-textdomain');
_e('这是一个可翻译的句子。', 'my-plugin-textdomain');

Vervolgens wordt met tools als Poedit een vertaling gemaakt..potTemplatebestanden, en vraag de vertalers om de corresponderende vertalingen in de gewenste talen te maken..po和.moBestanden. Ten slotte worden ze gebruikt wanneer de plugin wordt geladen.load_plugin_textdomain()Er is een functie voor het laden van vertalingen. Dit kan de acceptatie van het plugin op markten waar Engels niet de dominante taal is aanzienlijk verbeteren.

Set up page and option APIs

Professionele plugins bieden meestal een configuratiepagina aan. WordPress beschikt over een krachtige…Settings APIMaak, verifieer en sla opties veilig op.
U moet gebruikmaken vanadd_options_page()或add_menu_page()Voeg eerst een beheerpagina toe. Daarna kun je deze gebruiken…register_setting()、add_settings_section()和add_settings_field()Vormulieren bouwen en deze associëren met de mogelijkheden in de database.
Verifieer en reinig altijd de invoer van de gebruiker.sanitize_text_field()、intval()En andere functies, die worden gebruikt bij het uitvoeren van de output.esc_html()或esc_attr()Een escape-methode wordt gebruikt om XSS-aanvallen te voorkomen.

Prestatieoptimalisatie en beveiligingsversterking

Op het gebied van prestaties moet het gebruik verstandig worden ingezet.wp_cache_get()和wp_cache_set()Wacht op de WordPress-objectcache-functie om de resultaten van queries te bewaren. Voor frequent uitgevoerde database-operaties moet je ervoor zorgen dat de SQL-opdrachten zijn geoptimaliseerd en worden gebruikt.$wpdb->prepare()Een voorbereidende query uitvoeren om SQL-injecties te voorkomen.
Op het gebied van veiligheid moet je nooit vertrouwen op de invoer van gebruikers. Naast de hierboven genoemde methoden van reiniging en ontsnapping van gevaarlijke tekens, moet je bij het verwerken van gevoelige acties (zoals AJAX-verzoeken of het indienen van formulieren) altijd extra maatregelen nemen.wp_verify_nonce()和check_ajax_referer()Verifieer de willekeurige nummer en gebruik het vervolgens.current_user_can()Controleer de gebruikersrechten. Dit vormt een sterke beveiligingslaag voor het plugin.

Samenvatting

Het ontwikkelen van WordPress-plug-ins vereist een combinatie van PHP-programmering, kennis van de WordPress-core-API en de beste praktijken in webontwikkeling. Het begint met het maken van een enkele bestand dat bevat standaardheader-commentaren. De ontwikkelaar moet een diepe begrip hebben van de kernmechanismen voor interactie, zoals action hooks en filters. Naarmate de functionaliteit van de plug-in uitgebreid wordt, wordt het belangrijk om de database goed te beheren, AJAX-verzoeken veilig te verwerken en een gebruiksvriendelijke instellingeninterface te bouwen. Daarnaast kunnen eenvoudige functies met behulp van internationale standaarden, prestatieoptimalisatie en veilige codering worden versterkt tot professionele, betrouwbare en populaire commerciële plug-ins. Het voortdurend bestuderen van de WordPress Codex en andere ontwikkelaarsbronnen is de enige manier om je ontwikkelingsniveau te verbeteren.

Veelgestelde vragen (FAQ)

Welke basiskennis is vereist om een WordPress-plugin te ontwikkelen met de naam ###?
Om een WordPress-plugin te ontwikkelen, zijn ten minste basiskennis van PHP en concepten van objectgericht programmeren vereist. Daarnaast is een begrip van HTML, CSS, JavaScript (met name jQuery) en MySQL nodig. Het belangrijkste is om vertrouwd te zijn met de kernarchitectuur van WordPress, met name het hook-systeem (Actions en Filters), globale variabelen en de klassen voor database-operaties.$wpdbEn de werkwijze van de themaplagen.

Hoe debug je een door jezelf ontwikkeld WordPress-plugin?

De meest effectieve manier is om de debug-modus van WordPress in te schakelen.wp-config.phpIn het bestand zijn de instellingen gedefinieerd.define(‘WP_DEBUG’, true);Dit zal PHP-fouten, waarschuwingen en berichtgeving rechtstreeks op de pagina weergeven. Voor het oplossen van complexere logische problemen kan gebruik worden gemaakt van…error_log()De functie schrijft de variabelgegevens in het foutenlog van de server, of gebruikt professionele PHP-deboggingstools zoals Xdebug. Voor AJAX en front-end-interacties zijn de ontwikkelaarshulpmiddelen van de browser (console en netwerkpaneel) onmisbaar.

Hoe kan mijn plugin worden gecombineerd met andere plugins of thema's?

Het belangrijkste principe voor goede compatibiliteit is om de officiële API van WordPress te gebruiken, in plaats van de kernbestanden of database-tabellen rechtstreeks te bewerken. Gebruik unieke prefixen voor functies, klassen en variabelen om namenconflicten te voorkomen. Gebruik globale variabelen met voorzichtigheid. Wanneer je hooks toevoegt of verwijderd, moet je ervoor zorgen dat deze op het juiste moment worden uitgevoerd.init(Nadat de plug-in is geïnstalleerd.) Als de functionaliteit van de plug-in kan worden overschreven, moet er worden overwogen om filters te bieden zodat andere ontwikkelaars deze kunnen aanpassen. Voordat de plug-in wordt gepubliceerd, moet deze zo veel mogelijk worden getest in verschillende omgevingen en met populaire thema's.

Hoe stuur je je eigen plugin op naar de officiële WordPress-plugincatalogus?

Eerst moet u een account aanmaken op WordPress.org en uw plugin indienen. De code van uw plugin moet voldoen aan de officiële coderingstandaarden en mag geen versleutelde of gemaskeerde code bevatten. De plugin moet een standaardvolgens hoofdcommentaar hebben en, indien mogelijk, een uitgebreide README-documentatie. Alle tekststringen moeten internationaal bruikbaar zijn. Na het indienen wordt de plugin door een team van reviewers bekeken; zij controleren vooral de veiligheid, de kwaliteit van de code en of de plugin voldoet aan de GPL-licentie. Als de plugin de review succesvol doorloopt, kan het worden gevonden en gedownload door gebruikers wereldwijd.