Sviluppatore WordPress per agenzie e grafici: come trasformo un layout in un tema che il cliente sa aggiornare
Quando lavoro come sviluppatore WordPress per agenzie e studi grafici, la grafica del sito esiste già: l’ha disegnata l’agenzia e spesso il cliente l’ha approvata. Il mio lavoro è trasformarla in un tema WordPress che si apre in fretta anche da telefono e che il cliente aggiorna da solo, senza poter rompere l’impaginazione. Il metodo è quello che uso nei progetti di sviluppo di siti web a Firenze in cui disegno anche la grafica, e che descrivo nella pagina sullo sviluppo di siti WordPress.
Il caso reale da cui parto è il sito dell’ASP Città di Siena, l’azienda pubblica che gestisce residenze per anziani, farmacie comunali e la cucina che prepara i pasti delle scuole del Comune: il layout l’ha disegnato un’altra agenzia, io l’ho sviluppato in WordPress, come racconto nella FAQ su come sviluppare il sito partendo da una grafica già pronta. Gli altri esempi vengono dai temi di due siti del 2026 in provincia di Bergamo, Dental Shipment e Bergamo Tecnologie, e da quello di questo sito, quindi file e campi che cito sono quelli veri.
Quando conviene separare chi disegna da chi sviluppa
Separare i due lavori ha senso quando la parte visiva la decide qualcun altro: un’agenzia che cura l’immagine del cliente anche fuori dal sito, o un cliente che ha già approvato le tavole e cerca chi le sviluppi. L’agenzia tiene la direzione grafica e il rapporto con il cliente; io mi occupo di quello che nel file non si vede: codice, campi del pannello, peso delle pagine, ordine dei titoli. Le fasi sono quelle dell’articolo su come si realizza un sito web, senza la bozza grafica. Il prezzo della separazione è che ogni scelta non scritta nel file diventa una domanda, e per questo buona parte di quello che segue sono cose da decidere all’inizio.
Al cliente finale va detto subito che il sito non avrà un page builder: in una FAQ ho spiegato perché non uso Elementor né altri page builder. Non parto nemmeno da temi comprati, per i motivi che spiego nell’articolo su tema WordPress commerciale o tema custom. Ogni sezione si sviluppa come è nel file, senza adattarla ai blocchi di un builder; in cambio il cliente cambia dal pannello i contenuti delle sezioni previste, e una sezione nuova richiede un intervento di sviluppo.
Cosa mi serve trovare nel file di grafica
Da un file di progetto, per esempio in Figma, si leggono misure, colori e caratteri di ogni elemento; da un PDF o da un’immagine no, e ogni distanza diventa una stima. Oltre alle tavole da computer mi servono:
- la versione da telefono di ogni pagina tipo, non della sola home;
- gli stati di pulsanti e link, compreso il focus da tastiera per chi naviga senza mouse;
- i moduli con il campo in errore e il messaggio di invio riuscito;
- testi della lunghezza vera: un titolo che nella tavola ha tre parole e nel sito nove, da telefono, va su tre righe;
- gli elenchi vuoti e quelli lunghi, come una sezione notizie con una notizia sola;
- le foto originali e il nome dei caratteri con i pesi usati.
Va deciso anche lo stato intermedio dell’header: con tavole a 1440 e a 390 pixel, gli schermi in mezzo restano scoperti. In Dental Shipment e in Bergamo Tecnologie il menu è visibile da 1200 pixel in su e sotto diventa un pannello che entra da destra (navbar-expand-xl e offcanvas-end in Bootstrap). Il passaggio si sceglie con un conto. Prendiamo sette voci di menu larghe in media 100 pixel, spazi compresi, un logo di 180 e un pulsante «Richiedi preventivo» di 170: servono 1.050 pixel. Da 1200 pixel il contenitore di Bootstrap ne offre 1.116 utili (1.140 meno 12 di margine per lato); tra 992 e 1199 ne offre 936 e le voci vanno a capo, quindi per quella fascia il layout deve dire se il menu va nel pannello o se le voci si accorciano. Ne ho parlato nell’articolo su menu hamburger o menu visibile.
Ogni sezione del layout diventa un componente
Nel tema ogni sezione è un componente, un file nella cartella parts che i modelli di pagina richiamano con get_template_part(). Se una sezione compare in più pagine con piccole differenze non la copio, le passo dei parametri. In questo sito la scheda di un articolo è un solo file, che la pagina del blog richiama così:
get_template_part('parts/post-card', null, array('layout' => 'horizontal', 'size' => 'large', 'heading' => 'h2'));
layout sceglie la disposizione, size la dimensione e heading il livello del titolo; lo stesso file disegna le schede del blog, della home e della pagina su Firenze.
Prendiamo uno studio di architettura con cinque pagine (home, studio, elenco dei progetti, scheda del progetto, contatti) e 24 sezioni nelle tavole. Raggruppate per tipo diventano sette componenti: apertura con foto, testo con immagine (quattro volte, con l’immagine alternata), griglia dei progetti, dati del progetto, galleria, fascia dei contatti e modulo. Da sviluppare sono sette componenti, non 24 sezioni, e la fascia dei contatti corretta una volta cambia in tutte le pagine.
Per chi disegna vuol dire che due sezioni quasi uguali conviene farle uguali davvero: due fasce «testo e immagine» con 24 e 28 pixel tra titolo e testo sono due varianti da mantenere. Bootstrap, che uso in ogni tema, ha già una scala di distanze, 4, 8, 16, 24 e 48 pixel, con le classi da 1 a 5 (mb-4 lascia 24 pixel sotto un elemento, py-5 48 sopra e sotto): un layout costruito su questa scala si traduce quasi tutto senza CSS scritto a parte.
Caratteri, immagini e icone nel passaggio al codice
I caratteri li carico dal server del sito, per i motivi dell’articolo sui caratteri caricati in locale invece che da Google. Ogni peso o corsivo usato nel layout è un file da scaricare. Dental Shipment usa IBM Plex Sans nei pesi 500, 600 e 700 e Inter nei pesi 400, 500 e 700: sei file woff2 da circa 24 KB, 140 KB in tutto. Bergamo Tecnologie usa due caratteri variabili, con i pesi da 100 a 900 in un file solo: Hanken Grotesk pesa 34 KB; Archivo 88, e 99 il corsivo, perché contiene anche le larghezze, dal 62 al 125%. Con un carattere statico conviene tenere solo i pesi che servono; uno variabile va confrontato con i file che sostituisce. Se il carattere è a pagamento, serve anche la licenza per il web.
Le foto le salvo in WebP, per le ragioni dell’articolo sulle immagini in WebP, e loghi e icone in SVG. Le foto originali servono perché WordPress ne ricava le versioni più piccole e le elenca nell’attributo srcset. Nella scheda di un apparecchio usato di Dental Shipment la foto principale ha sizes="(min-width: 992px) 50vw, 100vw" (da 992 pixel occupa metà schermo, sotto tutta la larghezza) e fetchpriority="high" senza caricamento differito, perché è la prima immagine che il browser deve mostrare. Le icone sono di Bootstrap Icons; quelle disegnate dall’agenzia mi servono in SVG, una per file.
I campi del pannello: cosa cambierà il cliente e cosa resta fisso
Per ogni componente decido quali elementi diventano campi del pannello, di solito testi, immagini, scritte e collegamenti dei pulsanti, e quali restano nel codice: disposizione, colori, distanze, colonne. Ogni campo viene controllato prima di essere mostrato: se il cliente lo lascia vuoto, in pagina non resta un titolo senza testo o un pulsante senza scritta. Le operazioni che il cliente fa da solo sono nell’articolo su cosa potrà modificare il cliente dal pannello.
La domanda da fare al cliente, meglio se la fa l’agenzia, è cosa aggiornerà nei prossimi due anni: all’ASP il personale pubblica dal pannello news e foto della gallery, in Dental Shipment cambia soprattutto la vetrina dell’usato. Quello che si aggiorna spesso deve essere facile da trovare.
Anche gli stili dentro un titolo vanno decisi qui. Nel layout dell’ASP i titoli hanno la prima parola in grassetto e la seconda in corsivo leggero, come «Servizi Assistenziali»: se il cliente deve scrivere titoli nuovi con lo stesso stile, il campo deve permettergli di indicare la parte diversa. In Bergamo Tecnologie la parte in corsivo, azzurra nella grafica, si scrive tra <em> e </em>, come dice l’istruzione sotto il campo.
Le istruzioni servono anche a evitare errori di inserimento. In Dental Shipment il campo «Prezzo in euro» dice «Solo il numero, senza punti né simbolo. Esempio: 4000», e il tema lo mostra come 4.000 seguito dalla nota facoltativa, per esempio «trattabile». In Bergamo Tecnologie una pagina del pannello, Contenuti sito → Dove modificare, elenca dove si cambia ogni parte del sito, per esempio i punti della cartina, che si inseriscono con latitudine e longitudine nella scheda di ogni lavoro: è utile quando il pannello al cliente lo spiega l’agenzia.
ACF gratuito: elenchi che crescono senza il campo ripetitore
I campi li preparo con Advanced Custom Fields (ACF) nella versione gratuita. Sul sito ufficiale, ricontrollato a novembre 2026, il campo ripetitore (Repeater), il Flexible Content, la Gallery, il Clone e le Options Pages sono funzioni di ACF PRO, che ha una licenza annuale. Senza ripetitore ogni campo esiste una volta sola, quindi all’agenzia chiedo subito quali elenchi del layout hanno una lunghezza fissa e quali crescono. Le soluzioni che uso sono quattro:
- Un numero fisso di campi, se l’elenco ha un massimo. Nelle schede del portfolio di questo sito l’apertura ha sei coppie di campi, icona e testo, da
hero_li_1ahero_li_6: il tema le legge con un ciclo e salta quelle vuote, e oggi tutte le 23 schede ne compilano quattro (sito, anno, CMS, settore). - Un tipo di contenuto, se l’elenco cresce. In Bergamo Tecnologie ogni elemento ripetibile, dalle foto dello slider alle fasi del metodo, è un contenuto a sé che si aggiunge, si elimina e si riordina come una pagina; con un campo di relazione si scelgono le realizzazioni dello slider della home e si trascinano nell’ordine voluto.
- Una voce per riga in un campo di testo, per coppie etichetta e valore. Il campo «Caratteristiche» di un apparecchio usato di Dental Shipment chiede righe come «Marca: Carestream»: il tema divide ogni riga ai primi due punti e stampa un elenco di definizioni (
dl), etichetta a sinistra e valore a destra. - Una pagina privata per i contenuti comuni, al posto delle Options Pages. In Dental Shipment recapiti, header, footer, testi del modulo e pagina 404 stanno in una pagina «Contenuti globali», invisibile sul sito e con una voce propria nel menu del pannello; lì si cambiano anche le etichette degli stati dell’usato, Disponibile, In trattativa e Venduto.
Con ACF PRO il primo e il terzo caso diventerebbero un ripetitore e il quarto una Options Page, ma la licenza va rinnovata ogni anno, con piani per un sito, per dieci o senza limite di siti, e qualcuno deve intestarla e pagarla.
Titoli: il livello lo decide il contenuto, la dimensione il CSS
Nel layout i titoli si distinguono per dimensione; nel codice hanno anche un livello, da H1 a H6, che Google e i lettori di schermo usano per capire come è organizzata la pagina. La gerarchia dei titoli che seguo prevede un solo H1 per pagina, H2 per le sezioni e H3 per le loro parti, senza salti, mentre la dimensione la danno le classi. La scheda degli articoli di questo sito ha il titolo H2 nella pagina del blog e H3 in home, dove sta in una sezione che ha già il suo H2; in tutti e due i casi, con size large, ha la classe fs-3.
L’occhiello, la riga piccola in maiuscolo sopra un titolo, non è un titolo: nella pagina sui siti WordPress «Portfolio» è uno span con la classe eyebrow e l’H2 è la frase sotto. Perché il cliente non debba scegliere il livello, lo scrivo nell’etichetta del campo: «Titolo della sezione (H2)» in Dental Shipment, «Il nome diventa un titolo H3» in Bergamo Tecnologie.
Le dimensioni da telefono vanno controllate a parte. In Bootstrap le classi da fs-1 a fs-4 si riducono da sole sotto i 1200 pixel: fs-1 vale 40 pixel da 1200 in su e sotto 1,375rem più l’1,5% della larghezza dello schermo, cioè circa 28 pixel su un telefono largo 390 (22 + 5,85). Se la tavola da telefono vuole 32 pixel, serve una regola in più.
Dove il layout va adattato per velocità e leggibilità
In alcuni punti seguire il file alla lettera peggiorerebbe il sito: li segnalo all’agenzia con una proposta prima di scrivere il codice.
- Lo slider in apertura. La home di Dental Shipment si apre con una sola foto; in Bergamo Tecnologie lo slider ha un pulsante per fermare lo scorrimento, perché il criterio 2.2.2 delle WCAG 2.2 chiede di poter mettere in pausa i contenuti che si muovono da soli per più di cinque secondi. Swiper, la libreria dello slider, la carico solo nelle pagine che ne hanno uno.
- Il testo sopra le foto. Il criterio 1.4.3 chiede un contrasto di almeno 4,5:1, o di 3:1 per i testi da 24 pixel (circa 18,5 se in grassetto). Un titolo bianco su un cielo chiaro non ci arriva: in Dental Shipment la foto della home è scurita apposta.
- Gli effetti che richiedono una libreria. Ogni libreria aggiunge CSS e JavaScript; come li limito alle pagine che li usano l’ho spiegato nell’articolo su CSS e JavaScript caricati solo dove servono.
Revisioni: il confronto tra layout e sito in prova
Il sito lo sviluppo in un ambiente di prova che Google non indicizza e che l’agenzia può aprire mentre prende forma. Va confrontato con il layout alle larghezze delle tavole: in Chrome gli strumenti per sviluppatori si aprono con F12 (Cmd+Opzione+I sul Mac) e Ctrl+Maiusc+M (Cmd+Maiusc+M) attiva la barra dei dispositivi, dove si imposta per esempio 390 × 844. La prova finale va fatta su un telefono vero, dove barra degli indirizzi e tastiera tolgono spazio.
Per le correzioni serve un elenco unico tenuto dall’agenzia, con pagina, larghezza, cosa si vede, cosa dovrebbe esserci e uno screenshot. Le richieste che nel layout approvato non c’erano vanno tenute a parte: a tema sviluppato, una sezione nuova è un componente da scrivere e pagine da ricontrollare.
Consegna: accessi, manutenzione e chi parla con il cliente finale
Alcune regole valgono anche quando il cliente arriva da un’agenzia. Dominio e hosting restano intestati al cliente finale, che così non deve chiedere a nessuno un passaggio di proprietà se cambia fornitore. Alla consegna riceve un utente WordPress personale, con i permessi che gli servono. E ogni sito che sviluppo ha nel preventivo la manutenzione annuale, con gli aggiornamenti di WordPress e dei plugin, per i motivi che spiego nell’articolo sulla manutenzione dopo la consegna.
Il resto va deciso con l’agenzia prima di iniziare, per scritto:
- chi parla con il cliente finale durante lo sviluppo e a chi arrivano le richieste dopo la messa online;
- chi riceve il preventivo della manutenzione e chi chiede le modifiche ordinarie ai contenuti;
- se nel footer compare chi ha sviluppato il sito, e con quale nome;
- quali utenti amministratori restano attivi oltre a quello del cliente.
Tempi e preventivo per lo sviluppo da una grafica pronta
Per lo sviluppo da una grafica già pronta non c’è un prezzo pubblicato: la cifra la scrivo nel preventivo, come per i siti su più pagine. Come riferimento, nella FAQ su quanto costa un sito web un sito di una sola pagina parte da 700 € e va online di solito in 2-4 settimane, un e-commerce con WooCommerce parte da 1.800 € e ne richiede 3-6.
Nello sviluppo pesa soprattutto il numero di modelli di pagina diversi: dieci pagine di servizio con la stessa struttura sono un modello solo, mentre un archivio con i filtri, un modulo che cambia campi in base alla pagina, come quello di Dental Shipment, o una seconda lingua con WPML sono lavoro in più.
Se cerchi uno sviluppatore WordPress per agenzie e hai un layout da mettere online, mandami il link al file o le tavole esportate, l’elenco delle pagine, cosa aggiornerà il cliente, le lingue e la data di messa online: rispondo entro 48 ore. Puoi chiedermi un preventivo per lo sviluppo dal modulo, chiamarmi al 393 438 5449, scrivermi su WhatsApp o mandarmi una mail a alessio.piazzini@gmail.com.