Guida allo sviluppo di plugin per WordPress: creare moduli funzionali personalizzati da zero.

La forza di WordPress non risiede solo nelle sue funzionalità di base, ma anche nella sua capacità di espandersi all’infinito grazie agli plugin. Quando hai bisogno di aggiungere alla tua website una funzionalità che non è disponibile negli plugin esistenti, imparare a sviluppare plugin diventa essenziale. Questo guida ti accompagnerà dai concetti di base fino alla creazione del tuo primo plugin WordPress completo di funzionalità, permettendoti di acquisire le competenze fondamentali per lo sviluppo personalizzato.

Ambiente di sviluppo per plugin e struttura di base

Prima di iniziare a scrivere il codice, è necessario disporre di un ambiente di sviluppo appropriato e di una struttura del progetto chiara. Questo non solo permetterà di lavorare in modo efficiente, ma assicurerà anche che il plugin rispetti gli standard di WordPress, facilitando così la manutenzione e la distribuzione futura.

Configurare un ambiente di sviluppo locale

Si consiglia di utilizzare software per server locali come XAMPP, MAMP o Local by Flywheel per configurare un ambiente WordPress. Questi strumenti permettono di eseguire test e debug in modo sicuro sul proprio computer. Inoltre, assicurarsi che il proprio editor di codice (ad esempio VS Code o PhpStorm) supporti l’highlighting del codice PHP e le funzionalità di suggerimento, il che migliorerà notevolmente l’efficienza dello sviluppo.

Si consiglia di leggere Guida introduttiva allo sviluppo di plugin per WordPress: crea la tua prima estensione partendo da zero.。

Comprendere la struttura di base di un plugin

Un plugin WordPress il più semplice può consistere in un unico file, ma un plugin ben strutturato di solito include diversi directory e file. Il file più importante è il file principale del plugin, che deve contenere un’annotazione specifica chiamata “header comment” (commento di intestazione), utilizzata per comunicare al sistema WordPress l’esistenza del plugin stesso.

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

I file principali dei plugin di solito prendono il nome dalla funzionalità che il plugin svolge, ad esempio…my-custom-functionality.phpLa parte superiore deve contenere l’intestazione standard delle informazioni sui plugin.

<?php
/**
 * Plugin Name:       我的定制功能模块
 * Plugin URI:        https://example.com/my-custom-plugin
 * Description:       这是一个用于演示的WordPress定制功能插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-custom-plugin
 */

Questo commento indica la fonte delle informazioni riconosciute e visualizzate sulla pagina “Plugin” nell’interfaccia di back-end di WordPress.Text DomainUtilizzato per le traduzioni internazionali. In seguito, tutto il codice funzionale dovrebbe essere scritto in questo file o in altri file importati da questo file.

Sviluppo principale: Ganci di azione e filtri

L’architettura dei plugin per WordPress si basa sul sistema dei “Hook”, che rappresenta la pietra angolare della sua estensibilità. Comprendere e utilizzare correttamente i Hook è fondamentale per lo sviluppo di plugin. I Hook si dividono principalmente in due tipi: gli Action Hooks e i Filter Hooks.

Utilizzare gli “action hooks” per aggiungere funzionalità.

Gli “action hooks” ti permettono di “inserire” e eseguire le tue funzioni PHP in momenti specifici o quando si verificano determinati eventi. Ad esempio, potresti voler eseguire un’operazione al momento della pubblicazione di un articolo, o aggiungere un pezzo di codice personalizzato nella parte inferiore della pagina web.

Si consiglia di leggere Da zero a uno: guida completa allo sviluppo di plugin per WordPress e migliori pratiche.。

Puoi utilizzare…add_action()La funzione permette di collegare la tua funzione personalizzata a un determinato “action hook” (punto di interazione del sistema). L’esempio seguente mostra come aggiungere un riquadro meta personalizzato sulla pagina di modifica degli articoli nell’area di amministrazione.

// 将函数挂载到‘add_meta_boxes’这个动作钩子
add_action( 'add_meta_boxes', 'mcp_add_custom_meta_box' );

function mcp_add_custom_meta_box() {
    add_meta_box(
        'mcp_custom_box_id',          // 元框的唯一ID
        '自定义设置',                 // 元框标题
        'mcp_custom_meta_box_html',   // 回调函数，用于输出HTML内容
        'post',                       // 在‘文章’编辑页面显示
        'side',                       // 显示在侧边栏
        'high'                        // 优先级
    );
}

// 定义输出元框HTML内容的回调函数
function mcp_custom_meta_box_html( $post ) {
    // 获取已保存的值
    $value = get_post_meta( $post->ID, '_mcp_custom_field', true );
    // 输出一个非安全字段
    echo '<label for="mcp_field">自定义字段：</label>';
    echo '<input type="text" id="mcp_field" name="mcp_field" value="' . esc_attr( $value ) . '" />';
}

Modificare i dati utilizzando gli hook dei filtri

Gli “hook dei filtri” (filter hooks) ti permettono di modificare qualsiasi dato venga generato durante il processo di elaborazione da WordPress. A differenza degli “hook delle azioni” (action hooks), le funzioni dei filtri devono ricevere un valore in ingresso e devono restituire un valore modificato. Puoi utilizzarli per eseguire operazioni personalizzate sui dati prima che vengano visualizzati o salvati.add_filter()Una funzione per aggiungere filtri.

Ad esempio, modificando la parte finale di un articolo, si può aggiungere automaticamente una dichiarazione dei diritti d’autore.

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', 'mcp_add_copyright_to_content' );

function mcp_add_copyright_to_content( $content ) {
    // 仅对单篇文章页面生效
    if ( is_single() ) {
        $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;
}

Implementazione della gestione dei dati dei plugin

I plugin di solito hanno bisogno di memorizzare, leggere e aggiornare dati. WordPress offre un potente API per le opzioni e un API per i metadati degli articoli, che permettono di gestire queste operazioni in modo sicuro, evitando di dover intervenire direttamente sul database.

Utilizzare l’API delle opzioni per salvare le impostazioni.

Per le impostazioni globali dei plugin (come chiavi API, stati di attivazione/disattivazione, ecc.), è consigliabile utilizzare l’API delle opzioni. Questa API offre la possibilità di gestire tali impostazioni in modo centralizzato e affidabile.add_option()， get_option()， update_option()Funzioni come queste vengono utilizzate per gestire dati basati su coppie chiave-valore.

Ad esempio, creare una semplice impostazione per l’attivazione/disattivazione di un plugin.

Si consiglia di leggere Imparare a sviluppare plugin per WordPress: creare il tuo primo modulo di funzionalità estesa da zero.。

// 在插件激活时设置一个默认选项（通常写在激活钩子函数里）
register_activation_hook( __FILE__, 'mcp_plugin_activate' );
function mcp_plugin_activate() {
    if ( false === get_option( 'mcp_feature_enabled' ) ) {
        add_option( 'mcp_feature_enabled', 'yes' );
    }
}

// 在代码中获取这个选项的值
$is_enabled = get_option( 'mcp_feature_enabled', 'yes' ); // 第二个参数是默认值
if ( $is_enabled === 'yes' ) {
    // 执行功能
}

Salvare e leggere i metadati degli articoli

Per i dati associati a un articolo specifico, a una pagina o a un tipo di articolo personalizzato (come i campi personalizzati nell’esempio sopra), è necessario utilizzare l’API dei metadati dell’articolo (Post Meta). La funzione chiave è…update_post_meta()和get_post_meta()。

Devi effettuare la monitorazione.save_postGli “action hooks” vengono utilizzati per salvare i dati inseriti dall’utente all’interno dei moduli front-end. Durante il processo di salvataggio, è necessario eseguire controlli di sicurezza (ad esempio, la verifica del “Nonce”) nonché verifiche relative alle autorizzazioni dell’utente.

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

add_action( 'save_post', 'mcp_save_custom_field_data' );

function mcp_save_custom_field_data( $post_id ) {
    // 检查Nonce字段（应在元框HTML中输出wp_nonce_field）
    if ( ! isset( $_POST['mcp_meta_box_nonce'] ) || ! wp_verify_nonce( $_POST['mcp_meta_box_nonce'], 'mcp_save_data' ) ) {
        return;
    }
    // 检查自动保存
    if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
        return;
    }
    // 检查用户权限
    if ( ! current_user_can( 'edit_post', $post_id ) ) {
        return;
    }
    // 安全地获取并保存字段数据
    if ( isset( $_POST['mcp_field'] ) ) {
        $my_data = sanitize_text_field( $_POST['mcp_field'] );
        update_post_meta( $post_id, '_mcp_custom_field', $my_data );
    }
}

Creare una pagina di gestione dei plugin

Per i plugin complessi, di solito è necessaria una pagina di configurazione gestionale dedicata, che permetta agli amministratori del sito di impostare diversi parametri del plugin. WordPress offre un’ampia gamma di API per creare menu e pagine di gestione con un aspetto uniforme.

Aggiungere il menu di gestione di livello superiore

Usareadd_menu_page()La funzione permette di aggiungere un elemento di menu di livello superiore nella barra di navigazione laterale in background per il tuo plugin. È necessario specificare il titolo della pagina, il nome del menu, i permessi richiesti, un alias per il menu, nonché la funzione di callback utilizzata per visualizzare il contenuto della pagina.

add_action( 'admin_menu', 'mcp_register_admin_menu' );

function mcp_register_admin_menu() {
    add_menu_page(
        '我的插件设置',           // 页面标题
        '我的插件',               // 菜单名称
        'manage_options',         // 所需权限（通常为manage_options）
        'mcp-plugin-settings',    // 菜单别名（slug）
        'mcp_render_settings_page', // 渲染页面的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        80                         // 菜单位置
    );
}

// 定义渲染设置页面的函数
function mcp_render_settings_page() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
        <form action="/it/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段、非安全字段等（需要配合settings API使用）
            settings_fields( 'mcp_settings_group' );
            do_settings_sections( 'mcp-plugin-settings' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="it"/></form>
    </div>
    &lt;?php
}

Utilizzare l’API di configurazione per creare moduli.

Per gestire le opzioni dei moduli in modo più sicuro e standardizzato, si consiglia caldamente di utilizzare l’API delle impostazioni (Settings API) di WordPress. Questa API si occupa automaticamente della verifica dei “Nonce”, dei controlli sui diritti di accesso, dell’archiviazione dei dati e delle visualizzazioni di messaggi di errore. I passaggi fondamentali per implementarla includono:register_setting()Registrazione e impostazioni: utilizzale.add_settings_section()Aggiungere una sezione per le impostazioni, nonché il relativo utilizzo.add_settings_field()Aggiungere i campi di configurazione specifici.

Questo garantisce che la pagina di configurazione del tuo plugin sia in linea con lo stile di base di WordPress e che segua le migliori pratiche di sicurezza.

Riassumendo

Seguendo questa guida, hai percorso il percorso fondamentale nello sviluppo di plugin per WordPress: partendo dall’installazione dell’ambiente di sviluppo e dalla comprensione della struttura di base del sistema, sei passato al cuore dell’espandibilità di WordPress, ovvero il sistema di hook (hook system), imparando come aggiungere o modificare funzionalità tramite azioni (actions) e filtri (filters). Successivamente, hai acquisito conoscenze sull’utilizzo dell’API per le opzioni (Options API) e dell’API per i metadati degli articoli (Article Metadata API) al fine di gestire in modo sicuro i dati dei plugin. Infine, hai appreso come creare una pagina di configurazione per il plugin che sia professionale e sicura da utilizzare dagli utenti.

Lo sviluppo di plugin è un processo fortemente pratico: la vera padronanza si ottiene solo attraverso la pratica concreta. Si consiglia di iniziare con un requisito semplice, ad esempio “aggiungere un profilo dell’autore dopo ogni articolo”, e di applicare gradualmente le conoscenze acquisite. Continua a consultare le risorse disponibili per approfondire le tue competenze.Manuale ufficiale dei plugin per WordPressCon la referenza al codice sorgente, sarai in grado di creare plugin personalizzati potenti ed eleganti dal punto di vista della programmazione, sfruttando appieno il potenziale di WordPress.

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 una conoscenza preliminare dei concetti fondamentali di WordPress (come articoli, pagine, cicli e tag di template). Non è obbligatorio essere esperti di programmazione orientata agli oggetti (OOP), ma questa conoscenza è molto utile per lo sviluppo di plugin complessi.

Il file principale del plugin deve necessariamente avere un nome specifico?

Non esistono requisiti obbligatori, ma per motivi di chiarezza e standardizzazione, si consiglia di utilizzare nomi che descrivano correttamente le funzionalità del plugin. Ad esempio…my-gallery-plugin.phpL’unica richiesta è che la parte iniziale del file contenga le giuste annotazioni relative ai plugin; WordPress utilizza queste annotazioni per riconoscere i plugin.

Come posso assicurarmi che il mio plugin non entri in conflitto con altri plugin?

Aggiungere un prefisso unico a tutte le tue funzioni, classi, costanti e nomi di opzioni è la migliore pratica per evitare conflitti. Ad esempio, non utilizzare…get_data()Per un nome di funzione così generico, si dovrebbe utilizzare…mcp_get_data()(Dato che l’abbreviazione del tuo plugin è “mcp”, anche i nomi delle opzioni dovrebbero essere simili.)mcp_settings_array。

Una volta completato lo sviluppo, come si possono distribuire i plugin ad altre persone per che le utilizzino?

Comprimi la tua cartella di plugin in un file ZIP. Gli utenti possono caricare e installare questo file ZIP direttamente dalla pagina “Plugin” -> “Installa plugin” -> “Carica plugin” presente nell’interfaccia di amministrazione di WordPress. Se desideri pubblicare il tuo plugin nel catalogo ufficiale di plugin di WordPress, dovrai seguire delle procedure più rigorose.Guida alla presentazioneE accettare la revisione del codice.

Dovrei utilizzare un approccio procedurale o orientato agli oggetti per lo sviluppo del plugin?

Per i plugin semplici e di piccole dimensioni, l’approccio procedurale (utilizzo di funzioni indipendenti) è più diretto e veloce. Per i plugin di medie o grandi dimensioni e con funzionalità complesse, l’approccio orientato agli oggetti (utilizzo di classi) permette di organizzare meglio il codice, migliorando la manutenibilità e la riutilizzabilità. Entrambi gli approcci sono ampiamente accettati nella comunità di WordPress.