Intraprendere il percorso dello sviluppo di plugin per WordPress significa che avete acquisito le competenze necessarie per creare strumenti utili a utenti in tutto il mondo.

Intraprendere il percorso dello sviluppo di plugin per WordPress significa acquisire la capacità di aggiungere nuove funzionalità, semplificare i processi e creare valore unico per milioni di siti web in tutto il mondo. Che si tratti di soddisfare esigenze aziendali specifiche o di condividere i propri risultati con la comunità, comprendere l’architettura e i principi fondamentali di WordPress è il primo passo verso il successo. I plugin sono essenzialmente insiemi di codice PHP che seguono le specifiche e le API di WordPress, integrandosi senza problemi nel sistema principale. Attraverso gli “hook” (punti di interazione) e i “filter” (meccanismi di modifica dei dati), è possibile modificare o migliorare il funzionamento della piattaforma.

Configurare l’ambiente di sviluppo e creare plugin di base

Prima di iniziare a scrivere la prima riga di codice, è essenziale disporre di un ambiente di sviluppo isolato e professionale. Si consiglia l’uso di strumenti di sviluppo locali come Local by Flywheel, DevKinsta o MAMP, che permettono di configurare rapidamente un ambiente completo contenente PHP, MySQL e WordPress.

Creare il primo file di plugin

Tutto è iniziato da un file PHP. In WordPress… wp-content/plugins Nel catalogo, creare una nuova cartella per il vostro nuovo plugin. Ad esempio, possiamo creare una cartella chiamata… my-first-plugin La cartella in questione. Successivamente, all’interno di questa cartella, creare il file principale, che di solito ha lo stesso nome della cartella stessa.my-first-plugin.php。

Si consiglia di leggere Dallo zero all’uno: Guida completa e tutorial pratico per lo sviluppo di plugin per WordPress。

Le note presenti all’inizio di questo file principale costituiscono, in sostanza, il “certificato di identità” del plugin: forniscono a WordPress tutte le informazioni necessarie per riconoscere e gestire correttamente il plugin stesso. Ecco la struttura di base del file:

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

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

Dopo aver salvato il file, accedi al pannello di amministrazione di WordPress e vai alla pagina “Plugin”. Dovresti vedere un nuovo plugin chiamato “Il mio primo plugin”. Anche se al momento non ha alcuna funzionalità, puoi attivarlo o disattivarlo a piacimento. Questo segna il completamento del processo di creazione del tuo framework per plugin.

Comprendere i concetti fondamentali: Ganci di azione (Action Hooks) e Filtri (Filters)

Il cuore dello sviluppo di plugin per WordPress è il meccanismo dei “hook” (ganci). I hook permettono al vostro codice di “inserirsi” nei flussi di esecuzione principali di WordPress in momenti specifici, eseguendo così la vostra logica.

Action Hook

Gli “Action Hooks” eseguono del codice quando si verificano eventi specifici, come la pubblicazione di un articolo, l’accesso di un utente o il caricamento di un template. Le utilizzate… add_action() La funzione associa la tua funzione di callback al “hook” (punto di interazione specificato).

Ad esempio, vogliamo visualizzare un messaggio personalizzato in cima alla pagina di modifica degli articoli nell’area di amministrazione. Per farlo, possiamo utilizzare… edit_form_top Questo “action hook”.

Si consiglia di leggere Come scegliere e sviluppare plugin per WordPress di alta qualità: una guida dall’approccio iniziale all’esperto。

// 在文章编辑页面顶部添加自定义提示
add_action( 'edit_form_top', 'myplugin_edit_form_top_message' );
function myplugin_edit_form_top_message( $post ) {
    if ( 'post' === $post->post_type ) {
        echo '<div class="notice notice-info"><p>Questo è un messaggio personalizzato proveniente dal mio primo plugin (‘Il mio primo plugin”).</p></div>';
    }
}

Filter Hook

I “Filter Hooks” servono per modificare i dati. Vi permettono di alterarne i valori prima che vengano utilizzati (ad esempio, salvati in un database o visualizzati nel browser). add_filter() Funzione.

Un esempio classico è modificare le ultime parole del contenuto di un articolo. Possiamo utilizzare… the_content Filtro.

// 在文章内容末尾附加版权信息
add_filter( 'the_content', 'myplugin_add_copyright_to_content' );
function myplugin_add_copyright_to_content( $content ) {
    if ( is_single() ) {
        $content .= '<p><small>© 2026 Tutti i diritti riservati. Questo testo è stato ottimizzato utilizzando il mio plugin.</small></p>';
    }
    return $content;
}

Creare una pagina di gestione dei plugin e delle relative opzioni.

Per permettere agli utenti di configurare il vostro plugin, è necessario creare una pagina di impostazioni apposita per loro. WordPress offre un’ampia gamma di API per aggiungere nuove pagine al menu di amministrazione e gestire le opzioni disponibili.

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

Aggiungere il menu di gestione

Usare add_menu_page() 或 add_options_page() Le funzioni permettono di aggiungere un menu di livello superiore o di livello inferiore al vostro plugin. Di solito, i plugin semplici vengono inseriti nel menu “Impostazioni” come una pagina sottostante.

Innanzitutto, dobbiamo collegare una funzione all’inizializzazione dell’amministratore per registrare il menu.

// 在管理后台添加设置菜单
add_action( 'admin_menu', 'myplugin_add_admin_menu' );
function myplugin_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',      // 所需权限
        'myplugin-settings',   // 菜单别名 (slug)
        'myplugin_render_settings_page' // 用于输出页面内容的回调函数
    );
}

Pagina di impostazioni di rendering e opzioni di salvataggio

Di seguito, abbiamo bisogno di definire myplugin_render_settings_page La funzione è utilizzata per generare i moduli HTML della pagina e per gestire il salvataggio dei dati inseriti nei moduli. Per registrare, verificare e salvare le opzioni in modo sicuro, utilizzeremo l’API di configurazione di WordPress (Settings API).

Si consiglia di leggere Come scegliere e sviluppare plugin per WordPress di alta qualità: dall’approccio iniziale all’esperto。

// 渲染设置页面
function myplugin_render_settings_page() {
    ?>
    <div class="wrap">
        <h1>I miei setting per il plugin</h1>
        <form action="/it/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出必要的安全字段和隐藏字段
            settings_fields( 'myplugin_settings_group' );
            // 输出设置章节和字段
            do_settings_sections( 'myplugin-settings' );
            // 输出提交按钮
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="it"/></form>
    </div>
    <?php
}

// 初始化设置
add_action( 'admin_init', 'myplugin_settings_init' );
function myplugin_settings_init() {
    // 注册一个设置组和字段
    register_setting(
        'myplugin_settings_group', // 设置组名
        'myplugin_option_message'  // 选项名，将保存在 wp_options 表中
    );

    // 添加一个设置章节
    add_settings_section(
        'myplugin_section_basic',
        '基础设置',
        null, // 章节描述回调函数，可以为空
        'myplugin-settings' // 页面别名
    );

    // 向章节添加一个字段
    add_settings_field(
        'myplugin_field_message',
        '自定义消息',
        'myplugin_field_message_render', // 渲染字段 HTML 的函数
        'myplugin-settings',
        'myplugin_section_basic'
    );
}

// 渲染 ‘自定义消息’ 字段
function myplugin_field_message_render() {
    $option = get_option( 'myplugin_option_message' );
    ?>
    <input type='text' name='myplugin_option_message' value='<?php echo esc_attr( $option ); ?>'>
    <p class="description">I messaggi inseriti qui verranno visualizzati nell’interfaccia utente.</p>
    &lt;?php
}

Ora potete visualizzare una pagina di impostazioni contenente un campo di input testuale in “Impostazioni” -> “I miei plugin”, e potete salvare i messaggi. Per utilizzare questa funzionalità, potete farlo dall’interfaccia utente. get_option( 'myplugin_option_message' ) Ottenere il suo valore.

Implementare codici corti personalizzati

I codici brevi (shortcodes) permettono agli utenti di utilizzare semplici tag tra parentesi quadre (ad esempio…) [my_shortcode]Inserire contenuto dinamico in articoli, pagine o strumenti utili rappresenta un modo semplice ed intuitivo per sfruttare le funzionalità avanzate offerte dai plugin.

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

Registra un codice breve

Usare add_shortcode() Esiste una funzione per registrare il vostro codice breve. Accetta due parametri: l’etichetta del codice breve e la funzione di elaborazione associata.

Ad esempio, creiamo dei codici brevi (short codes). [display_greeting]Può mostrare diversi saluti in base all’orario e, opzionalmente, accettare un input da parte dell’utente. name Parametri.

// 注册自定义短代码
add_shortcode( 'display_greeting', 'myplugin_render_greeting_shortcode' );
function myplugin_render_greeting_shortcode( $atts ) {
    // 设置默认属性值
    $attributes = shortcode_atts(
        array(
            'name' => '访客',
        ),
        $atts,
        'display_greeting'
    );

    // 获取当前小时
    $hour = date( 'H' );
    $greeting = '';

    if ( $hour < 12 ) {
        $greeting = '早上好';
    } elseif ( $hour < 18 ) {
        $greeting = '下午好';
    } else {
        $greeting = '晚上好';
    }

    // 构建输出
    $output = sprintf(
        &#039;<div class="myplugin-greeting"><p><strong>%s, %s!</strong> Benvenuti sul nostro sito.</p></div>',
        esc_html( $greeting ),
        esc_html( $attributes['name'] )
    );

    return $output;
}

Gli utenti possono ora inserire dei contenuti nell’editor. [display_greeting name="张三"]Durante la rendering della pagina, questo testo verrà sostituito con un saluto personalizzato.

Riassumendo

Lo sviluppo di plugin per WordPress è un processo potente e flessibile; il suo segreto risiede nella comprensione e nell’utilizzo del sistema di “hook” (ganci) nonché dell’API di base del framework. Partendo dalla creazione di un file PHP con un’intestazione standard, si possono estendere le funzionalità tramite gli “action hook” e i “filter hook”, creare interfacce di configurazione user-friendly utilizzando l’API di configurazione, e fornire codici brevi e pratici per semplificare il lavoro. In questo modo si costruisce un plugin che possiede una struttura di base e moduli funzionali essenziali. Combinando questi moduli, approfondendone il funzionamento e seguendo gli standard di codifica di WordPress nonché le migliori pratiche di sicurezza, è possibile creare plugin efficaci in grado di soddisfare svariate esigenze.

FAQ - Domande frequenti

Quali sono le conoscenze di base necessarie per sviluppare plugin per WordPress?

È necessario disporre di una conoscenza di base della lingua di programmazione PHP, poiché i plugin sono principalmente scritti in PHP. Inoltre, una conoscenza di base di HTML, CSS e JavaScript sarà utile per creare interfacce utente e funzionalità interattive. Il più importante è essere familiari con i concetti fondamentali di WordPress, come gli “Hook” (Ganci), il “The Loop” (Il Ciclo) e la struttura gerarchica dei template.

Come si esegue il debug di un plugin per WordPress che si sta sviluppando?

Si consiglia di attivare il modalità di debug di WordPress nell’ambiente di sviluppo locale. wp-config.php Nel documento, verrà indicato che... WP_DEBUG La costante è impostata su trueÈ anche possibile installare plugin di monitoraggio delle query (come Query Monitor) per tracciare le operazioni di interrogazione del database, l’esecuzione dei “hook” e il caricamento dei script. Questo è estremamente utile per l’ottimizzazione delle prestazioni e il controllo della logica di funzionamento del sistema.

Come posso rendere il mio plugin compatibile con l’internazionalizzazione?

WordPress utilizza il framework GNU gettext per l’internazionalizzazione. È necessario definire tale configurazione all’inizio del file principale del proprio plugin. Text Domain 和 Domain PathNel codice, utilizzare… __()、_e() Le funzioni come `translate` avvolgono tutte le stringhe da tradurre. Successivamente, si utilizzano strumenti come Poedit per generare il risultato della traduzione. .pot File di template, utilizzati dai traduttori per creare i contenuti da tradurre. .po 和 .mo Documenti.

Come posso inviare in modo sicuro il mio plugin al catalogo ufficiale di plugin di WordPress?

Innanzitutto, è necessario creare un account su WordPress.org e inviare il plugin. Il codice deve seguire gli standard di codifica di WordPress e non deve contenere alcun codice crittografato o obstruito. Il directory del plugin, il file principale, le immagini di schermata e il file README devono rispettare strutture specifiche. Il team di revisione controllerà la qualità del codice, la sicurezza e l’accordo di licenza (che deve essere compatibile con GPL).