1. ACF come strumento di architettura, non solo di sviluppo
ACF non è solo un modo per aggiungere campi personalizzati. È un modo per definire come il cliente gestisce i contenuti del sito. Ogni campo crea ha un impatto sull'esperienza editoriale: quanto è difficile da capire, quanto è facile sbagliare, quanto tempo richiede aggiornare una pagina.
Prima di aprire l'interfaccia di ACF vale la pena rispondere a tre domande: cosa modifica il cliente, con quale frequenza e con quale livello di dimestichezza tecnica. Queste risposte orientano ogni scelta sui tipi di campo e sull'organizzazione dei gruppi.
2. Tipi di campo e quando usarli
ACF offre molti tipi di campo. Quelli più usati in un progetto agenzia:
| Campo | Quando usarlo |
|---|---|
| Text / Textarea | Titoli, testi brevi, descrizioni senza formattazione |
| WYSIWYG Editor | Testi lunghi con formattazione: corsivo, link, liste |
| Image | Una singola immagine con alt text e proporzioni definite |
| Gallery | Più immagini in una sezione (slider, griglia fotografica) |
| Select / Radio | Scelte tra opzioni predefinite (colore sfondo, layout sezione) |
| True/False | Toggle per mostrare o nascondere una sezione |
| Relationship / Post Object | Collegare un elemento a un altro (articoli correlati, prodotti) |
| Options Page | Dati globali del sito: telefono, indirizzo, link social, testi footer |
3. Repeater, Flexible Content e Group: quando servono davvero
Il Repeater permette di aggiungere righe ripetibili — ad esempio una lista di servizi con icona, titolo e testo. Funziona bene quando il numero di elementi è variabile e il cliente deve poterli aggiungere e riordinare in autonomia.
Flexible Content è il componente più potente di ACF: permette di costruire una pagina componendo blocchi di layout in ordine libero. Richiede più lavoro in fase di sviluppo e può diventare difficile da gestire se si aggiungono troppe varianti.
Group raggruppa campi correlati in un pannello unico. Utile per tenere il backend ordinato senza usare strutture più complesse del necessario.
Regola pratica: Flexible Content ha senso solo quando il cliente deve davvero costruire pagine con layout variabile. Per la maggior parte delle pagine un Repeater o una serie di campi semplici è sufficiente.
4. ACF Blocks vs blocchi nativi di Gutenberg
Con ACF 6 è possibile registrare blocchi Gutenberg che usano campi ACF invece del markup del block editor. Questo permette di mantenere l'interfaccia di editing in ACF anche su siti che usano Gutenberg.
Ha senso usare ACF Blocks quando il team è già abituato a lavorare con ACF e vuole un'esperienza coerente, quando i blocchi hanno layout complessi che l'editor nativo gestisce male, o quando il cliente ha bisogno di un'interfaccia di editing più semplice di quella predefinita di Gutenberg.
Ha senso usare blocchi nativi quando il progetto usa il Full Site Editing (FSE), quando il team vuole seguire l'evoluzione naturale di WordPress senza dipendenze aggiuntive, o quando il design usa pattern semplici che i blocchi core gestiscono già bene.
5. Strutturare ACF per la manutenzione nel tempo
Un errore frequente: creare gruppi di campo con nomi generici come 'Sezione 1' o 'Dati pagina', che sei mesi dopo non dicono nulla a chi riprende il progetto.
Alcune pratiche che riducono la confusione nel tempo:
- Nominare i gruppi in modo descrittivo: 'Hero - Homepage', 'Card Servizi', 'Footer - Dati Contatto'.
- Usare il campo Istruzioni per documentare formato richiesto, dimensioni immagine o lunghezza massima del testo.
- Esportare la configurazione ACF come JSON nel tema, in modo che sia sotto controllo versione.
- Evitare di moltiplicare i gruppi: un gruppo ben organizzato vale più di cinque piccoli con tre campi ciascuno.
Domande frequenti
ACF è compatibile con Gutenberg?
Sì. ACF 6 introduce ACF Blocks che si integrano con Gutenberg. Si può anche usare ACF in parallelo con Gutenberg: alcuni contenuti tramite blocchi, altri tramite meta box ACF nella sidebar del backend.
È necessaria la versione Pro di ACF?
Dipende dai componenti usati. Repeater, Flexible Content e Options Page sono funzionalità Pro. Per campi semplici la versione gratuita è sufficiente. Per la maggior parte dei progetti agenzia, Pro vale l'investimento.
Come si sincronizza la configurazione ACF tra staging e produzione?
ACF supporta la sincronizzazione tramite file JSON. Con la configurazione corretta i gruppi di campo vengono salvati come file all'interno del tema e si spostano tra ambienti come parte del deploy.
Prossimo passo
Hai un progetto WordPress con contenuti complessi da strutturare?
Posso affiancare il team nella definizione dell'architettura dei campi ACF e nell'implementazione.
Parliamo del progetto