Guida introduttiva allo sviluppo di plugin per WordPress: crea il tuo primo plugin personalizzato da zero.

Preparazione dell’ambiente per lo sviluppo di plugin per WordPress

Prima di iniziare a scrivere il codice, è necessario disporre di un ambiente di sviluppo appropriato. Questo non solo migliora l’efficienza dello sviluppo, ma aiuta anche a effettuare il debug e i test dei plugin in modo più efficace. Per prima cosa, è necessario configurare un ambiente di esecuzione di WordPress sul proprio computer locale. È possibile utilizzare ambienti di sviluppo integrati come XAMPP, MAMP o Local by Flywheel, che consentono di installare rapidamente PHP, MySQL e i server Apache/Nginx. Per quanto riguarda i file del core di WordPress, si consiglia di scaricare e installare la versione più recente e stabile dal sito ufficiale.

Assicurati che la tua versione di PHP soddisfi i requisiti minimi di WordPress e abilita la funzionalità di reporting degli errori: questa è essenziale per il debug. Puoi farlo tramite le impostazioni di PHP o utilizzando strumenti specifici forniti da WordPress stesso.wp-config.phpAggiungi il seguente codice al file per attivare il modalità di debug:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true); // 将错误记录到 /wp-content/debug.log
define('WP_DEBUG_DISPLAY', false); // 不在页面上显示错误

Inoltre, un potente editor di codice è essenziale, come Visual Studio Code, PhpStorm o Sublime Text. Questi editor offrono solitamente funzionalità come l’highlighting del codice, suggerimenti automatici e integrazione con i sistemi di controllo delle versioni, il che migliora notevolmente l’esperienza di sviluppo. Infine, si consiglia di installare gli strumenti per sviluppatori nel browser e di considerare l’utilizzo di estensioni appositamente progettate per WordPress, per facilitare il controllo dei “hook”, le query al database e il monitoraggio delle prestazioni del sito.

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

Crea il tuo primo file di plugin.

La forma più basilare di un plugin per WordPress è un file PHP. Tutti i plugin vengono archiviati in una specifica directory all’interno del sito web./wp-content/plugins/All’interno del directory, ogni plugin può essere un file PHP indipendente oppure una cartella che contiene più 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

Prima di tutto, crea una cartella unica per il tuo plugin, ad esempio:my-first-pluginAll’interno di questa cartella, creare il file principale del plugin, che di solito prende il nome identico alla cartella stessa.my-first-plugin.phpAll’inizio di questo file deve essere presente una nota di intestazione del plugin che rispetti gli standard di WordPress; tale nota fornisce al sistema WordPress le informazioni di base sul plugin stesso.

Esempio di commento nella parte iniziale del file del plugin principale:

<?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
 */

Il campo “Nome del plugin” è obbligatorio in questa nota; esso determina il nome con cui il plugin verrà visualizzato nell’interfaccia di amministrazione in background. Altre informazioni, come il numero di versione e l’autore, aiutano gli utenti a comprendere meglio le funzionalità del plugin. Dopo aver creato questo file, inseritelo nella giusta directory./wp-content/plugins/my-first-plugin/Indice. In questo momento, accedi al pannello di amministrazione di WordPress e vai alla pagina “Aggiornamenti” (Plugins). Dovresti vedere un nuovo plugin chiamato “Il mio primo plugin personalizzato” e potrai attivarlo. Anche se al momento non fa nulla, hai comunque creato con successo la struttura di base di un plugin.

Gestione dell’attivazione e della disattivazione dei plugin

I plugin spesso necessitano di eseguire operazioni di inizializzazione e pulizia quando vengono attivati o disattivati, ad esempio creare tabelle nel database, impostare opzioni predefinite o eliminare dati temporanei. WordPress gestisce queste attività attraverso due apposite funzionalità chiamate “Hook”.register_activation_hook和register_deactivation_hook。

Si consiglia di leggere Dall'inizio all'eccellenza: guida completa allo sviluppo di plugin per WordPress e migliori pratiche.。

È possibile definire questi “hook” (punti di interazione con il sistema) nel file principale del plugin. Ad esempio, quando il plugin viene attivato, potrebbe essere necessario scrivere un’opzione di configurazione predefinita nel database; quando il plugin viene disattivato, potrebbe essere necessario eliminare tale opzione. Il codice per implementare questa funzionalità è il seguente:

// 定义插件激活时执行的函数
function my_plugin_activate() {
    // 添加一个默认选项到数据库
    add_option('my_plugin_default_option', '这是默认值');
    // 或者可以在这里初始化自定义数据库表（需要更复杂的SQL）
}
register_activation_hook(__FILE__, 'my_plugin_activate');

// 定义插件停用时执行的函数
function my_plugin_deactivate() {
    // 删除之前创建的选项
    delete_option('my_plugin_default_option');
    // 注意：通常不在停用钩子中删除数据，以免用户重新激活时丢失设置
    // 更常见的清理工作在卸载钩子中处理
}
register_deactivation_hook(__FILE__, 'my_plugin_deactivate');

È importante notare che…register_deactivation_hookDi solito viene utilizzato per una pulizia leggera, mentre la cancellazione permanente dei dati (come ad esempio la cancellazione delle tabelle del database) dovrebbe essere gestita nell'hook di disinstallazione, che richiede la funzionalità di disinstallazione.register_uninstall_hookRegistra il tuo plugin. Utilizzando questi “hook” in modo appropriato, potrai garantire che il comportamento del tuo plugin sia conforme alle norme stabilite e che non vengano lasciati dati ridondanti sul sito web.

Comprendere e utilizzare gli “hook” (ganci) e i “filter” (filtri)

Il cuore dello sviluppo di plugin per WordPress risiede nel meccanismo dei “Hook” (Ganci), che ti permette di inserire codice personalizzato in momenti o posizioni specifiche al fine di modificare o estendere le funzionalità di base di WordPress. I Hook si dividono principalmente in due tipi: 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

Gli “action hooks” (ganci di azione) ti permettono di eseguire funzioni personalizzate quando si verificano eventi specifici. Ad esempio, quando un articolo viene pubblicato…publish_post), quando la pagina viene caricata (wp_head) oppure durante l’inizializzazione dall’interfaccia di amministrazione.admin_initPuoi utilizzare…add_action()Ecco una funzione per incollare il tuo codice. Qui c’è un esempio semplice: aggiunge automaticamente un testo personalizzato alla fine di ogni articolo.

function add_custom_footer_to_content($content) {
    if (is_single()) { // 仅在单篇文章页面添加
        $custom_text = '<p><em>Grazie per aver letto questo articolo!</em></p>'// Funzione per aggiungere un testo personalizzato al contenuto del footer del sito web.  
function add_custom_footer_to_content($content) {  
    if (is_home() || is_archive() || is_single() || is_page()) {  
        $custom_text = get_option(‘custom_footer_text');  
        if (isset($custom_text) &amp;&amp; !empty($custom_text)) {  
            $content .= '<p class='custom-footer'>' . $custom_text . '</p>';  
        }  
    }  
    return $content;  
}
// Utilizzare il filtro 'the_content', nota che questo è un esempio di filtro (Filter).  
add_filter('the_content', 'add_custom_footer_to_content');

Come mostrato nel codice sopra, in realtà utilizziamo dei “filter” (filtri). Gli hook dei filtri servono per modificare i dati che vengono passati loro. La principale differenza rispetto alle azioni (actions) è che i filtri devono restituire i valori modificati. Esempi tipici di filtri includono…the_content(Modifica del contenuto dell’articolo)the_title(Modificato il titolo) Eexcerpt_length(Modificato la lunghezza della sintesi). Corrispondente a questo.add_filter()La funzione viene utilizzata per montare le funzioni di filtraggio.

Creare degli hook personalizzati che altri possano estendere.

Un plugin ben progettato non si limita ad utilizzare gli hook del core di WordPress, ma fornisce anche i propri hook personalizzati, al fine di permettere ad altri sviluppatori di estendere le funzionalità del plugin stesso.do_action()I funzioni possono creare un hook di azione, utilizzandoapply_filters()È possibile creare un filtro hook.

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

Ad esempio, prima che il tuo plugin elabori un determinato dato, potresti fornire un filtro che permetta ad altri di modificare i parametri di input.

// 定义插件的主要处理函数
function my_plugin_process_data($input_data) {
    // 在核心处理前，允许其他开发者通过过滤器修改 $input_data
    $filtered_data = apply_filters('my_plugin_filter_input', $input_data);

// ... 使用 $filtered_data 进行核心处理 ...

// 在处理完成后，触发一个动作钩子，通知其他开发者
    do_action('my_plugin_after_processing', $filtered_data);

return $result;
}

Creando hook personalizzati, il tuo plugin diventa estremamente estensibile, seguendo così la filosofia di sviluppo propria 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

Aggiungere una pagina di gestione e opzioni di configurazione per il plugin.

La maggior parte degli plugin pratici richiede un’interfaccia di gestione backend che permetta agli amministratori del sito di configurare le opzioni del plugin. WordPress offre un’ampia gamma di API per creare menu di gestione e pagine di configurazione.

Prima di tutto, è necessario utilizzare…add_action('admin_menu', 'your_function')Il gancio viene utilizzato per registrare una voce di menu. Nella funzione corrispondente, viene utilizzato.add_menu_page()或add_submenu_page()Funzioni per aggiungere menu principali o sottomenu. Ecco un esempio di base per aggiungere un menu principale e impostare la pagina corrispondente:

\n// Incorporare admin_menu per aggiungere il menu di amministrazione
function my_plugin_add_admin_menu() {
    add_menu_page(
        'Impostazioni del mio plugin',   // Titolo della pagina
        'Il mio plugin',   // Titolo del menu
        'manage_options',   // Permessi (amministratore)
        'my-plugin-settings',   // Slug del menu
        'my_plugin_settings_page',   // Funzione di callback per visualizzare il contenuto della pagina
        'dashicons-admin-generic',   // Icona (Dashicon)
        80   // Posizione del menu
    );
}
add_action('admin_menu', 'my_plugin_add_admin_menu');

// Definire il contenuto della pagina delle impostazioni
function my_plugin_settings_page() {
    // Verificare i permessi dell'utente
    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
            // 输出设置字段和非ce字段
            settings_fields('my_plugin_options_group');
            do_settings_sections('my-plugin-settings');
            submit_button('保存设置');
            ?>
        <input type="hidden" name="trp-form-language" value="it"/></form>
    </div>
    &lt;?php
}

Campi per la registrazione e la verifica delle impostazioni

Non basta avere semplicemente una pagina web: è necessario utilizzare l’API dei Settings di WordPress per registrare, memorizzare e verificare in modo sicuro le opzioni di configurazione. Questo processo prevede l’uso di…register_setting()、add_settings_section()和add_settings_field()e altre funzioni.

Il codice seguente mostra come registrare un gruppo di opzioni di configurazione e un campo di testo:

// 初始化插件设置
function my_plugin_settings_init() {
    // 注册一个设置选项组及其数据
    register_setting(
        'my_plugin_options_group', // 选项组名，需与settings_fields()参数一致
        'my_plugin_settings',      // 存储在wp_options表中的选项名
        'my_plugin_sanitize_input' // 可选的验证回调函数
    );

// 添加一个设置区域
    add_settings_section(
        'my_plugin_section_main',
        '主要设置',
        null, // 区域描述的回调函数，可为空
        'my-plugin-settings' // 所属页面的slug
    );

// 向该区域添加一个具体的字段
    add_settings_field(
        'my_plugin_field_text',
        '示例文本字段',
        'my_plugin_field_text_render', // 渲染字段HTML的回调函数
        'my-plugin-settings',
        'my_plugin_section_main'
    );
}
add_action('admin_init', 'my_plugin_settings_init');

// 渲染文本输入字段的函数
function my_plugin_field_text_render() {
    $options = get_option('my_plugin_settings');
    $value = $options['text_field'] ?? ''; // PHP 7.0+ 空合并运算符
    ?>
    <input type='text' name='my_plugin_settings[text_field]' value='<?php echo esc_attr($value); ?>'>
    <?php
}

// 清理和验证输入的函数
function my_plugin_sanitize_input($input) {
    $sanitized_input = [];
    if (isset($input['text_field'])) {
        // 清理文本输入，移除非法标签
        $sanitized_input['text_field'] = sanitize_text_field($input['text_field']);
    }
    return $sanitized_input;
}

Attraverso l’API Settings, WordPress gestisce automaticamente la salvataggio delle opzioni, le verifiche di sicurezza e i controlli sui permessi, semplificando notevolmente il processo di sviluppo e migliorando la sicurezza del sito.

Riassumendo

Attraverso questa guida, abbiamo esaminato in modo sistematico i passaggi principali dello sviluppo di plugin per WordPress: dalla creazione dell’ambiente di sviluppo e dei file di base del plugin, alla comprensione e all’utilizzo del meccanismo dei “hook” (punti di interazione predefiniti dal framework), fino all’aggiunta di un’interfaccia di gestione professionale e di opzioni di configurazione al plugin stesso. Ogni fase dell’iterazione è stata accompagnata da esempi di codice chiave e da pratiche standard. Il cuore dello sviluppo di plugin consiste nell’utilizzare al meglio il vasto sistema di hook di WordPress per estendere le funzionalità del sito, seguendo al contempo le specifiche dell’API per garantire sicurezza e compatibilità. Ricorda che partire da un’idea semplice, aggiungere gradualmente nuove funzionalità e testare accuratamente il plugin durante tutto il processo di sviluppo rappresenta il percorso più efficace per creare plugin di qualità. In seguito, potrai esplorare argomenti più avanzati, come la creazione di tipi di articoli personalizzati, l’aggiunta di “shortcode” (frasi di codice utilizzabili direttamente all’interno del contenuto del sito), la gestione delle richieste AJAX e l’internazionalizzazione del plugin.

FAQ - Domande frequenti

Per sviluppare plugin per WordPress è necessario conoscere bene PHP?

Sì, è essenziale disporre di una solida conoscenza di PHP: il core di WordPress, così come i suoi plugin, sono infatti scritti in PHP. È necessario comprendere la grammatica di PHP, le funzioni, i concetti di programmazione orientata agli oggetti, ecc. Inoltre, avere una conoscenza di base di HTML, CSS e JavaScript è molto utile per creare interfacce utente interattive.

Quanti file deve contenere un plugin?

Non esistono requisiti obbligatori. Un plugin può contenere soltanto un file principale PHP. Tuttavia, man mano che le funzionalità diventano più complesse, diventa più conveniente modularizzare il codice in più file.admin.phpLavoro sul lato backend.public.phpOccuparsi della parte front-end.includesÈ una pratica migliore conservare le funzioni comuni in una cartella, poiché ciò aiuta nell’organizzazione e nella manutenzione del codice.

Perché il mio plug-in provoca una schermata bianca sul sito web dopo l'attivazione?

Di solito ciò è causato da un errore fatale (Fatal Error), come errori di sintassi, chiamate a funzioni o classi non esistenti. Assicurati di aver…wp-config.phpÈ stato attivato.WP_DEBUGModalità… e verifica.wp-content/debug.logInformazioni sull’errore presente nel file: Disabilitare il tuo plugin tramite FTP o un gestore di file (rinominando la cartella contenente il plugin) permetterà di ripristinare rapidamente l’accesso al sito web.

Come gestire in modo sicuro i dati inviati dagli utenti tramite il frontend?

Non si deve mai fidare dei dati inseriti dagli utenti. Prima di elaborare qualsiasi informazione proveniente da moduli, parametri URL o cookie, è necessario effettuare controlli, pulizie dei dati e l’applicazione di opportuni meccanismi di “escape” (per evitare problemi legati alla formattazione dei caratteri). WordPress mette a disposizione un gran numero di funzioni di sicurezza per questo scopo.sanitize_text_field()(Cleaning the text)esc_url()(Escaped URL)wp_kses_post()(Filtrare il contenuto utilizzando gli tag HTML consentiti) eintval()(Convertito in numero intero). Quando si visualizzano i dati su una pagina HTML, è essenziale utilizzare…esc_html()、esc_attr()È necessario eseguire l'escape delle funzioni come, ad esempio, print().

Come posso rendere il testo del mio plugin disponibile in più lingue?

Questo deve essere realizzato attraverso l’internazionalizzazione (i18n). Nel tuo codice, sostituisci tutte le stringhe che devono essere tradotte con i relativi valori in lingue diverse.__()或_e()Incapsulamento della funzione. Successivamente, impostare correttamente le note nella parte iniziale del plugin.Text Domain和Domain PathUtilizzare strumenti come Poedit per creare….potFile di template, e la generazione delle relative versioni in diverse lingue..po和.moIl file di traduzione verrà caricato automaticamente da WordPress in base alle impostazioni di lingua del sito web. WordPress seleziona e applica automaticamente la traduzione corrispondente.