Guida completa allo sviluppo di plugin per WordPress: costruire funzionalità personalizzate da zero

Preparativi e allestimento dell'ambiente.

Prima di iniziare a scrivere il codice, un ambiente di sviluppo stabile e professionale rappresenta la base per il successo. Questo non solo migliora l’efficienza della tua attività di programmazione, ma garantisce anche la compatibilità dei plugin in diversi contesti.

Configurazione dell’ambiente di sviluppo locale

Si consiglia di utilizzare pacchetti per l’ambiente server locale, come Local by Flywheel, XAMPP o MAMP. Questi strumenti permettono di installare automaticamente Apache, MySQL e PHP, simulando perfettamente l’ambiente di un server online. Assicurati che la versione di PHP utilizzata sia compatibile con i requisiti della versione di WordPress che desideri utilizzare; di solito si consiglia l’uso di PHP 7.4 o versioni più recenti per ottenere prestazioni e sicurezza migliori.

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

Un editor di codice potente è di fondamentale importanza. Visual Studio Code, PhpStorm e Sublime Text sono tutte ottime scelte: offrono evidenziazione del codice, suggerimenti automatici e funzionalità di debug. Inoltre, l’installazione di uno strumento di controllo del codice come Git rappresenta lo standard del settore per la gestione dei cambiamenti apportati al codice, la collaborazione tra team e la creazione di backup.

Si consiglia di leggere Il manuale definitivo per lo sviluppo di plugin per WordPress: dal principiante all’esperto。

Crea il tuo primo file di plugin.

La parte più essenziale di un plugin per WordPress è il suo file principale. Questo file non contiene soltanto il codice esecutivo del plugin, ma fornisce anche le informazioni di metadati del plugin al sistema WordPress tramite commenti presenti all’inizio del 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

La struttura del file principale di un plugin

Ogni plugin deve avere un file PHP principale. Di solito diamo a questo file il nome in base alle funzionalità offerte dal plugin stesso, ad esempio… my-first-plugin.phpAll’inizio del file devono essere presenti le note di intestazione standard per i plugin; queste sono essenziali affinché WordPress possa riconoscere il plugin corrispondente.

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

Questo commento indica a WordPress di visualizzare, sulla pagina dei “plugin” presenti nell’area di back-end, informazioni come il nome e la descrizione dei plugin stessi. Text Domain Utilizzato per l’internazionalizzazione, al fine di preparare il lavoro di traduzione successivo.

Attivare e disattivare i plugin

Dopo aver creato il file principale, è necessario inserirlo nella directory di installazione di WordPress. /wp-content/plugins/ Nel folder. È possibile posizionarlo separatamente oppure creare un directory dedicato a esso (ad esempio…). /wp-content/plugins/my-first-plugin/Dopo aver creato il file necessario, inserisci il file principale al suo interno. Una volta completato il processo, accedi al pannello di controllo di WordPress e vai alla pagina “Plugin”. Lì troverai il nuovo plugin; fai clic su “Attiva” per abilitarlo.

Comprendere i meccanismi fondamentali di WordPress: gli hook e i filtri

La potenza e la flessibilità di WordPress derivano in gran parte dal suo sistema di “Hook”. I plugin, infatti, possono essere collegati a questi Hook per modificare o aggiungere funzionalità a WordPress senza dover modificare il codice sorgente principale.

Si consiglia di leggere Analisi approfondita dello sviluppo di plugin per WordPress: costruire da zero estensioni personalizzate。

L’utilizzo dei “action hooks”

Gli “Action Hooks” ti permettono di eseguire codice personalizzato in momenti specifici: ad esempio, quando un articolo viene pubblicato, quando un utente si collega, o quando una pagina di amministrazione in background viene caricata. add_action() La funzione permette di “montare” (ovvero associare) la propria funzione a un determinato “gancio” (hook), che rappresenta un punto di interazione specifico all’interno del sistema.

L’esempio seguente mostra come aggiungere un testo personalizzato in fondo alla pagina principale di un sito web. Utilizziamo… wp_footer Questo “action hook”.

function myplugin_add_footer_text() {
    echo '<p style="text-align:center;">Grazie per aver utilizzato il nostro sito web!</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );

L’utilizzo dei filtri

I filtri (Filters) vengono utilizzati per modificare i dati generati durante un processo. A differenza delle azioni (Actions), i filtri devono ricevere un valore in ingresso e devono restituire un valore modificato. add_filter() Una funzione per applicare i 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

Ad esempio, il codice seguente modifica il contenuto visualizzato alla fine dei titoli degli articoli, aggiungendo una suffisso a tutti i titoli. Utilizziamo… the_title Questo filtro.

function myplugin_modify_title( $title ) {
    // 确保只在主循环中修改
    if ( is_single() ) {
        return $title . ' [推荐阅读]';
    }
    return $title;
}
add_filter( 'the_title', 'myplugin_modify_title' );

Aggiungere una pagina delle impostazioni per il plug-in.

Un plugin maturo dovrebbe solitamente offrire all’utente delle opzioni di configurazione. In WordPress, esistono metodi standardizzati per creare pagine di impostazioni per i plugin, che possono essere aggiunte in diverse posizioni del menu amministrativo.

Creare una voce di menu di gestione.

Prima di tutto, è necessario utilizzare… add_action( ‘admin_menu’, … ) Esistono degli strumenti per registrare una nuova pagina del menu in WordPress. Il framework fornisce diverse funzioni per aggiungere elementi del menu a diversi livelli di organizzazione. add_menu_page()(Top menu) o add_options_page()(Aggiungere al sottomenu “Impostazioni”).

Si consiglia di leggere Guida completa allo sviluppo di plugin per WordPress: dall’approccio iniziale alla creazione di plugin funzionali e avanzati。

Il codice seguente dimostra come creare una semplice pagina di menu principale. Funzione: myplugin_settings_page_html È responsabile della rendering del contenuto HTML della pagina.

function myplugin_add_menu() {
    add_menu_page(
        ‘我的插件设置’,          // 页面标题
        ‘我的插件’,             // 菜单标题
        ‘manage_options’,      // 所需权限
        ‘myplugin’,            // 菜单 Slug
        ‘myplugin_settings_page_html’, // 回调函数
        ‘dashicons-admin-generic’, // 图标（可选）
        20                     // 位置（可选）
    );
}
add_action( ‘admin_menu’, ‘myplugin_add_menu’ );

function myplugin_settings_page_html() {
    // 检查用户权限
    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
            // 输出设置字段
            settings_fields( ‘myplugin_options’ );
            do_settings_sections( ‘myplugin’ );
            submit_button( ‘保存设置’ );
            ?>
        <input type="hidden" name="trp-form-language" value="it"/></form>
    </div>
    &lt;?php
}

Impostazioni di registrazione, campi e sezioni

Per permettere al suddetto modulo di memorizzare dati, è necessario utilizzare l’API di configurazione di WordPress. Ciò include l’utilizzo di… register_setting() Registra un gruppo di impostazioni. add_settings_section() Aggiungi una sezione e utilizzala per… add_settings_field() Aggiungi i campi specifici.

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

Questo processo avviene solitamente… admin_init Tutto è stato completato all’interno dei “hook” (meccanismi di integrazione). L’impostazione dell’API gestirà automaticamente la verifica dei dati e il loro salvataggio. wp_options Questi aspetti (come la validazione dei dati e i controlli di sicurezza basati sui valori “Nonce”) semplificano notevolmente il lavoro di sviluppo.

Riassumendo

Lo sviluppo di plugin per WordPress rappresenta un processo sistematico che prevede la creazione di un ambiente di sviluppo, la generazione dei file di base, una comprensione approfondita del sistema di “hook” (meccanismi di interazione tra plugin e framework), nonché la realizzazione di interfacce utente per il plugin stesso. Seguendo gli standard di codifica e le migliori pratiche di WordPress (come l’utilizzo di commenti specifici nei file dei plugin, l’adozione di prefissi sicuri per le funzioni, l’implementazione di funzionalità internazionali e l’configurazione delle API), si garantisce non solo il corretto funzionamento del plugin, ma anche la sua facilità di manutenzione e espansione. L’elemento chiave è rappresentato dall’utilizzo dell’ampio ecosistema di hook fornito da WordPress, che permette di arricchire le funzionalità del sito in modo modulare e non invasivo. Attraverso le pratiche descritte in questa guida, hai appreso i passaggi fondamentali per creare da zero un plugin personalizzato completo e ben strutturato.

FAQ - Domande frequenti

Per sviluppare plugin, sono necessarie alcune basi di programmazione. Le competenze più importanti includono:

È necessario disporre di una solida conoscenza di base di PHP, poiché il nucleo di WordPress e i suoi plugin sono scritti principalmente in PHP. Inoltre, è fondamentale avere una conoscenza di base di HTML, CSS e JavaScript (in particolare di jQuery, data l’ampia utilizzazione di codice legacy in WordPress), il che ti aiuterà a gestire l’aspetto visivo e le interazioni dell’interfaccia utente. Sarà anche utile comprendere i concetti di base delle operazioni su database MySQL.

Come evitare che i nomi delle funzioni dei plugin siano in conflitto con quelli di altri plugin?

La migliore pratica per evitare conflitti è quella di utilizzare un prefisso unico per denominare tutte le tue funzioni, classi, costanti e variabili. Questo prefisso dovrebbe essere abbastanza distintivo e solitamente correlato al nome del tuo plugin o alla sua abbreviazione. Ad esempio, se il tuo plugin si chiama “Awesome Widget”, potresti utilizzare un prefisso come “aww”. aw_、awesome_widget_ 或 AW_ 作为前缀。将代码封装在类（Class）中也是现代 WordPress 插件开发中广泛采用的、更优雅的避免冲突和组织代码的方式。

In quale directory dovrebbero essere salvati i plugin?

I file dei plugin devono essere memorizzati nella directory di installazione di WordPress. /wp-content/plugins/ All’interno della cartella. Per i plugin semplici che consistono in un unico file, è possibile posizionare il file PHP principale direttamente in questa directory. Per i plugin più complessi, si consiglia caldamente di creare una sottodirectory separata che abbia lo stesso nome del plugin (ad esempio: /wp-content/plugins/my-awesome-plugin/Poi organizza tutti i file dei plugin (PHP, CSS, JS, immagini, ecc.) in questo sottodiretorio. Questo rende la gestione dei file più chiara e ordinata.

Come aggiungere il supporto per le traduzioni ai plugin?

Per aggiungere il supporto all’internazionalizzazione (i18n) a un plugin, sono necessari principalmente i seguenti passaggi: innanzitutto, è necessario impostare correttamente le informazioni relative all’internazionalizzazione nelle note presenti all’inizio del codice del plugin. Text DomainE utilizzare le funzioni di traduzione di WordPress nel codice, ad esempio… ()、_e()、esc_html() Utilizzate dei marcatori per identificare tutte le stringhe da tradurre. Successivamente, utilizzate strumenti come Poedit per estrarre queste stringhe e generare il file di traduzione necessario. .pot I file di template vengono utilizzati per creare i contenuti in diverse lingue, in base alle esigenze specifiche. .po 和 .mo Infine, utilizzalo durante l’inizializzazione del plugin. load_plugin_textdomain() Funzione per caricare le traduzioni.