Guida all’approccio di base allo sviluppo di plugin per WordPress: crea il tuo primo plugin da zero

Perché scegliere di sviluppare plugin per WordPress?

WordPress, come il sistema di gestione dei contenuti più popolare al mondo, deve la sua notevole estensibilità soprattutto ai plugin. Sviluppando plugin è possibile aggiungere qualsiasi funzionalità personalizzata al sito web, senza dover modificare i file di base del software, il che garantisce la compatibilità anche durante gli aggiornamenti di WordPress. Che si tratti di soddisfare le esigenze specifiche di un progetto, di risolvere un problema comune, o di condividere le proprie soluzioni con la comunità e generare entrate, lo sviluppo di plugin rappresenta una competenza di grande valore.

Imparare a sviluppare plugin non solo ti permetterà di comprendere a fondo il funzionamento di WordPress, come il sistema dei “Hook” e i “Shortcode”, ma migliorerà anche le tue competenze di programmazione in PHP. Dalle semplici funzionalità aggiuntive fino all’integrazione di applicazioni più complesse, tutto è possibile.

Configura il tuo ambiente di sviluppo per plugin.

Prima di iniziare a scrivere il codice, è essenziale disporre di un ambiente di sviluppo locale adeguato. Questo ti permetterà di eseguire test e debug in modo sicuro, senza influenzare il sito web online.

Si consiglia di leggere Guida definitiva allo sviluppo di plugin per WordPress: costruire plugin professionali da zero。

Configurare l’ambiente del server locale

Si consiglia di utilizzare strumenti di sviluppo locali integrati, come Local by Flywheel, DevKinsta o XAMPP. Questi strumenti possono essere installati con un solo clic e includono Apache/Nginx, PHP e MySQL. Assicurati che la versione di PHP utilizzata sia compatibile con il server bersaglio; di solito si consiglia l’uso di PHP 7.4 o versioni più recenti per ottenere prestazioni e sicurezza migliori.

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

Installare e configurare WordPress

Installa un nuovo esempio di WordPress sul server locale. Si consiglia di utilizzare il tema predefinito (ad esempio, la serie Twenty Twenty) per lo sviluppo e i test, al fine di evitare problemi di compatibilità con i temi.wp-config.phpNel file, abilita questa funzione.WP_DEBUGCostanti: queste ti aiuteranno a individuare rapidamente gli errori durante lo sviluppo.

define( 'WP_DEBUG', true );

Preparare un editor di codice.

Scegli un potente editor di codice, come Visual Studio Code, PhpStorm o Sublime Text. Installa gli estensioni pertinenti, come quelle che forniscono autocompletamento intelligente per PHP o frammenti di codice per WordPress: queste possono migliorare notevolmente la tua efficienza nella programmazione.

Crea il tuo primo file di plugin.

Un plug-in WordPress è essenzialmente uno o più file situati all'interno della cartella dei plug-in del tuo sito WordPress./wp-content/plugins/I file PHP presenti nella directory… Ora, iniziamo dalla struttura più basilare.

Scrivere le note di testo nella parte iniziale del plugin.

Ogni plugin deve contenere una nota di testo nella parte iniziale, formattata secondo uno standard specifico, che permette a WordPress di riconoscere le informazioni relative al plugin stesso. Nel tuo directory dei plugin (ad esempio…)/wp-content/plugins/my-first-plugin/Nel documento, creare un elemento chiamato…my-first-plugin.phpIl file principale.

Si consiglia di leggere Dall’approccio iniziale alla padronanza: Guida completa allo 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
 */

Questo commento definisce i nomi, le descrizioni e altre informazioni che vengono visualizzate per il plugin nell’interfaccia di amministrazione di WordPress.Text DomainUtilizzato per la traduzione internazionale.

Costruire un quadro di sicurezza di base per i plugin

Per impedire l’accesso diretto ai file del tuo plugin, è possibile aggiungere un codice di protezione all’inizio del file stesso. Questa è una buona pratica per lo sviluppo di plugin per WordPress.

// 防止直接访问
if ( ! defined( 'ABSPATH' ) ) {
	exit; // 如果未定义ABSPATH（WordPress根目录的绝对路径），则退出
}

ABSPATHSi tratta di una costante definita da WordPress, che rappresenta la path assoluta in cui il plugin è installato. Controllando la presenza di questa costante, è possibile impedire efficacemente che utenti esterni accedano direttamente ai file del plugin tramite URL.

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

Implementare le funzionalità principali: aggiungere un menu di gestione e le impostazioni.

Un plugin completo dovrebbe solitamente offrire un’interfaccia di configurazione nell’area di amministrazione di WordPress. Aggiungeremo una semplice pagina del menu di gestione utilizzando l’API fornito da WordPress.

Utilizzare una funzione per aggiungere il menu di gestione di livello superiore.

Utilizzeremo…add_action()La funzione viene montata suadmin_menuAggiungi il codice seguente al file del tuo plugin principale, in modo da creare un nuovo elemento menu in background.

// 添加管理菜单
function mfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',           // 菜单标题
        'manage_options',    // 所需权限（管理员）
        'my-first-plugin',   // 菜单slug
        'mfp_settings_page', // 显示页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        80                    // 菜单位置
    );
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );

Questo, qui,add_menu_page()La funzione viene utilizzata per creare un menu principale. I parametri definiscono il titolo della pagina, il titolo del menu, i diritti di accesso, l’identificatore unico (slug), la funzione di callback utilizzata per visualizzare il contenuto della pagina, l’icona del menu, nonché la posizione del menu all’interno della barra laterale.

Si consiglia di leggere Guida completa allo sviluppo di plugin per WordPress: da zero alla pubblicazione effettiva.。

Creare una funzione di callback per la pagina delle impostazioni.

Ora, dobbiamo definire ciò che è stato menzionato sopra.mfp_settings_page()La funzione genererà il contenuto HTML della pagina di gestione.

// 设置页面回调函数
function mfp_settings_page() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
        <p>Benvenuti sulla pagina di configurazione del mio primo plugin! Qui è possibile aggiungere moduli (form) e opzioni in futuro.</p>
        <form action="/it/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段、非ce等（后续扩展）
            settings_fields( 'mfp_options_group' );
            do_settings_sections( 'my-first-plugin' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="it"/></form>
    </div>
    &lt;?php
}

Questa funzione verifica innanzitutto se l’utente attuale dispone di…manage_optionsI permessi (solitamente riservati agli amministratori), seguiti da un semplice framework per la pagina di configurazione.settings_fields()和do_settings_sections()Questo spazio è riservato per impostare le opzioni di registrazione dell’API per un utilizzo successivo con WordPress.

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

Aggiungere una semplice funzionalità front-end al plugin.

Oltre all’interfaccia di gestione backend, i plugin sono più comunemente utilizzati per fornire funzionalità al lato frontend del sito web. Creeremo un semplice codice breve (shortcode) che permetterà agli utenti di utilizzarlo all’interno degli articoli o delle pagine.

Utilizzare una funzione per registrare un codice breve.

I codici brevi permettono agli utenti di…[shortcode]Questi semplici tag permettono di inserire funzionalità dinamiche all’interno del contenuto.add_shortcode()La funzione viene registrata.

// 注册一个短代码
function mfp_hello_world_shortcode( $atts ) {
    // 短码属性，设置默认值
    $atts = shortcode_atts(
        array(
            'name' => '访客',
        ),
        $atts,
        'mfp_hello'
    );

// 安全地输出内容
    return '<p>Ciao, '. esc_html($atts['name'])'. ‘! Questo è il saluto generato dal mio plugin.</p>'php
add_shortcode('mfp_hello', 'mfp_hello_world_shortcode');

add_shortcode()La funzione accetta due parametri: il nome del tag di codice breve (quello utilizzato dall’utente) e la funzione di elaborazione corrispondente.shortcode_atts()La funzione viene utilizzata per combinare gli attributi inseriti dall’utente con i valori predefiniti, al fine di garantire la robustezza del codice.

Testare codice breve sul front end

Dopo aver salvato il file del plugin, vai alla pagina “Plugin” nell’interfaccia di amministrazione di WordPress e attiva il plugin “Il mio primo plugin”. Successivamente, crea o modifica un articolo e inserisci il codice del plugin direttamente nell’editor di contenuto.[mfp_hello name="小明"]Dopo la pubblicazione dell’articolo, la pagina front-end mostrerà: “Ciao, Xiao Ming! Questo è il saluto generato dal mio plugin.” Se l’attributo `name` non viene fornito, come…[mfp_hello]In tal caso, verrà visualizzato il messaggio predefinito: “Ciao, visitatore!”.

Riassumendo

Seguendo questa guida, hai completato l’intero processo per creare da zero un plugin WordPress di base. Hai imparato la struttura fondamentale di un plugin, l’importanza delle annotazioni presenti nella parte iniziale del codice (header), come aggiungere un menu di gestione nell’interfaccia di amministrazione e come creare dei codici brevi ma utili per il lato frontend. Questi sono i fondamenti essenziali per lo sviluppo di plugin per WordPress.

Il vero viaggio nello sviluppo di plugin è appena iniziato. In seguito, potrai esplorare il potente API di configurazione di WordPress per creare opzioni salvabili, e sfruttare gli “action hooks” (ganci di azione).add_action()“Hook for filters”add_filter()Modifica i comportamenti fondamentali del plugin, impara come aggiungere supporto all’internazionalizzazione e come gestire i dati degli utenti in modo sicuro. Ricorda che seguire gli standard di codifica di WordPress e prestare attenzione alla sicurezza sono fondamentali per lo sviluppo di plugin di alta qualità.

FAQ - Domande frequenti

Quali sono le conoscenze preliminari necessarie per sviluppare plugin per WordPress?

È necessario disporre di conoscenze di base di programmazione in PHP, comprendere i linguaggi HTML e CSS, nonché avere dimestichezza con le operazioni di base di WordPress (come pubblicare articoli e installare temi o plugin). Non è obbligatorio essere esperti di programmazione orientata agli oggetti (OOP), ma questa conoscenza è molto utile per lo sviluppo di plugin più complessi.

Il nome del file principale del plugin deve essere lo stesso del nome della cartella in cui è contenuto?

Non è obbligatorio, ma si tratta di una buona pratica fortemente consigliata che rende la struttura più chiara. Il file PHP del plugin principale può avere qualsiasi nome, tuttavia le note iniziali (header comments) devono essere corrette e il file stesso deve trovarsi all’interno della cartella appartenente al plugin stesso. Il nome della cartella di solito corrisponde al “slug” del plugin.

Come devo debuggare il codice del mio plugin?

Oltre ad attivare…WP_DEBUGPuoi anche utilizzare…error_log()La funzione scrive le informazioni di debug nel log di errore del server, oppure le utilizza in qualche altro modo.var_dump()和wp_die()Esegui un controllo dell’output (solo per l’ambiente di sviluppo). L’utilizzo di plugin di debug come Query Monitor rappresenta anche una scelta efficace.

Come posso pubblicare il plugin che ho sviluppato nel catalogo ufficiale di plugin di WordPress?

Innanzitutto, è necessario assicurarsi che il codice del plugin sia in linea con i requisiti di pubblicazione di WordPress, inclusi la licenza compatibile con GPL, la qualità del codice, la sicurezza e l’internazionalizzazione. Successivamente, è possibile richiedere un repository SVN su WordPress.org, caricare il proprio codice e seguire il processo di revisione. L’ufficio di WordPress fornisce un manuale dettagliato per la submission dei plugin.