Stai guardando il pannello di amministrazione di WordPress e pensi: «Posso fare molto di più che trascinare blocchi». Oppure scrivi già PHP/JavaScript e vuoi capire come funziona sotto il cofano il CMS più diffuso al mondo. Entrambi gli scenari portano alla stessa domanda: da dove iniziare con lo sviluppo WordPress per non affogare nella documentazione e mollare dopo una settimana?

Il problema non è la complessità di WordPress. Il problema è che la maggior parte delle «guide per principianti» spiega come installare un tema dal pannello di amministrazione oppure ti butta subito nella creazione di un plugin con gli hook e la REST API. Non esiste quasi una via di mezzo, una tabella di marcia da zero al tuo primo codice significativo. Ci siamo passati anche noi e abbiamo messo insieme quanto segue: niente fronzoli, con strumenti specifici e link a risorse aggiornate.

💡 Panoramica rapida:

• PHP, CSS, HTML: tre linguaggi che ti servono subito; JavaScript arriva dopo, una volta padroneggiate le basi
• Ambiente locale: WordPress Studio o Local, operativi in 5 minuti, senza bisogno di hosting
• Temi: il miglior punto di partenza per i principianti; plugin: il livello successivo; core: per sviluppatori PHP esperti
• Risorse ufficiali: Developer Resources, Learn WordPress e WP-CLI coprono la maggior parte delle domande comuni
• Community: forum, WordCamp e canali Slack, ciò che trasforma l'apprendimento individuale in una carriera

1. Su cosa è costruito WordPress

WordPress è scritto in PHP e memorizza i dati in MySQL. Non si tratta di una fredda combinazione «script più database»: in oltre 20 anni di evoluzione, attorno al core è cresciuto un ecosistema con centinaia di API, un sistema di hook, la REST API, un editor a blocchi e una propria utility CLI. Ma quando si inizia, uno sviluppatore deve comprendere solo tre livelli.

PHP gestisce la logica. Ogni pagina del sito è assemblata a partire da template PHP che chiamano funzioni del core e dei plugin, interrogano il database tramite WP_Query e generano la risposta HTML. Senza PHP non puoi scrivere un solo tema o plugin: è un requisito indispensabile dal primo giorno.

CSS e HTML costituiscono il livello di presentazione. I temi WordPress sono principalmente file PHP, ma hanno l'aspetto che descrivi nei CSS. Il WordPress moderno usa l'editor a blocchi (Gutenberg) e capire CSS Flexbox/Grid oggi è più importante di quanto lo fosse cinque anni fa. L'HTML è il collante: markup per widget, menu e template.

JavaScript è il quarto linguaggio. Non è indispensabile all'inizio (puoi scrivere un tema senza una riga di JS), ma se prevedi di lavorare con i blocchi Gutenberg o con elementi interattivi, React e @wordpress/scripts diventeranno i tuoi strumenti. Lascia JS per dopo, una volta che avrai padroneggiato la combinazione PHP + CSS.

2. Ambiente locale: dove scrivere codice

La prima regola dello sviluppo WordPress: mai sperimentare su un sito live. Un functions.php rotto senza accesso FTP significa una serata di panico e ripristino dal backup. Per fortuna, configurare un WordPress in locale oggi è più facile che mai.

WordPress Studio è un'app gratuita del team ufficiale che funziona su Windows e macOS. Si avvia con un clic, usa WebAssembly per isolare i siti e non richiede Docker o XAMPP. La scelta ideale per il tuo primo incontro con il codice.

Local (ex Local by Flywheel) è un'alternativa con un'interfaccia più ricca: cambio di versione PHP, esplorazione del database tramite Adminer e URL demo per mostrare il lavoro ai clienti. È adatto se prevedi di gestire più progetti in parallelo.

Per chi ha già familiarità con i container, l'immagine Docker ufficiale wordpress e wp-env (un pacchetto del team Gutenberg) offrono il pieno controllo sull'ambiente. Ma all'inizio è sproporzionato: Studio o Local copriranno le tue esigenze per i prossimi sei mesi o un anno.

3. Percorso uno: sviluppo di temi

I temi sono l'ingresso più naturale nello sviluppo WordPress. Vedi i risultati all'istante, lavori con tutti e tre i linguaggi principali (PHP, CSS, HTML) e puoi sbirciare come sono costruiti gli altri temi, dato che il codice è aperto.

Inizia con un tema child. È l'approccio più sicuro: crei una cartella, aggiungi un style.css con un commento di intestazione e un functions.php che fa l'enqueue del tema padre. Poi sovrascrivi un template, aggiungi un file CSS, ti agganci a un'azione. Piccole vittorie ogni giorno.

La gerarchia dei template di WordPress è un documento che vale la pena stampare e appendere sopra la scrivania. Mostra quale file PHP viene chiamato per ogni pagina: front-page.php → home.php → index.php e così via. Capire questa catena è metà del mestiere dello sviluppatore di temi.

Una volta padroneggiato il tema child, prova a scrivere un tema da zero. Il set minimo: index.php, style.css e functions.php. Aggiungi il supporto per l'editor a blocchi con add_theme_support('wp-block-styles') e i menu con register_nav_menus(). La Developer Resources di WordPress contiene un elenco completo delle opzioni add_theme_support disponibili con esempi: tieni quella scheda aperta.

4. Percorso due: sviluppo di plugin

I plugin sono codice che estende WordPress indipendentemente dal tema. Un forum, un negozio online, un sistema di prenotazione, custom post type: tutto questo sono plugin. La barriera d'ingresso è più alta rispetto ai temi: devi capire gli hook (add_action, add_filter), conoscere $wpdb ed essere in grado di leggere il codice scritto da altri.

Un plugin minimale è un singolo file PHP con un'intestazione /* Plugin Name: ... */. Può già contenere un hook che, per esempio, aggiunge testo al footer del sito tramite add_filter('the_content', ...). Prova a scriverne uno oggi; ci vogliono 10 minuti e toglie la paura della parola «plugin».

Il passo successivo è studiare il Manuale sui Plugin sulle Developer Resources. Copre la struttura dei plugin, attivazione/disattivazione, lavoro con il database e creazione di pagine di impostazioni. Non cercare di leggere tutto; apri la sezione pertinente quando ti serve.

La regola principale per chi inizia con i plugin: non reinventare la ruota. Per quasi ogni esigenza esiste già un plugin. Guarda come è stata risolta in un plugin gratuito popolare del repository; è il miglior libro di testo. Il repository di WordPress.org contiene oltre 60.000 plugin con codice open source.

5. Terzo percorso: contribuire al core di WordPress

Non è roba per principianti, ma sapere che questa possibilità esiste è utile. WordPress è un progetto open source e ogni release contiene patch di centinaia di sviluppatori in tutto il mondo.

Partecipare richiede solide competenze PHP, conoscenza dei Coding Standard e disponibilità a passare attraverso la code review. Il processo si svolge tramite ticket Trac su core.trac.wordpress.org. Puoi iniziare con l'etichetta good-first-bug: si tratta di piccoli bug selezionati appositamente per i nuovi contributori.

Anche se non hai intenzione di correggere il core, leggere i ticket Trac e le relative discussioni è un ottimo modo per capire come vengono prese le decisioni architetturali in un progetto con milioni di installazioni.

6. Dove imparare: risorse vive invece di link obsoleti

Il Codex è morto; lunga vita alle Developer Resources. Questo è il portale ufficiale che ha sostituito il vecchio Codex: Code Reference per ogni funzione e classe, guide su temi e plugin, l'editor a blocchi, REST API e WP-CLI. Se devi aprire una sola scheda, apri questa.

Learn WordPress offre corsi strutturati gratuiti dal team di WordPress.org. Ci sono video, materiali testuali e sandbox per fare pratica. Il percorso "Beginner WordPress Developer" ti porta dall'installazione al tuo primo plugin in poche ore.

Per domande specifiche, usa il forum di supporto di WordPress.org e Stack Overflow. Su Stack Overflow il tag wordpress contiene oltre 60.000 domande con risposta; quasi sicuramente qualcuno ha già posto la tua. Il forum di supporto è utile per problemi con plugin e temi specifici.

WP-CLI è uno strumento a riga di comando che ti farà risparmiare ore. Il comando wp scaffold plugin crea lo scheletro di un plugin, wp search-replace cambia gli URL nell'intero database, wp cron event list mostra le attività pianificate. Impara almeno 10 comandi; l'investimento si ripagherà già nella prima settimana.

7. La community senza cui non puoi avere successo

Uno sviluppatore solitario che non interagisce con la community inevitabilmente reinventa la ruota e perde i cambiamenti importanti. La community di WordPress è una delle più amichevoli nell'open source.

Da un punto di vista pratico: WordPress Slack ha canali per ogni area: #core per le discussioni sul core, #themes per i temi, #plugins per i plugin e #docs per la documentazione. Puoi fare una domanda lì e ricevere una risposta dagli sviluppatori che scrivono proprio quel core. I WordCamp sono conferenze di un giorno che si tengono in tutto il mondo (inclusa l'Italia) dove incontri le persone che sviluppano i plugin che usi.

Ci sono altri modi per partecipare: tradurre la documentazione e l'interfaccia nella tua lingua, testare le versioni beta, aiutare nel forum di supporto. Ognuna di queste attività approfondisce la tua comprensione del sistema mentre costruisci la tua reputazione. Nell'ecosistema WordPress, la reputazione si converte direttamente in clienti.

🎥 Video correlato

Una guida testuale è una struttura, ma a volte è più facile vedere qualcosa una volta. Ecco una roadmap dettagliata per sviluppatori WordPress con un'analisi degli strumenti e delle fasi di apprendimento:

⁉️🤔 Domande frequenti

Con quale linguaggio dovrei iniziare, PHP o JavaScript?

PHP. WordPress è costruito su PHP, e senza di esso non capirai gli hook, i template o WP_Query. JavaScript serve per l'editor a blocchi e l'interattività frontend, ma è il secondo passo. Il percorso: PHP + HTML/CSS → basi → primo plugin → JavaScript/React.

Devo imparare MySQL?

Non all'inizio. WordPress astrae il lavoro sul database tramite WP_Query e $wpdb. Ma capire la struttura delle tabelle wp_posts, wp_postmeta e wp_options ti farà risparmiare ore di debugging. Segui un breve tutorial su phpMyAdmin o Adminer; è sufficiente per i primi sei mesi.

Quanto tempo ci vuole per passare da zero al primo plugin?

Se conosci già PHP a livello base, 2-3 settimane con pratica quotidiana. Partendo da zero nella programmazione, 2-3 mesi. Il tuo primo plugin sarà semplice (per esempio, uno shortcode che restituisce la data corrente con formattazione), ma è codice reale e funzionante.

Tema o plugin: cosa è meglio per la carriera?

Gli sviluppatori di temi sono sempre richiesti perché ogni sito ha bisogno di un tema. Gli sviluppatori di plugin guadagnano di più attraverso la distribuzione (il modello freemium su WordPress.org). Il percorso ideale: inizia con i temi per imparare l'ecosistema, poi scrivi un plugin che risolva un'esigenza specifica. I migliori specialisti sanno fare entrambe le cose.

Mi serve GitHub?

Assolutamente sì. Anche se scrivi codice "per il cassetto", Git ti salverà quando rompi il codice e non ricordi cosa hai cambiato. Inoltre un link a un profilo GitHub con repository attivi di temi e plugin WP è il miglior argomento quando cerchi clienti. Inizia oggi con git init nella cartella del tuo tema.

Cosa fare subito: la tua prima settimana

Una roadmap non funziona se ti limiti a leggerla. Ecco un piano per i prossimi sette giorni, concreto e realizzabile.

Installa WordPress Studio o Local. Crea un sito di test. Apri la cartella wp-content/themes, crea un tema child per twentytwentyfive e fallo caricare nel pannello di amministrazione. Questo è il primo giorno, e forse il più importante: hai superato la barriera del "non so dove cliccare".

Secondo e terzo giorno: aggiungi un hook a functions.php (per esempio, wp_enqueue_scripts per caricare il tuo file CSS) e cambia il colore dei titoli tramite quel file. Un piccolo risultato, ma stai già interagendo con gli hook di WordPress.

Quarto e quinto giorno: crea una cartella separata in wp-content/plugins, scrivi un plugin minimale con uno shortcode tramite add_shortcode(). Inserisci lo shortcode in un articolo qualsiasi e guarda il risultato. Ecco fatto; sei uno sviluppatore di plugin.

Sesto e settimo giorno: registrati sullo Slack ufficiale di WordPress, iscriviti al canale #core e leggi qualche ticket sul sistema Trac di WordPress. Non per partecipare, ma per vedere come vengono prese le decisioni nel progetto con cui ora lavori.

La regola principale per la prima settimana: scrivi codice ogni giorno. 30 minuti di pratica valgono più di tre ore di lettura della documentazione. WordPress è un ecosistema che si impara con le mani.

🔗 Developer Resources, documentazione ufficiale di WordPress