Un plugin WordPress \u00e8 fondamentalmente una directory contenente file PHP che estendono le funzionalit\u00e0 del CMS. La struttura minima richiede un file principale con un’intestazione specifica riconosciuta da WordPress. Puoi posizionare la directory del plugin in wp-content\/plugins\/ o in wp-content\/mu-plugins\/ per i must-use plugin.<\/p>\n
La struttura consigliata per un plugin ben organizzato include:<\/p>\n
Il file principale del plugin deve iniziare con un header comment che WordPress utilizza per identificare e visualizzare il plugin nella schermata di amministrazione. Ecco la struttura obbligatoria:<\/p>\n
L’header include: Plugin Name, Plugin URI, Description, Version, Requires at least, Requires PHP, Author, Author URI, License e License URI. Campi aggiuntivi come Text Domain e Domain Path sono necessari per l’internazionalizzazione.<\/p>\n
Dopo l’header, usa un controllore di accesso diretto per impedire l’esecuzione del file se chiamato direttamente via URL: WordPress fornisce hook specifici per gestire il ciclo di vita del plugin. register_activation_hook() esegue codice all’attivazione: creazione di tabelle personalizzate, impostazione di opzioni predefinite, controllo dei requisiti di sistema.<\/p>\n register_deactivation_hook() esegue codice alla disattivazione: pulizia di cache temporanee, disattivazione di cron job, ma non deve mai eliminare dati utente. Questo \u00e8 importante: l’utente potrebbe riattivare il plugin in futuro e ritrovare i propri dati intatti.<\/p>\n Per la disinstallazione, il metodo migliore \u00e8 usare un file uninstall.php nella root del plugin. Viene eseguito solo quando l’utente elimina il plugin, non alla semplice disattivazione. Qui puoi rimuovere definitivamente tutte le opzioni, tabelle e dati creati dal plugin.<\/p>\n La maggior parte dei plugin offre una pagina di impostazioni nel backend. Puoi aggiungerla usando le WordPress Settings API, che gestiscono automaticamente validazione e salvataggio dei dati. Le funzioni principali sono:<\/p>\n Le Settings API seguono il principio di separazione tra presentazione e logica. Definisci i campi in una funzione e renderizzali in un template. Questo rende il codice manutenibile e facile da estendere.<\/p>\n I custom post type (CPT) permettono di aggiungere tipi di contenuto personalizzati oltre a post e pagine. Si registrano con register_post_type(), specificando label, supporti (thumbnail, editor, excerpt), rewrite rules e capacit\u00e0. Per portfolio, testimonianze, eventi, prodotti (se non usi WooCommerce), i CPT sono la soluzione ideale.<\/p>\n Le tassonomie personalizzate (register_taxonomy()) aggiungono sistemi di categorizzazione specifici per i tuoi CPT. Se crei un CPT “Libri”, puoi registrare una tassonomia “Genere” per classificarli. Le tassonomie supportano gerarchia (come le categorie) o piatta (come i tag).<\/p>\n Dopo aver registrato CPT e tassonomie, flusha le rewrite rule con flush_rewrite_rules() durante l’attivazione del plugin, mai a ogni caricamento della pagina.<\/p>\n Gli shortcode permettono agli utenti di inserire funzionalit\u00e0 complesse nei contenuti con una semplice sintassi [mioshortcode]. Si registrano con add_shortcode() e accettano attributi e contenuto racchiuso. Un esempio classico \u00e8 uno shortcode che mostra un pulsante personalizzato: [pulsante colore=”rosso” url=”https:\/\/esempio.com”]Clicca qui[\/pulsante].<\/p>\n I widget sono blocchi riutilizzabili posizionabili nelle sidebar. La vecchia API (WP_Widget) \u00e8 ancora supportata, ma dal 2024 il futuro sono i Block Widget basati su Gutenberg. Per nuovi plugin, sviluppa widget come blocchi Gutenberg: sono pi\u00f9 flessibili e compatibili con il Full Site Editing.<\/p>\n WordPress REST API \u00e8 il modo moderno per interagire con i dati del sito via HTTP. Puoi registrare endpoint personalizzati usando register_rest_route(). Ogni endpoint specifica namespace, route, metodi (GET, POST, PUT, DELETE) e callback di autorizzazione.<\/p>\n Esempio pratico: un endpoint \/mioplugin\/v1\/dati che restituisce dati in formato JSON a chiamate AJAX dal front-end. La REST API gestisce automaticamente serializzazione, validazione e permessi. Usa sempre permission_callback per verificare che l’utente abbia i diritti necessari.<\/p>\n Per la sicurezza degli endpoint, implementa nonce verification per le richieste provenienti dal front-end e verifica le capability per le richieste amministrative.<\/p>\n Scrivere plugin sicuri \u00e8 fondamentale. WordPress fornisce numerose API per proteggere il codice:<\/p>\n Non fidarti mai dell’input utente. Anche gli amministratori possono essere ingannati da attacchi XSS. Ogni dato che arriva da $_GET, $_POST, $_REQUEST o dal database deve essere trattato come potenzialmente pericoloso fino a prova contraria.<\/p>\n Per rendere il tuo plugin traducibile, usa le funzioni di WordPress: __() e _e() per stringhe semplici, _n() per plurali, _x() e _ex() per stringhe con contesto. Il text domain deve corrispondere al nome della directory del plugin, come dichiarato nell’header comment.<\/p>\n Genera il file .pot con strumenti come Poedit o WP-CLI, poi traduci in .po e compila in .mo. Per caricare le traduzioni, usa load_plugin_textdomain() all’inizio del plugin. Se distribuisci su WordPress.org, le traduzioni vengono caricate automaticamente dal translate.wordpress.org.<\/p>\n Pubblicare un plugin sul repository ufficiale di WordPress.org lo rende disponibile a milioni di utenti. Il processo richiede:<\/p>\n Una volta approvato, il plugin avr\u00e0 una pagina su WordPress.org, statistiche di download, valutazioni degli utenti e aggiornamenti automatici per gli installati. Mantieni il plugin aggiornato, rispondi ai ticket di supporto e aggiorna la compatibilit\u00e0 con le ultime versioni di WordPress.<\/p>\n Creare un plugin WordPress da zero \u00e8 pi\u00f9 accessibile di quanto sembri. Seguendo la struttura standard, utilizzando le API ufficiali e applicando le best practice di sicurezza, puoi sviluppare plugin robusti e professionali. Inizia con un plugin semplice (uno shortcode, una pagina di impostazioni) e gradualmente aggiungi complessit\u00e0. La documentazione ufficiale WordPress Developer Resources \u00e8 il tuo miglior alleato: \u00e8 completa, aggiornata e ricca di esempi pratici.<\/p>\n","protected":false},"excerpt":{"rendered":" Struttura di un plugin WordPress Un plugin WordPress \u00e8 fondamentalmente una directory contenente file PHP che estendono le funzionalit\u00e0 del CMS. La struttura minima richiede un file principale con un’intestazione specifica riconosciuta da WordPress. Puoi posizionare la directory del plugin in wp-content\/plugins\/ o in wp-content\/mu-plugins\/ per i must-use plugin. La struttura consigliata per un plugin […]<\/p>\n","protected":false},"author":1,"featured_media":2053,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_gspb_post_css":"","ai_primary_source":"Studio Immens Blog","visibility_scope":"both","ai_summary":"Struttura di un plugin WordPress Un plugin WordPress \u00e8 fondamentalmente una directory contenente file PHP che estendono le funzionalit\u00e0 del CMS. La struttura minima richiede un file principale con un'intestazione specifica riconosciuta da WordPress. Puoi posizionare la directory del plugin in wp-...","ai_intent":"informative","ai_related_resources":"","ai_priority":5,"ai_entity_type":"Article","ai_is_based_on":"https:\/\/blog.studioimmens.com\/creare-un-plugin-wordpress-da-zero\/","ai_citations":"","ai_mentions":"","ai_speakable_selector":"","ai_chunk_hints":"Creare, un, plugin, WordPress","footnotes":""},"categories":[133],"tags":[],"ai_visibility":[],"class_list":["post-1935","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-wordpress"],"blocksy_meta":[],"_links":{"self":[{"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/posts\/1935","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/comments?post=1935"}],"version-history":[{"count":0,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/posts\/1935\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/media\/2053"}],"wp:attachment":[{"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/media?parent=1935"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/categories?post=1935"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/tags?post=1935"},{"taxonomy":"ai_visibility","embeddable":true,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/ai_visibility?post=1935"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}if (!defined('ABSPATH')) exit;<\/code>. Questo \u00e8 uno standard di sicurezza fondamentale.<\/p>\nAttivazione, disattivazione e disinstallazione<\/h2>\n
Aggiungere una pagina di impostazioni<\/h2>\n
\n
Creare custom post type e tassonomie<\/h2>\n
Shortcode e widget<\/h2>\n
Esporre API REST endpoints<\/h2>\n
Best practice di sicurezza<\/h2>\n
\n
Internazionalizzazione<\/h2>\n
Distribuzione su WordPress.org<\/h2>\n
\n
Conclusione<\/h2>\n