Partendo da zero: una guida completa e un tutorial pratico per lo sviluppo di plugin WordPress.

Preparazioni per lo sviluppo di plugin per WordPress

Prima di iniziare a scrivere la prima riga di codice, una preparazione adeguata è la base per il successo di un progetto. Questo include non solo la configurazione dell’ambiente tecnico, ma anche un’analisi chiara dei requisiti e una pianificazione dettagliata del progetto stesso.

Innanzitutto, ti servirà un ambiente di sviluppo locale. Ti consigliamo di utilizzare strumenti come Local by Flywheel, MAMP, XAMPP o Docker per creare rapidamente un ambiente di esecuzione per WordPress che includa PHP, MySQL e Apache/Nginx. Assicurati che la versione di PHP sia in linea con le ultime richieste ufficiali di WordPress; di solito è necessaria PHP 7.4 o una versione più recente.

In secondo luogo, è importante chiarire quale problema il tuo plugin intende risolvere: si tratta di aggiungere una funzionalità specifica al sito web o di ottimizzare un processo esistente? Una descrizione dettagliata del plugin e un elenco delle funzionalità disponibili costituiscono la base per lo sviluppo futuro. Si consiglia di utilizzare strumenti come Trello o semplici documenti per pianificare le iterazioni di sviluppo e le funzionalità da implementare.

Si consiglia di leggere Guida all’approccio di base allo sviluppo di plugin per WordPress: dal nulla alla pubblicazione sul sito web。

Infine, ti servirà un editor di codice o un ambiente di sviluppo integrato. Visual Studio Code, PhpStorm e Sublime Text sono ottime scelte: forniscono un ottimo supporto allo sviluppo in PHP e per WordPress, con funzionalità come l’illuminazione del codice, suggerimenti automatici e strumenti di debug. Una volta che avrai tutto pronto, potrai creare il file principale, che costituirà la base del tuo plugin.

UltaHost – Hosting per siti WordPress

Garanzia di rimborso entro 30 giorni, larghezza di banda illimitata e accesso ai database, protezione gratuita contro gli attacchi DDoS; sconto del 50% per l’acquisto di un piano valido per 3 anni (da 3 a 4 TB di spazio di archiviazione).

pagina di accesso

Crea il tuo primo plugin per WordPress.

Tutto ha inizio con difficoltà, ma creare un file di plugin WordPress di base è estremamente semplice. In questa sezione ti guideremo nella creazione della struttura di base del plugin, nell’aggiunta della dichiarazione di sicurezza necessaria e nel processo di attivazione dello stesso.

Crea una nuova cartella il cui nome sia unico e possa descrivere la funzionalità del plugin, ad esempio:my-first-pluginIn questa cartella, creare il file principale del plugin, che di solito si chiama…plugin-name.phpDobbiamo dare un nome a questo file. Questo file rappresenta il punto di ingresso per il plugin, e WordPress riconosce il plugin leggendo informazioni specifiche presenti nelle note in cima al file.

All’inizio di questo file principale, è necessario aggiungere un commento con l’intestazione del plugin che sia conforme agli standard di WordPress. Ecco un esempio di base:

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

Il “Nome del plugin” è obbligatorio in questa nota; le altre informazioni sono opzionali, ma si consiglia vivamente di inserirle tutte. Una volta completato il processo, carica la cartella del plugin nella directory di installazione di WordPress./wp-content/plugins/È nel percorso corretto. Accedi alla pagina “Plugin” nell’interfaccia di amministrazione di WordPress e vedrai i tuoi plugin; potrai attivarli. Al momento, non hanno alcuna funzionalità, ma hai comunque creato con successo un plugin riconosciuto da WordPress.

Si consiglia di leggere Lo sviluppo di plugin per WordPress parte da zero e rappresenta un processo fondamentale per rendere questo sistema di gestione dei contenuti il più popolare al mondo.。

Implementare una funzionalità semplice

Aggiungiamo la prima funzionalità concreta a questo plugin “vuoto”: l’aggiunta automatica di una dichiarazione di copyright in fondo al contenuto degli articoli. Questo esempio ti aiuterà a comprendere meglio il meccanismo dei “hook” (i punti di interazione predefiniti) di WordPress.

Prima di tutto, dobbiamo creare una funzione per implementare la logica di aggiunta del testo relativo ai diritti d’autore. Chiameremo questa funzione…myplugin_add_footer_text。

function myplugin_add_footer_text($content) {
    // 确保只在网站前端的主文章循环中执行
    if (is_single() && in_the_loop() && is_main_query()) {
        $footer_text = '<p><em>Questo articolo vi viene presentato dal mio primo plugin.</em></p>';
        $content .= $footer_text;
    }
    return $content;
}

Successivamente, dobbiamo “montare” questa funzione in un punto specifico di esecuzione di WordPress; questo processo viene chiamato “aggiunta di un hook”. Qui utilizziamo…the_content“Filter Hook”: Aggiungi il seguente codice nel file principale del tuo plugin.

hosting.com Hosting condiviso

Prestazioni elevate con CPU AMD EPYC, storage SSD NVMe e LiteSpeed, supporto interno di esperti 24 ore su 24, 7 giorni su 7, misure di sicurezza avanzate, tra cui SSL, brute force, malware e protezione DDoS, risparmi fino a 73%

pagina di accesso

add_filter('the_content', 'myplugin_add_footer_text');

Dopo aver salvato il file, aggiorna la pagina di un articolo sul tuo sito web e noterai che alla fine del contenuto è apparso il testo relativo ai diritti d’autore che hai definito. Con questo semplice esempio, hai già compreso il modello di base dello sviluppo di plugin: creare funzioni e utilizzarle.add_action或add_filterIl “hook” consente di collegare una funzione al ciclo di vita di WordPress.

Approfondimento: Ganci (Hooks) e API di WordPress

Il meccanismo dei “hook” rappresenta l’essenza dello sviluppo di plugin per WordPress: consente al tuo codice di eseguirsi in momenti o in posizioni specifiche del funzionamento del sito. Comprendere e utilizzare abilmente questi meccanismi è fondamentale per creare funzionalità complesse.

Gli hook di WordPress si dividono principalmente in due tipi: Action e Filter. Gli hook di tipo Action vengono attivati in occasione di eventi specifici del core di WordPress, come la pubblicazione di un articolo o il caricamento dell’interfaccia di amministrazione; in questi casi, la tua funzione può eseguire determinate operazioni. Gli hook di tipo Filter, invece, servono per modificare i dati: permettono alla tua funzione di alterare i valori dei dati prima che vengano utilizzati o salvati, ad esempio modificando il contenuto o il titolo di un articolo.

Si consiglia di leggere Sviluppo di plugin per WordPress: dall’approccio base alla padronanza completa: impara passo dopo passo come creare funzionalità personalizzate。

Crea una funzione di hook per un’azione:

function myplugin_log_post_published($ID, $post) {
    // 当文章发布时，在错误日志中记录一条信息（仅用于演示）
    error_log("文章 {$post->post_title} (ID: {$ID}) 已发布。");
}
// 将函数挂载到 `publish_post` 这个动作钩子上
add_action('publish_post', 'myplugin_log_post_published', 10, 2);

Crea una funzione di hook per il filtro:

Hosting condiviso InterServer

Hosting condiviso $2,50 USD al mese, primo mese $0,1 USD codice promozionale tryinterserver, 461 script di applicazioni cloud, installazione con un clic.

pagina di accesso

function myplugin_excerpt_length($length) {
    // 将默认的摘要长度从55个词修改为20个词
    return 20;
}
// 将函数挂载到 `excerpt_length` 这个过滤器钩子上
add_filter('excerpt_length', 'myplugin_excerpt_length');

Quando si utilizza…add_action或add_filterI terzo e quarto parametro rappresentano rispettivamente la priorità e il numero di parametri; impostarli correttamente permette di controllare con precisione l’ordine di esecuzione di più funzioni di callback.

Utilizzare le funzionalità di WordPress per configurare un’API

Per permettere agli utenti dei plugin di personalizzare il comportamento del plugin stesso, è necessario creare una pagina di configurazione. WordPress fornisce un’API di configurazione per semplificare questo processo. Di solito, questo richiede l’utilizzo di tre funzioni principali:register_settingUtilizzato per registrare un insieme di impostazioni.add_settings_sectionPer aggiungere una sezione di configurazione sulla pagina…add_settings_fieldViene utilizzato per aggiungere campi specifici in quell’area.

Creare una funzione per una pagina di opzioni:

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

Poi devi implementarlo.myplugin_render_settings_pageLa funzione viene utilizzata per visualizzare un modulo (form) e per eseguire ulteriori operazioni relative ad esso.settings_fields和do_settings_sectionsUna funzione per visualizzare i campi dei moduli elaborati automaticamente dall’API di WordPress.get_optionÈ possibile ottenere facilmente i valori delle opzioni salvate dall’utente in qualsiasi parte del codice del plugin.

Pratiche avanzate per lo sviluppo di plugin e la loro pubblicazione

Man mano che le funzionalità del tuo plugin diventano più complete e la quantità di codice aumenta, un’organizzazione efficace del codice, misure di sicurezza adeguate e il supporto per l’internazionalizzazione diventano elementi fondamentali.

Per mantenere la chiarezza del codice, si consiglia di separare il codice che svolge funzioni diverse in file distinti. Ad esempio, i meccanismi di registrazione dei “hook” (funzioni di interazione con il sistema) e le funzioni principali del programma dovrebbero essere inseriti nel file principale, mentre il codice relativo alle pagine di configurazione dovrebbe essere collocato in file dedicati.admin/Sottodirectory: inserire il codice delle funzionalità front-end lì.public/I sottodirectory vengono utilizzati per organizzare i contenuti in modo strutturato, e i componenti vengono caricati in base a determinate condizioni. L’adozione della programmazione orientata agli oggetti (OOP – Object-Oriented Programming) rappresenta inoltre una pratica eccellente per la gestione di plugin complessi, poiché permette di incapsulare al meglio i dati e le funzionalità.

La sicurezza rappresenta l’elemento fondamentale nello sviluppo di plugin. Tutti i dati raccolti dagli utenti (ad esempio…)$_GET， $_POST， $_COOKIETutti questi elementi devono essere verificati e disinfettati. WordPress mette a disposizione un gran numero di funzioni per questo scopo.sanitize_text_field， wp_kses_post， intvalQuando si inviano dati al browser o al database, è necessario effettuare l’escape delle informazioni in modo appropriato.esc_html， esc_attr或wp_ksesPer le operazioni sul database, è necessario utilizzare le funzionalità fornite da WordPress.$wpdbClassi e i loro…prepareMetodi per prevenire gli attacchi di iniezione SQL.

Realizzare l'internazionalizzazione del plug-in.

Per permettere al tuo plugin di essere utilizzato da utenti in tutto il mondo, l’internazionalizzazione è un passo essenziale. Questo processo prevede principalmente due fasi:__()或_e()Le funzioni `etc.` incapsulano tutte le stringhe da tradurre, nonché il caricamento corretto dei campi di testo.

Nella parte iniziale del plugin abbiamo già definito il “Text Domain”; durante l’inizializzazione del plugin (solitamente nel file principale), è necessario caricare i file relativi alle lingue.

function myplugin_load_textdomain() {
    load_plugin_textdomain('my-first-plugin', false, dirname(plugin_basename(__FILE__)) . '/languages/');
}
add_action('init', 'myplugin_load_textdomain');

In seguito, puoi utilizzare qualcosa di simile a…__('Hello World', 'my-first-plugin')Per marcare le stringhe, si utilizza un determinato formato di scrittura. I traduttori possono impiegare strumenti come Poedit per lavorare sulle traduzioni generate..potCreazione di file di template.po和.moTraduci il file e posizionalo all’interno del plugin./languages/All’interno della directory.

Infine, una volta che le funzionalità del plugin saranno stabilizzate, potrai decidere di inviarlo al catalogo ufficiale di plugin di WordPress, in modo che possa essere utilizzato da un maggior numero di persone. Per farlo, dovrai compilare il codice del plugin e redigere una descrizione dettagliata delle sue caratteristiche e del suo funzionamento.readme.txtI file devono essere creati seguendo le linee guida di sviluppo stabilite dalla comunità.

Riassumendo

Lo sviluppo di plugin per WordPress è un percorso pratico che consente di trasformare idee in funzionalità efficaci. Partendo dall’installazione dell’ambiente di sviluppo e dalla creazione dei file di base del plugin, si procede gradualmente verso la comprensione dei meccanismi di “hook” e delle API di configurazione, per arrivare infine a temi più avanzati come l’organizzazione del codice, la sicurezza e l’internazionalizzazione. Il cuore di tutto questo processo è la comprensione dell’architettura basata su eventi di WordPress, che permette di estendere le funzionalità di base in modo semplice e fluido attraverso gli “action hook” e i “filter hook”. Ricorda: iniziare con una funzionalità semplice, iterare costantemente, e dare sempre la priorità alla sicurezza del codice e all’esperienza utente sono le chiavi per diventare uno sviluppatore di plugin di successo.

FAQ - Domande frequenti

Per sviluppare plugin per WordPress, è necessario conoscere quali linguaggi di programmazione sono utilizzati. Quali sono questi linguaggi?
Per sviluppare plugin per WordPress è necessario padroneggiare principalmente il linguaggio PHP, poiché il core di WordPress è scritto in PHP. Le funzionalità front-end, invece, richiedono solitamente la conoscenza di HTML, CSS e JavaScript. Per interagire con i database, è utile disporre di basi di conoscenza SQL.$wpdbLa classe incapsula la maggior parte delle operazioni.

Come posso debuggare il mio plugin WordPress?

Durante la fase di sviluppo, si consiglia di attivare il modalità di debug di WordPress.wp-config.phpNel documento, verrà indicato che...WP_DEBUGLa costante è impostata sutruePuoi anche utilizzare…error_log()La funzione registra le informazioni nel log di errori del server. Per un debug più approfondito, è possibile utilizzare strumenti professionali come Xdebug o Query Monitor per tracciare l’esecuzione del codice e le query sul database.

Come può il mio plugin interagire con servizi o API di terze parti?

I plugin possono essere sviluppati utilizzando l’API HTTP di WordPress.wp_remote_get()， wp_remote_post()Permette una comunicazione sicura e stabile con servizi esterni. L’HTTP API di WordPress include funzionalità come il controllo dei tempi di attesa e la verifica SSL, rendendolo più affidabile rispetto all’uso diretto delle funzioni PHP come `curl` o `file_get_contents`. Durante l’elaborazione delle risposte, è essenziale verificare eventuali errori e gestirli in modo appropriato.

Come posso aggiungere tabelle di database personalizzate al mio plugin?

Sebbene la tabella delle opzioni di WordPress sia sufficiente per la maggior parte dei casi di memorizzazione delle configurazioni, i dati strutturati potrebbero essere più adatti a essere memorizzati in tabelle personalizzate. È possibile farlo utilizzando gli hook di attivazione dei plugin.register_activation_hookNella fase di registrazione delle funzioni, viene eseguita l’istruzione SQL per creare la tabella. È obbligatorio utilizzare…$wpdb->prefixAssicurarsi che il prefisso della tabella sia corretto e utilizzarlo…dbDeltaEsistono funzioni per creare o aggiornare in modo sicuro la struttura di un database. Qualsiasi query effettuata su tabelle personalizzate dovrebbe avvenire tramite tali funzioni.$wpdbL'operazione viene eseguita sull'oggetto.

Come posso assicurarmi che il mio plugin sia compatibile con altri plugin o temi?

Le migliori pratiche per mantenere la compatibilità sono: utilizzare l’API di base di WordPress e gli hook standard; aggiungere prefissi unici ai nomi delle funzioni, delle classi e delle opzioni (ad esempio, utilizzando abbreviazioni relative ai plugin); incapsulare le funzionalità all’interno di classi o namespace per evitare conflitti di nomi; evitare di modificare direttamente le variabili globali; e verificare, prima di eseguire operazioni che potrebbero influenzare lo stato globale (come l’ registrazione di shortcut o la creazione di nuovi tipi di articoli), se tali operazioni siano già state eseguite. Prima della pubblicazione, effettuare il maggior numero possibile di test in diversi ambienti.