Guida gratuita · 7 min di lettura
Come pubblicare un tema su WordPress.org: i requisiti spiegati
Cosa deve avere un tema per entrare nella directory ufficiale, quali sono gli errori più comuni e come controllarli prima di inviarlo.
Di Denis Franchi, Theme Moderator nel WordPress Themes Team ·
Pubblicare un tema nella directory di WordPress.org è gratuito, e chiunque può farlo. Il tema però deve rispettare una lista di requisiti, e molti invii si fermano sempre sugli stessi punti.
In questa guida li ripercorro in italiano, nell’ordine in cui conviene controllarli. La fonte è la pagina Required del Theme Review Handbook, aggiornata il 9 giugno 2026. I requisiti cambiano nel tempo: prima di inviare, rileggi sempre l’originale.
Un tema con tre o più problemi distinti può essere chiuso come non approvato. Puoi correggerlo e inviarlo di nuovo, ma perdi tempo: meglio arrivare preparati.
1. Licenza e copyright
È il primo punto dell’handbook e uno dei più trascurati.
- Tutto quello che c’è nello zip deve essere compatibile con la GPL: codice, immagini, font, librerie. La licenza consigliata è la stessa di WordPress, «GPLv2 or later».
- Dichiara il copyright del tema.
- Per ogni risorsa di terzi indica licenza, copyright e fonte, tutte nello stesso file. Di solito è
readme.txt. - Il design e il codice devono essere tuoi. Clonare il design di un altro tema non è ammesso.
- Il copyright mostrato nel sito deve essere quello dell’utente, non il tuo.
L’errore tipico: un’immagine o un font presi online, senza licenza indicata.
2. Privacy e risorse esterne
- Qualsiasi raccolta di dati deve essere disattivata all’inizio e partire solo se l’utente la attiva.
- Tutte le risorse devono stare dentro lo zip: script, immagini, video. Niente CDN e niente chiamate a server esterni senza il consenso esplicito dell’utente.
I font e Google Fonts
Qui la regola scritta e la pratica consigliata non coincidono, quindi le tengo separate.
Cosa dice il requisito. La pagina Required indica ancora Google Fonts come unica eccezione alla regola sulle risorse esterne. Sulla carta, quindi, caricare un font dai server di Google non è vietato.
Cosa raccomanda il team. Dal 2022 il Themes Team raccomanda con forza di caricare i font in locale, per motivi di privacy e GDPR: un font caricato dai server di Google rivela l’indirizzo IP di chi visita il sito. In un secondo articolo il team ha scritto che l’eccezione è destinata a cambiare.
Cosa ti consiglio. Includi sempre i font nel tema, in qualsiasi tipo di tema:
- nei temi a blocchi i font si dichiarano in
theme.jsone i file stanno nella cartella del tema; - nei temi classici puoi includere i file nel tema e caricarli con
@font-face, oppure fare in modo che il tema li scarichi e li salvi sul server del sito; - un font incluso nel tema deve avere una licenza per font compatibile con la GPL, per esempio la SIL Open Font License, e va elencato con licenza e fonte come ogni altra risorsa.
Un font ospitato in locale non è più una risorsa esterna, quindi non richiede il consenso dell’utente.
3. Accessibilità
Sono tre i punti da controllare in tutti i temi.
Skip link. Se prima del contenuto c’è qualcosa da saltare, come un menu, serve un link che porti direttamente al contenuto. Deve essere il primo elemento raggiungibile da tastiera e deve diventare visibile quando riceve il focus. Nei temi a blocchi WordPress lo aggiunge da solo.
Navigazione da tastiera. Ogni link e ogni controllo deve essere raggiungibile e utilizzabile con la tastiera, anche nel menu mobile.
Focus visibile e a contrasto. Quando un elemento riceve il focus da tastiera, si deve vedere chiaramente: vale per le voci di menu, i link nel testo, i campi dei moduli e i pulsanti. L’indicatore deve avere un contrasto sufficiente rispetto allo sfondo. Un cambio di colore appena percettibile non basta.
/* Sbagliato: il focus sparisce */
a:focus {
outline: none;
}
/* Corretto: un contorno ben visibile */
a:focus-visible {
outline: 2px solid currentColor;
outline-offset: 2px;
}
Un controllo veloce: apri il tema e naviga solo con il tasto Tab. Se a un certo punto non sai più dove sei, c’è un problema.
4. Codice e sicurezza
- Nessun errore, warning o notice di PHP e JavaScript. Sviluppa con
WP_DEBUGattivo. - Nessuna funzione deprecata.
- Valida e sanifica i dati prima di salvarli nel database.
- Fai l’escape di tutto quello che stampi.
L’escape mancante è l’errore che si incontra più spesso:
// Sbagliato
echo get_theme_mod( 'miotema_footer_text' );
// Corretto
echo esc_html( get_theme_mod( 'miotema_footer_text' ) );
Il prefisso
Tutto quello che il tema definisce nello spazio pubblico deve avere un prefisso unico di almeno quattro lettere: funzioni, opzioni, costanti, variabili globali, handle di script e stili, nomi delle dimensioni immagine.
// Sbagliato
function setup() { /* ... */ }
// Corretto
function miotema_setup() { /* ... */ }
Non vanno prefissati gli handle di librerie di terzi, le posizioni dei menu e gli ID delle sidebar.
5. Cosa non deve fare un tema
Un tema si occupa dell’aspetto. Le funzionalità stanno nei plugin. Per questo un tema non può includere:
- custom post type, blocchi personalizzati, shortcode;
- ruoli utente o altre funzioni che non riguardano design e presentazione;
- plugin o file zip nella cartella del tema.
Puoi consigliare dei plugin, ma solo se sono ospitati su WordPress.org, e l’installazione deve partire da un’azione dell’utente.
Non puoi nemmeno nascondere la barra di amministrazione, fare redirect all’attivazione del tema o mettere funzioni di WordPress dietro un pagamento.
6. Nome del tema
- Il nome non può contenere «WordPress», «Theme» o «Twenty».
- Scrivi sempre «WordPress» in una parola sola, con W e P maiuscole.
- Non usare marchi di altri.
- Il team può chiederti di cambiare nome se è troppo simile a un tema o a un marchio esistente.
7. Traduzioni
Tutte le stringhe di testo devono essere traducibili con le funzioni gettext. Il text domain deve essere lo slug del tema, cioè il nome in minuscolo con i trattini al posto degli spazi, e va dichiarato in style.css.
// Sbagliato
echo 'Leggi tutto';
// Corretto
esc_html_e( 'Read more', 'mio-tema' );
8. I file
style.csscon le intestazioni richieste. Theme URI e Author URI sono facoltativi, ma se li usi devono puntare a pagine sul tema o sull’autore.readme.txtvalido.- Screenshot in proporzione 4:3, non più grande di 1200 × 900 px. Non deve sembrare una pubblicità.
- Se usi file minificati, includi anche gli originali.
- Non includere librerie che WordPress ha già, come jQuery: usa la versione di WordPress.
- Togli le cartelle
.gite simili, e il codice pensato per una versione a pagamento.
9. Tema classico o tema a blocchi
Tema a blocchi. I file obbligatori sono style.css, readme.txt, theme.json e templates/index.html. I template devono essere completi, senza blocchi con tag di chiusura mancanti o sbagliati.
Tema classico. Servono, tra le altre cose:
wp_head()subito prima di</head>ewp_footer()subito prima di</body>;wp_body_open()subito dopo<body>,body_class()epost_class();add_theme_support( 'title-tag' )eadd_theme_support( 'automatic-feed-links' );- i template standard richiamati con le loro funzioni, per esempio
get_header()eget_footer().
10. Avvisi, pagine di amministrazione e link
- Gli avvisi nel pannello devono usare l’hook
admin_noticese devono potersi chiudere. Niente popup all’attivazione. - Le impostazioni si salvano con le API Settings e Options, in una sola opzione con il prefisso del tema.
- Non sono ammessi import di demo, chiamate esterne e link di affiliazione o tracciamento nelle pagine del tema.
- Sul sito è ammesso un solo link di credito, verso il Theme URI o l’Author URI, più uno facoltativo verso WordPress.org.
- Niente promozioni invadenti nel pannello e nessuna promozione nel sito pubblico.
11. Un tema alla volta
Puoi inviare un solo tema nuovo alla volta. Gli aggiornamenti dei temi già in directory invece non hanno limiti.
Prima di inviare
Una lista corta da ripassare:
- Ogni immagine, font e libreria ha licenza e fonte in
readme.txt. - Nessun file caricato da server esterni, e i font inclusi nel tema con la loro licenza.
- Il tema si usa tutto con la tastiera e il focus è ben visibile, con un buon contrasto.
WP_DEBUGattivo: nessun errore, warning o notice.- Ogni output ha il suo escape e ogni funzione ha il prefisso.
- Tutte le stringhe sono traducibili, con il text domain giusto.
- Screenshot 4:3,
readme.txtvalido, nessuna cartella.git. - Nessuna funzionalità da plugin.
Installa anche il plugin Theme Check: esegue in automatico una parte di questi controlli. Non li copre tutti, quindi usalo insieme alla lista, non al suo posto.
Quando tutto è a posto, puoi caricare il tema dalla pagina di upload di WordPress.org. La revisione viene fatta dai volontari del Themes Team.