Sviluppo di plugin per WordPress: una guida completa dall'inizio alla perfezione per creare siti web personalizzati.

Perché imparare lo sviluppo di plugin per WordPress?

WordPress, come il sistema di gestione dei contenuti più popolare al mondo, deve la sua notevole estensibilità principalmente al meccanismo dei plugin. Sviluppando plugin personalizzati, gli sviluppatori possono superare i limiti forniti dai temi predefiniti e aggiungere al sito qualsiasi funzionalità sia necessaria, dalle semplici soluzioni basate su “shortcode” fino a sistemi di e-commerce complessi. Acquisire competenze nello sviluppo di plugin significa non solo essere in grado di soddisfare le esigenze di progetti specifici, ma anche di trasformare tali soluzioni in prodotti commerciali, creando valore all’interno dell’ampia ecosistema di WordPress.

Rispetto a quelli che modificano direttamente l’argomento in questione…functions.phpRispetto all’utilizzo di file tradizionali, l’impiego di plugin per incapsulare le funzionalità rappresenta un approccio più professionale e sostenibile. I plugin possono esistere in modo indipendente dai temi (temi di WordPress) facilitando il riutilizzo delle funzionalità, nonché la manutenzione e l’aggiornamento individuali. Un plugin ben strutturato, che segue gli standard di codifica e i principi architetturali di WordPress, garantisce la compatibilità con il core del sistema e con altri plugin.

Dal punto di vista dello sviluppo professionale, sia che si tratti di fornire soluzioni personalizzate ai clienti in qualità di freelance, sia che si tratti di creare plugin commerciali per utenti di tutto il mondo in qualità di product manager, questa competenza presenta un elevato mercato di domanda e un notevole potenziale di monetizzazione.

Si consiglia di leggere Imparare dall'inizio lo sviluppo di plugin per WordPress: creare funzionalità e estensioni personalizzate.。

Configura il tuo ambiente di sviluppo per plugin.

Prima di iniziare a scrivere la prima riga di codice, è fondamentale creare un ambiente di sviluppo locale professionale. Questo ti permetterà di eseguire test e debug in un ambiente sicuro e isolato.

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

Configurazione dell’ambiente del server locale

Si consiglia di utilizzare pacchetti software per server locali integrati, come Local by Flywheel, DevKinsta o XAMPP. Questi strumenti installano in un’unica operazione PHP, MySQL/MariaDB e i server web (come Apache o Nginx). Assicurarsi che il proprio ambiente utilizzi una versione di PHP compatibile o più recente rispetto a quella del proprio ambiente di produzione (ad esempio PHP 7.4 o 8.0+), e che siano abilitate le estensioni necessarie, come MySQLi o PDO.

Editor di codice e strumenti di debug

Scegliete un editor di codice o un ambiente di sviluppo integrato (IDE) dalle funzionalità avanzate. Visual Studio Code, PhpStorm e Sublime Text sono tutte ottime opzioni. Dovrebbero essere dotati di funzionalità come l’highlighting del codice, suggerimenti automatici e integrazione con i sistemi di controllo delle versioni.

La debugging è un passaggio fondamentale nello sviluppo. È essenziale assicurarsi di…wp-config.phpAbilita il modalità di debug di WordPress nel file.WP_DEBUGLa costante è impostata sutrueQuesto permetterà di visualizzare sugli schermi gli errori, gli avvisi e le notifiche di PHP, aiutandoti a individuare rapidamente i problemi.

// 在 wp-config.php 中定义调试常量
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // 将错误记录到 /wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // 不在前端显示错误

Inizializzazione del sistema di controllo delle versioni

Utilizza Git per il controllo delle versioni fin dall’inizio. Inizializza un repository nel directory radice del tuo plugin e crea….gitignoreFile: Ignora elementi come…node_modules、vendor(Se si utilizza Composer), nonché qualsiasi file di configurazione che contenga informazioni sensibili. Questo ti aiuterà a tracciare i cambiamenti apportati al codice e a collaborare con il team.

Si consiglia di leggere Partire da zero: costruire il tuo primo plugin per WordPress。

Crea il tuo primo plugin per WordPress.

Un plugin WordPress di base richiede soltanto un file PHP principale, nel quale è necessario includere, all’inizio del file, delle annotazioni contenenti le informazioni relative al plugin, in conformità con gli standard stabiliti.

La struttura del file principale di un plugin

Nel tuowp-content/pluginsAll’interno del directory, crea una nuova cartella, ad esempio…my-first-pluginAll’interno di quella cartella, creare il file PHP principale; il nome del file è solitamente lo stesso del nome della cartella.my-first-plugin.php。

Apri questo file e aggiungi delle note all’inizio del file, relative alla struttura del plugin. Queste note sono necessarie affinché WordPress possa riconoscere il plugin correttamente.

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

<?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 il file, accedi al pannello di amministrazione di WordPress e vai alla pagina “Aggiornamenti” (Plugins). Dovresti vedere il tuo primo plugin elencato nell’elenco. Attivalo: anche se al momento non dispone di alcuna funzionalità, hai comunque creato con successo un nuovo plugin.

Realizzare una funzionalità semplice: la gestione delle notifiche.

Aggiungiamo la prima funzionalità concreta a questo plugin: la visualizzazione di una notifica personalizzata nell’interfaccia di amministrazione. Per farlo, utilizzeremo l’API per le notifiche di WordPress.

Nel file principale del plugin, aggiungi il seguente codice sotto le note di testo iniziali. Lo utilizzeremo…admin_noticesUtilizziamo degli “Action Hook” per visualizzare il nostro contenuto in posizioni specifiche del sito.

Si consiglia di leggere Guida completa allo sviluppo di plugin per WordPress: da principianti a esperti。

// 钩子：在管理后台显示通知
add_action( 'admin_notices', 'mfp_display_admin_notice' );

/**
 * 在管理后台显示欢迎通知的函数。
 * 该函数通过 `admin_notices` 钩子被调用。
 */
function mfp_display_admin_notice() {
    // 检查当前用户是否有管理权限，避免向普通用户显示
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="notice notice-success is-dismissible">
        <p><?php _e( '欢迎使用“我的第一个插件”！', 'my-first-plugin' ); ?></p>
    </div>
    &lt;?php
}

Spiegazione del codice:add_action()La funzione utilizza la nostra funzione personalizzata.mfp_display_admin_noticeMontare su…admin_noticesQuesto “gancio” viene utilizzato per attivare una funzione specifica quando WordPress esegue le operazioni relative alla zona delle notifiche in background. All’interno della funzione vengono prima verificate le autorizzazioni dell’utente, e successivamente viene visualizzata una notifica in formato HTML che include gli elementi grafici necessari per indicare il successo dell’operazione, nonché un pulsante che permette all’utente di chiudere la notifica.__()或_e()Utilizzare funzioni per l’internazionalizzazione del testo rappresenta una buona pratica.

Approfondimento: Ganci, codici brevi e opzioni

Per sviluppare plugin ricchi di funzionalità, è necessario padroneggiare alcuni dei meccanismi di estensione fondamentali di WordPress: gli “Hook” (Ganci), i “Shortcode” (Codici Ridotti) e l’API per le “Opzioni” (Options).

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

Comprendere e utilizzare gli “action hooks” e i “filter hooks”.

Gli “hook” rappresentano la pietra angolare dell’architettura dei plugin per WordPress: permettono di inserire il proprio codice in punti specifici dell’esecuzione del codice di base del sito. Esistono due tipi di hook: gli “Action” e i “Filter”.

Gli “action hooks” eseguono il tuo codice quando si verifica un evento specifico, senza richiedere il restituto di un valore. Ad esempio…init(Inizializzazione)wp_enqueue_scripts(Lo caricamento degli script front-end e dei relativi stili.)save_post(Quando si salva l’articolo…) Abbiamo utilizzato… in precedenza.admin_noticesSi tratta semplicemente di un “hook” per un’azione (un meccanismo di interazione programmata).

I “filter hooks” sono utilizzati per modificare i dati. Ricevono un valore e richiedono che venga restituito il valore modificato. Ad esempio,the_titleI filtri ti permettono di modificare l’aspetto visivo del titolo degli articoli, ovvero di personalizzarne la forma e il contenuto visualizzato agli utenti.widget_textI filtri ti permettono di modificare il testo contenuto nei widget.

// 使用过滤器修改文章标题
add_filter( 'the_title', 'mfp_modify_post_title' );
function mfp_modify_post_title( $title ) {
    if ( ! is_admin() && in_the_loop() ) {
        return '📢 ' . $title;
    }
    return $title;
}

Creare e utilizzare codici brevi

I codici brevi permettono agli utenti di utilizzare un semplice tag (ad esempio…)[my_shortcode]Inserire contenuto dinamico in un articolo o una pagina. Utilizzare…add_shortcode()Una funzione per registrare codici brevi (short codes).

// 注册一个短代码
add_shortcode( 'mfp_current_time', 'mfp_render_current_time_shortcode' );
/**
 * 渲染显示当前时间的短代码。
 * @param array $atts 短代码属性。
 * @param string $content 短代码包裹的内容（如果有）。
 * @return string 渲染后的HTML。
 */
function mfp_render_current_time_shortcode( $atts = [], $content = null ) {
    // 使用 shortcode_atts 设置默认属性并合并用户输入
    $atts = shortcode_atts( [
        'format' => 'Y-m-d H:i:s',
    ], $atts, 'mfp_current_time' );

// 根据格式获取当前时间
    $current_time = date( $atts['format'] );

// 返回输出
    return '<p class="mfp-time">Ora attuale: ''. esc_html($current_time). ‘</p>';
}

Gli utenti possono inserire testo nell’editor.[mfp_current_time format="F j, Y"]Visualizza l’ora nel formato specificato.

Utilizzare l’API delle opzioni per salvare le impostazioni.

I plugin di solito hanno bisogno di salvare alcune informazioni di configurazione. WordPress fornisce l’API Options, che permette di gestire queste informazioni in modo semplice e affidabile.wp_optionsI dati vengono memorizzati, recuperati e aggiornati in modo sicuro all’interno della tabella.

Usareadd_option()、get_option()、update_option()和delete_option()Esistono funzioni per manipolare i dati. Al fine di mantenere un’organizzazione chiara, si consiglia di aggiungere un prefisso uniforme a tutti i nomi delle voci opzionali.

// 定义默认选项
define( 'MFP_DEFAULT_MESSAGE', '你好，世界！' );

// 插件激活时设置默认选项（需要注册激活钩子）
register_activation_hook( __FILE__, 'mfp_set_default_options' );
function mfp_set_default_options() {
    if ( false === get_option( 'mfp_custom_message' ) ) {
        add_option( 'mfp_custom_message', MFP_DEFAULT_MESSAGE );
    }
}

// 在代码中获取选项值
$message = get_option( 'mfp_custom_message', MFP_DEFAULT_MESSAGE );
echo esc_html( $message );

Creare plugin professionali: sicurezza, gestione e pubblicazione

Man mano che le funzionalità di un plugin diventano più complesse, è necessario prendere in considerazione l’organizzazione del codice, la sicurezza, l’interfaccia utente e il processo di pubblicazione.

Seguire le migliori pratiche di sicurezza.

La sicurezza rappresenta l’elemento fondamentale nello sviluppo di plugin. Il principio principale da seguire è: non fidarsi mai degli input forniti dagli utenti. È necessario verificare, pulire ed “escapare” (cioè modificare in modo appropriato) tutti i dati provenienti dagli utenti, dal database o da API esterne.
* 验证（Validation）：检查数据是否符合预期格式（如是否是邮箱、数字），使用filter_var()、preg_match()O funzioni di WordPress…is_email()。
* 清理（Sanitization）：清理数据，移除不安全字符。对于文本输入，使用sanitize_text_field()Per i contenuti HTML, utilizzare…wp_kses_post()Per i URL, utilizzare…esc_url_raw()。
* 转义（Escaping）：在将数据输出到HTML、JavaScript或URL时，根据上下文进行转义。使用esc_html()、esc_attr()、esc_js()、esc_url()e altre funzioni.
* 非ce验证：所有可能修改数据库的操作（如表单提交）都必须包含非ce验证，使用wp_nonce_field()、wp_verify_nonce()。

Creare la pagina per la gestione delle impostazioni

Per i plugin che richiedono configurazioni da parte dell’utente, è essenziale fornire una pagina di gestione delle impostazioni chiara e intuitiva. WordPress offre un’API per la configurazione che semplifica questo processo, gestendo automaticamente le verifiche non basate su meccanismi di autenticazione (come il protocollo CE), i controlli sui diritti di accesso e la salvazione dei dati.

Devi utilizzare…add_options_page()或add_menu_page()Aggiungi una pagina per le funzioni di attesa, e poi utilizzala.register_setting()、add_settings_section()和add_settings_field()Per definire i campi di configurazione…

Organizzare il codice e prepararlo per la pubblicazione

Non accumulare tutto il codice nel file principale. Man mano che i plugin aumentano di numero, è opportuno suddividere il codice in moduli funzionali e distribuirlo in file separati. Una struttura di directory tipica potrebbe includere:
* /adminContiene il codice relativo al backend (pagine di configurazione, ecc.).
* /publicContiene il codice relativo alla parte front-end dell’applicazione.
* /includesContiene le classi e le funzioni relative alle funzionalità principali dell’applicazione.
* /assetsPer conservare i file CSS, JavaScript e le immagini.
* /languagesPer conservare i file di traduzione internazionali (.po/.mo).

Usarerequire_once或include_onceIntroducete questi file nei punti appropriati del codice. Prendete in considerazione l’uso di Composer per gestire le dipendenze PHP, nonché di NPM/Yarn per gestire i risorse front-end.

Prima di pubblicare il tuo plugin, assicurati che sia in conformità con il “Manuale di sviluppo di plugin” ufficiale di WordPress e con gli standard di codifica stabiliti. Utilizza strumenti come PHP_CodeSniffer per effettuare controlli rigorosi sul codice. Scrivi inoltre una documentazione chiara e completa per aiutare gli utenti a comprendere come utilizzare il plugin.readme.txtFile: Descrizione dettagliata delle funzionalità, istruzioni per l’installazione, screenshot e log degli aggiornamenti.

Riassumendo

Lo sviluppo di plugin per WordPress è un percorso che inizia con la comprensione dell’infrastruttura di base (file dei plugin, meccanismi di interazione tra plugin, cosiddetti “hook”), per poi approfondire i concetti fondamentali (come i “shortcode” e l’API per la configurazione delle opzioni dei plugin), fino ad arrivare allo sviluppo professionale, con attenzione alla sicurezza, all’architettura del software e alle procedure di pubblicazione dei plugin. Partendo dalla creazione di un semplice plugin “Hello World”, è possibile aggiungere gradualmente funzionalità come notifiche in background, supporto per i “shortcode” e strumenti per la configurazione delle opzioni, imparando così in modo sistematico l’intero processo di sviluppo. Ricorda che scrivere codice sicuro, efficiente e facile da mantenere, seguendo le specifiche e le migliori pratiche dell’ecosistema WordPress, è fondamentale per creare plugin di successo. Continuare a imparare, leggere la documentazione ufficiale e analizzare il codice sorgente di plugin di qualità ti aiuterà a migliorare le tue competenze, passando da principiante a esperto.

FAQ - Domande frequenti

Per sviluppare plugin per ###, è necessario conoscere a fondo PHP?
Sì, una solida conoscenza di PHP è essenziale, poiché il nucleo di WordPress e i suoi plugin sono scritti in PHP. È necessario comprendere la grammatica di PHP, le funzioni, gli array, il programmazione orientata agli oggetti e altri concetti correlati. Inoltre, una conoscenza di base di HTML, CSS e JavaScript è fondamentale per creare le interfacce grafiche e gli elementi interattivi dei plugin.

Qual è la differenza tra i file functions.php dei plugin e dei temi?

Mettere il codice funzionale all’interno del tema…functions.phpNel file, questa funzionalità è legata al tema specifico utilizzato. Quando si cambia tema, queste funzionalità smettono di funzionare. I plugin, invece, sono moduli indipendenti dal tema e possono essere utilizzati in qualsiasi tema attivo, il che ne facilita il riutilizzo, la manutenzione e la distribuzione. Per le funzionalità destinate a un utilizzo prolungato o alla distribuzione ad altri utenti, è consigliabile preferire lo sviluppo di plugin.

Come devo eseguire il debug del codice del mio plugin?

Attivare il modalità di debug di WordPress è il primo passo più importante: basta impostare le opzioni corrette per abilitarla.WP_DEBUGUtilizzare costanti correlate per visualizzare gli errori.error_log()La funzione registra le informazioni relative alle variabili nel log di errore del server.debug.logIl file contiene informazioni utili per lo sviluppo. Inoltre, è possibile installare plugin di debug professionali, come Query Monitor, che forniscono dettagli su query al database, hook, script e altre funzionalità, rappresentando uno strumento molto potente per gli sviluppatori.

Come posso rendere il mio plugin internazionale per supportare più lingue?

WordPress utilizza il framework GNU gettext per l’internazionalizzazione. Nel tuo plugin, utilizza le funzioni di traduzione per tutte le stringhe destinate agli utenti.()、_e()、esc_html()Esegui quindi le operazioni necessarie per specificare il “Text Domain” (dominio del testo). Successivamente, utilizza strumenti come Poedit per analizzare il codice del plugin e generare il contenuto richiesto..potFile di template: i traduttori utilizzano questi file per creare versioni del testo in diverse lingue..po和.moFile… Mettilo all’interno del plugin./languagesBasta trovarlo all’interno della directory.