Tutti i Tipi di Campo ACF: Testo, Immagine, Relazione e Altro

Una Panoramica Completa dei Tipi di Campo ACF

Advanced Custom Fields mette a disposizione oltre 30 tipi di campo diversi, ciascuno progettato per gestire una specifica tipologia di dato. Questa varietà è uno dei principali punti di forza del plugin: indipendentemente dal tipo di informazione che devi raccogliere e visualizzare, esiste quasi certamente un campo ACF adatto allo scopo. In questo articolo esploreremo in dettaglio tutte le categorie di campi disponibili, analizzando le caratteristiche, le opzioni di configurazione e i casi d’uso ideali per ciascun tipo.

Comprendere le differenze tra i vari tipi di campo è fondamentale per progettare strutture dati efficienti. Scegliere il tipo di campo sbagliato può portare a problemi di usabilità per chi gestisce i contenuti, a difficoltà nella visualizzazione frontend e a complicazioni nelle query del database. Questa guida ti aiuterà a prendere decisioni informate durante la fase di progettazione dei tuoi gruppi di campi personalizzati.

Campi di Tipo Basic: Testo, Numero e Oltre

La categoria Basic comprende i campi più fondamentali e frequentemente utilizzati. Il campo Text è il più semplice: un singolo campo di input per testo breve, ideale per titoli, sottotitoli, nomi e qualsiasi stringa di testo corta. Supporta opzioni come valore predefinito, placeholder, testo prepend/append e limite di caratteri. Il campo Text Area è simile ma consente testo su più righe, perfetto per descrizioni brevi, abstract o note interne. Puoi configurare il numero di righe visibili e scegliere se il testo inserito deve preservare la formattazione (nuove righe e paragrafi) oppure no.

Il campo Number accetta esclusivamente valori numerici e offre opzioni specifiche come valore minimo, valore massimo e step (incremento). È ideale per prezzi, quantità, valutazioni e qualsiasi dato numerico. Il campo Range è una variante visuale del campo Number che presenta uno slider orizzontale: particolarmente intuitivo per valori percentuali o valutazioni su scala. Il campo Email valida automaticamente il formato dell’indirizzo email inserito, mentre il campo URL fa lo stesso per gli indirizzi web. Infine, il campo Password nasconde il testo inserito con pallini, utile per memorizzare credenziali o codici riservati (anche se per dati veramente sensibili è preferibile usare soluzioni di crittografia dedicate).

Campi di Tipo Content: Immagine, File e Media

La categoria Content include campi specifici per la gestione dei contenuti multimediali. Il campo Image è uno dei più utilizzati in assoluto: permette all’utente di selezionare o caricare un’immagine dalla libreria media di WordPress. Puoi configurare il formato di ritorno (ID dell’allegato, URL dell’immagine o array completo con tutte le informazioni), la dimensione dell’anteprima, le dimensioni minime e massime accettate e i tipi di file consentiti. Il formato “Array” è generalmente il più versatile perché ti dà accesso a URL, dimensioni, alt text e tutte le varianti di dimensione registrate nel tema.

Il campo File funziona in modo analogo all’Image ma accetta qualsiasi tipo di file: PDF, documenti, fogli di calcolo, archivi ZIP e altro. Anche qui puoi specificare i tipi MIME consentiti e la dimensione massima del file. Il campo Wysiwyg Editor inserisce un editor visuale completo, identico a quello principale di WordPress, con barra degli strumenti per la formattazione del testo. È ideale per sezioni di contenuto formattato come biografie, descrizioni dettagliate o blocchi di testo ricchi. Puoi scegliere se mostrare la barra degli strumenti completa o ridotta e se abilitare il caricamento dei media.

Il campo oEmbed accetta URL di servizi come YouTube, Vimeo, Twitter, Spotify e molti altri, convertendoli automaticamente nel corrispondente contenuto incorporato. Basta che l’utente incolli l’URL del video o del contenuto e ACF mostrerà un’anteprima direttamente nell’editor. Il campo Gallery (disponibile solo nella versione PRO) permette di selezionare e ordinare più immagini, creando una galleria fotografica gestibile con drag and drop.

Campi di Tipo Choice: Selezioni e Opzioni

I campi della categoria Choice permettono all’utente di scegliere tra opzioni predefinite. Il campo Select presenta un menu a discesa con le opzioni che hai definito. Puoi configurarlo per consentire selezione singola o multipla, abilitare la ricerca tra le opzioni (utile quando la lista è lunga), permettere l’inserimento di valori personalizzati e definire un valore predefinito. Le opzioni vengono definite come coppie valore:etichetta, dove il valore è ciò che viene salvato nel database e l’etichetta è ciò che l’utente vede.

Il campo Checkbox mostra un elenco di caselle di controllo che permettono selezioni multiple. A differenza del Select multiplo, tutte le opzioni sono sempre visibili, rendendo più immediata la scelta. Il campo Radio Button è simile al Checkbox ma consente una sola selezione: è l’ideale quando l’utente deve scegliere esattamente un’opzione tra diverse alternative mutuamente esclusive. Il campo Button Group è una variante visuale del Radio Button che presenta le opzioni come pulsanti affiancati, particolarmente elegante per scelte binarie o con poche opzioni (ad esempio: “Sì / No”, “Allineamento: Sinistra / Centro / Destra”).

Il campo True/False è il più semplice della categoria: un singolo toggle on/off. È perfetto per flag booleani come “Mostra in Homepage”, “Articolo in Evidenza”, “Abilita Sidebar”. Puoi personalizzare il testo mostrato accanto all’interruttore per renderlo immediatamente comprensibile. Questo campo restituisce 1 (vero) o 0 (falso) e si integra perfettamente con la logica condizionale per mostrare o nascondere altri campi in base al suo stato.

Campi di Tipo Relational: Post, Tassonomie e Utenti

I campi relazionali sono tra i più potenti di ACF e permettono di creare connessioni tra diversi tipi di contenuto. Il campo Post Object consente all’utente di selezionare uno o più post da un elenco ricercabile. Puoi filtrare per tipo di post, stato e tassonomia. È ideale per creare relazioni dirette: ad esempio, associare un autore a un libro, un testimonial a un progetto, o un prodotto correlato a un altro prodotto.

Il campo Relationship è simile al Post Object ma offre un’interfaccia più ricca con due colonne: a sinistra i post disponibili (filtrabili e ricercabili), a destra i post selezionati (riordinabili con drag and drop). È preferibile al Post Object quando l’utente deve selezionare più elementi e l’ordine conta. Il campo Page Link è invece specifico per i link interni: restituisce l’URL della pagina selezionata piuttosto che l’oggetto post, ed è utile per creare menu personalizzati o link di navigazione gestibili dall’editor dei contenuti.

Il campo Taxonomy permette di selezionare termini da una tassonomia specifica (categorie, tag o tassonomie personalizzate). Puoi scegliere il tipo di interfaccia (checkbox, select, multi-select o radio button) e decidere se salvare il termine come relazione standard di WordPress o come campo ACF separato. Il campo User consente la selezione di utenti WordPress, filtrabili per ruolo: utile per associare autori, responsabili o referenti a specifici contenuti.

Campi jQuery: Date Picker, Color Picker e Google Map

ACF include diversi campi che sfruttano componenti jQuery per offrire interfacce specializzate. Il campo Date Picker presenta un calendario popup per la selezione di date, con opzioni per il formato di visualizzazione e il formato di salvataggio. Il campo Date Time Picker estende il precedente aggiungendo la selezione dell’ora. Il campo Time Picker è dedicato alla sola selezione dell’orario. Questi tre campi sono essenziali per gestire eventi, appuntamenti, scadenze e qualsiasi contenuto legato a riferimenti temporali.

Il campo Color Picker mostra un selettore colori visuale con supporto per i formati HEX e, nelle versioni più recenti, anche RGBA (con trasparenza). È utile per temi che permettono la personalizzazione dei colori di specifiche sezioni, per palette cromatiche di brand o per qualsiasi contesto in cui l’utente deve specificare un colore. Il campo Google Map integra una mappa interattiva di Google Maps dove l’utente può cercare e selezionare una posizione, salvando automaticamente indirizzo, latitudine e longitudine. Richiede una API Key di Google Maps valida per funzionare.

Campi di Layout: Tab, Group, Accordion e Message

I campi di layout non raccolgono dati ma servono a organizzare visivamente l’interfaccia di editing. Il campo Tab crea schede di navigazione che raggruppano i campi sottostanti, permettendo di suddividere un gruppo con molti campi in sezioni tematiche facilmente navigabili. Il campo Group crea un sottogruppo di campi annidati, salvando i dati come array associativo: è utile per raggruppare logicamente campi correlati (ad esempio, un gruppo “Indirizzo” con via, città, CAP e provincia come sottocampi).

Il campo Accordion crea sezioni espandibili e comprimibili, simili ai tab ma con un layout verticale. L’opzione “multi-expand” permette di avere più sezioni aperte contemporaneamente. Il campo Message visualizza un testo statico nell’editor, senza raccogliere dati: è perfetto per inserire istruzioni dettagliate, avvisi o note per gli utenti che compilano i contenuti. Puoi usare HTML nel testo del messaggio per formattarlo con grassetti, elenchi e link.

Campi PRO: Repeater, Flexible Content, Gallery e Clone

La versione PRO di ACF aggiunge quattro campi premium che estendono enormemente le possibilità del plugin. Il campo Repeater permette di creare sezioni ripetibili: definisci un set di sottocampi e l’utente può aggiungere quante righe desidera. È ideale per elenchi di caratteristiche, team di persone, FAQ, timeline e qualsiasi struttura dati che si ripete. Il campo Flexible Content è ancora più avanzato: permette di definire diversi “layout”, ciascuno con i propri campi, e l’utente può comporre la pagina combinando e riordinando questi layout a piacere, creando di fatto un page builder leggero.

Il campo Gallery permette la gestione avanzata di gallerie fotografiche con selezione multipla, riordinamento drag and drop, e opzioni di configurazione per dimensioni e formati. Il campo Clone consente di riutilizzare campi o interi gruppi di campi già definiti, evitando duplicazioni e semplificando la manutenzione. Se modifichi un campo clonato, tutte le istanze si aggiornano automaticamente. Questi campi PRO saranno approfonditi in articoli dedicati di questa serie.

Come Scegliere il Tipo di Campo Giusto

La scelta del tipo di campo corretto dipende da diversi fattori: il tipo di dato da memorizzare, il formato desiderato per l’output frontend, l’esperienza utente nell’editor e le esigenze di query nel database. Ecco alcune linee guida pratiche. Per testo breve (fino a 255 caratteri), usa Text. Per testo medio senza formattazione, usa Text Area. Per contenuto formattato con grassetti, link e liste, usa Wysiwyg.

Per valori numerici che devi usare in calcoli o ordinamenti, usa sempre Number (non Text, anche se l’utente inserirà numeri). Per scelte tra opzioni predefinite, preferisci Select quando le opzioni sono più di 5, Radio Button quando sono 3-5 e Button Group quando sono 2-3. Per flag vero/falso, usa sempre True/False. Per relazioni tra contenuti, scegli Relationship quando l’ordine conta e servono selezioni multiple, Post Object per selezioni singole o quando servono pochi elementi.

Ricorda che ogni campo ACF viene salvato come meta nel database di WordPress, occupando una riga nella tabella wp_postmeta per ogni valore. Questo significa che un gruppo con 20 campi genererà fino a 20 righe di metadati per ogni post. Per la maggior parte dei siti questo non è un problema, ma per siti con migliaia di post e decine di campi per post, le performance delle query possono risentirne. Approfondiremo questo tema nell’articolo dedicato alle query avanzate e alle performance.

Hai bisogno di aiuto per progettare la struttura dei campi personalizzati del tuo sito WordPress? Il team di G Tech Group è specializzato nella realizzazione di siti web con architetture dati avanzate basate su ACF. Contattaci per una consulenza personalizzata e trasforma il tuo sito in una piattaforma su misura per le tue esigenze.

Migliora il Tuo Sito WordPress

Scopri le nostre guide complete sugli altri plugin essenziali per WordPress:

• Come Installare Elementor su WordPress
• Come Installare e Configurare WP Rocket
• Come Installare e Configurare SEOPress
• Come Installare e Configurare UpdraftPlus