Sviluppo di plugin per WordPress: dall’approccio base alla maestria: impara passo dopo passo a creare le tue funzionalità personalizzate

Nel mondo di Internet di oggi, WordPress occupa una posizione di rilievo grazie alla sua notevole estensibilità. Uno dei suoi punti di forza principali è il meccanismo dei plugin, che consente agli sviluppatori di aggiungere quasi qualsiasi funzionalità al sito. Sia che si tratti di semplici strumenti basati su codici brevi che di funzionalità avanzate per i sistemi di gestione dei contenuti, tutto può essere realizzato tramite plugin ben progettati. Acquisire competenze nella sviluppo di plugin significa non solo essere in grado di creare soluzioni personalizzate per i propri progetti o per quelli dei clienti, ma anche di trasformare le proprie idee in prodotti commercializzabili, entrando così in un vasto e dinamico mercato.

Ambiente di sviluppo per plugin e fondamenti di base

Prima di iniziare a scrivere un plugin per WordPress, è essenziale disporre di un ambiente di sviluppo locale stabile ed efficiente. Consigliamo l’uso di strumenti come Local by Flywheel, Laragon o Docker per creare rapidamente un ambiente WordPress che includa PHP, MySQL e Apache/Nginx. Questo ti permetterà di eseguire test e debug in un ambiente sicuro e isolato.

Crea il tuo primo file di plugin.

Un plugin può essere semplicissimo, costituito da un unico file, ma per motivi di standardizzazione, inizieremo da una struttura di base. Entriamo nel directory di installazione di WordPress… wp-content/plugins Cestino: crea un nuovo cestino, ad esempio… my-first-plugin。

Si consiglia di leggere Guida introduttiva allo sviluppo di plugin per WordPress: crea la tua prima estensione funzionale da zero.。

In questa cartella, crea un file principale per il plugin, che di solito prende il nome dello stesso plugin, ad esempio: my-first-plugin.phpOgni plugin deve contenere un commento nella parte iniziale del codice (header) che segua lo standard specificato da WordPress; questa è l’unica modalità con cui WordPress può riconoscere le informazioni relative al plugin.

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

<?php
/**
 * Plugin Name: 我的第一个插件
 * Plugin URI:  https://yourwebsite.com/my-first-plugin
 * Description: 这是一个用于学习 WordPress 插件开发的基础插件。
 * Version:     1.0.0
 * Author:      你的名字
 * License:     GPL v2 or later
 * Text Domain: my-first-plugin
 */

Dopo aver salvato il file, accedi alla pagina “Plugin” nell’interfaccia di amministrazione di WordPress e dovresti vedere il tuo plugin nell’elenco dei plugin disponibili. Puoi attivarlo come fai con qualsiasi altro plugin. Anche se al momento non dispone di alcuna funzionalità, hai comunque compiuto il primo passo con successo. Per lo sviluppo futuro, ti consigliamo di creare una struttura di cartelle chiara all’interno della cartella dei plugin. admin/(Codice correlato al backend)public/(Codice relativo al front-end)includes/(Funzioni chiave e librerie di classi), nonché per l’archiviazione dei file di JavaScript e CSS. assets/ 文件夹。

Core development concepts: Hooks and actions

Dopo aver compreso la struttura di base dei plugin, dobbiamo approfondire l’essenza del sistema di plugin di WordPress: i “Hook” (Ganci). I Hook si dividono in due tipi: le “Actions” (Azioni) e i “Filters” (Filtri). Essi rappresentano il cuore dell’architettura basata sugli eventi di WordPress, permettendo al tuo codice di essere eseguito in momenti specifici all’interno del flusso principale di funzionamento di WordPress.

Comprendere i “action hooks” (ganci di azione)

Gli “action hooks” permettono di eseguire codice personalizzato in momenti specifici del ciclo di vita di WordPress. Ad esempio, WordPress attiva gli action hooks dopo la pubblicazione di un articolo o quando un utente si collega al sito.

Usare add_action() Una funzione può essere utilizzata per “montare” un’altra funzione su un determinato “hook” (punto di interazione specifico nel sistema). La sintassi di base è la seguente:add_action( ‘hook_name’, ‘your_function_name’, priority, accepted_args );Aggiungiamo una riga di testo personalizzato alla parte inferiore della pagina del sito web.

Si consiglia di leggere Sviluppo di plugin per WordPress: Da principianti a esperti: Una guida completa per creare moduli con funzionalità altamente personalizzabili。

function myplugin_add_footer_text() {
    echo '<p id="custom-footer">Grazie per aver utilizzato il nostro sito web! Questo contenuto è stato aggiunto dal mio plugin.</p>';
}
add_action( ‘wp_footer’, ‘myplugin_add_footer_text’ );

Dopo aver attivato il plugin contenente il codice sopra menzionato, noterai che questo testo viene aggiunto nella sezione del piede di pagina (footer) del sito web. Questo rappresenta un esempio tipico dell’utilizzo dei cosiddetti “action hooks”: si esegue del codice in posizioni specifiche del sito, senza modificare i dati originali, ma semplicemente effettuando operazioni di “output” o di esecuzione.

Imparare a utilizzare i “filter hooks”.

A differenza delle azioni, gli “hook” dei filtri vengono utilizzati per modificare i dati. Ti permettono di alterarli prima che vengano utilizzati (ad esempio, prima di essere salvati in un database o visualizzati in un browser). WordPress invia i dati a te attraverso questi filtri; dopo le modifiche che hai apportato, i dati vengono restituiti.

Usare add_filter() Esistono funzioni per applicare filtri. Ad esempio, se vogliamo modificare la fine del titolo di un articolo aggiungendogli un suffisso personalizzato.

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 myplugin_modify_title( $title ) {
    // 确保只在主循环且在前端单篇文章页面修改
    if ( is_single() && in_the_loop() ) {
        return $title . ‘ - 精彩内容’;
    }
    return $title;
}
add_filter( ‘the_title’, ‘myplugin_modify_title’ );

In questo esempio,the_title Il filtro mostra il titolo dell’articolo attuale. $title La funzione che ti viene passata… myplugin_modify_titleDopo che hai modificato la stringa e ne hai restituito una nuova, WordPress utilizzerà il valore modificato per l’output. Comprendere e utilizzare correttamente gli “action” (azioni) e i “filter” (filtri) è fondamentale per sfruttare appieno le infinite possibilità di personalizzazione offerte da WordPress.

Creare funzionalità per plugin: aggiungere un menu di gestione e opzioni.

Un plugin maturo dovrebbe disporre di una propria pagina di configurazione all’interno dell’interfaccia di amministrazione di WordPress, che permetta agli utenti di impostare le varie opzioni. Questo richiede l’utilizzo dell’API dei menu di WordPress.

Creare il menu di gestione di livello superiore

Puoi utilizzare… add_menu_page() La funzione aggiunge un elemento di menu di livello superiore al tuo plugin. Definisce il titolo del menu, i permessi necessari per accedervi, il segmento di URL relativo alla pagina da visualizzare, nonché una funzione di callback che verrà eseguita per mostrare il contenuto della pagina stessa.

Si consiglia di leggere Guida introduttiva allo sviluppo di plugin per WordPress: crea la tua prima estensione funzionale da zero.。

function myplugin_add_admin_menu() {
    add_menu_page(
        ‘我的插件设置’, // 页面标题
        ‘我的插件’, // 菜单标题
        ‘manage_options’, // 所需权限（管理员）
        ‘myplugin-settings’, // 菜单 Slug
        ‘myplugin_display_settings_page’, // 显示页面的函数
        ‘dashicons-admin-generic’, // 菜单图标（Dashicon）
        100 // 菜单位置
    );
}
add_action( ‘admin_menu’, ‘myplugin_add_admin_menu’ );

function myplugin_display_settings_page() {
    ?>
    <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( ‘myplugin_options_group’ );
            do_settings_sections( ‘myplugin-settings’ );
            submit_button( ‘保存设置’ );
            ?>
        <input type="hidden" name="trp-form-language" value="it"/></form>
    </div>
    &lt;?php
}

Aggiungi il codice sopra al tuo plugin; una volta attivato, vedrai un nuovo menu denominato “I miei plugin” sul lato sinistro del pannello di amministrazione di WordPress. Cliccandoci, accederai alla sezione dedicata al tuo plugin. myplugin_display_settings_page Pagina generata dalla funzione di rendering.

Utilizzare l’API di configurazione per registrare le opzioni.

L’elaborazione e la verifica manuale dei dati inviati tramite moduli sono operazioni complesse e poco sicure. WordPress offre un potente API per le Impostazioni (Settings API) che semplifica questo processo: si occupa della verifica dei dati inviati tramite il meccanismo “nonce”, del controllo degli accessi e dell’archiviazione dei dati.

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

Prima di tutto, è necessario utilizzare… register_setting() Registra i tuoi gruppi di impostazioni e i campi, utilizzando… add_settings_section() Aggiungi una zona di configurazione e utilizzala. add_settings_field() Aggiungi i campi specifici.

function myplugin_register_settings() {
    // 注册一组设置，数据将保存在 `myplugin_options` 选项中
    register_setting(
        ‘myplugin_options_group’, // 设置组名，与 settings_fields() 对应
        ‘myplugin_options’, // 选项名
        ‘myplugin_sanitize_callback’ // 数据清理回调函数（可选但推荐）
    );

// 添加一个设置区域
    add_settings_section(
        ‘myplugin_main_section’,
        ‘主要设置’,
        null, // 区域描述的回调函数
        ‘myplugin-settings’ // 页面 Slug
    );

// 在区域中添加一个文本字段
    add_settings_field(
        ‘myplugin_text_field’,
        ‘欢迎语’,
        ‘myplugin_text_field_render’, // 渲染字段输入框的函数
        ‘myplugin-settings’,
        ‘myplugin_main_section’
    );
}
add_action( ‘admin_init’, ‘myplugin_register_settings’ );

function myplugin_text_field_render() {
    $options = get_option( ‘myplugin_options’ );
    $value = $options[‘myplugin_text_field’] ?? ‘’;
    ?>
    <input type=“text” name=“myplugin_options[myplugin_text_field]” value=“<?php echo esc_attr( $value ); ?>”>
    <?php
}

function myplugin_sanitize_callback( $input ) {
    // 清理和验证输入数据
    $sanitized_input = [];
    if ( isset( $input[‘myplugin_text_field’] ) ) {
        $sanitized_input[‘myplugin_text_field’] = sanitize_text_field( $input[‘myplugin_text_field’] );
    }
    return $sanitized_input;
}

Ora, la tua pagina di configurazione dispone di un campo di testo dotato di funzionalità di verifica e salvataggio dei dati. Attraverso l’API Settings, puoi creare interfacce di configurazione complesse in modo sicuro ed efficiente.

Pubblicazione e manutenzione di plugin

Quando le funzionalità del tuo plugin saranno complete e avranno superato test approfonditi, potrai considerare la possibilità di condividerlo con un numero maggiore di persone. Questo richiederà l’internazionalizzazione del codice, il rafforzamento delle misure di sicurezza e la preparazione per il suo rilascio.

Realizzare l'internazionalizzazione del plug-in.

Per permettere ai tuoi plugin di essere utilizzati anche da utenti non cinesi, è necessario avvolgere tutte le stringhe destinate all’utente utilizzando le funzioni di internazionalizzazione (i18n) di WordPress. __() Utilizzato per visualizzare il risultato della traduzione._e() Utilizzato per l’output diretto della traduzione.

Innanzitutto, modifica tutte le stringhe presenti nel tuo codice:

// 在插件头部注释中，确保 Text Domain 正确
// 在代码中
function myplugin_display_settings_page() {
    ?>
    <h1><?php _e( ‘我的插件设置’, ‘my-first-plugin’ ); ?></h1>
    &lt;?php
}

Successivamente, utilizza uno strumento simile a Poedit per analizzare il codice del tuo plugin e generare il contenuto necessario. .pot(Template) file, and create it for the base language (such as English). .po E quello compilato… .mo File: Posizionare questi file linguistici all’interno del plugin. languages/ Nel folder contenente i file di traduzione, WordPress caricherà automaticamente le traduzioni corrispondenti in base alle impostazioni linguistiche del sito.

Garantire la sicurezza e le prestazioni del codice

Prima della pubblicazione, è essenziale verificare la sicurezza del codice. Utilizzate le funzioni di pulizia fornite da WordPress per tutti i dati inseriti dagli utenti e per i risultati visualizzati, come previsto dalla documentazione ufficiale di WordPress. esc_html(), esc_attr(), sanitize_text_field() 和 wp_kses_post()Durante le query al database, utilizzare… $wpdb I metodi di una classe… WP_QueryEvitare di concatenare direttamente le istruzioni SQL per prevenire attacchi di iniezione (SQL injection).

Allo stesso tempo, prestare attenzione all’ottimizzazione delle prestazioni: utilizza gli “hook” in modo appropriato per evitare che vengano eseguite molte operazioni non necessarie ad ogni caricamento della pagina. Per i risultati di query complesse, considera l’uso dell’API “Transients” di WordPress per il caching, ad esempio… set_transient() 和 get_transient()。

Infine, segui le linee guida ufficiali di WordPress per lo sviluppo di plugin e la struttura del loro catalogo, e redigi documentazioni chiare nonché un file README. Puoi scegliere di inviare il tuo plugin al catalogo ufficiale di WordPress.org: in questo modo, gli utenti potranno cercarlo e installarlo direttamente dall’interfaccia di amministrazione, ricevendo anche aggiornamenti automatici.

Riassumendo

Lo sviluppo di plugin per WordPress è un processo sistematico che inizia con la comprensione della sua struttura di base, per poi passare alla padronanza del sistema di “hook” (meccanismi di interazione tra moduli del sito) e della creazione di interfacce di gestione, al fine di realizzare plugin sicuri e internazionalizzabili. Attraverso questo articolo, hai imparato a creare il tuo primo plugin “vuoto”, a estenderne le funzionalità utilizzando gli “action hook” e i “filter hook”, a costruire pagine di configurazione avanzate tramite l’API Settings, e infine a conoscere i passaggi necessari prima della pubblicazione del plugin stesso. Ricorda: la chiave è la pratica. Partendo da un’idea semplice e iterando gradualmente, sfruttando appieno l’ampio API fornito da WordPress nonché le risorse della comunità, sarai in grado di creare plugin personalizzati e professionali, che ti permetteranno di modificare in modo significativo il tuo sito WordPress o addirittura di sviluppare prodotti di valore.

FAQ - Domande frequenti

Quali sono le conoscenze preliminari necessarie per sviluppare plugin per WordPress?

È necessario disporre di conoscenze di base di programmazione in PHP, inclusi i concetti di variabili, funzioni, array e programmazione orientata agli oggetti. È altrettanto importante avere una conoscenza di base di HTML, CSS e JavaScript, poiché sarà necessario gestire l’aspetto visivo e le interazioni dell’interfaccia utente. Essere familiari con le operazioni di base di WordPress e con l’interfaccia di back-end rappresenta una condizione preliminare per comprendere l’ambiente in cui funzionano i plugin.

Qual è la differenza tra i plugin e i temi? Quando si dovrebbe sviluppare un plugin?

I temi (themes) controllano principalmente l’aspetto e la disposizione del sito web, mentre i plugin (plugins) servono ad aggiungere funzionalità. Un semplice principio per distinguere tra i due è il seguente: se una funzionalità è strettamente legata al design visivo del sito, probabilmente appartiene ai temi; se invece è indipendente e può essere utilizzata anche dopo aver cambiato tema (ad esempio, moduli di contatto, ottimizzazione SEO, caching), allora dovrebbe essere sviluppata come plugin. Seguendo il principio di separazione “le funzionalità con i plugin, lo stile con i temi”, si facilita la manutenzione e l’aggiornamento a lungo termine del sito web.

Come devo debuggare il mio plugin per WordPress?

Prima di tutto, wp-config.php Attiva il modalità di debug di WordPress nel file. WP_DEBUG La costante è impostata su trueQuesto comporterà l’visualizzazione degli errori, degli avvisi e delle notifiche PHP sulla pagina. In secondo luogo, utilizzare… error_log() La funzione scrive informazioni di debug personalizzate nel log di errore del server. Per logiche complesse, è possibile utilizzare strumenti di debug professionali come Xdebug, abbinandoli alle impostazioni dell’IDE per eseguire il debug passo dopo passo. Le schede “Console” e “Network” presenti negli strumenti di sviluppo del browser rappresentano strumenti molto utili per il debug del JavaScript front-end e delle richieste AJAX.

Come posso garantire che il mio plugin sia compatibile con altri plugin?

Per massimizzare la compatibilità, il tuo plugin dovrebbe utilizzare un prefisso unico per denominare tutte le funzioni, le classi, le costanti, i nomi delle opzioni e le tabelle del database. Questo permetterà di evitare conflitti di nomi. Utilizza con cautela le variabili globali. Quando aggiungi dei “hook” (meccanismi di interazione con il sistema), imposta correttamente i parametri di priorità per garantire che l’ordine di esecuzione sia conforme alle tue aspettative. Per i dati condivisi che potrebbero essere modificati da altri plugin, assicurati che il tuo codice sia abbastanza robusto da gestire tutte le possibili situazioni di input. Prima di pubblicare il plugin, effettua test in diversi ambienti e con combinazioni di plugin comuni.

Come posso aggiungere tabelle di database personalizzate al mio plugin?

Sebbene WordPress offra… wp_options Per la configurazione dello storage dei dati in tabella, per grandi quantità di informazioni strutturate, l’utilizzo di tabelle di database personalizzate offre prestazioni migliori. È possibile configurare questo comportamento utilizzando gli hook di attivazione dei plugin. register_activation_hook() Nel processo di registrazione delle funzioni, è necessario scrivere il codice SQL per creare la tabella. Assicuratevi di utilizzare i comandi appropriati per creare, modificare o eliminare le tabelle nel database. $wpdb->prefix Per ottenere il prefisso corretto e utilizzarlo… dbDelta() Esiste una funzione che permette di eseguire operazioni di creazione o aggiornamento di tabelle, in grado di gestire in modo intelligente eventuali differenze nella struttura delle tabelle stesse. Inoltre, è necessario prendere in considerazione il modo in cui questi dati vengono eliminati quando il plugin viene disinstallato, offrendo all’utente la possibilità di scegliere come procedere.