Costruire un tema WordPress da zero è uno dei modi migliori per capire come funziona WordPress. Un tema controlla ogni aspetto dell'aspetto e del layout del tuo sito. Mentre i temi predefiniti sono comodi, lo sviluppo di temi personalizzati ti dà il controllo completo su design, prestazioni ed esperienza utente.
Questa guida copre come costruire un tema WordPress da zero, dai file essenziali alle funzionalità avanzate dei block theme.
File Essenziali del Tema
Ogni tema WordPress ha bisogno di almeno due file: style.css e index.php. style.css contiene l'header del tema — nome, autore, versione, descrizione — e qualsiasi stile CSS di base. index.php è il file template principale che renderizza tutte le pagine per impostazione predefinita se non esiste un template più specifico.
Per i block theme, hai bisogno di un file theme.json invece di (o in aggiunta a) functions.php per la configurazione degli stili. Un file templates/index.html sostituisce index.php come template primario. I block theme sono il futuro del theming WordPress e sono richiesti per il supporto completo all'editing del sito.
La Gerarchia dei Template
La gerarchia dei template di WordPress determina quale file template viene usato per renderizzare ogni tipo di pagina. La gerarchia procede dai template specifici a quelli generali. Ad esempio, un singolo post usa single-post-{slug}.php, poi single-post-{id}.php, poi single.php, poi singular.php e infine index.php.
Comprendere la gerarchia dei template ti permette di creare template precisi per diversi tipi di contenuto. Crea archive.php per le pagine di archivio, single.php per i singoli post, page.php per le pagine e front-page.php per la homepage. Ogni template eredita da index.php se non esiste.
Template Tag e The Loop
The Loop di WordPress è il cuore dei file template. Elabora la query principale, mostrando ogni post a turno. Dentro il loop, template tag come the_title(), the_content(), the_permalink() e the_post_thumbnail() restituiscono i dati del post. Fuori dal loop, template tag come wp_nav_menu(), get_sidebar() e get_footer() renderizzano gli elementi strutturali.
I template tag gestiscono l'escape automaticamente. Usa the_title() invece di fare echo di get_the_title() direttamente. Usa the_content() invece di applicare i filtri di contenuto manualmente. Questi template tag sono il modo standard WordPress di renderizzare i contenuti.
Enqueue delle Risorse
Carica CSS e JavaScript nel tuo tema usando wp_enqueue_style() e wp_enqueue_script(). Aggiungili a una funzione collegata a wp_enqueue_scripts. Usa sempre il sistema di dipendenze appropriato — se il tuo JavaScript richiede jQuery, dichiaralo come dipendenza. Assegna versioni alle tue risorse così che i browser carichino le nuove versioni quando aggiorni il tema.
Registra le funzionalità di supporto del tema con add_theme_support() in functions.php. Le funzionalità comuni includono post-thumbnails, custom-logo, html5, title-tag e align-wide. Per i block theme, configura queste in theme.json.
Template di Pagina Personalizzati
I template di pagina personalizzati ti permettono di creare layout unici per pagine specifiche. Crea un file PHP con un commento header Template Name. Il template appare nella meta box Page Attributes nelle schermate di modifica delle pagine. Usa i template di pagina personalizzati per le landing page, i layout a larghezza piena o qualsiasi pagina che necessiti di una struttura diversa dalle pagine standard.
Per i block theme, i template personalizzati vengono creati come file HTML nella directory templates e registrati tramite theme.json.
Il punto fondamentale
Lo sviluppo dei temi WordPress segue un pattern ben definito. Inizia con i file essenziali, impara la gerarchia dei template, padroneggia the Loop e i template tag, fai l'enqueue delle tue risorse correttamente e crea template personalizzati per i layout speciali. I block theme rappresentano la direzione futura, ma i temi classici con template PHP sono ancora ampiamente usati e pienamente supportati.
