Guida all’approccio di base allo sviluppo di plugin per WordPress: costruisci il tuo primo plugin personalizzato da zero

I plugin per WordPress rappresentano il cuore dell’espansione delle funzionalità di un sito web: permettono di aggiungere nuove caratteristiche in modo modulare, senza dover modificare il codice sorgente di WordPress stesso. Sviluppando i propri plugin, è possibile creare soluzioni completamente personalizzate per soddisfare esigenze specifiche, mantenendo al contempo la compatibilità con altri temi e plugin esistenti. Questo guida vi accompagnerà passo dopo passo nella creazione di un plugin WordPress completo e ben strutturato.

La struttura di base e le norme per i plugin di WordPress

Un plugin standard per WordPress deve seguire una struttura e delle specifiche file specifiche, al fine di garantire che venga riconosciuto correttamente dal sistema WordPress, funzioni in modo sicuro e sia facile da mantenere.

Creare il file principale del plugin

Ogni plugin deve disporre di un file PHP principale, il cui nome corrisponde solitamente a quello della directory contenente il plugin stesso. All’inizio di questo file deve essere presente un commento contenente informazioni specifiche sul plugin; è attraverso questo commento che WordPress riconosce il plugin.

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

Crea una cartella nel directory dei plugin con il nome… my-first-plugin.php Il file in questione deve contenere il seguente contenuto, oltre alle informazioni di intestazione indicate:

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

Seguire le migliori pratiche di sicurezza.

Tutto il codice dei plugin deve essere sottoposto a controlli di sicurezza per impedirne l’accesso diretto. Inoltre, è consigliabile utilizzare prefissi unici per denominare tutte le funzioni, le classi e le costanti, al fine di evitare conflitti con i temi o con altri plugin.

Nel file principale del plugin, il codice di protezione della sicurezza deve essere aggiunto immediatamente dopo le note iniziali, utilizzando un prefisso unico (ad esempio: “SECURITY”). mfp_Utilizza questo nome per denominare la tua funzione:

// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

// 使用唯一前缀定义一个函数
function mfp_display_greeting() {
    echo '<p>Ciao, benvenuto nell’utilizzo del mio primo plugin!</p>';
}

Implementare le funzionalità principali: azioni e filtri.

Il meccanismo di estensione principale di WordPress si basa sugli “hook” (ganci), che sono divisi in “Actions” (azioni) e “Filters” (filtri). Comprendere e utilizzarli correttamente è fondamentale per lo sviluppo di plugin.

Utilizzare gli “action hooks” per aggiungere funzionalità.

Gli “action hooks” ti permettono di eseguire il tuo codice in momenti specifici o quando si verificano determinati eventi. Ad esempio, per aggiungere un testo in fondo alla pagina, puoi utilizzare questi meccanismi. wp_footer Azione.

Si consiglia di leggere Sviluppo di plugin per WordPress: Creare da zero plugin con funzionalità personalizzate。

Mount the previously defined function to… wp_footer Sul gancio:

// 将函数挂载到 wp_footer 动作钩子
add_action( 'wp_footer', 'mfp_display_greeting' );

In questo modo, quando WordPress arriva alla parte inferiore della pagina (il “footer”), verrà eseguito il codice richiesto. mfp_display_greeting Funzione per visualizzare un saluto.

Modificare il contenuto utilizzando gli hook dei filtri.

Gli “hook” dei filtri vengono utilizzati per modificare i dati. Ricevono un valore, lo elaborano e lo restituiscono successivamente. Ad esempio, per modificare il suffisso predefinito dei titoli degli articoli, è possibile utilizzare questi hook. the_title Filtro.

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

Crea una funzione per modificare il titolo di un articolo e aggiungilo a un filtro:

// 定义一个函数来修改文章标题
function mfp_modify_title( $title, $id = null ) {
    // 仅在前端修改非管理员页面的标题
    if ( ! is_admin() && in_the_loop() ) {
        $title .= ' - 来自我的插件';
    }
    return $title;
}
// 将函数挂载到 the_title 过滤器钩子，参数3是优先级，参数4是接受的参数个数
add_filter( 'the_title', 'mfp_modify_title', 10, 2 );

Creare un’interfaccia di gestione per i plugin

La maggior parte degli plugin richiede una pagina di configurazione sul backend, che permette agli amministratori del sito di impostare le opzioni del plugin. WordPress offre un’ampia gamma di API per creare menu di gestione e moduli standard.

Creare la pagina di configurazione del plugin

Usare add_menu_page() 或 add_options_page() La funzione permette di aggiungere una pagina di gestione al tuo plugin. Di solito, questa pagina si trova all’interno del menu “Impostazioni”.

Si consiglia di leggere Imparare a sviluppare plugin per WordPress da zero: principi, pratiche e tecniche avanzate。

Crea una funzione per registrare e gestire i menu, e montala (ovvero associarla al sistema in modo che possa essere utilizzata). admin_menu Azione:

// 添加插件设置页面到后台菜单
function mfp_add_admin_menu() {
    add_options_page(
        '我的第一个插件设置', // 页面标题
        '我的插件设置',       // 菜单标题
        'manage_options',     // 权限要求
        'my-first-plugin',    // 菜单slug
        'mfp_render_settings_page' // 用于渲染页面的回调函数
    );
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );

// 渲染设置页面的回调函数
function mfp_render_settings_page() {
    ?>
    <div class="wrap">
        <h1>La configurazione del mio primo plug-in.</h1>
        <form action="/it/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            settings_fields( 'mfp_settings_group' );
            do_settings_sections( 'my-first-plugin' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="it"/></form>
    </div>
    &lt;?php
}

Opzioni di registrazione e configurazione dell’elaborazione

L’API di configurazione di WordPress permette di gestire in modo sicuro l’ registrazione, la verifica e l’archiviazione delle opzioni. È necessario definire i campi di configurazione e le sezioni pertinenti, nonché utilizzare una funzione apposita per salvare i 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

Continua ad aggiungere il seguente codice nel file principale del plugin per registrare le impostazioni:

// 初始化插件设置
function mfp_settings_init() {
    // 注册一个新的设置组和选项
    register_setting( 'mfp_settings_group', 'mfp_settings', 'mfp_sanitize_settings' );

// 在插件设置页面添加一个节
    add_settings_section(
        'mfp_section_basic',
        '基本设置',
        null,
        'my-first-plugin'
    );

// 向节中添加一个字段
    add_settings_field(
        'mfp_greeting_text',
        '问候语文本',
        'mfp_greeting_text_render',
        'my-first-plugin',
        'mfp_section_basic'
    );
}
add_action( 'admin_init', 'mfp_settings_init' );

// 渲染问候语文本输入字段
function mfp_greeting_text_render() {
    $options = get_option( 'mfp_settings' );
    $value = isset( $options['greeting_text'] ) ? $options['greeting_text'] : '你好，世界！';
    echo '<input type="text" name="mfp_settings[greeting_text]" value="' . esc_attr( $value ) . '" class="regular-text">';
}

// 清理和验证设置输入
function mfp_sanitize_settings( $input ) {
    $sanitized = [];
    if ( isset( $input['greeting_text'] ) ) {
        $sanitized['greeting_text'] = sanitize_text_field( $input['greeting_text'] );
    }
    return $sanitized;
}

Internazionalizzazione dei plugin e preparazione per il deployment

Per permettere all’estensione di essere utilizzata dagli utenti di tutto il mondo e di essere poi pubblicata ufficialmente, è necessario procedere con l’internazionalizzazione del software e l’ottimizzazione del codice sorgente.

Implementare l’internazionalizzazione del testo

Utilizzando WordPress… __()、_e() Utilizzare funzioni come queste per incapsulare tutte le stringhe di testo da tradurre e caricare correttamente i campi di testo.

Modifica la tua funzione di output in modo che supporti la traduzione.

function mfp_display_greeting() {
    $options = get_option( ‘mfp_settings’ );
    $greeting = isset( $options[‘greeting_text’] ) ? $options[‘greeting_text’] : __( ‘你好，世界！’, ‘my-first-plugin’ );
    echo ‘<p>’ . esc_html( $greeting ) . ‘</p>’;
}

// 在插件加载时加载翻译文件
function mfp_load_textdomain() {
    load_plugin_textdomain( ‘my-first-plugin’, false, dirname( plugin_basename( __FILE__ ) ) . ‘/languages/’ );
}
add_action( ‘plugins_loaded’, ‘mfp_load_textdomain’ );

Ottimizzare il codice e creare pacchetti da pubblicare

Dopo aver completato lo sviluppo, è necessario rimuovere il codice di debug e assicurarsi che tutte le funzioni abbiano un prefisso unico. Successivamente, comprimere l’intero directory del plugin in un file ZIP; questo file potrà essere caricato e installato tramite l’interfaccia di amministrazione di WordPress.

Assicurarsi che il file principale contenga un procedimento di disinstallazione standard, utilizzato per pulire le opzioni presenti nel database quando l’utente elimina un plugin. Ciò viene realizzato registrando un “hook” di disinstallazione.

// 插件卸载时的清理操作
register_uninstall_hook( __FILE__, ‘mfp_uninstall’ );
function mfp_uninstall() {
    delete_option( ‘mfp_settings’ );
}

Riassumendo

Questo articolo fornisce una descrizione dettagliata del processo completo per creare un plugin personalizzato per WordPress partendo da zero. Iniziamo con la comprensione della struttura di base dei plugin e delle norme di sicurezza, per poi approfondire il sistema di hook (azioni e filtri) presente al cuore di WordPress. Impariamo anche come creare un’interfaccia di amministrazione in back-end dotata di pagine di configurazione. Infine, esaminiamo aspetti legati all’internazionalizzazione dei plugin, all’ottimizzazione del codice e ai passaggi necessari per il loro deployment finale.

Ricorda che lo sviluppo di plugin di qualità non consiste solo nell’implementazione delle funzionalità richieste, ma anche nella sicurezza del codice, nella sua manutenibilità e nel rispetto degli standard di WordPress. Ti consiglio di approfondire la lettura della guida ufficiale per lo sviluppo di plugin di WordPress, di seguire le linee guida per la codifica e di mettere in pratica queste conoscenze nei tuoi progetti reali.

FAQ - Domande frequenti

Per sviluppare plugin per WordPress, quali conoscenze preliminari sono necessarie?

È molto utile disporre di una conoscenza di base della programmazione in PHP, inclusa la comprensione di variabili, funzioni, array e condizioni logiche. Inoltre, avere una conoscenza di base di HTML e CSS, nonché una certa dimestichezza con le operazioni di base di WordPress e la struttura del suo lato backend, rappresenta un vantaggio significativo. Conoscere la programmazione orientata agli oggetti (OOP) rappresenta un ulteriore plus per lo sviluppo avanzato.

我必须使用类（Class）来编写插件吗？

Non necessariamente. Per i plugin semplici, l’utilizzo della programmazione procedurale (un insieme di funzioni) è del tutto fattibile, ed è proprio questo il metodo adottato negli esempi di questo articolo. Tuttavia, per i plugin più complessi e dotati di molte funzionalità, l’utilizzo della programmazione orientata agli oggetti (OOP) e l’organizzazione del codice in classi rappresenta una scelta migliore. Questo permette di organizzare il codice in modo più efficace, evitare conflitti di nomi e migliorare la manutenibilità.

Come devo debuggare il codice del mio plugin per WordPress?

Attivare il modalità di debug di WordPress è il primo passo da compiere. Nel sito… wp-config.php Nel documento, verrà indicato che... WP_DEBUG La costante è impostata su trueQuesto comporterà l’visualizzazione di errori PHP, notifiche e avvisi sulla pagina. Inoltre, è possibile utilizzare… error_log() La funzione scrive le informazioni di debug nel log di errore del server, oppure utilizza plugin di debug professionali (come Query Monitor) per verificare problemi relativi alle query sul database, all’esecuzione dei “hook” e alle prestazioni del sistema.

Come garantire la sicurezza nello sviluppo di plugin?

Le misure chiave per garantire la sicurezza includono: verificare e pulire sempre gli input forniti dagli utenti (utilizzando…) sanitize_text_field(), esc_html(), wp_kses_post() Funzioni come queste vengono utilizzate per tutte le query effettuate sui database. $wpdb Utilizzare i metodi delle classi disponibili e applicare le relative istruzioni di preparazione dei dati (prepare statements) per prevenire gli attacchi di iniezione SQL; escapare tutti i contenuti dinamici visualizzati nel browser; impiegare i meccanismi di sicurezza integrati in WordPress, come i valori “nonce” e i controlli di accesso.current_user_can()Vengono utilizzati metodi specifici per proteggere i moduli e le richieste AJAX.