Guida completa allo sviluppo di plugin per WordPress: crea il tuo primo plugin funzionale da zero

Ambiente di sviluppo per plugin WordPress e preparazioni di base

Prima di iniziare a scrivere il codice, è essenziale disporre di un ambiente di sviluppo stabile ed efficiente. Questo non solo migliora la tua produttività, ma ti aiuta anche a seguire le migliori pratiche, garantendo la qualità e la compatibilità degli plugin che crei.

Innanzitutto, ti servirà un ambiente di sviluppo WordPress locale. Puoi utilizzare strumenti come XAMPP, MAMP, Local by Flywheel o Docker per configurarlo rapidamente. Assicurati che il tuo ambiente sia dotato di una versione recente di PHP (consigliata 7.4 o superiore) e di MySQL/MariaDB. Un ambiente di sviluppo locale ti consente di eseguire test e debug in modo indipendente, senza influenzare il sito web online.

In secondo luogo, ti servirà un editor di codice o un ambiente di sviluppo integrato (IDE). Visual Studio Code, PhpStorm o Sublime Text sono ottime scelte: offrono funzionalità come l’highlighting del codice, suggerimenti automatici e strumenti per il debug. Ti consiglio inoltre di installare strumenti per la qualità del codice, come PHP_CodeSniffer, e di configurare gli standard di codifica di WordPress, in modo da mantenere lo stile del tuo codice in linea con quello del core di WordPress.

Si consiglia di leggere Guida completa allo sviluppo di plugin per WordPress: dall'introduzione alla creazione di estensioni di livello professionale.。

Infine, comprendere la struttura di base di un plugin per WordPress è il primo passo. Il plugin più semplice richiede soltanto un file PHP principale, nel quale vanno incluse delle annotazioni contenenti le informazioni specifiche relative al plugin. Questo file rappresenta l’“ingresso” del plugin stesso: WordPress lo legge per riconoscerlo e gestirlo correttamente.

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 file di plugin.

Iniziamo creando il plugin più semplice possibile, chiamato “Hello World”. Questo processo ti aiuterà a comprendere la struttura di base di un plugin e il modo in cui WordPress riconosce e gestisce i plugin installati.

Prima di tutto, all’interno della directory di installazione di WordPress…wp-content/pluginsAll’interno della cartella, crea una nuova cartella. Il nome della nuova cartella deve essere unico, descrittivo e composto esclusivamente da lettere minuscole e trattini, ad esempio:my-first-plugin。

All’interno di quella cartella, creare un file PHP principale; il nome del file di solito coincide con il nome della cartella stessa, ad esempio:my-first-plugin.phpAll’inizio di questo file, è necessario aggiungere un commento che contenga i dati di identificazione del plugin, in conformità con gli standard di WordPress. Questo commento rappresenta, in sostanza, il “cartellino di identità” del plugin e contiene informazioni come il nome, la descrizione, la versione, l’autore, ecc. Senza di esso, WordPress non riuscirà a individuare il plugin nell’elenco dei plugin disponibili nell’interfaccia di amministrazione.

Ecco un esempio di file di plugin il più semplice possibile:

Si consiglia di leggere Partendo da zero: perché scegliere lo sviluppo di plugin per WordPress?。

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

// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
    exit; // 如果ABSPATH未定义，则退出
}

Dopo aver salvato il file, fai login al pannello di amministrazione di WordPress e vai alla pagina “Plugin”. Dovresti vedere “Il mio primo plugin” nell’elenco dei plugin disponibili. A questo punto puoi attivarlo, ma non farà ancora nulla. Il codice presente nel file…if ( ! defined( ‘ABSPATH’ ) )Il controllo rappresenta una pratica di sicurezza fondamentale: serve a impedire agli utenti di accedere direttamente ai file del tuo plugin tramite l’URL, garantendo che il codice venga eseguito esclusivamente nell’ambiente di WordPress.

Aggiungere funzionalità essenziali al plugin

Un plugin attivato deve eseguire alcune operazioni. In WordPress, ciò avviene principalmente attraverso gli “Action Hooks” (Ganci di Azione) e gli “Filter Hooks” (Ganci di Filtraggio). Questi rappresentano i pilastri fondamentali dell’architettura dei plugin di WordPress, permettendoti di inserire il tuo codice in momenti specifici o di modificare i dati.

Utilizzare gli “action hooks” per aggiungere notifiche al backend di gestione.

Gli “action hooks” permettono di eseguire le proprie funzioni in momenti specifici durante l’esecuzione di WordPress (ad esempio, al termine dell’inizializzazione, durante il caricamento della parte superiore della pagina, o al salvataggio di un articolo). Aggiungiamo ora una funzionalità semplice: visualizzare un messaggio di benvenuto in cima alla barra di navigazione del pannello di amministrazione di WordPress.

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

Utilizzeremo…admin_noticesQuesto “action hook”. Per prima cosa, è necessario creare una funzione per generare il contenuto HTML, e poi utilizzarla…add_action()La funzione “monta” questa funzione su un hook (un punto di interazione predefinito nel sistema).

Nel file principale del tuo plugin, aggiungi il seguente codice:

/**
 * 在管理后台显示欢迎通知
 */
function myfp_display_admin_notice() {
    ?>
    <div class="notice notice-success is-dismissible">
        <p>Benvenuto nell’utilizzo del “Mio primo plugin”! Il plugin è stato attivato con successo.</p>
    </div>
    &lt;?php
}
// 将函数挂载到 admin_notices 动作钩子
add_action( &#039;admin_notices&#039;, &#039;myfp_display_admin_notice&#039; );

Salva e aggiorna il backend di WordPress; dovresti vedere una finestra di dialogo verde con un messaggio di successo in cima alla pagina. Attenzione: il nome della funzione…myfp_display_admin_noticeÈ stato utilizzato un prefisso.myfp_(Estratto dall’abbreviazione del nome del plugin) Questo viene fatto per evitare conflitti con i nomi delle funzioni di altri plugin o temi; si tratta di una convenzione di denominazione che deve essere rispettata.

Si consiglia di leggere Guida completa allo sviluppo di plugin per WordPress: costruire funzionalità aggiuntive di alta qualità per WordPress partendo da zero。

Modificare il contenuto di un articolo utilizzando gli hook dei filtri

Gli “hook” dei filtri ti permettono di modificare i dati trasmessi in WordPress. Ad esempio, puoi modificare il contenuto, il titolo o la descrizione di un articolo prima che vengano visualizzati. Creiamo ora una funzionalità che aggiunga automaticamente una dichiarazione di copyright alla fine di ogni articolo.

Utilizzeremo…the_contentQuesto “filter hook”: devi creare un componente in grado di ricevere il contenuto originale…$contentModifica la funzione in questione e poi restituisce il contenuto modificato.

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

Aggiungi il seguente codice al file del tuo plugin:

/**
 * 在文章内容末尾添加版权声明
 * @param string $content 原始的文章内容
 * @return string 修改后的文章内容
 */
function myfp_add_copyright_to_content( $content ) {
    // 仅对主循环中的单篇文章页面生效
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $copyright_text = '<p><em>Il copyright di questo articolo appartiene a questo sito; per ripubblicarlo, è necessario indicare la fonte.</em></p>';
        $content .= $copyright_text;
    }
    return $content;
}
// 将函数挂载到 the_content 过滤器钩子，优先级为10
add_filter( 'the_content', 'myfp_add_copyright_to_content', 10 );

Ora, ogni volta che visualizzi un articolo sul sito web, alla fine del contenuto apparirà la dichiarazione di copyright che hai aggiunto. Questo avviene grazie ai criteri di controllo presenti nella funzione responsabile dell’visualizzazione dei contenuti.is_single() && in_the_loop() && is_main_query()È molto importante: questo aspetto garantisce che il testo venga visualizzato esclusivamente nel ciclo principale della pagina dell’articolo, e non nella lista della pagina iniziale, negli strumenti aggiuntivi o in altri luoghi. È un dettaglio da tenere a mente quando si sviluppa un plugin di alta qualità.

Internazionalizzazione dei plugin e migliori pratiche

Per permettere ai tuoi plugin di essere utilizzati da utenti in tutto il mondo, l’internazionalizzazione (i18n) è un passo essenziale. WordPress fornisce funzionalità complete per supportare la traduzione dei testi presenti nei plugin in altre lingue.

Preparare il testo del plugin per supportare la traduzione.

Devi utilizzare una funzione specifica per incapsulare tutte le stringhe che vengono visualizzate all’utente all’interno del plugin. La funzione più comune utilizzata a questo scopo è…()Utilizzato per ottenere la traduzione._e()Utilizzato per visualizzare direttamente i risultati della traduzione, nonché…esc_html()Utilizzato in contesti in cui è necessario escapare i caratteri HTML.

Innanzitutto, modifichiamo il testo presente nelle funzioni di notifica e di copyright che abbiamo creato in precedenza, utilizzando una funzione di traduzione.

function myfp_display_admin_notice() {
    ?>
    <div class="notice notice-success is-dismissible">
        <p><?php _e( '欢迎使用“我的第一个插件”！插件已成功激活。', 'my-first-plugin' ); ?></p>
    </div>
    &lt;?php
}

function myfp_add_copyright_to_content( $content ) {
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        $copyright_text = &#039;<p><em>' . esc_html__( '本文版权归本网站所有，转载请注明出处。', 'my-first-plugin' ) . '</em></p>';
        $content .= $copyright_text;
    }
    return $content;
}

Attenzione: ogni funzione di traduzione include un secondo parametro.‘my-first-plugin’Questo è ciò che hai definito nella parte iniziale del plugin.Text DomainÈ un identificatore unico che permette a WordPress di capire a quale plugin appartengono queste stringhe.

Poi, è necessario specificare ciò nell’annotazione presente nella parte iniziale del plugin.Domain Path(Ossia,/languagesPosiziona i file di traduzione (.po e .mo) all’interno della cartella appropriata. Puoi utilizzare strumenti come Poedit per creare e gestire questi file di traduzione.

Seguire le norme di sicurezza e le linee guida per la codifica.

La sicurezza è di fondamentale importanza nello sviluppo di plugin. Non fidarsi mai dei dati forniti dagli utenti. Quando si lavora con qualsiasi informazione proveniente dagli utenti…$_GET、$_POST或$_REQUESTPrima di utilizzare i dati, è necessario verificarli, pulirli e escaparli.

WordPress offre un’ampia gamma di funzioni per aiutarti nel tuo lavoro.
* 验证（Validation）：检查数据是否符合预期格式（如is_email()）。
* 清理（Sanitization）：清除数据中的非法字符（如sanitize_text_field()， sanitize_email()）。
* 转义（Escaping）：在将数据输出到HTML、JavaScript或URL之前，确保其安全（如esc_html()， esc_js()， esc_url()）。

Inoltre, quando si opera direttamente sul database, è essenziale utilizzare le classi dedicate al database di WordPress.$wpdbI metodi forniti, come…$wpdb->prepare()Per prevenire gli attacchi di iniezione SQL.

Riassumendo

Seguendo questa guida, hai completato l’intero processo di creazione di un plugin WordPress funzionale partendo da zero. Hai imparato come configurare l’ambiente di sviluppo, creare i file di base del plugin, utilizzare gli “action” e i “filter hook” per aggiungere nuove funzionalità a WordPress, nonché come migliorare la professionalità e l’usabilità del plugin attraverso pratiche di internazionalizzazione e sicurezza. Il cuore dello sviluppo di plugin consiste nella comprensione e nell’uso efficace del sistema di hook di WordPress, che offre una flessibilità e un’espandibilità senza eguali. Ricorda: inizia con funzionalità semplici, continua ad iterare, e metti sempre al primo posto la sicurezza e la qualità del codice; in questo modo riuscirai a creare plugin WordPress potenti e affidabili.

FAQ - Domande frequenti

Un plugin deve essere posizionato all’interno di una cartella?

Non necessariamente. Un plugin molto semplice, composto da un unico file, può essere utilizzato per eseguire direttamente l’operazione richiesta.plugin-name.phpMetterewp-content/plugins/All’interno del directory… Tuttavia, per qualsiasi plugin che contenga più file (come CSS, JS, immagini o file linguistici), si consiglia caldamente di utilizzare una cartella separata per organizzare tutti i file correlati. Questo renderà la struttura più chiara e faciliterà la gestione.

Come posso creare una pagina di configurazione per il mio plugin?

Puoi utilizzare l’API di configurazione fornita da WordPress per creare pagine di configurazione professionali e sicure. I passaggi principali includono:add_menu_page()或add_submenu_page()La funzione registra una pagina del menu e successivamente la utilizza.register_setting()、add_settings_section()和add_settings_field()Utilizzare funzioni come `defineField` e `defineChapter` per configurare i campi e i contenuti dei capitoli. Infine, scrivere una funzione di callback per generare il codice HTML del form relativo alla pagina di configurazione.

Nello sviluppo di plugin, perché i prefissi sono così importanti?

WordPress è un enorme ecosistema composto da plugin e temi. Tutto il codice viene eseguito nello stesso spazio di nomi globale. Se hai definito una variabile chiamata…get_data()Se una funzione comune esiste già nel codice principale del sito web e un altro plugin definisce una funzione con lo stesso nome, ciò può causare errori fatali che portano al crash del sito. L’utilizzo di un prefisso unico (ad esempio, l’abbreviazione del nome del plugin) può evitare tali conflitti in modo significativo, garantendo così la compatibilità tra i diversi componenti del sito.

Come dovrei debuggare il codice del mio plugin?

Nello sviluppo di WordPress, lo strumento preferito per il debug è l’attivazione di…WP_DEBUGPuoi farlo sul sito web.wp-config.phpNel file, è possibile impostare specifiche configurazioni tramite opportuni parametri.define( ‘WP_DEBUG’, true );Per abilitarlo, segui le istruzioni fornite. In questo modo, tutti gli errori, gli avvisi e le notifiche di PHP verranno visualizzati sullo schermo. Per un debug più approfondito, puoi utilizzare strumenti specifici.error_log()La funzione scrive le informazioni nel log di errore del server, oppure si può utilizzare uno strumento di debug PHP professionale come Xdebug in combinazione con il proprio ambiente di sviluppo (IDE) per eseguire il debug passo dopo passo.