Partendo da zero: guida completa allo sviluppo di plugin per WordPress e tutorial pratico

Preparativi e allestimento dell'ambiente.

Prima di iniziare a scrivere il codice, è essenziale disporre di un ambiente di sviluppo stabile ed efficiente. Questo non solo permette di mantenere una struttura chiara per il plugin durante lo sviluppo futuro, ma consente anche di utilizzare strumenti moderni per aumentare l’efficienza nel lavoro.

Configurazione dell’ambiente di sviluppo locale

Consigliamo l’utilizzo di ambienti server locali, come Local by Flywheel, XAMPP o MAMP. Questi strumenti permettono di configurare rapidamente su un computer personale un ambiente di esecuzione per WordPress che include Apache/Nginx, MySQL e PHP. Assicurati che la versione di PHP utilizzata sia compatibile con quella del server su cui andrai a pubblicare il sito, e attiva la funzione di reporting degli errori: questo aiuterà a individuare rapidamente eventuali problemi durante la fase di sviluppo.

Scegliere un editor di codice e gli strumenti appropriati è fondamentale per un lavoro efficace nello sviluppo software. Ecco alcuni aspetti da considerare:

Il primo passo consiste nell’ scegliere un editor di codice potente, come Visual Studio Code, PhpStorm o Sublime Text. Questi strumenti offrono solitamente funzionalità come l’highlighting del codice, suggerimenti automatici e integrazione con i sistemi di controllo delle versioni. Inoltre, l’installazione di strumenti per la pulizia e la formattazione del codice (ad esempio PHP_CodeSniffer) nonché di strumenti di debug (come Xdebug) migliorerà notevolmente la tua esperienza di sviluppo e la qualità del codice che scrivi.

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

Creare il tuo primo plug-in

Ora, iniziamo creando il plugin più semplice possibile per comprendere la struttura di base e il meccanismo di attivazione dei plugin per WordPress.

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

File principale del plugin e informazioni di intestazione di base

Ogni plugin per WordPress deve disporre di un file PHP principale, il quale deve contenere le informazioni di intestazione standard del plugin, in modo che WordPress possa riconoscerlo. Creiamo quindi un file chiamato… my-first-plugin.php Il file…

Inserisci il codice nel file in questione e poi caricalo nella directory di installazione di WordPress. /wp-content/plugins/my-first-plugin/ All’interno della cartella.

<?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 i file, potrai trovare questo plugin nella pagina “Plugin” dell’interfaccia di amministrazione di WordPress e cliccare su “Attiva” per attivarlo. Al momento non dispone di alcuna funzionalità, ma hai comunque creato con successo un plugin riconosciuto da WordPress.

Aggiungere una pagina di configurazione per il plugin.

Un requisito comune è quello di aggiungere una pagina di gestione da back-end per i plugin. Questo può essere realizzato utilizzando le funzionalità offerte da WordPress. add_menu_page() 或 add_options_page() La funzione viene implementata per svolgere un determinato compito.

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

Continuiamo ad aggiungere codice nel file principale per creare una semplice pagina di configurazione.

// 钩子：在管理员菜单中添加一个新的页面
add_action('admin_menu', 'mfp_add_admin_menu');

function mfp_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 所需权限
        'my-first-plugin',      // 菜单slug
        'mfp_settings_page_html' // 用于显示页面内容的回调函数
    );
}

// 设置页面的HTML内容
function mfp_settings_page_html() {
    // 检查用户权限
    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!</p>
        <form action="/it/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段（后续可在此添加）
            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
}

Questo codice viene utilizzato… add_action() Il “gancio” (hook) utilizza una funzione… mfp_add_admin_menu Montato su WordPress admin_menu Dal punto di vista delle azioni: quando viene creato il menu amministratore, la nostra funzione viene eseguita, aggiungendo così un nuovo elemento di menu secondario al menu principale “Impostazioni”. Facendo clic su quell’elemento di menu, verrà avviata l’operazione desiderata. mfp_settings_page_html Una funzione viene utilizzata per rendere il contenuto della pagina.

Comprendere i “hook” e i “filter” di WordPress

La filosofia fondamentale di WordPress si basa sui cosiddetti “Hook” (Ganci), che permettono di inserire codice personalizzato in momenti o posizioni specifiche del funzionamento del sito, al fine di modificare o estendere le funzionalità di base di WordPress senza dover modificare direttamente i file sorgente. I Hook si dividono principalmente in due categorie: le “Actions” (Azioni) e i “Filters” (Filtri).

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

L’utilizzo dei “action hooks”

Gli “action hooks” eseguono il codice specificato quando si verifica un evento particolare, ad esempio la pubblicazione di un articolo, il caricamento dell’interfaccia di gestione o l’output del piede di pagina. Non richiedono il restituto di un valore e sono utilizzati principalmente per eseguire un compito specifico. add_action() Una funzione per incollare un funzione di callback a un hook di azione specificato.

Ad esempio, vorremmo aggiungere automaticamente una dichiarazione dei diritti d’autore alla fine di ogni articolo. È possibile utilizzare… the_content Questo filtro (che è anche un punto di azione) viene utilizzato per realizzare il funzionamento desiderato. Tuttavia, al fine di mostrare più chiaramente le azioni in questioni, abbiamo scelto di utilizzare… wp_footer Il “gancio” (hook) viene utilizzato per visualizzare informazioni nella parte inferiore della pagina principale del sito web.

add_action('wp_footer', 'mfp_add_footer_note');

function mfp_add_footer_note() {
    if (is_single()) { // 仅在文章页面显示
        echo '<p style="text-align:center; color:#666;">Questo articolo viene presentato per voi tramite il mio plugin.</p>';
    }
}

L’utilizzo dei “filter hooks”

I “filter hooks” servono per modificare i dati prima che vengano utilizzati o salvati nel database. Si aspetta che tu riceva un valore, lo modifichi e poi lo restituisca. Noi li utilizziamo… add_filter() Una funzione per montare una funzione di callback.

Si consiglia di leggere Guida introduttiva allo sviluppo di plugin per WordPress: crea il tuo modulo di funzionalità personalizzato da zero.。

Un esempio classico è la modifica della lunghezza della traccia di un articolo. In WordPress, la lunghezza predefinita della traccia è di 55 parole; possiamo modificarla in base alle nostre esigenze. excerpt_length Utilizziamo dei filtri per modificarlo.

add_filter('excerpt_length', 'mfp_custom_excerpt_length');

function mfp_custom_excerpt_length($length) {
    // 将摘要长度修改为 20 个单词
    return 20;
}

In questo esempio, la funzione… mfp_custom_excerpt_length Ho ricevuto il valore di lunghezza predefinito. $lengthPoi restituiamo il valore della nuova lunghezza che abbiamo definito, ovvero 20. WordPress utilizzerà questo valore restituito per generare il riassunto.

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

La sicurezza dei plug-in e le migliori pratiche.

Sviluppare un plugin popolare richiede di prendere in considerazione aspetti fondamentali come la sicurezza, la manutenibilità e le prestazioni del software. Seguendo le migliori pratiche di sviluppo è possibile evitare molti problemi comuni.

Convalida dei dati, escape e pulizia dei dati

Non fidarti mai dei dati inseriti dagli utenti o provenienti dai database. Prima di elaborarli, è necessario verificarli, pulirli e escaparli.
* 验证（Validation）：检查数据是否符合预期的格式或类型（如是否是邮箱、数字等）。可以使用 filter_var() Funzione o relativa a WordPress sanitize_*() Serie di funzioni.
* 清理（Sanitization）：清除数据中的非法或危险字符，使其变得安全。对于表单输入，常用 sanitize_text_field()。
* 转义（Escaping）：在将数据输出到 HTML、JavaScript 或 URL 时，根据上下文进行转义，以防止跨站脚本（XSS）攻击。WordPress 提供了丰富的转义函数，如 esc_html()、esc_attr()、esc_url() 和 wp_kses_post()。

Ad esempio, per visualizzare in modo sicuro un valore proveniente da un database:

// 假设 $user_input 是从数据库或表单获取的数据
echo '<div class="info">'`. esc_html($user_input)`.'</div>';
// 或者，如果允许一些安全的HTML标签
echo '<div class="info">'. wp_kses_post($user_input)'.'</div>';

Internazionalizzazione e localizzazione di plugin

Per permettere ai tuoi plugin di essere utilizzati da utenti in tutto il mondo, è necessario aggiungere il supporto per le traduzioni; questo processo è noto come internazionalizzazione (i18n). WordPress utilizza il framework GNU gettext per realizzare questa funzionalità.

Innanzitutto, per tutte le stringhe da tradurre, è necessario utilizzare una funzione specifica per elaborarle. La funzione più comune utilizzata in questo contesto è… __()(Usato per i valori restituiti) E _e()(Per l’echeggiamento diretto dell’output.)

Modifica il titolo della pagina di gestione che abbiamo creato in precedenza:

function mfp_settings_page_html() {
    if (!current_user_can('manage_options')) {
        return;
    }
    ?>
    <div class="wrap">
        <h1><?php echo esc_html(get_admin_page_title()); ?></h1>
        <p><?php _e('欢迎来到我的第一个插件的设置页面！', 'my-first-plugin'); ?></p>
        ...
    </div>
    &lt;?php
}

Attenzione: ogni funzione di traduzione include un parametro di tipo testo (‘my-first-plugin’), che deve essere coerente con le informazioni definite nella parte iniziale del plugin. Text Domain Completamente in accordo. Successivamente, puoi utilizzare strumenti come Poedit per analizzare le stringhe traducibili presenti nel codice del plugin e generare il contenuto da tradurre. .pot File di template, e ne creiamo versioni per diverse lingue. .po 和 .mo Traduci il file e mettilo nella directory dei plugin. /languages/ All’interno della cartella.

Riassumendo

Attraverso questa guida, abbiamo esaminato in modo sistematico i passaggi fondamentali per lo sviluppo di plugin per WordPress. Dalla creazione di un ambiente locale e di un file principale che contenga le informazioni di intestazione standard, all’utilizzo degli “action” e degli “filter hook” per interagire in profondità con il core di WordPress, fino alle pratiche di sicurezza essenziali e alle preparazioni per l’internazionalizzazione, hai acquisito le conoscenze di base necessarie per creare plugin funzionali, sicuri e affidabili. Ricorda che un plugin di qualità deriva da una struttura del codice chiara, da procedure di sicurezza rigorose e da un’esperienza utente curata. Il modo migliore per proseguire nel tuo apprendimento è ora metterti all’opera, iniziando con lo sviluppo di plugin che risolvano problemi pratici, per poi esplorare gradualmente API e funzionalità più complesse.

FAQ - Domande frequenti

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

È necessario padroneggiare il linguaggio di programmazione PHP, che rappresenta il nucleo dello sviluppo di WordPress. Inoltre, è fondamentale avere una conoscenza di base di HTML, CSS e JavaScript per gestire la visualizzazione e l’interazione dell’interfaccia utente. È utile anche essere familiari con i concetti di base dei database MySQL (come le operazioni CRUD), poiché WordPress li utilizza per archiviare i dati. Infine, è essenziale comprendere l’architettura di base di WordPress e il suo flusso di lavoro.

Come devo debuggare il mio plugin per WordPress?

Innanzitutto, attiva il modalità di debug di WordPress nel file wp-config.php. define('WP_DEBUG', true); 和 define('WP_DEBUG_LOG', true); Imposta il valore su “true”. In questo modo, i messaggi di errore verranno registrati nel file /wp-content/debug.log, evitando che vengano visualizzati direttamente agli utenti. Inoltre, integrando strumenti di debug professionali come Xdebug con il tuo editor di codice (ad esempio VS Code), è possibile utilizzare funzionalità avanzate come l’impostazione di punti di interruzione e il debug passo dopo passo. In aggiunta, utilizzando i pannelli di rete e console degli strumenti di sviluppo del browser, è possibile verificare le richieste AJAX e gli errori del JavaScript front-end.

Come posso inviare il plugin che ho sviluppato al catalogo ufficiale di plugin di WordPress?

Prima di inviare il tuo plugin, assicurati che esso segua completamente gli standard di codifica ufficiali di WordPress e le migliori pratiche di sviluppo. Effettua inoltre un’attenta revisione del codice e controlli di sicurezza. È necessario registrare un account su WordPress.org per poi inviare il pacchetto compresso del tuo plugin sulla pagina dedicata alle sottomissioni. Il team di revisione esaminerà il codice per verificare la sua sicurezza, la sua conformità alle normative e il rispetto delle linee guida stabilite da WordPress. Una volta superata la revisione, il tuo plugin verrà inserito nel catalogo ufficiale di WordPress, a disposizione di utenti in tutto il mondo per il download e l’installazione.

Come posso aggiungere un’opzione di configurazione al mio plugin nell’editor personalizzato di WordPress?

Il Personalizzatore di WordPress (WordPress Customizer) offre un modo per visualizzare in tempo reale le modifiche apportate alle impostazioni del sito. Puoi utilizzarlo per testare le varie opzioni disponibili prima di applicarle definitivamente. add_action('customize_register', 'your_function'); Gancio… nella funzione di callback. your_function In Cina, attraverso $wp_customize L’oggetto include una sezione (Section), un elemento di configurazione (Setting) e un controllo (Control). Questo consente agli utenti di modificare le impostazioni nell’interfaccia di personalizzazione e di visualizzare immediatamente gli effetti sul front-end, rendendolo particolarmente adatto alla gestione delle impostazioni relative all’aspetto dei temi e dei plugin.