Una guida introduttiva allo sviluppo di plugin per WordPress: crea il tuo primo plugin funzionale da zero.

Conoscenze di base sullo sviluppo di plugin per WordPress.

Prima di iniziare a scrivere codice, è fondamentale comprendere i concetti di base dei plug-in di WordPress. Un plug-in di WordPress è essenzialmente un insieme di uno o più file PHP, che vengono forniti tramite le varie funzionalità offerte da WordPress.API和HookPer estendere o modificare le funzionalità principali di WordPress. I plugin possono essere molto semplici, come l'aggiunta di un codice breve, o molto complessi, come la creazione di una piattaforma di e-commerce completa. Tutti i plugin sono archiviati in/wp-content/plugins/Nella directory, ogni plug-in ha una propria cartella indipendente.

Il fulcro dello sviluppo di un plug-in consiste nel comprendere WordPress.动作钩子和过滤器钩子。动作钩子Ti consente di eseguire codice PHP personalizzato in momenti specifici (ad esempio, quando la pagina viene caricata o quando viene pubblicato un articolo), mentre过滤器钩子Questo ti consente di modificare i vari dati generati da WordPress durante l'esecuzione (come il contenuto degli articoli, i titoli e gli estratti). Padroneggiare l'uso di questi hook è fondamentale per lo sviluppo di plugin.

Perché i plugin possano essere riconosciuti da WordPress, ogni plugin deve includere un'intestazione di plugin standard. Questo blocco di commenti si trova generalmente all'inizio del file PHP principale del plugin e fornisce a WordPress le informazioni di base del plugin, come il nome, la descrizione, la versione, l'autore, ecc. Senza questa intestazione, il plugin non apparirà nell'elenco dei plugin del backend.

Si consiglia di leggere Comprendere a fondo lo sviluppo dei plug-in di WordPress: da zero alla creazione di estensioni professionali。

Creare il tuo primo plug-in

Inizieremo creando un plugin “Hello World” molto semplice. Questo plugin visualizzerà un messaggio di benvenuto personalizzato nella parte superiore della dashboard del pannello di amministrazione di WordPress.

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

Inizializza la directory dei plug-in e il file principale.

Prima di tutto, hai bisogno di installare WordPress nel tuo ambiente di sviluppo locale o nel tuo sito di test. /wp-content/plugins/ Creiamo una nuova cartella nella directory. La chiameremo my-first-pluginQuindi, all'interno di quella cartella, creiamo un file PHP principale, che di solito chiamiamo con il nome del plugin. In questo caso, lo chiamiamo my-first-plugin.php。

在 my-first-plugin.php All'inizio del file, è necessario aggiungere le informazioni dell'intestazione del plug-in. Questa è la “carta d'identità” del plug-in.

Scrivi le informazioni dell'intestazione del plug-in e le funzioni principali.

Dopo aver creato il file, aprilo e inserisci il seguente codice:

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://yourwebsite.com/my-first-plugin
 * Description:       这是一个用于学习插件开发的入门示例，会在仪表盘显示欢迎信息。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Questa nota definisce le informazioni di base del plug-in. Dopo aver salvato il file, accedi al pannello di amministrazione di WordPress e vai alla pagina “Plug-in”; dovresti vedere un nuovo plug-in denominato “Il mio primo plug-in”. Ora attivalo, ma non avrà ancora alcuna funzionalità.

Si consiglia di leggere Guida completa allo sviluppo di plugin per WordPress: dalla creazione di un plugin da zero fino al suo completamento.。

Di seguito, aggiungiamo la prima funzionalità. Utilizzeremo add_action() La funzione monta una funzione personalizzata sull'hook di azione di WordPress. Sotto il commento dell'intestazione, aggiungere il seguente codice:

/\n Aggiungere un messaggio di benvenuto nella parte superiore della dashboard
function my_first_plugin_admin_notice() {
    echo '<div class="notice notice-success is-dismissible"><p>Benvenuto a “Il mio primo plug-in”! Questo è un inizio di successo.</p></div>';
}
add_action( 'admin_notices', 'my_first_plugin_admin_notice' );

Questo è il luogo in cui abbiamo creato un nome chiamato my_first_plugin_admin_notice La funzione, il cui scopo è quello di generare un codice HTML per visualizzare una notifica con lo stile del backend di WordPress. Successivamente, utilizziamo add_action( ‘admin_notices’, ‘my_first_plugin_admin_notice’ ) Mount this function to… admin_notices Questo è un hook di azione. Ciò significa che ogni volta che WordPress si prepara a mostrare le notifiche di amministrazione in background, eseguirà la nostra funzione.

Dopo aver salvato il file, aggiorna una qualsiasi pagina del backend di WordPress e vedrai una finestra di conferma verde nella parte superiore della pagina. Congratulazioni, il tuo primo plugin funzionale è stato attivato con successo!

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

Aggiungere una pagina delle impostazioni per il plug-in.

Un plug-in completo di solito deve fornire all'utente opzioni di configurazione. Aggiungeremo una semplice pagina delle impostazioni per “Il mio primo plug-in”, che consentirà agli utenti di personalizzare il testo visualizzato nel messaggio di benvenuto.

Creare una voce di menu di gestione.

Per prima cosa, dobbiamo aggiungere una voce di menu nella barra laterale di amministrazione di WordPress. Per fare questo, abbiamo bisogno di utilizzare add_action() La funzione viene montata su admin_menu Hook. Continua aggiungendo il seguente codice al file principale del plug-in:

// 添加插件设置页面到后台菜单
function my_first_plugin_add_menu() {
    add_menu_page(
        ‘我的第一个插件设置’， // 页面标题
        ‘第一个插件’，         // 菜单标题
        ‘manage_options’，     // 权限 (manage_options 表示管理员权限)
        ‘my-first-plugin-settings’， // 菜单 slug
        ‘my_first_plugin_settings_page’， // 用于显示页面内容的回调函数
        ‘dashicons-smiley’，   // 菜单图标 (Dashicons)
        100                    // 菜单位置
    );
}
add_action( ‘admin_menu’， ‘my_first_plugin_add_menu’ );

add_menu_page() La funzione è una funzione principale di WordPress, utilizzata per aggiungere un menu di primo livello in background. Abbiamo definito il titolo della pagina, il testo visualizzato nel menu e i permessi di accesso (in questo caso, è stato impostato in modo che solo gli amministratori possano accedervi). manage_options）、唯一oslugNonché il nome della funzione di callback utilizzata per visualizzare il contenuto della pagina. my_first_plugin_settings_page。

Si consiglia di leggere Introduzione ai server cloud per principianti: una guida passo passo all'installazione e alla gestione dei server cloud da zero.。

Creare un modulo per la pagina delle impostazioni.

Di seguito, abbiamo bisogno di definire my_first_plugin_settings_page Una funzione per rendere il contenuto HTML della pagina delle impostazioni e gestire la logica di salvataggio del modulo. Questa funzione creerà un semplice modulo, i cui dati verranno inviati tramite WordPress. options L'API esegue il salvataggio e il recupero dei dati.

\n// Imposta il contenuto della pagina
function my_first_plugin_settings_page() {
    // Controlla i permessi dell'utente
    if ( !current_user_can( ‘manage_options’ ) ) {
        wp_die( __( ‘Non hai i permessi per accedere a questa pagina.’ ) );
    }

// Salva i dati del modulo
    if (isset( $_POST[‘my_first_plugin_message’] ) ) {
        update_option( ‘my_first_plugin_custom_message’, sanitize_text_field( $_POST[‘my_first_plugin_message’] ) );
        echo ‘<div class="“notice" notice-success is-dismissible”><p>Le impostazioni sono state salvate!</p></div>’;
    }

// 获取已保存的消息
    $saved_message = get_option( ‘my_first_plugin_custom_message’， ‘这是一个通过设置页面定制的欢迎消息！’ );

// 输出表单 HTML
    ?&gt;
    <div class="“wrap”">
        <h1>La configurazione del mio primo plug-in.</h1>
        <form method="“post”" action="/it/“”/" data-trp-original-action="“”">
            <table class="“form-table”">
                <tr>
                    <th scope="“row”"><label for="“custom_message”">Messaggio di benvenuto personalizzato</label></th>
                    <td>
                        <input type="“text”" id="“custom_message”" name="“my_first_plugin_message”" value="”NO NUMERIC NOISE KEY" 1001” class="“regular-text”" />
                        <p class="“description”">Inserisci il testo che desideri visualizzare nelle notifiche del dashboard.</p>
                    </td>
                </tr>
            </table>
            <?php submit_button( ‘保存更改’ ); ?>
        <input type="hidden" name="trp-form-language" value="it"/></form>
    </div>
    &lt;?php
}

In questa funzione, prima di tutto verifichiamo i permessi dell'utente. Poi, controlliamo se è stata inviata una richiesta POST (ovvero se l'utente ha cliccato sul pulsante "Salva"). Se è stato così, utilizziamo update_option() La funzione salva i messaggi del modulo in WordPress. options Nella tabella del database, e utilizzando sanitize_text_field() Eseguire un filtraggio di sicurezza. Successivamente, utilizziamo get_option() Leggi i valori salvati in precedenza e, in caso di mancanza, utilizza i valori predefiniti. Infine, esportiamo un modulo HTML che contiene la casella di input.

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

Modificare la funzione di notifica per utilizzare un messaggio personalizzato.

Infine, dobbiamo modificare quello che abbiamo creato in precedenza. my_first_plugin_admin_notice Aggiungiamo una funzione che consenta di leggere i messaggi dalle opzioni che abbiamo salvato, invece di mostrare del testo fisso.

\n// Funzione di notifica modificata
function my_first_plugin_admin_notice() {
    // Recupera il messaggio personalizzato dal database
    $custom_message = get_option( ‘my_first_plugin_custom_message’， ‘Benvenuto a “Il mio primo plugin”! Questo è un inizio di successo.’ );
    echo ‘<div class="“notice" notice-success is-dismissible”><p>’ . esc_html( $custom_message ) . ‘</p></div>’;
}

Ora, attivando il plug-in, vedrai il menu “Primo plug-in” nella barra laterale di backend. Clicca per accedervi, modifica il messaggio e salva. Aggiorna le altre pagine di backend e scoprirai che il messaggio di notifica nella parte superiore è già stato sostituito dal contenuto personalizzato da te. A questo punto, un piccolo plug-in dotato delle funzionalità di base di inserimento, modifica, eliminazione e ricerca è stato completato.

Le migliori pratiche e i trucchi avanzati per lo sviluppo di plug-in.

Per sviluppare un plug-in che sia facile da mantenere, sicuro e compatibile, è necessario seguire alcune best practice.

Garantire la sicurezza del codice e la pulizia dei dati

La sicurezza è la priorità principale nello sviluppo dei plug-in. Non fidarti mai degli input degli utenti o dei dati provenienti da fonti esterne. WordPress offre una vasta gamma di funzioni per aiutarti a pulire, evadere e convalidare i dati.
* Pulizia dell'input: utilizzare funzioni come sanitize_text_field()、sanitize_email()、sanitize_url() Per elaborare i dati inviati dal modulo.
* Output di escape: è necessario eseguire l'escape quando si inviano dati a HTML, JavaScript o URL. Utilizzare < esc_html()、esc_attr()、esc_url() 和 wp_kses_post() e altre funzioni.
* Controllo dei permessi: prima di eseguire qualsiasi operazione di gestione, è necessario utilizzare current_user_can() Verificare se l'utente corrente ha i permessi appropriati, ad esempio. current_user_can( ‘manage_options’ )。
* Verifica del nonce: per le operazioni che comportano la modifica dei dati (come l'invio di un modulo o una richiesta AJAX), utilizzare wp_nonce_field()、wp_verify_nonce() Per prevenire gli attacchi di falsificazione delle richieste tra siti. Possiamo migliorare il precedente modulo della pagina di impostazioni, aggiungendo la verifica nonce per aumentare la sicurezza.

Realizzare l'internazionalizzazione del plug-in.

Per consentire ai tuoi plug-in di essere utilizzati da utenti di tutto il mondo, l'internazionalizzazione è un passaggio indispensabile. Questo richiede che tu prepari la traduzione di tutte le stringhe di testo destinate agli utenti.
1. Utilizzare il campo di testo: definirlo nei commenti dell'intestazione del plug-in. Text Domain(Ad esempio, my-first-plugin(...) e usarlo in tutte le stringhe che necessitano di traduzione. __(‘文本’， ‘my-first-plugin’) 或 _e(‘文本’， ‘my-first-plugin’) Avvolgimento della funzione.
2. Generare il file di traduzione: utilizzare strumenti come Poedit per scansionare tutti i caratteri traducibili all'interno del plug-in e generare il file di traduzione. .pot I file dei modelli, quindi tradurli in varie lingue. .po 和 .mo Documenti.
3. Caricare il campo di testo: durante l'inizializzazione del plug-in, utilizzare load_plugin_textdomain() La funzione carica i tuoi file di traduzione.

Gestire il ciclo di vita dei plug-in.

Un plug-in professionale dovrebbe gestire correttamente gli eventi di attivazione, disattivazione e disinstallazione. È possibile farlo creando le funzioni hook appropriate.
* Attivare l'hook: utilizzare register_activation_hook() Per registrare una funzione da eseguire quando il plug-in viene attivato. Di solito viene utilizzata per creare tabelle di database, inizializzare le opzioni predefinite o verificare la compatibilità dell'ambiente.
* Disattivare gli hook: utilizzare register_deactivation_hook()Di solito viene utilizzato per pulire i dati temporanei o per interrompere i task pianificati.
* Disinstallare l'hook: utilizzare register_uninstall_hook()Attenzione: questo hook viene utilizzato per eseguire l'operazione di pulizia di tutti i database, le tabelle personalizzate e i file creati dal plugin quando l'utente lo elimina completamente da WordPress. È necessario procedere con cautela e informare chiaramente l'utente di questa operazione.

Riassumendo

Questo articolo ti guida, partendo da zero, attraverso l'intero processo di sviluppo di un plug-in WordPress. Innanzitutto, imparerai i concetti di base dei plug-in, in particolare il ruolo fondamentale degli hook di azione e dei hook di filtro. Successivamente, creerai manualmente un framework di plug-in che include cartelle, file principali e informazioni di intestazione standard, e lo testerai utilizzando il plugin tester di WordPress. add_action() Le funzioni e admin_notices Il gancio ha implementato la prima funzionalità di visualizzazione. Successivamente, aggiungendo una pagina di impostazioni al plug-in, hai imparato come utilizzarlo. add_menu_page() Creare un menu di back-end e come utilizzarlo. update_option() 和 get_option() Effettuare operazioni di inserimento, eliminazione, modifica e consultazione dei dati. Infine, abbiamo esaminato le migliori pratiche da seguire nello sviluppo professionale, come la codifica sicura, l'internazionalizzazione e la gestione del ciclo di vita dei plug-in. Seguendo questi passaggi e principi, acquisirai la capacità di sviluppare autonomamente plug-in WordPress semplici, pratici e sicuri, e potrai successivamente esplorare funzionalità più complesse.

FAQ - Domande frequenti

Quali conoscenze di base sono necessarie per sviluppare un plugin WordPress?

Devi padroneggiare la sintassi di base del linguaggio PHP, poiché il codice dei plug-in è scritto principalmente in PHP. Allo stesso tempo, è necessaria una certa conoscenza di HTML, CSS e JavaScript di base per creare interfacce e interazioni front-end. La cosa più importante è avere familiarità con l'architettura di base di WordPress, in particolare con i suoi componenti principali.HookIl sistema (azioni e filtri),选项API、数据库APIE inoltreREST APIÈ inoltre fondamentale conoscere gli standard di codifica e le migliori pratiche di sicurezza di WordPress.

Come posso depurare e testare il mio plug-in?

Esistono diversi metodi di debug per lo sviluppo di plug-in WordPress. Prima di tutto, nel tuo wp-config.php Il file è stato aperto. WP_DEBUG 和 WP_DEBUG_LOG Una costante, che registrerà gli errori e gli avvertimenti di PHP in /wp-content/debug.log Il file rende più facile individuare i problemi. Inoltre, per il codice con una logica complessa, è possibile utilizzare error_log() La funzione esporta i valori delle variabili nel registro. Inoltre, si consiglia di sviluppare in un ambiente di sviluppo locale (come Local by Flywheel, XAMPP) o in un sito di test temporaneo, per evitare di influenzare il sito di produzione. È inoltre buona norma utilizzare un sistema di controllo delle versioni (come Git) per gestire le modifiche al codice.

Come può il mio plug-in essere compatibile con diverse versioni di WordPress?

Per garantire un'ampia compatibilità dei plug-in, durante lo sviluppo è necessario prestare attenzione ai seguenti punti: evitare di utilizzare funzioni introdotte solo nell'ultima versione di WordPress; se è necessario utilizzarle, è consigliabile farlo con cautela. function_exists() Eseguire una verifica delle condizioni e fornire una soluzione di ripristino. Nell'intestazione del plug-in, tramite Requires at least 和 Tested up to Il campo specifica chiaramente l'intervallo delle versioni di WordPress che supporti. Testa regolarmente il tuo plug-in sull'ultima versione di WordPress e aggiorna tempestivamente la dichiarazione di compatibilità. Seguire gli standard di codifica ufficiali di WordPress può anche ridurre al minimo i problemi di compatibilità causati dagli aggiornamenti del kernel.

Dopo lo sviluppo, come posso distribuire il mio plug-in?

Esistono due modi principali per distribuire i plugin. Il primo consiste nel pubblicarli gratuitamente nel catalogo ufficiale dei plugin di WordPress, che consente ai tuoi plugin di essere scoperti e scaricati da milioni di utenti in tutto il mondo. Devi visitare WordPress.org per inviare i plugin e assicurarti che il codice sia conforme alle sue norme e agli standard di revisione. Il secondo modo consiste nel venderli come plugin commerciali attraverso il tuo sito web. In questo caso, devi gestire autonomamente le vendite, i pagamenti, la verifica delle licenze e l'assistenza clienti. Per i plugin commerciali, viene solitamente utilizzata la programmazione orientata agli oggetti (OOP) per organizzare meglio la struttura del codice e potenzialmente integrare framework per semplificare la gestione delle licenze, le notifiche di aggiornamento e altre funzionalità. In entrambi i casi, è molto importante fornire una documentazione chiara e un supporto tempestivo.