Guida all’approccio di base allo sviluppo di plugin per WordPress

Guida all’approccio di base allo sviluppo di plugin per WordPress

I plugin per WordPress rappresentano il meccanismo fondamentale per estendere le funzionalità di base del software. Consentono agli sviluppatori di aggiungere nuove funzionalità al sito web o modificare il comportamento esistente senza dover modificare il codice sorgente di WordPress stesso. Sia che si tratti di semplici funzionalità realizzate tramite “shortcodes” sia di sistemi e-commerce più complessi, tutto può essere realizzato utilizzando plugin. Comprendere il funzionamento dei plugin è il primo passo fondamentale per ogni sviluppatore di WordPress.

Un plugin per WordPress è essenzialmente uno o più file PHP che contengono codice scritto secondo gli standard di codifica di WordPress. Questi file vengono posizionati in una directory specifica all’interno del sito web e interagiscono con il core di WordPress tramite l’API per plugin. Lo sviluppo di plugin richiede non solo conoscenze di PHP, ma anche una buona familiarità con la vasta libreria di funzioni fornita da WordPress, il sistema di “hook” (hook system) e i metodi per operare sul database.

Crea il tuo primo file di plugin.

Ogni plugin per WordPress richiede un file principale, che funge da punto di ingresso per il plugin stesso. Questo file contiene le informazioni di metadati del plugin e è responsabile dell’inizializzazione delle funzionalità fondamentali del plugin.

Si consiglia di leggere Guida completa allo sviluppo di plugin per WordPress: da zero alla pubblicazione sull'app store.。

La struttura del file principale di un plugin

Il nucleo di un plugin è il file principale, che di solito prende il nome dello stesso plugin. Ad esempio… my-first-plugin.phpLe note presenti nella parte iniziale di questo file sono estremamente importanti, poiché forniscono a WordPress le informazioni relative all’identità del plugin. Ecco un esempio di commento minimo da inserire all’inizio del file principale del 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://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
 */

Il campo “Nome del plugin” è obbligatorio: WordPress ne ha bisogno per riconoscere e visualizzare il tuo plugin nell’interfaccia di amministrazione in background. Le altre informazioni, come il numero di versione e la descrizione, aiutano gli utenti a comprendere meglio le funzionalità del plugin.

Dopo aver definito le informazioni del plugin, di solito iniziamo ad aggiungere il codice funzionale. Ad esempio, la funzionalità più semplice consiste nell’aggiungere una riga di testo personalizzato in fondo al sito web. Questo può essere realizzato utilizzando… wp_footer Questo “gancio” (Action Hook) viene utilizzato per realizzare tale funzionalità.

Implementare una semplice funzione di funzionalità.

Ecco un esempio completo del file principale di un plugin che implementa la funzionalità di aggiungere del testo in fondo alla pagina:

<?php
/**
 * Plugin Name: 页脚问候插件
 */
// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * 在网站页脚输出一条自定义问候语
 */
function myplugin_add_footer_text() {
	echo &#039;<p style="text-align:center;">Grazie per aver visitato il nostro sito web!</p>';
}
// 将函数挂载到`wp_footer`钩子上
add_action( 'wp_footer', 'myplugin_add_footer_text' );

In questo codice,myplugin_add_footer_text È una funzione che abbiamo definito noi; essa esegue le operazioni di output specifiche.add_action() Si tratta di una funzione di WordPress che permette di “incorporare” le nostre funzionalità all’interno del nucleo principale di WordPress. wp_footer Il punto di esecuzione è stato impostato correttamente. In questo modo, ogni volta che WordPress arriva alla parte del piede della pagina (footer), la nostra funzione verrà chiamata automaticamente.

Si consiglia di leggere Dall’approccio iniziale alla padronanza: Guida completa e tutorial pratico per lo sviluppo di plugin per WordPress。

Comprendere il meccanismo dei “hook” in WordPress

Gli “hook” rappresentano il cuore e l’anima dello sviluppo di plugin per WordPress, poiché consentono di modificare o estendere le funzionalità di base del sistema. Esistono due tipi principali di hook: gli “Action Hooks” e gli “Filter Hooks”.

L’applicazione dei “action hooks”

Gli “action hooks” (ganci di azione) ti permettono di eseguire codice personalizzato in momenti specifici o quando si verificano determinati eventi. Ad esempio, quando viene pubblicato un articolo…publish_postOppure quando l’utente effettua il login.wp_loginUtilizzare. add_action() Una funzione può associare la tua funzione di callback a un “action hook”.

Esempi come questi dimostrano come aggiungere automaticamente una dichiarazione di copyright alla fine del contenuto di un articolo.

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_add_post_copyright( $content ) {
	if ( is_single() ) {
		$copyright = '<div class="post-copyright"><p>Questo testo è di proprietà dell’autore originale; per riprodurlo, si prega di indicare la fonte.</p></div>';
		$content .= $copyright;
	}
	return $content;
}
add_filter( 'the_content', 'myplugin_add_post_copyright' );

Nota: qui abbiamo utilizzato… add_filter() e non add_action()Poiché modificare il contenuto di un articolo rientra nell’ambito delle operazioni di “filtraggio”, questo fenomeno ha portato all’emergere un altro aspetto importante da considerare.

La funzione dei “filter hooks”

I “filter hooks” ti permettono di modificare i dati trasmessi durante il processo. La principale differenza rispetto ai “action hooks” è che le funzioni utilizzate per i filtri devono restituire un valore (solitamente il valore di input modificato). Ad esempio…the_content I filtri ti permettono di modificare il contenuto degli articoli che stanno per essere visualizzati., the_title Ti è permesso modificare il titolo dell’articolo.

Questi esempi dimostrano come utilizzare i filtri per modificare la lunghezza degli estratti di articoli.

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

function myplugin_custom_excerpt_length( $length ) {
	// 将默认的55个词改为20个词
	return 20;
}
add_filter( 'excerpt_length', 'myplugin_custom_excerpt_length' );

In questo esempio, la nostra funzione… myplugin_custom_excerpt_length Abbiamo ricevuto il valore predefinito per la lunghezza dell’estratto e ne abbiamo restituito uno nuovo, personalizzato da noi. WordPress utilizzerà poi questo nuovo valore per generare l’estratto.

Internazionalizzazione di plugin e campi di testo

Per permettere ai tuoi plugin di essere utilizzati da utenti in tutto il mondo, l’internazionalizzazione (i18n) è un passo essenziale. WordPress fornisce un insieme completo di funzioni per realizzare la traduzione dei plugin in più lingue.

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

Campo di testo per il caricamento del testo del plugin

Il primo passo verso l’internazionalizzazione è impostare correttamente il “Text Domain” all’interno del plugin e caricare i file di traduzione nel momento appropriato. Il “Text Domain” deve essere esattamente lo stesso definito nelle note in cima al file principale del plugin.

Di solito lo utilizziamo durante l’inizializzazione del plugin. load_plugin_textdomain Esiste una funzione per caricare le traduzioni. Una pratica standard consiste nel posizionare il seguente codice nel file principale:

function myplugin_load_textdomain() {
	load_plugin_textdomain( 'my-first-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
}
add_action( 'plugins_loaded', 'myplugin_load_textdomain' );

Questo codice definisce una funzione. myplugin_load_textdomainE utilizzare… add_action Montarlo su… plugins_loaded Sul gancio… Questo garantisce che i file di traduzione vengano caricati prima dell’esecuzione del codice funzionale del plugin. Il terzo parametro specifica la posizione in cui si trovano i file linguistici (.mo), solitamente all’interno della directory del plugin. languages Nella cartella.

Utilizzare la funzione di traduzione per incapsulare una stringa.

Nel codice dei plugin, tutte le stringhe destinate all’utente che devono essere tradotte devono essere racchiuse all’interno di funzioni specifiche. Le due funzioni più utilizzate sono… __() 和 _e()。

__() La funzione restituisce la stringa tradotta. _e() La funzione lo visualizza direttamente (con l’istruzione `echo`). Nell’esempio precedente in cui è stato aggiunto il testo del piede di pagina, avremmo dovuto scrivere il codice in questo modo per supportare la traduzione:

function myplugin_add_footer_text() {
	$text = __( '感谢您访问本网站！', 'my-first-plugin' );
	echo '<p style="text-align:center;">'`. esc_html($text)`.'</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );

Qui, la stringa “Grazie per aver visitato il nostro sito web!” viene… __() Funzione incapsulata, con specificazione dell’area di testo. my-first-pluginI traduttori possono creare file di traduzione in diverse lingue per questa stringa. Inoltre, utilizziamo… esc_html() Escapare i caratteri di output da una funzione rappresenta una pratica di sicurezza molto importante.

Sicurezza dei plugin e migliori pratiche di utilizzo

Sviluppare un plugin popolare significa dare la stessa importanza sia alla sicurezza e alla qualità del codice che alle funzionalità stesse. Seguire le migliori pratiche di sviluppo permette di proteggere i siti web degli utenti, nonché di aumentare la affidabilità e la manutenibilità del plugin stesso.

Convalida dei dati, escape e pulizia dei dati

Non fidarsi mai dei dati provenienti dagli utenti o da fonti esterne. Prima di elaborare qualsiasi dato in ingresso (ad esempio $_GET, $_POST, $_COOKIE) o di inviarli al browser o al database, è necessario eseguire controlli appropriati.

Per i dati che vengono visualizzati su una pagina HTML, è consigliabile utilizzare le funzioni di escape fornite da WordPress. esc_html(), esc_attr(), esc_url()Per i dati che stanno per essere memorizzati nel database, utilizzare… wp_strip_all_tags() 或 sanitize_text_field() Eseguire la pulizia dei dati. Il seguente esempio mostra un metodo sicuro per gestire gli input dei form:

// 假设我们接收一个名为`user_bio`的POST字段
$raw_bio = $_POST['user_bio'] ?? ''; // 使用空合并运算符提供默认值
// 清理数据：移除标签，清理额外空格和特殊字符
$clean_bio = sanitize_textarea_field( $raw_bio );
// 在存入数据库前，还可以使用`wp_kses_post`允许安全的HTML标签
$safe_bio_for_db = wp_kses_post( $clean_bio );
// 现在$safe_bio_for_db可以安全地存入数据库了

Utilizzare metodi diversi da CE (Common Encryption) e i controlli di autorizzazione.

Se il tuo plugin dispone di un’interfaccia di gestione o gestisce la submission di moduli, è obbligatorio utilizzare il meccanismo “nonce” di WordPress per prevenire gli attacchi di tipo Cross-Site Request Forgery (CSRF). Inoltre, è necessario attivare i “Capability Checks” per verificare che l’utente attuale abbia le autorizzazioni necessarie per eseguire l’operazione.

Quando si crea un menu di gestione o un modulo, è necessario generare un campo che non sia di tipo “CE” (Common Element).

// 在表单中输出一个非ce字段
wp_nonce_field( 'myplugin_save_action', 'myplugin_nonce_field' );

Durante il processo di invio di un modulo, è necessario verificare che il valore non sia “ce”.

// 验证非ce
if ( ! isset( $_POST['myplugin_nonce_field'] ) || ! wp_verify_nonce( $_POST['myplugin_nonce_field'], 'myplugin_save_action' ) ) {
	wp_die( __( '安全校验失败，操作已终止。', 'my-first-plugin' ) );
}
// 检查用户权限（例如，检查是否有`manage_options`权限）
if ( ! current_user_can( 'manage_options' ) ) {
	wp_die( __( '您没有执行此操作的权限。', 'my-first-plugin' ) );
}
// 通过所有安全检查，开始处理数据...

Seguire queste linee guida di sicurezza rappresenta la base per creare un plugin affidabile.

Riassumendo

Lo sviluppo di plugin per WordPress rappresenta un processo che trasforma le idee in funzionalità concrete, basato su una profonda comprensione dell’architettura di base di WordPress. Tutto inizia dalla creazione di un file principale che contenga le giuste annotazioni di intestazione. Per espandere le funzionalità di WordPress, è fondamentale comprendere le differenze e l’utilizzo degli “action hooks” e dei “filter hooks”. L’internazionalizzazione dei plugin permette di rendere i propri strumenti disponibili per utenti di tutto il mondo. Inoltre, pratiche di sicurezza costanti – come la validazione dei dati, l’elaborazione dei testi (es: l’escape coding), la pulizia dei dati e i controlli sui permessi – costituiscono la base per garantire la stabilità e l’affidabilità dei plugin, nonché per conquistare la fiducia degli utenti. Seguendo questi passaggi e le migliori pratiche di sviluppo, sarà possibile creare plugin potenti, sicuri e facili da mantenere.

FAQ - Domande frequenti

Quanti file sono necessari almeno per un plugin WordPress?

Un plugin WordPress il più semplice possibile può consistere in un unico file PHP. Questo file deve contenere le note di intestazione standard per i plugin (come il nome del plugin, ecc.) nonché il codice necessario per implementare le funzionalità desiderate. Man mano che le funzionalità del plugin diventano più complesse, esso viene solitamente suddiviso in più file, che includono anche file CSS, JavaScript, immagini e file di traduzione per i vari linguaggi.

Dovrei scrivere il codice del plugin direttamente nel file functions.php del tema?

Per il codice che è specifico solo per l’argomento attuale e che presenta una stretta correlazione funzionale, può essere scritto all’interno della sezione dedicata a quell’argomento.functions.phpSì. Tuttavia, per le funzionalità che hanno un carattere generale e possono essere utilizzate in diversi contesti (temi), si consiglia vivamente di svilupparle come plugin indipendenti. I plugin presentano diversi vantaggi: sono indipendenti dal tema specifico utilizzato, quindi le funzionalità non vengono perse quando si cambia tema; inoltre, sono più facili da gestire e distribuire.

Come posso creare una pagina di configurazione per la gestione del mio plugin?

È possibile utilizzare le funzioni fornite da WordPress per aggiungere menu di gestione e pagine. Le più comuni sono… add_menu_page() 或 add_options_page() È necessario creare una funzione di callback per visualizzare il contenuto HTML della pagina e gestire l’invio dei moduli (compresi i controlli di validità non basati su protocolli come CE e i controlli di autorizzazione). Di solito, questo processo richiede l’utilizzo dell’API di configurazione di WordPress (Settings API), che permette di creare e gestire le opzioni di configurazione in modo più standardizzato e sicuro.

Quando si sviluppa un plugin, come si esegue il debug e si registrano gli errori?

Prima di tutto, assicurati che, nell’ambiente di sviluppo…wp-config.phpAttivare WP_DEBUG nel file:define( 'WP_DEBUG', true );Questo mostrerà gli errori e gli avvisi di PHP sulla pagina. Per un debug più avanzato, è possibile utilizzare…error_log()La funzione registra le informazioni nel log di errori del server, oppure le utilizza direttamente all’interno di WordPress.wp_debugFunzioni correlate. Inoltre, esistono molti ottimi plugin di debug di terze parti, come Query Monitor, che possono aiutarti ad analizzare le query sul database, gli hook e i script, rappresentando strumenti molto utili per lo sviluppo di plugin.