Una guida pratica allo sviluppo di plugin per WordPress: dalla creazione del tuo primo plugin funzionale, da zero.

Il sistema di plugin di WordPress rappresenta il cuore della sua notevole capacità di estensione. Grazie ai plugin, gli sviluppatori possono aggiungere al sito web funzionalità che vanno da semplici moduli di contatto a complesse funzionalità di e-commerce. Questo articolo ti guiderà passo dopo passo nella creazione di un plugin completo, permettendoti di comprendere a fondo la sua struttura fondamentale, i meccanismi di interazione tra i diversi componenti del sistema (i cosiddetti “hook”), le misure di sicurezza e le migliori pratiche di sviluppo. Alla fine, avrai a disposizione un plugin pronto per essere pubblicato o utilizzato direttamente.

Ambiente di sviluppo e preparazioni di base

Prima di scrivere la prima riga di codice, avere un ambiente di sviluppo stabile ed efficiente è di fondamentale importanza. Questo non solo ti permette di concentrarti sulla costruzione della logica del programma, ma ti aiuta anche a evitare alcuni errori comuni.

Configurazione dell’ambiente di sviluppo locale

Si consiglia di utilizzare pacchetti per ambienti server locali, come XAMPP, MAMP o il più professionale Local by Flywheel. Assicurarsi che la versione di PHP (consigliata 7.4 o superiore) sia compatibile con l’ambiente WordPress che si intende distribuire, e abilitare il modalità di debug.wp-config.phpNel file, sono stati effettuati i seguenti impostazioni:WP_DEBUG为trueDurante la fase di sviluppo, verranno visualizzati tutti gli errori e gli avvisi, il che ti aiuterà a individuare rapidamente i problemi.

Si consiglia di leggere Guida all’approccio di base allo sviluppo di plugin per WordPress: dal nulla alla creazione di moduli funzionali professionali。

Pianificazione della struttura dei file dei plugin

Un plugin standard richiede almeno un file principale. La pratica consueta consiste nel creare una cartella dedicata al plugin, che deve essere chiamata in base alla funzionalità principale di questo. Ad esempio…my-first-pluginIn quella cartella, il file principale ha solitamente lo stesso nome della cartella stessa, con l’estensione “..phpOvvero,my-first-plugin.phpUna struttura chiara facilita l’aggiunta successiva di file JavaScript, CSS, pacchetti linguistici o file contenenti classi.

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

Creare il file principale del plugin e le informazioni di intestazione di base.

L“”ingresso” ai plugin, nonché i meccanismi di identificazione degli utenti, dipendono dalle informazioni presenti nella parte iniziale del file principale (il file header). Questo rappresenta il fattore chiave per il funzionamento corretto di WordPress nel riconoscere e caricare i plugin.

Scrivere una testa di plugin standard

All’inizio del file PHP principale, è necessario utilizzare un blocco di commenti PHP specifico per fornire le informazioni sul plugin. Queste informazioni verranno visualizzate sulla pagina di gestione dei plugin nell’interfaccia amministrativa di WordPress.

<?php
/**
 * Plugin Name:       我的第一个功能插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个实战指南中创建的示例插件，用于演示核心开发流程。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Tra questi,Plugin Name和Text DomainQuesto campo è obbligatorio; gli altri campi sono opzionali. È presente un campo di testo.Text DomainUtilizzato per il supporto all’internazionalizzazione.

Prevenire l’accesso diretto ai file

Per proteggere la sicurezza del codice dei plugin e prevenire eventuali perdite di informazioni o errori dovuti all’accesso diretto ai file principali tramite URL, è necessario aggiungere un controllo di accesso diretto dopo le informazioni di intestazione (header) e prima di qualsiasi altro codice.

Si consiglia di leggere Guida allo sviluppo personalizzato del plug-in WooCommerce: creare un negozio online esclusivo.。

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

CostanteABSPATHSi tratta di un percorso assoluto relativo al directory radice di WordPress; esso viene definito durante l’esecuzione di WordPress stesso. Questo condizione garantisce che il codice successivo venga eseguito soltanto all’interno di un ambiente WordPress.

Implementare le funzionalità principali e gli hook di WordPress

WordPress offre due potenti meccanismi: gli “action hooks” e i “filter hooks”, che permettono al tuo codice di intervenire nei processi principali del sistema o di modificare i dati in momenti specifici. Comprendere e utilizzare questi strumenti è fondamentale per lo sviluppo di plugin.

Utilizzare gli “action hooks” per aggiungere funzionalità.

Gli “action hooks” (ganci di azione) ti permettono di eseguire codice personalizzato quando si verificano eventi specifici. Ad esempio, possiamo creare una funzionalità che aggiunge automaticamente i diritti d’autore in fondo al contenuto di un articolo. Per farlo, è necessario utilizzare…the_contentI filtri (che sono essenzialmente dei “hook” per il filtraggio, ma vengono utilizzati in modo simile ai “hook” per le azioni) e…wp_enqueue_scriptsGli “action hooks” vengono utilizzati per caricare risorse.

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

Innanzitutto, scriviamo una funzione.mfp_add_copyright_noticeE montarlo su…the_contentSul gancio.

// 在文章内容后添加版权声明
function mfp_add_copyright_notice( $content ) {
	if ( is_single() && in_the_loop() && is_main_query() ) {
		$copyright_text = '<p><em>Il copyright di questo articolo appartiene a questo sito; per ripubblicarlo, è necessario indicare la fonte.</em></p>';
		$content .= $copyright_text;
	}
	return $content;
}
add_filter( 'the_content', 'mfp_add_copyright_notice' );

Le condizioni di controllo garantiscono che la dichiarazione dei diritti d’autore venga visualizzata soltanto nel ciclo principale di un singolo articolo nella parte frontale del sito, senza influenzare la pagina stessa, il riassunto dell’articolo o il funzionamento del backend.

Modificare i dati utilizzando gli hook dei filtri

Gli “hook” dei filtri vengono utilizzati per modificare i dati che vi vengono passati. Supponiamo di voler modificare alcune parti del titolo di un sito web: possiamo creare una funzione e aggiungerla al sistema che gestisce i filtri.wp_titleO qualcosa di più moderno…document_title_partsFiltro.

Si consiglia di leggere Guida pratica all’intero processo di sviluppo di plugin per WordPress: dall’approccio iniziale alla padronanza delle tecniche più avanzate。

// 修改网站标题后缀
function mfp_modify_title_suffix( $title ) {
	if ( is_home() ) {
		$title['suffix'] = ' | 我的精彩博客';
	}
	return $title;
}
add_filter( 'document_title_parts', 'mfp_modify_title_suffix' );

Introdurre script e stili in modo sicuro

Per aggiungere stili grafici o interazioni all’interno di un plugin, è necessario utilizzare i metodi raccomandati da WordPress.wp_enqueue_style()和wp_enqueue_script()La funzione, e attraverso di essawp_enqueue_scriptsChiamata tramite hook.

// 注册并排队插件的前端样式
function mfp_enqueue_frontend_assets() {
	// 获取插件目录的URL
	$plugin_url = plugin_dir_url( __FILE__ );

// 排队一个CSS文件
	wp_enqueue_style(
		'mfp-frontend-style',
		$plugin_url . 'assets/css/frontend.css',
		array(),
		'1.0.0'
	);

// 排队一个JS文件，并依赖jQuery
	wp_enqueue_script(
		'mfp-frontend-script',
		$plugin_url . 'assets/js/frontend.js',
		array( 'jquery' ),
		'1.0.0',
		true // 在页脚加载
	);
}
add_action( 'wp_enqueue_scripts', 'mfp_enqueue_frontend_assets' );

Creare una pagina di gestione e opzioni di configurazione.

Molti plugin richiedono di fornire all’utente opzioni di configurazione. WordPress offre un’API di configurazione per creare in modo sicuro e standardizzato menu di gestione e pagine di impostazioni.

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

Aggiungere il menu di gestione

Prima di tutto, usaadd_action( ‘admin_menu’, … )Per registrare un nuovo elemento del menu di gestione o un sottomezzo, utilizzate la funzione seguente:mfp_create_admin_menuVerrà aggiunta una pagina di menu secondario all’interno del menu principale “Impostazioni”.

// 创建插件管理菜单
function mfp_create_admin_menu() {
	add_options_page(
		‘我的插件设置’, // 页面标题
		‘我的插件’,     // 菜单标题
		‘manage_options’, // 权限要求
		‘mfp-settings’,   // 菜单slug
		‘mfp_settings_page_html’ // 用于输出页面内容的回调函数
	);
}
add_action( ‘admin_menu’, ‘mfp_create_admin_menu’ );

Creare una pagina di configurazione e i relativi campi

Successivamente, è necessario definire la funzione di callback.mfp_settings_page_htmlPer renderizzare il contenuto della pagina, utilizziamo l’API di configurazione per registrare un gruppo di impostazioni, un’opzione e i campi specifici.

// 设置页面的HTML输出
function mfp_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
			// 输出设置字段、非ce等
			settings_fields( ‘mfp_options_group’ );
			do_settings_sections( ‘mfp-settings’ );
			submit_button( ‘保存设置’ );
			?>
		<input type="hidden" name="trp-form-language" value="it"/></form>
	</div>
	‘mfp_field_copyright_text’ )
	);
}
add_action( ‘admin_init’, ‘mfp_settings_init’ );

// 渲染版权文本文档字段
function mfp_field_copyright_text_html() {
	$options = get_option( ‘mfp_options’ );
	$value = $options[‘copyright_text’] ?? ‘默认版权文本’; // PHP 7.0+ 空合并运算符
	?&gt;
	<input type="“text”"
		   id="“mfp_field_copyright_text”"
		   name="“mfp_options[copyright_text]”"
		   value="“NO NUMERIC NOISE KEY" 1000”
		 class="“regular-text”">
	&lt;?php
}

Ora puoi procedere come previsto…mfp_add_copyright_noticeNella funzione, viene utilizzato…get_option( ‘mfp_options’ )[‘copyright_text’]Per ottenere dinamicamente il testo delle impostazioni dell’utente dal backend, è possibile rendere le funzionalità del plugin configurabili.

Riassumendo

Questo articolo descrive in dettaglio il processo completo per sviluppare un plugin funzionale per WordPress partendo da zero. Iniziamo con l’installazione dell’ambiente di sviluppo e la creazione del file principale che contiene le informazioni di intestazione standard, sottolineando l’importanza delle misure di sicurezza. Successivamente, esaminiamo in profondità il meccanismo dei “hook” utilizzato nello sviluppo di plugin per WordPress: spieghiamo come utilizzare gli “action hook” per eseguire codice e gli “filter hook” per modificare i dati, e mostriamo come caricare in modo sicuro i risorse front-end. Infine, utilizzando l’API di configurazione di WordPress, creiamo una pagina di gestione di livello professionale che consente agli utenti di personalizzare le funzionalità del plugin.

L’intero processo di sviluppo segue gli standard di codifica e le migliori pratiche di WordPress, inclusi l’utilizzo di prefissi unici per le funzioni, la validazione e l’elaborazione dei dati, nonché le basi per il supporto all’internazionalizzazione. Una volta acquisite queste conoscenze di base, è possibile espandere illimitatamente le funzionalità del proprio plugin combinando diversi “hook” (meccanismi di interazione con il sistema di WordPress), creando tabelle di database personalizzate, sviluppando strumenti utili o scrivendo codice breve.

FAQ - Domande frequenti

Come scegliere un prefisso appropriato per le funzioni e le classi di un plugin?

Tutte le funzioni, le classi, le variabili e le costanti globali presenti nei plugin devono utilizzare un prefisso unico per evitare conflitti di nomi con altri plugin o temi. Il prefisso è solitamente composto dall’abbreviazione o dal nome abbreviato del plugin; ad esempio, se il nome del plugin è “My First Plugin”, si può scegliere un prefisso appropriato.mfp_或myfirstplugin_Mantenere la coerenza è di fondamentale importanza.

Perché è necessario utilizzare `wp_enqueue_script` per aggiungere script?

Usarewp_enqueue_script()和wp_enqueue_style()È il metodo ufficialmente consigliato da WordPress. Consente di gestire correttamente le dipendenze da script (come jQuery), evita il caricamento ripetuto dello stesso script e permette ad altri plugin o temi di interagire con esso.wp_deregister_script()Per rimuovere o sostituire in modo sicuro il tuo script, utilizzalo direttamente.L’inserimento di tag rende impossibile godere di questi vantaggi di gestione e può causare conflitti.

Quali sono le principali linee guida di sicurezza da seguire nello sviluppo di plugin?

Il principio fondamentale è: non fidarsi mai degli input forniti dagli utenti. Per quanto riguarda tutto ciò che viene inviato dagli utenti…$_GET、$_POST、$_REQUESTI dati ottenuti dal database vengono verificati, puliti ed escapati. Questi dati vengono poi utilizzati per generare il codice HTML.esc_html()、esc_attr(); Utilizzare l'output per l'URL.esc_url()Nelle query SQL, è essenziale utilizzare…$wpdb->prepare()Eseguite query parametrizzate per prevenire gli attacchi di tipo SQL injection. Inoltre, utilizzate…current_user_can()Verifica i permessi dell’utente.

Come posso aggiungere il supporto all’internazionalizzazione al mio plugin?

Innanzitutto, è necessario impostare correttamente le informazioni nella parte iniziale del plugin.Text Domain和Domain PathPoi, in tutto il codice, in tutti i punti in cui sono presenti stringhe da tradurre, utilizzare…()Esegui l’output della traduzione._e()Eseguire la traduzione di “echos” (risposte o riflessi).( ‘Hello World’, ‘my-first-plugin’ )Infine, utilizzando uno strumento come Poedit, si può eseguire la scansione del codice per generare….potFile di template, creati per diverse lingue..po和.moTradurre il file e posizionarlo in…/languagesAll’interno della directory.