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

Comprendere l’architettura di base di un plugin per WordPress

I plugin per WordPress sono essenzialmente uno o più file PHP che seguono una specifica struttura di denominazione e organizzazione. Essi permettono di estendere o modificare le funzionalità di base di WordPress attraverso il sistema di “hook” (ganci) fornito dal framework stesso. Comprendere questa architettura rappresenta il primo passo verso lo sviluppo di plugin efficaci.

Il plugin più semplice richiede soltanto un file principale e un commento nella parte iniziale del file stesso (noto come “header del plugin”). Questo commento è fondamentale affinché WordPress possa riconoscere il plugin e deve essere posizionato all’inizio del file PHP principale. Ad esempio, un plugin chiamato…my-first-plugin.phpIl contenuto del file in questione dovrebbe iniziare con quanto segue:

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

Questo commento indica al backend di gestione dei plugin di WordPress che si tratta di un plugin chiamato “Il mio primo plugin”. Creare questo file e inserirlo nella giusta posizione all’interno del sistema di WordPress./wp-content/plugins/my-first-plugin/Dopo aver creato il file di catalogo, potrete trovarlo sulla pagina “Plugin” nell’interfaccia amministrativa di WordPress e attivarlo o disattivarlo a seconda delle vostre esigenze.

Si consiglia di leggere Imparare dall'inizio lo sviluppo di plugin per WordPress: creare la tua prima funzionalità personalizzata.。

Il principio di funzionamento fondamentale del plugin si basa sugli “hook” (ganci). Esistono due tipi di hook: gli Action hook e i Filter hook. Gli Action hook ti permettono di eseguire codice personalizzato in momenti specifici, ad esempio al momento della pubblicazione di un articolo o del caricamento di una pagina. Gli Filter hook, invece, ti consentono di modificare i dati generati durante il processo (ad esempio il contenuto dell’articolo o il suo titolo). Il codice del tuo plugin si basa principalmente sull’utilizzo di questi hook.add_action()和add_filter()Queste due funzioni vengono “montate” (ovvero integrate) in questi punti di interazione (hook).

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

Configura il tuo primo ambiente di sviluppo per plugin.

Prima di iniziare a scrivere il codice, avere un ambiente di sviluppo locale affidabile è di fondamentale importanza. Ti permetterà di eseguire test e debug in modo sicuro.

Scegliere gli strumenti giusti per il server locale.

Si consiglia l’utilizzo di soluzioni basate su server locali integrate, come Local by Flywheel, XAMPP o MAMP. Queste permettono di installare in un solo passo un ambiente completo che include PHP, MySQL nonché Apache/Nginx, semplificando notevolmente il processo di configurazione. In particolare, Local by Flywheel offre un supporto particolarmente ottimizzato per WordPress, facilitando la creazione e la clonazione di siti web basati su questo framework.

Inizializzare la directory e i file del plugin.

Sul tuo sito WordPress locale…wp-content/plugins/All’interno del directory, crea una cartella separata per il tuo plugin. Il nome della cartella dovrebbe essere composto da lettere minuscole, numeri e trattini, e dovrebbe essere il più possibile in linea con il nome del file principale del plugin. Ad esempio:greeting-pluginE creare al suo interno il file principale.greeting-plugin.php。

Per garantire una chiara organizzazione del codice, si consiglia di adottare una struttura modulare fin dall’inizio. Un catalogo di plugin di base potrebbe apparire come segue:

Si consiglia di leggere Analisi approfondita dello sviluppo di plugin per WordPress: dall’approccio base alla personalizzazione efficiente。

greeting-plugin/
├── greeting-plugin.php      // 主文件，包含插件头部注释和核心逻辑
├── includes/                // 存放核心功能类或函数文件
├── admin/                   // 存放后台管理界面相关文件
├── public/                  // 存放前端功能相关文件
├── assets/                  // 存放CSS、JavaScript和图片资源
│   ├── css/
│   ├── js/
│   └── images/
└── languages/               // 存放国际化翻译文件（可选）

Implementare le funzionalità principali e la gestione del backend.

Analizziamo un esempio concreto per mettere in pratica quanto appreso: creiamo un plugin in grado di visualizzare saluti personalizzati sulla pagina principale di un sito web, permettendo agli utenti di modificare il testo del saluto direttamente dall’area di amministrazione.

Creare funzioni per le funzionalità di base.

Innanzitutto, nel file principale…greeting-plugin.phpSotto i commenti in testa, scrivere una funzione principale che esegua la funzionalità principale. Questa funzione…display_greeting()Utilizzato per ottenere i saluti da visualizzare.

function display_greeting() {
    // 从WordPress选项中获取存储的问候语，默认为“欢迎光临！”
    $greeting_text = get_option('my_greeting_text', '欢迎光临！');
    // 将问候语进行安全转义后返回
    return '<p class="custom-greeting">'`. esc_html($greeting_text)`.'</p>';
}

Per far apparire questo saluto dopo il contenuto dell’articolo, dobbiamo utilizzare un “action hook”.the_contentCreiamo una nuova funzione.append_greeting_to_content()E montarlo su quel gancio.

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 append_greeting_to_content( $content ) {
    // 只在单篇文章和页面中追加问候语
    if ( is_single() || is_page() ) {
        $content .= display_greeting();
    }
    return $content;
}
// 将函数挂载到‘the_content’过滤器
add_filter( 'the_content', 'append_greeting_to_content' );

Aggiungere il menu di gestione dei plugin e la pagina di configurazione.

Per permettere agli utenti di personalizzare i messaggi di saluto, dobbiamo aggiungere una pagina di configurazione nel backend di WordPress. Questo viene solitamente fatto…admin/Per gestire i file in modo separato, è possibile creare un file distinto all’interno di un sottodiretorio. Ad esempio:admin/settings-page.php。

Prima di tutto, utilizzalo nel file principale.add_action()Carica una funzione che crea un menu di gestione.

// 仅在后台加载时引入管理页面代码
if ( is_admin() ) {
    require_once plugin_dir_path( __FILE__ ) . 'admin/settings-page.php';
}

在admin/settings-page.phpNel file, abbiamo scritto la logica per creare i menu e gestire i moduli. La funzione chiave è…add_options_page()。

Si consiglia di leggere Iniziare da zero: creare il tuo primo plug-in WordPress.。

function my_greeting_add_admin_menu() {
    add_options_page(
        '问候语设置',          // 页面标题
        '自定义问候语',        // 菜单标题
        'manage_options',      // 所需权限
        'greeting-settings',   // 菜单slug
        'my_greeting_settings_page' // 用于显示页面内容的回调函数
    );
}
add_action( 'admin_menu', 'my_greeting_add_admin_menu' );

function my_greeting_settings_page() {
    ?>
    <div class="wrap">
        <h1>Impostazioni dei saluti</h1>
        <form method="post" action="/it/options.php/" data-trp-original-action="options.php">
            <?php
            settings_fields( 'greeting_settings_group' ); // 设置组名
            do_settings_sections( 'greeting-settings' ); // 页面slug
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="it"/></form>
    </div>
    &lt;?php
}

Successivamente, dobbiamo registrare un’opzione di configurazione.my_greeting_textE aggiungiamo un campo di input per esso. Questo viene realizzato…register_setting()、add_settings_section()和add_settings_field()La funzione è stata completata.

function my_greeting_settings_init() {
    register_setting( 'greeting_settings_group', 'my_greeting_text' );

add_settings_section(
        'greeting_settings_section',
        '编辑问候文本',
        null,
        'greeting-settings'
    );

add_settings_field(
        'my_greeting_field',
        '问候语内容',
        'my_greeting_field_render',
        'greeting-settings',
        'greeting_settings_section'
    );
}
function my_greeting_field_render() {
    $value = get_option( 'my_greeting_text', '欢迎光临！' );
    echo '<input type="text" name="my_greeting_text" value="' . esc_attr( $value ) . '" class="regular-text">';
}
add_action( 'admin_init', 'my_greeting_settings_init' );

Ora, gli utenti possono modificare il testo sulla pagina “Impostazioni” -> “Saluti personalizzati”. Il nuovo saluto verrà visualizzato alla fine degli articoli e dei contenuti delle pagine visualizzati dall’interfaccia 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

Sicurezza dei plugin, ottimizzazione e preparazione alla pubblicazione

Un plugin qualificato non deve solo funzionare correttamente, ma deve anche essere sicuro, efficiente e facile da mantenere.

Attuare le migliori pratiche di sicurezza

La sicurezza è un fattore di primaria importanza. Tutti i dati ottenuti dall’input degli utenti o dal database e visualizzati sul front-end devono essere opportunamente “escapati” (cioè modificati in modo da evitare problemi legati all’interpretazione errata dei caratteri). Per farlo, si possono utilizzare le funzioni fornite da WordPress.esc_html()、esc_attr()、wp_kses_post()Etc. Quando si gestiscono i processi di invio di moduli e le richieste non AJAX, è essenziale utilizzare…wp_verify_nonce()和check_admin_referer()Questo passaggio serve a verificare la legittimità della richiesta, al fine di prevenire attacchi di tipo Cross-Site Request Forgery (CSRF).

Per qualsiasi script front-end o foglio di stile introdotto tramite un plugin, è obbligatorio utilizzare…wp_enqueue_script()和wp_enqueue_style()Esegui la registrazione e il caricamento correttamente: questo garantirà che le dipendenze siano gestite correttamente e eviterà eventuali conflitti. Inoltre, utilizza questi procedimenti per i tuoi oggetti di script.wp_localize_script()Come trasmettere in modo sicuro una variabile PHP a JavaScript?

Effettuare l'internazionalizzazione e la localizzazione.

Per permettere all’plugin di essere utilizzato da utenti in tutto il mondo, è essenziale supportare la funzionalità di internazionalizzazione. Ciò significa che devi tradurre tutte le stringhe di testo destinate agli utenti presenti nell’plugin in diverse lingue.__()或_e()Incapsula le funzioni di traduzione in una classe o struttura appropriata. Aggiungi delle note nella parte iniziale del file principale per spiegare l’uso di tali funzioni.Text DomainDeve essere identico al nome della directory dei plugin. Ad esempio:
Text Domain: greeting-plugin

Poi, puoi utilizzare uno strumento di traduzione (come Poedit) per generare il risultato..potFile di template: i traduttori possono utilizzarli per creare i contenuti desiderati..po和.moIl file viene salvato all’interno del plugin stesso.languages/Nella cartella.

Pronto per la pubblicazione nel catalogo ufficiale di WordPress.

Se pianificate di inviare il plugin al catalogo di plugin di WordPress.org, è necessario prepararsi adeguatamente. Prima di tutto, assicuratevi che il codice segua gli standard di codifica di WordPress. Inoltre, create un documento dettagliato che descriva tutte le funzionalità del plugin, i suoi requisiti tecnici e i passaggi necessari per il suo utilizzo. Questo documento sarà utile per gli sviluppatori e gli utenti di WordPress che potrebbero aver bisogno di informazioni aggiuntive sul plugin.readme.txtIl file deve essere conforme ai requisiti del catalogo e contenere una descrizione, istruzioni per l’installazione, screenshot, log degli aggiornamenti, ecc. Inoltre, è necessario inviare il plugin al repository SVN e assicurarsi che la struttura del directory sia conforme alle normative. Prima della pubblicazione, è fondamentale eseguire test di compatibilità approfonditi tra diverse versioni, diversi temi e altri plugin.

Riassumendo

Lo sviluppo di plugin per WordPress rappresenta un processo che trasforma le idee in funzionalità pratiche; il suo nucleo risiede nella comprensione e nell’uso efficace del sistema di “hook” (meccanismi di interazione tra moduli del framework). Partendo dalla creazione di un singolo file contenente le giuste annotazioni di intestazione, si procede gradualmente alla costruzione di moduli funzionali, seguendo rigorosamente standard di codifica sicura e internazionalizzazione. In questo modo, è possibile creare plugin professionali e affidabili. Praticando l’intero processo – dall’installazione di un ambiente locale, all’organizzazione modulare del codice, all’implementazione dell’interazione tra interfaccia utente e server, fino alla preparazione della pubblicazione del plugin – si acquisiscono le competenze di base per svilupparli da zero. Continuare a studiare l’API di base di WordPress e analizzare in profondità il codice sorgente dei plugin di qualità rappresenta il modo migliore per migliorare le proprie abilità di sviluppo.

FAQ - Domande frequenti

Per sviluppare plugin, è necessario essere esperti di PHP?

Sì, è essenziale disporre di una solida conoscenza di PHP. WordPress è infatti scritto in PHP, e lo stesso vale per il codice dei plugin. È necessario comprendere la grammatica di PHP, le funzioni, la programmazione orientata agli oggetti, nonché il modo in cui interagire con i database MySQL. Inoltre, una conoscenza di base di HTML, CSS e JavaScript è molto utile per creare interfacce utente efficaci.

Come devo debuggare il mio plugin?

WordPress offre diversi strumenti per il debug. Innanzitutto, nel tuo…wp-config.phpAbilita il modalità di debug nel file.WP_DEBUGLa costante è impostata sutrueQuesto visualizzerà sugli schermi errori, avvertimenti e notifiche PHP. È anche possibile utilizzare…error_log()La funzione registra le informazioni personalizzate nel log di errore del server, oppure utilizza strumenti più avanzati come il plugin Query Monitor, in grado di analizzare le query al database, gli script e altri elementi del sistema. Questi strumenti rappresentano veri e propri ausili per gli sviluppatori.

Il mio plugin potrebbe causare conflitti con il tema attualmente in uso o con altri plugin installati sul sito?

È possibile. I conflitti si verificano solitamente per i seguenti motivi: utilizzo di nomi di funzioni, classi o costanti comuni; sovrapposizione tra script e fogli di stile caricati; o gestione impropria delle priorità dei diversi “hook” (meccanismi di interazione). Per evitare tali conflitti, è consigliabile assegnare a tutte le funzioni, classi e costanti un prefisso unico, solitamente legato al nome del plugin o a un’abbreviazione relativa a esso.wp_enqueue_scriptLe funzioni di serie permettono di gestire correttamente il ciclo di vita degli asset. Quando si modifica il comportamento principale di un sistema, è importante prendere in considerazione con attenzione la priorità e le dipendenze dei vari “hook” (meccanismi di interazione tra componenti).

Devo creare un database indipendente per il mio plugin?

Nella stragrande maggioranza dei casi, non è necessario né consigliabile creare nuove tabelle di database. WordPress offre due potenti API: l’Options API (utilizzata per memorizzare coppie chiave-valore) e l’Post Meta/User Meta API (per archiviare dati relativi agli articoli e agli utenti), in grado di soddisfare le esigenze di archiviazione di dati anche in quantità molto elevate (superiori a 90%). L’utilizzo di nuove tabelle di database dovrebbe essere preso in considerazione soltanto quando è necessario memorizzare un gran numero di dati con relazioni complesse e quando si richiedono query efficienti.$wpdbLa creazione di classi per generare tabelle personalizzate aumenta notevolmente la complessità del plugin.

Come posso aggiungere opzioni di configurazione al mio plugin?

Come già accennato in precedenza, la prassi standard consiste nell’utilizzare l’API Settings di WordPress. Quest’API si occupa di aspetti legati alla sicurezza (ad esempio, la verifica dei “nonce”), al controllo degli accessi degli utenti e alla rendering dell’interfaccia utente. I passaggi da seguire includono:add_menu_page()o le sue funzioni derivate (ad esempio)...add_options_page()Aggiungi i menu e le pagine, e poi utilizzali.register_setting()、add_settings_section()和add_settings_field()Per definire e visualizzare i campi di configurazione specifici, si utilizza un approccio più sicuro e standardizzato rispetto alla creazione manuale dei moduli e al trattamento delle richieste di invio.