Guida allo sviluppo di plugin per WordPress: Crea il tuo primo plugin personalizzato da zero

Ambiente di sviluppo e preparazioni di base

Prima di iniziare a scrivere il codice, è essenziale disporre di un ambiente di sviluppo locale stabile ed efficiente. Per lo sviluppo di plugin per WordPress, consigliamo l’uso di ambienti integrati come XAMPP, MAMP o Local by Flywheel, che permettono di installare automaticamente Apache, MySQL e PHP con un solo clic, evitando così procedure di configurazione complesse. Assicurati che la versione di PHP sia almeno 7.4 e quella di MySQL almeno 5.6, in linea con i requisiti più recenti raccomandati da WordPress.

Successivamente, avrai bisogno di un editor di codice. Visual Studio Code, PhpStorm o Sublime Text sono ottime scelte: offrono evidenziazione del codice, suggerimenti automatici e funzionalità di debug, il che può migliorare notevolmente l’efficienza dello sviluppo. Inoltre, installa uno strumento di controllo della versione, come Git, per gestire la storia dei cambiamenti apportati al codice; questa è una pratica standard nel mondo dello sviluppo moderno.

Comprendere la struttura di base di un plugin per WordPress è il primo passo. Un plugin di base contiene almeno un file PHP principale; le annotazioni presenti all’inizio di questo file costituiscono il “cartellino d’identità” del plugin, utilizzate per comunicare informazioni sullo stesso al sistema WordPress. Questo file può esistere in modo indipendente, oppure può fungere da punto di ingresso per un intero catalogo di plugin più complessi.

Si consiglia di leggere Sviluppo di plugin per WordPress: dall’approccio iniziale alla maestria: crea il tuo primo plugin personalizzato。

Crea il tuo primo file di plugin.

Iniziamo creando il plugin più semplice possibile. Prima di tutto, entri nella directory di installazione di WordPress locale.wp-content/pluginsCartella. Qui, crea una nuova cartella e daile il nome…my-first-pluginTutti i file relativi ai plugin verranno posizionati in questo directory.

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

All’interno di quella cartella, creare un file PHP principale, ad esempio chiamandolo “main.php”.my-first-plugin.phpLa parte iniziale di questo file deve contenere un blocco di annotazioni con informazioni specifiche sui plugin. Ecco un esempio standard:

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

Nel testo dell’annotazione, “Nome del plugin” è un campo obbligatorio: WordPress ne ha bisogno per riconoscere e visualizzare il tuo plugin nell’elenco dei plugin disponibili in background. Altre informazioni, come il numero di versione e l’autore, aiutano gli utenti a conoscere meglio le caratteristiche del plugin. Dopo aver salvato il file, accedi al pannello di amministrazione di WordPress e vai alla pagina “Plugin”; dovresti vedere il tuo plugin (“Il mio primo plugin”) nell’elenco e poterlo attivare o disattivare. Al momento non ha alcuna funzionalità, ma hai comunque creato con successo una struttura di base per un plugin valido.

Aggiungere funzionalità essenziali al plugin

Un plugin attivato deve eseguire il proprio codice tramite il meccanismo dei “hook” di WordPress. Esistono due tipi di hook: gli Action Hooks e i Filter Hooks. Gli Action Hooks ti permettono di inserire codice in momenti specifici del processo per eseguire determinate funzionalità, mentre i Filter Hooks ti consentono di modificare i dati che vengono passati durante l’esecuzione del codice.

Utilizzare gli “action hooks” per aggiungere un menu di gestione.

Per permettere agli utenti di interagire con i plugin, di solito è necessario aggiungere una pagina di configurazione nel pannello di amministrazione di WordPress. Questo può essere fatto tramite…add_action()La funzione viene montata suadmin_menuQuesto hook di azione viene utilizzato per implementare il funzionamento desiderato.

Si consiglia di leggere Guida definitiva allo sviluppo di plugin per WordPress: creare il primo plugin personalizzato da zero。

Innanzitutto, definiamo una funzione nel file principale del plugin per generare il contenuto HTML della pagina di configurazione. Questa funzione può essere chiamata…mfp_settings_page_htmlPoi creiamo un’altra funzione, ad esempio…mfp_add_admin_menuIn cui viene utilizzato WordPress.add_menu_page()Una funzione per registrare un nuovo elemento di menu di livello superiore. Infine, utilizzare…add_action('admin_menu', 'mfp_add_admin_menu')Carica la funzione di registrazione nel sistema.

Modificare il contenuto di un articolo utilizzando gli hook dei filtri

Oltre alle funzionalità di back-end, i plugin vengono spesso utilizzati per modificare il contenuto visibile sul sito web (il front-end). Ad esempio, è possibile aggiungere automaticamente una dichiarazione di copyright alla fine di ogni articolo. Per farlo, è necessario utilizzare un plugin appropriato.the_contentQuesto filtro hook.

Definiamo una funzione, ad esempio chiamata…mfp_add_copyright_to_contentRiceve un parametro (ovvero il contenuto originale dell’articolo) e aggiunge in coda del testo HTML personalizzato. Successivamente, tramite…add_filter('the_content', 'mfp_add_copyright_to_content')Registra questa funzione come filtro. In questo modo, ogni volta che WordPress richiede il contenuto di un articolo, esso verrà prima elaborato dalla nostra funzione: verranno aggiunte le informazioni sul copyright prima che il contenuto venga visualizzato.

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

Sicurezza, ottimizzazione e pubblicazione di plugin

Lo sviluppo delle funzionalità è solo il primo passo: garantire la sicurezza e le prestazioni del plugin è altrettanto importante. Tutti i dati inseriti dagli utenti devono essere sottoposti a controlli rigorosi, processi di “escape” e pulizia prima di essere memorizzati nel database o visualizzati sulle pagine web. WordPress offre una serie di funzioni di sicurezza molto utili per questo scopo.sanitize_text_field()(Cleaning the text)esc_html()(Escape HTML) ewp_kses()(È consentito l’uso di tag HTML specificati; assicuratevi di utilizzarli nei punti appropriati.)

Per migliorare la manutenibilità e le prestazioni del plugin, si consiglia di seguire i principi della programmazione orientata agli oggetti (OOP) nell’organizzazione del codice, incapsulando le funzionalità all’interno di classi. Inoltre, è opportuno utilizzare correttamente l’API per i dati temporanei (Transients API) di WordPress per memorizzare i risultati di query che richiedono molto tempo o i dati ottenuti da richieste remote, in modo da evitare calcoli ripetuti ad ogni caricamento della pagina.

Quando le funzionalità del tuo plugin saranno complete e avranno superato i test, potrai considerare la possibilità di pubblicarlo. Dovrai preparare un documento chiaro e dettagliato che descriva tutte le caratteristiche del plugin, i suoi requisiti di installazione, come utilizzarlo e qualsiasi altra informazione rilevante per gli utenti.readme.txtI file devono essere in formato conforme ai requisiti di WordPress.org e devono contenere informazioni relative alle funzionalità del plugin, ai metodi di installazione, ai log di aggiornamento e alle domande più comuni. Se desideri inviare il plugin al catalogo ufficiale di plugin di WordPress, è necessario creare un repository SVN e seguire le relative linee guida per lo sviluppo del codice e le procedure di submission. Per i plugin commerciali, inoltre, è necessario predisporre propri server per le attività di vendita e di aggiornamento del software.

Si consiglia di leggere Padroneggiare completamente lo sviluppo di plugin per WordPress: costruire funzionalità personalizzate da zero.。

Riassumendo

Attraverso questa guida, abbiamo percorso il percorso fondamentale dello sviluppo di plugin per WordPress: dalla creazione dell’ambiente di sviluppo e della struttura dei file di base, all’implementazione di funzionalità attraverso azioni (actions) e hook dei filtri (filters), fino alle attenzioni finali alla sicurezza, all’ottimizzazione e alla preparazione per la pubblicazione del plugin. L’essenza dello sviluppo di plugin consiste nell’estendere le funzionalità di base di WordPress, e il meccanismo dei hook rappresenta il ponte che collega il tuo codice al mondo di WordPress. Una volta acquisite queste nozioni di base, potrai esplorare API più complesse e nuove possibilità consultando la documentazione ufficiale dei plugin e il codice sorgente di WordPress, per creare plugin potenti, sicuri e apprezzati dagli utenti.

FAQ - Domande frequenti

Quali file deve contenere un plugin?

Il plugin più semplice può contenere soltanto un file PHP con le giuste annotazioni relative all’intestazione del file. Tuttavia, con l’aumentare della complessità delle funzionalità, di solito viene incluso un insieme più ampio di file: PHP, JavaScript, CSS, risorse grafiche, nonché altri elementi necessari per il corretto funzionamento del plugin.readme.txtFile di istruzioni: Il file principale PHP è essenziale.

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

Come posso evitare che il mio plugin entri in conflitto con altri plugin?

Aggiungere un prefisso unico a tutti i nomi delle funzioni, delle classi, delle costanti e delle variabili globali è la migliore pratica per evitare conflitti di denominazione. Di solito si utilizzano abbreviazioni di plugin o nomi specifici come prefisso.mfp_或my_plugin_Inoltre, incapsulare il codice all’interno di una classe permette di isolare efficacemente gli ambiti di utilizzo dei vari elementi del programma.

Come aggiungere opzioni di configurazione personalizzabili a un plugin?

Si consiglia di utilizzare l’API WordPress Settings per creare pagine di configurazione sicure e standardizzate. Questa API fornisce funzioni per registrare le impostazioni, aggiungere campi e sezioni di configurazione, nonché per gestire automaticamente il salvataggio delle opzioni, la loro validazione e il processo di verifica (come il meccanismo NonCE). Risulta molto più semplice e affidabile rispetto a un approccio manuale.$_POSTI dati devono essere molto più sicuri e convenienti da utilizzare.

Come si possono debuggare gli errori presenti nei plugin durante lo sviluppo?

Prima di tutto, assicurati che…wp-config.phpIl file ha attivato il modalità di debug di WordPress.WP_DEBUGLa costante è impostata sutrueInoltre, è possibile installare e attivare plugin di debug professionali come Query Monitor, che ti aiutano a visualizzare le query eseguite sul database, l’esecuzione dei “hook”, gli errori di PHP e i punti di blocco nella performance del sistema. Si tratta di strumenti essenziali durante il processo di sviluppo.