Guida introduttiva allo sviluppo di plugin per WordPress: crea la tua prima estensione di funzionalità personalizzata da zero.

Perché è necessario sviluppare plugin personalizzati?

WordPress è noto per la sua elevata estensibilità, e uno dei segreti del suo successo è sicuramente il suo sistema di plugin. Quando i requisiti di un sito web superano le capacità dei temi disponibili o degli plugin esistenti, lo sviluppo di soluzioni personalizzate diventa la scelta migliore. Questo è particolarmente vero rispetto al caso in cui si decidesse di modificare direttamente i temi stessi. functions.php Rispetto alla creazione di file separati, la creazione di un plugin indipendente presenta notevoli vantaggi. I plugin sono separati dai temi (temi in questo contesto probabilmente si riferiscono a elementi grafici o di stile del sito web), il che significa che, anche cambiando tema, le funzionalità del plugin rimangono invariate, garantendo così l’indipendenza e la manutenibilità delle stesse. Inoltre, un plugin ben strutturato può essere facilmente trasferito e riutilizzato su diversi siti web, e può anche essere distribuito tramite canali ufficiali o di terze parti.

Lo sviluppo di plugin personalizzati ti consente di controllare con precisione la logica delle funzionalità, evitando i costi di prestazioni e i possibili conflitti di codice derivanti dall’installazione di troppi plugin generici. Dalla semplice generazione di codice breve alla gestione complessa di dati e flussi di lavoro, lo sviluppo di plugin ti apre le porte a una personalizzazione approfondita di WordPress.

Costruire la struttura di base del tuo primo plugin

Un plugin WordPress è essenzialmente uno o più file che si trovano nella cartella dei plugin di WordPress. wp-content/plugins/ I file PHP presenti nel directory. Il primo passo per creare un plugin è stabilirne la struttura di base.

Si consiglia di leggere Guida introduttiva allo sviluppo di plugin per WordPress: crea il tuo primo plugin funzionale da zero.。

Creare il file principale del plugin e aggiungere le note di testo iniziali

Prima di tutto, wp-content/plugins/ Crea una nuova cartella all’interno del directory, ad esempio… my-first-pluginPoi, all’interno di quella cartella, crea il file PHP principale, che di solito ha lo stesso nome della cartella stessa.my-first-plugin.php。

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

All’inizio del file deve essere presente un commento con le informazioni relative al plugin, conforme agli standard di WordPress. Questo commento è fondamentale affinché WordPress possa riconoscere il plugin correttamente. Le informazioni contenute in questo commento forniscono i dettagli essenziali sul plugin e verranno visualizzate sulla pagina di gestione dei plugin nell’interfaccia amministrativa di 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
 */

Dopo aver salvato il file, accedi al pannello di amministrazione di WordPress e vai alla pagina “Plugin”. Dovresti vedere un plugin chiamato “Il mio primo plugin personalizzato” nell’elenco; potrai attivarlo o disattivarlo a seconda delle tue esigenze. Al momento, non possiede alcuna funzionalità concreta.

Creare un “impacchetto sicuro” per le funzionalità di un plugin

Per evitare che i nomi delle funzioni siano in conflitto con quelli dei temi o di altri plugin, la pratica migliore è racchiudere tutte le funzionalità all’interno di una classe, oppure aggiungere un prefisso unico a ciascuna funzione. In questo caso utilizziamo il metodo delle classi, poiché offre un maggiore livello di incapsulamento e una struttura organizzativa più chiara.

Nel file principale, dopo le note di testo iniziali, possiamo iniziare a definire la classe principale del plugin.

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

if ( ! defined( 'ABSPATH' ) ) {
    exit; // 防止直接访问文件
}

class My_First_Plugin {
    /**
     * 构造方法，用于初始化插件
     */
    public function __construct() {
        // 初始化钩子
        $this->init_hooks();
    }

/**
     * 初始化 WordPress 钩子（动作和过滤器）
     */
    private function init_hooks() {
        // 后续的钩子将在这里添加
    }
}

// 初始化插件
new My_First_Plugin();

Attraverso if ( ! defined( 'ABSPATH' ) ) Con questo codice, abbiamo garantito che il file possa essere accesso esclusivamente dall’ambiente WordPress, aumentando così la sicurezza. Ora il framework di base del plugin è pronto per l’utilizzo.

Estendere le funzionalità di base di WordPress utilizzando gli “hook”

Il nucleo dell’API per gli plugin di WordPress sono i “Hook”, che ti permettono di eseguire codice personalizzato in momenti specifici o su dati specifici. I Hook si dividono in due tipi: “Actions” e “Filters”.

Comprendere e aggiungere un semplice “hook” per un’azione.

Gli action hook eseguono il codice specificato quando si verifica un evento particolare, ad esempio la pubblicazione di un articolo o il caricamento di una pagina di gestione. Non restituiscono alcun valore; si limitano semplicemente ad “eseguire” un’azione.

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

Aggiungiamo una funzionalità: alla fine di ogni articolo, verrà automaticamente inserito un testo personalizzato. Per farlo, utilizzeremo… the_content Questo filtro (sì, anche se chiamato “filtro”, in realtà viene spesso utilizzato per aggiungere contenuti; tecnicamente si tratta comunque di un filtro, poiché riceve e restituisce dei dati)… Tuttavia, per prima cosa vogliamo dimostrare un’azione puramente “operativa” (ossia un’azione che esegue un compito specifico senza interazioni con altri elementi del sistema). Per questo motivo, aggiungeremo anche una funzionalità che permette di visualizzare messaggi nella barra di gestione in background.

Prima di tutto, init_hooks Aggiungere un “hook” di registrazione nel metodo:

private function init_hooks() {
    // 在文章内容末尾添加信息的过滤器
    add_filter( 'the_content', array( $this, 'append_custom_text' ) );
    // 在管理栏添加节点的动作
    add_action( 'admin_bar_menu', array( $this, 'add_admin_bar_node' ), 999 );
}

Poi, definisci i metodi di callback corrispondenti all’interno della classe:

Si consiglia di leggere Guida completa allo sviluppo di plugin per WordPress: dall’approccio iniziale alla creazione di funzionalità personalizzate avanzate。

/**
 * 在文章内容末尾添加自定义文本（过滤器回调）
 *
 * @param string $content 原始文章内容。
 * @return string 修改后的文章内容。
 */
public function append_custom_text( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $custom_text = '<p><em>Questo articolo è supportato tecnologicamente da “Il mio primo plugin”.</em></p>';
        $content .= $custom_text;
    }
    return $content;
}

/**
 * 在管理工具栏添加一个自定义节点（动作回调）
 *
 * @param WP_Admin_Bar $wp_admin_bar WordPress 管理栏对象。
 */
public function add_admin_bar_node( $wp_admin_bar ) {
    $args = array(
        'id'    =&gt; 'my_plugin_node',
        'title' =&gt; '我的插件',
        'href'  =&gt; admin_url( 'plugins.php' ),
        'meta'  =&gt; array( 'class' =&gt; 'my-plugin-node' )
    );
    $wp_admin_bar-&gt;add_node( $args );
}

Ora, dopo aver attivato il plugin, il testo aggiunto apparirà in fondo a ogni singola articolo nella parte frontale del sito, mentre nella barra di gestione in alto nella parte posteriore del sito verrà visualizzato un menu denominato “I miei plugin”.

Modificare l’output dei dati utilizzando filtri.

I filtri servono per modificare i dati che vengono passati in un punto specifico. Ricevono un valore e devono restituire il valore modificato. Ne abbiamo utilizzato uno poco fa… append_custom_text In realtà, un metodo rappresenta semplicemente un callback per un filtro. Creiamo un altro esempio più tipico di filtro: modificare la lunghezza della traccia di un articolo.

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

在 init_hooks Aggiungere quanto segue:

add_filter( 'excerpt_length', array( $this, 'custom_excerpt_length' ), 999 );

Poi definisci il metodo di callback:

/**
 * 修改文章摘要的默认字数长度
 *
 * @param int $length 默认的摘要长度。
 * @return int 修改后的摘要长度。
 */
public function custom_excerpt_length( $length ) {
    // 将摘要长度设置为 30 个字
    return 30;
}

Implementare una pagina di opzioni per plugin configurabili.

Per rendere i plugin più flessibili, è solitamente necessario fornire agli utenti una pagina di configurazione. WordPress offre l“”API di configurazione” per creare pagine di opzioni in modo sicuro e standardizzato.

Creare un menu di gestione e pagine sottostanti

Prima di tutto, dobbiamo aggiungere un elemento di menu nel backend di WordPress. Utilizzeremo… add_options_page La funzione aggiunge una sottopagina al menu principale “Impostazioni”.

在 init_hooks Aggiungere un’azione:

add_action( 'admin_menu', array( $this, 'add_plugin_admin_menu' ) );

Definire il metodo per aggiungere un menu:

/**
 * 向 WordPress 后台添加插件设置页面
 */
public function add_plugin_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 所需权限
        'my-first-plugin',      // 菜单 Slug
        array( $this, 'display_plugin_admin_page' ) // 回调函数
    );
}

Utilizzare l’API di configurazione per registrare e visualizzare i campi.

Di seguito, abbiamo bisogno di definire display_plugin_admin_page Metodi per rendere il contenuto della pagina visibile all’utente, nonché per registrare impostazioni, campi e sezioni del documento.

Innanzitutto, aggiungiamo un altro “hook” per registrare le impostazioni:

add_action( 'admin_init', array( $this, 'register_plugin_settings' ) );

Poi implementare i metodi correlati:

/**
 * 使用 WordPress 设置 API 注册设置、字段和章节
 */
public function register_plugin_settings() {
    // 注册一个设置，存储到一个选项 `my_first_plugin_options`
    register_setting(
        'my_first_plugin_options_group', // 选项组名
        'my_first_plugin_options'        // 选项名
    );

// 添加一个设置章节
    add_settings_section(
        'my_first_plugin_main_section',  // 章节 ID
        '主要设置',                      // 章节标题
        array( $this, 'render_section_description' ), // 章节描述回调
        'my-first-plugin'                // 页面 Slug
    );

// 向章节中添加一个文本字段
    add_settings_field(
        'custom_text_field',             // 字段 ID
        '自定义文本',                    // 字段标题
        array( $this, 'render_text_field' ), // 字段渲染回调
        'my-first-plugin',               // 页面 Slug
        'my_first_plugin_main_section'   // 所属章节 ID
    );
}

/**
 * 渲染设置章节的描述文字
 */
public function render_section_description() {
    echo '<p>Qui puoi configurare le impostazioni del tuo primo plugin.</p>';
}

/**
 * 渲染自定义文本输入字段
 */
public function render_text_field() {
    $options = get_option( 'my_first_plugin_options' );
    $value = isset( $options['custom_text_field'] ) ? $options['custom_text_field'] : '';
    echo '<input type="text" name="my_first_plugin_options[custom_text_field]" value="' . esc_attr( $value ) . '" class="regular-text" />';
    echo '<p class="description">Il testo inserito qui verrà visualizzato alla fine dell’articolo.</p>';
}

/**
 * 渲染插件管理页面的主要内容
 */
public function display_plugin_admin_page() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?&gt;
    <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_fields( 'my_first_plugin_options_group' );
            do_settings_sections( 'my-first-plugin' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="it"/></form>
    </div>
    &lt;?php
}

Infine, dobbiamo modificare quanto fatto in precedenza. append_custom_text Metodo per leggere il testo salvato dall’utente tra le opzioni disponibili:

public function append_custom_text( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $options = get_option( 'my_first_plugin_options' );
        $custom_text = isset( $options['custom_text_field'] ) && ! empty( $options['custom_text_field'] ) ?
            '<p><em>'`. esc_html($options['custom_text_field'])`.'</em></p>' :
            '<p><em>Questo articolo è supportato tecnologicamente da “Il mio primo plugin”.</em></p>';
        $content .= $custom_text;
    }
    return $content;
}

Ora, gli utenti possono personalizzare il testo che viene visualizzato alla fine degli articoli nella pagina “Impostazioni” -> “I miei plugin”.

Riassumendo

Attraverso questa guida, abbiamo seguito passo dopo passo il processo di sviluppo di un plugin personalizzato per WordPress: dalla creazione della struttura di base dei file e dell’imballaggio sicuro del codice, all’approfondimento e all’utilizzo dei meccanismi di estensione fondamentali di WordPress, ovvero gli “action” e i “filter hooks”, fino alla realizzazione di un plugin configurabile che include una pagina di impostazioni per l’amministratore. Abbiamo inoltre mostrato come utilizzare in modo corretto l’API di configurazione di WordPress per creare pagine di opzioni, garantendo così l’archiviazione sicura dei dati e l’omogeneità dell’interfaccia utente.

Padroneggiare queste nozioni di base rappresenta un passo fondamentale verso lo sviluppo di plugin più complessi. In seguito, potrai esplorare argomenti più avanzati, come la personalizzazione delle tabelle del database, la creazione di codici brevi (shortcodes), l’aggiunta di widget, la scrittura di endpoint REST API e l’implementazione di interazioni AJAX. Ricorda che un’organizzazione efficace del codice, controlli di sicurezza rigorosi (come la verifica delle autorizzazioni, la pulizia e l’elaborazione dei dati) nonché il rispetto degli standard di codifica di WordPress sono fondamentali per lo sviluppo di plugin di alta qualità e facili da mantenere.

FAQ - Domande frequenti

Quali sono le conoscenze preliminari necessarie per lo sviluppo di plugin?

È necessario possedere una conoscenza di base della lingua di programmazione PHP, inclusi concetti come la sintassi, le variabili, le funzioni, le classi e gli oggetti. Inoltre, avere una conoscenza di base di HTML, CSS e JavaScript sarà molto utile, soprattutto quando si creano plugin che coinvolgono interazioni utente o interfacce posteriori complesse. È essenziale comprendere le operazioni di base e l’architettura di WordPress.

Come debuggare un plugin che si sta sviluppando?

Prima di tutto, assicurati che nel tuo… wp-config.php Il documento includerà... WP_DEBUG Imposta come trueQuesto attiverà la funzionalità di reporting degli errori di WordPress. Utilizza gli strumenti di sviluppo del browser (le schede “Console” e “Network”) per verificare gli errori JavaScript e le richieste di rete. Per il codice PHP, puoi utilizzare… error_log() La funzione registra le variabili o le informazioni nel log di debug del server, oppure utilizza plugin di debug dedicati per tracciare il flusso di esecuzione del codice e lo stato delle variabili.

È possibile spostare il codice presente nel file `functions.php` del tema direttamente nel plugin?

In molti casi è possibile, ma è necessario prestare attenzione ai problemi legati alla referenza dei percorsi e degli URL. L’utilizzo di tali elementi all’interno di un argomento (topic) è consigliato. get_template_directory_uri() Per ottenere l’URI del catalogo dei temi, nel plugin è necessario utilizzare un approccio diverso. plugin_dir_url(FILE)Allo stesso modo, la funzione per il percorso del catalogo dei temi. get_template_directory() Dovrebbe anche essere sostituito con il plugin. plugin_dir_path(FILE)Inoltre, è necessario assicurarsi che tutte le funzionalità presenti nel codice siano correttamente incapsulate all’interno di classi o funzioni che utilizzino un prefisso, al fine di evitare conflitti.

Cosa bisogna considerare quando si sviluppano plugin commerciali?

I plugin commerciali distribuiti secondo il piano di sviluppo devono prestare maggiore attenzione alla qualità del codice, alla sicurezza e all’espandibilità. È necessario effettuare una preparazione approfondita per l’internazionalizzazione e la localizzazione (utilizzando i giusti strumenti e approcci). __()、_e() È necessario includere funzioni e campi di testo per facilitare la traduzione. Il codice deve seguire gli standard di codifica di WordPress. È importante prendere in considerazione la licenza (solitamente GPL) e i meccanismi di aggiornamento successivi. È altrettanto essenziale fornire al plugin documentazione d’uso chiara e dettagliata, nonché canali di supporto tecnico. Nel contesto dell’ecosistema di WordPress del 2026, garantire la compatibilità del plugin con le nuove versioni di WordPress, le versioni di PHP, i temi più popolari e altri plugin rappresenta una parte fondamentale del processo di manutenzione continua.

Come aggiungere il supporto per più lingue a un plugin?

WordPress utilizza la tecnologia GNU gettext per l’internazionalizzazione (i18n). Prima di tutto, tutte le stringhe da tradurre all’interno di un plugin devono essere racchiuse in funzioni specifiche. __('文本', 'my-first-plugin') Utilizzato per restituire la traduzione._e('文本', 'my-first-plugin') Utilizzalo per generare il file di output della traduzione. Successivamente, utilizza uno strumento come Poedit per analizzare il codice sorgente del plugin e creare il file di traduzione necessario. .pot File di template. Il traduttore ha creato i file corrispondenti per la lingua richiesta basandosi su questo modello. .po Il file viene poi compilato in un formato comprensibile dal computer. .mo File. Infine, è necessario… load_plugin_textdomain() La funzione viene integrata nel codice di inizializzazione del plugin, in modo da caricare i file di traduzione tramite il percorso corretto.