Costruire il tuo primo plugin WordPress può sembrare scoraggiante. Il sistema di hook, le API del database, l'interfaccia admin — c'è molto da imparare. Ma i fondamenti sono sorprendentemente semplici. Un plugin WordPress è solo un file PHP con un'intestazione specifica che WordPress riconosce. Tutto il resto è costruito su quella base.
Questo tutorial ti guida nella costruzione di un plugin WordPress completo da zero, coprendo ogni passaggio dall'intestazione del plugin alla sottomissione a WordPress.org.
L'Intestazione del Plugin
Ogni plugin WordPress inizia con un'intestazione. Crea una directory in wp-content/plugins con il nome del tuo plugin. Crea un file PHP con lo stesso nome. La parte superiore del file deve includere un commento di intestazione con nome del plugin, descrizione, versione, autore e licenza. Questa intestazione dice a WordPress che si tratta di un plugin e lo visualizza nella pagina admin dei plugin.
I campi minimi richiesti sono Plugin Name e Version. Aggiungi un campo URI che collega alla homepage del tuo plugin e un Author URI che collega al tuo sito web. Per i plugin inviati a WordPress.org, la licenza deve essere GPLv2 o successiva.
Registrare gli Hook
Dopo l'intestazione del plugin, definisci un hook di attivazione e uno di disattivazione. register_activation_hook() esegue il codice quando il plugin viene attivato. register_deactivation_hook() esegue il codice quando viene disattivato. Usa questi hook per impostare le opzioni predefinite, creare le tabelle del database o svuotare le regole di rewrite.
Per la funzionalità principale del plugin, agganciati alle azioni e ai filtri di WordPress usando add_action() e add_filter(). L'hook più comune è init, che viene eseguito dopo il caricamento di WordPress ed è usato per registrare custom post type, tassonomie e shortcode.
Aggiungere una Pagina Admin
La maggior parte dei plugin ha bisogno di una pagina di impostazioni admin. Usa l'azione admin_menu per registrare la tua pagina admin. add_menu_page() aggiunge una voce di menu di primo livello. add_submenu_page() aggiunge un sottomenu sotto un menu esistente. Nella tua funzione callback della pagina, genera l'HTML per la tua pagina di impostazioni.
Usa la Settings API per le pagine di impostazioni standard dei plugin. register_setting() comunica a WordPress la tua impostazione. add_settings_section() e add_settings_field() creano i campi del modulo. do_settings_sections() li renderizza nella tua pagina admin. Questa API gestisce automaticamente l'invio dei moduli, la validazione e i messaggi di errore.
Creare uno Shortcode
Gli shortcode permettono agli utenti di incorporare le funzionalità del tuo plugin nei post e nelle pagine. Usa add_shortcode() per registrare uno shortcode. La funzione callback riceve gli attributi e il contenuto dello shortcode e restituisce l'output HTML. Tieni semplici le callback degli shortcode — la logica complessa dovrebbe stare in funzioni helper o classi.
Restituisci l'output dalla callback dello shortcode invece di stamparlo. Gli shortcode dovrebbero restituire una stringa che sostituisce il tag dello shortcode nel contenuto del post.
Aggiungere Custom Post Type
I custom post type estendono WordPress oltre i post e le pagine. Usa register_post_type() durante l'hook init per registrare il tuo tipo di contenuto personalizzato. Definisci le label, le funzionalità supportate e la struttura degli URL. Registra una tassonomia con register_taxonomy() se hai bisogno di categorizzare gli elementi del tuo custom post type.
Svuota le regole di rewrite durante l'attivazione così che gli URL del tuo custom post type funzionino. Aggiungi custom meta box con add_meta_box() per i campi dati aggiuntivi nella schermata di modifica del tuo custom post type.
Prepararsi per WordPress.org
Quando il tuo plugin è pronto, preparalo per la directory dei plugin di WordPress.org. Crea un file README.txt usando il formato readme dei plugin WordPress. Controlla il tuo codice con PHPCS rispetto agli standard di codifica WordPress. Assicurati che tutte le stringhe di testo siano internazionalizzate con __() e _e(). Aggiungi una licenza e un update URI all'intestazione del plugin.
Invia il tuo plugin tramite il modulo di sottomissione dei plugin di WordPress.org. Il team di revisione controllerà il tuo codice per problemi di sicurezza, conformità agli standard di codifica e documentazione adeguata.
Il punto fondamentale
Costruire un plugin WordPress da zero segue uno schema coerente. Inizia con l'intestazione del plugin, aggiungi gli hook per l'attivazione e la disattivazione, crea una pagina di impostazioni admin, registra shortcode e custom post type e prepara il tuo plugin per la sottomissione. Ogni plugin che costruisci seguirà questa stessa struttura, con variazioni solo nelle funzionalità specifiche che implementi.
