A partire da zero: la guida definitiva allo sviluppo di plugin per WordPress e un tutorial pratico

I concetti fondamentali dello sviluppo di plugin per WordPress

Prima di approfondire lo studio del codice, è fondamentale comprendere i principi di base dei plugin per WordPress. Un plugin per WordPress è essenzialmente uno script PHP, o un insieme di script, che estende o modifica le funzionalità di base di WordPress attraverso il sistema standard di “hook” (ganci) di WordPress. La sua essenza risiede nella capacità di integrarsi perfettamente nel flusso di esecuzione di WordPress, senza la necessità di modificare direttamente i file di codice sorgente del core.

I file “core” si riferiscono a file PHP che contengono specifiche annotazioni nel loro header. Questo header è il modo in cui WordPress riconosce un plugin. Ad esempio, il file principale di un plugin di base contiene tali annotazioni. my-first-plugin.php All’inizio di… deve essere inclusa la seguente informazione:

<?php
/**
 * Plugin Name: 我的第一个插件
 * Description: 这是一个用于演示的简单WordPress插件。
 * Version: 1.0.0
 * Author: 你的名字
 */

Non appena questo file verrà posizionato… /wp-content/plugins/ All’interno del catalogo, la pagina “Plugin” presente nell’interfaccia di amministrazione di WordPress riconoscerà e elencherà tale plugin.

Si consiglia di leggere Guida completa allo sviluppo di temi per WordPress: costruire temi per siti web di livello professionale da zero。

Il meccanismo di funzionamento degli plugin si basa su due concetti fondamentali: gli Action Hooks e gli Filter Hooks. Gli Action Hooks ti permettono di inserire il tuo codice in momenti specifici dell’esecuzione di WordPress, ad esempio dopo la pubblicazione di un articolo o prima del caricamento dei file di stile nella parte superiore della pagina. Per utilizzarli, basta scrivere funzioni appropriate. add_action() È possibile “montare” le tue funzioni su questi “ganci” (hook). I ganci per i filtri ti permettono di modificare i dati prima che vengano utilizzati o salvati nel database, ad esempio modificando il contenuto di un articolo, il titolo o un estratto. Questo avviene tramite… add_filter() L’implementazione di funzioni è fondamentale. Comprendere e utilizzare con abilità il sistema di “hook” (meccanismi di interazione tra moduli) rappresenta un passo cruciale per passare da utente di WordPress a sviluppatore.

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 plugin funzionale.

Iniziamo con un esempio concreto e utile: creiamo un piccolo plugin che aggiunge automaticamente una dichiarazione di copyright in fondo alle pagine degli articoli di un sito web. Questo processo includerà la creazione del plugin, l’utilizzo di “hook” per i filtri, nonché la configurazione di base delle opzioni del plugin stesso.

Prima di tutto, nel tuo ambiente locale o di test… /wp-content/plugins/ Crea una nuova cartella all’interno del directory e dale il nome di… my-copyright-noticeAll’interno di quella cartella, creare il file principale del plugin. my-copyright-notice.phpE scrivi il seguente codice:

<?php
/**
 * Plugin Name: 文章版权声明
 * Description: 自动在文章内容末尾附加自定义版权声明。
 * Version: 1.0.0
 * Author: 开发者
 */

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

/**
 * 在文章内容后追加版权声明
 */
function mycn_add_copyright_to_content( $content ) {
    // 确保只在主循环的单篇文章中显示
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $site_url = get_site_url();
        $current_year = date( 'Y' );
        // 构建版权文本，这里用 2026 作为示例，实际开发可动态获取
        $copyright_text = sprintf(
            &#039;<p><em>© 2026 %s. Questo testo è stato scritto da… <strong>%s</strong> Opinione originale: per riprodurla, si prega di indicare la fonte.</em></p>',
            esc_html( get_bloginfo( 'name' ) ),
            esc_url( $site_url )
        );
        $content .= $copyright_text;
    }
    return $content;
}
// 将函数挂载到 ‘the_content’ 过滤器
add_filter( 'the_content', 'mycn_add_copyright_to_content' );

Questo plugin dimostra il funzionamento di base dei filtri.mycn_add_copyright_to_content La funzione riceve il contenuto dell’articolo. $contentUtilizzando i criteri di valutazione, si garantisce che le informazioni sul copyright vengano aggiunte soltanto sulla pagina di un singolo articolo e soltanto nell’ambito della query principale. Successivamente, il contenuto viene modificato e restituito.add_filter( ‘the_content’， ‘mycn_add_copyright_to_content’ ) Questo blocco di codice effettua l’iniezione della funzionalità desiderata.

Aggiungere un’interfaccia di gestione e delle opzioni per il plugin.

Un plugin maturo di solito deve permettere agli utenti di effettuare configurazioni, e questo viene realizzato creando pagine di opzioni nel backend di WordPress. Aggiungeremo una pagina di impostazioni al plugin relativo ai diritti d’autore menzionato in precedenza, in modo che gli utenti possano personalizzare il testo relativo ai diritti d’autore.

Si consiglia di leggere Come personalizzare un tema WordPress con funzionalità uniche e un aspetto visivamente eccezionale per soddisfare esigenze professionali?。

Innanzitutto, dobbiamo creare una funzione per registrare un elemento del menu di configurazione. Questo processo avviene solitamente durante l’inizializzazione da parte dell’amministratore.

Modifica il tuo… my-copyright-notice.php Aggiungi il seguente codice al file:

// 添加管理员菜单
function mycn_add_admin_menu() {
    add_options_page(
        '版权声明设置', // 页面标题
        '文章版权',     // 菜单标题
        'manage_options', // 权限
        'my_copyright_notice', // 菜单slug
        'mycn_settings_page_html' // 回调函数，用于输出页面HTML
    );
}
add_action( 'admin_menu', 'mycn_add_admin_menu' );

// 初始化插件的设置
function mycn_settings_init() {
    // 注册一个新的设置项到 ‘mycn_settings’ 组
    register_setting( ‘mycn_settings’, ‘mycn_copyright_text’ );

// 在 ‘mycn_settings’ 组内添加一个设置区块
    add_settings_section(
        ‘mycn_settings_section’,
        ‘自定义版权文本’,
        null, // 可选的区块描述回调函数
        ‘mycn_settings’
    );

// 向区块中添加字段
    add_settings_field(
        ‘mycn_copyright_field’,
        ‘版权声明’,
        ‘mycn_copyright_field_html’,
        ‘mycn_settings’,
        ‘mycn_settings_section’
    );
}
add_action( ‘admin_init’， ‘mycn_settings_init’ );

// 设置字段的HTML输出
function mycn_copyright_field_html() {
    $option = get_option( ‘mycn_copyright_text’， ‘© 2026 [site_name]. 本文原创自 [site_url]。’ );
    ?>
    <textarea name="‘mycn_copyright_text’" rows="‘5’" cols="‘50’"><?php echo esc_textarea( $option ); ?></textarea>
    <p class="“description”">Sono supportati i codici brevi: [site_name] per il nome del sito web, [site_url] per l’indirizzo del sito web.</p>
    <?php
}

// 设置页面的HTML结构
function mycn_settings_page_html() {
    // 检查用户权限
    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_fields( ‘mycn_settings’ );
            do_settings_sections( ‘mycn_settings’ );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="it"/></form>
    </div>
    &lt;?php
}

Successivamente, dobbiamo modificare quanto fatto in precedenza. mycn_add_copyright_to_content La funzione viene modificata in modo da utilizzare le opzioni salvate dall’utente e sostituire i codici brevi presenti al loro interno.

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

function mycn_add_copyright_to_content( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $text = get_option( ‘mycn_copyright_text’， ‘© 2026 [site_name]. 本文原创自 [site_url]。’ );
        $text = str_replace(
            array( ‘[site_name]’， ‘[site_url]’ ),
            array( esc_html( get_bloginfo( ‘name’ ) )， esc_url( get_site_url() ) ),
            $text
        );
        $content .= ‘<p><em>’ . wp_kses_post( $text ) . ‘</em></p>’;
    }
    return $content;
}

Ora, gli utenti possono trovare il sottomenù “Copyright degli articoli” all’interno del menu “Impostazioni” nel pannello di amministrazione di WordPress e personalizzare il testo della dichiarazione relativa ai diritti d’autore.

Best Practices per la Sicurezza, il Debugging e l’Internazionalizzazione degli Plugin

Per sviluppare un plugin da utilizzare da altri, è essenziale prendere in considerazione aspetti come sicurezza, stabilità e mantenibilità. Ecco alcune delle migliori pratiche da seguire:

Sicurezza: non fidarsi mai degli input degli utenti. Tutti i dati provenienti dagli utenti, dai database o dalle API di terze parti devono essere adeguatamente evasi o puliti prima di essere visualizzati sullo schermo, inseriti nel database o utilizzati per le operazioni sui file. WordPress offre una vasta gamma di funzioni di sicurezza, come l'uso di per l'HTML. esc_html()Per l’utilizzo con URL… esc_url()Per utilizzare gli attributi HTML… esc_attr()Quando è necessario consentire l’uso di alcune tag HTML sicure, utilizzare… wp_kses_post() 或 wp_kses()All’inizio del plugin, è necessario assolutamente utilizzare… if ( ! defined( ‘ABSPATH’ ) ) exit; Per impedire che i file vengano accessati direttamente.

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

Debugging: Attivare durante il processo di sviluppo. WP_DEBUG Le costanti sono di fondamentale importanza. Nel tuo… wp-config.php I parametri sono impostati nel file. define( ‘WP_DEBUG’， true);Questo farà apparire tutti gli errori, gli avvisi e le notifiche PHP sullo schermo (solo nell’ambiente di sviluppo). Inoltre, se utilizzato in combinazione con altri strumenti… error_log() Funzioni o strumenti di debug come Query Monitor possono aiutarti molto a tracciare i valori delle variabili e le query SQL.

Preparazione della traduzione (internazionalizzazione/i18n): per consentire ai tuoi plug-in di essere utilizzati da utenti di tutto il mondo, tutte le stringhe rivolte agli utenti dovrebbero essere preparate per la traduzione. Ciò significa non utilizzare testo in cinese o inglese codificato a mano, ma utilizzare le funzioni di traduzione di 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

Ad esempio, modificare le informazioni sul plugin precedente in:

/**
 * Plugin Name: 文章版权声明
 * Description: 自动在文章内容末尾附加自定义版权声明。
 * Version: 1.0.0
 * Author: 开发者
 * Text Domain: my-copyright-notice
 */

Nel codice, le stringhe che possono essere tradotte vanno evidenziate in un modo specifico, ad esempio utilizzando caratteri speciali o marcatori. __( ‘string’， ‘text-domain’ ) 或 _e( ‘string’， ‘text-domain’ ) Funzioni incapsulate. Ad esempio, nella configurazione delle funzioni della pagina:

function mycn_settings_page_html() {
    if ( ! current_user_can( ‘manage_options’ ) ) {
        return;
    }
    ?>
    <div class="“wrap”">
        <h1><?php echo esc_html( __( ‘版权声明设置’， ‘my-copyright-notice’ ) ); ?></h1>
        ...
    </div>
    &lt;?php
}

Successivamente, puoi utilizzare strumenti come Poedit per estrarre queste stringhe e generarne un file di output. .pot File di template, utilizzati dai traduttori per creare i contenuti da tradurre. .po/.mo File di lingua.

Riassumendo

Lo sviluppo di plugin per WordPress rappresenta un processo attraverso il quale le idee vengono trasformate in funzionalità integrate in modo efficace nel sistema di gestione dei contenuti più popolare al mondo. Partendo dalla comprensione dei meccanismi dei “hook” (ganci), è possibile iniziare facilmente creando plugin con funzionalità semplici. L’aggiunta di interfacce di gestione e opzioni per i plugin ne migliora notevolmente la professionalità e l’utilità. Seguire le migliori pratiche in termini di sicurezza, debuggabilità e internazionalizzazione è fondamentale per garantire che i plugin siano stabili, sicuri e facilmente distribuibili. Ricorda: il modo migliore per imparare è praticare direttamente, partendo da un’esigenza reale e sviluppando gradualmente il proprio plugin, perfezionandolo man mano che procedi.

FAQ - Domande frequenti

Quali sono le conoscenze di base necessarie per lo sviluppo di plugin per WordPress?

È necessario disporre di una solida conoscenza della programmazione in PHP, poiché i plugin sono principalmente scritti in questo linguaggio. Inoltre, è fondamentale avere una conoscenza di base di HTML, CSS e JavaScript per creare l’output grafico e gestire le interfacce utente. È essenziale comprendere la struttura di base di WordPress, come i temi, i tipi di articoli, le categorie, nonché i sistemi di “action hooks” e “filter hooks”.

Come iniziare a debuggare un plugin che non funziona?

Prima di tutto, nel tuo… wp-config.php Abilitato nel file. WP_DEBUG 和 WP_DEBUG_LOGQuesto registrerà i messaggi di errore in un file di log, invece di visualizzarli agli utenti. In secondo luogo, assicurati che il tuo plugin sia attivo. Successivamente, verifica la sintassi del codice e controlla che tutti i nomi delle funzioni, dei “hook” e i percorsi dei file siano corretti. var_dump() 或 error_log() Eseguite il comando per visualizzare i valori delle variabili chiave, oppure installate un plugin di debug professionale per WordPress (ad esempio, Query Monitor) per aiutarvi nell’individuazione dei problemi.

In quale cartella dovrebbe essere posizionato il mio plugin?

Il tuo plugin deve essere posizionato nella directory di installazione di WordPress. /wp-content/plugins/ All’interno della cartella, puoi creare direttamente un file PHP (adatto per plugin di tipo “minimalistico”). Tuttavia, la pratica più consigliata è quella di creare una cartella separata per il tuo plugin, e di posizionare il file principale nonché altri file di risorse (come JS, CSS, immagini) all’interno di questa cartella. I nomi della cartella e del file PHP principale devono essere unici, per evitare conflitti con altri plugin.

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

Innanzitutto, devi registrare un account su WordPress.org e inviare il tuo plugin. Il codice del plugin deve essere conforme alle specifiche e agli standard ufficiali di WordPress, inclusi aspetti legati alla sicurezza, l’assenza di codice dannoso, e l’inclusione di commenti appropriati nei file di codice. Devi inoltre fornire informazioni valide relative al tuo plugin. readme.txt Il file è in formato conforme ai requisiti ufficiali. Dopo la submission, il tuo plugin verrà esaminato manualmente da un team di revisori specializzati; questo processo potrebbe richiedere diverse settimane. Una volta superato l’esame, il tuo plugin sarà disponibile per essere cercato e installato dagli utenti in tutto il mondo.