{"id":167165,"date":"2025-05-12T09:00:00","date_gmt":"2025-05-12T09:00:00","guid":{"rendered":"https:\/\/gtechgroup.it\/blog\/acf-tipi-campo-testo-immagine-relazione\/"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T22:00:00","slug":"acf-tipi-campo-testo-immagine-relazione","status":"publish","type":"post","link":"https:\/\/gtechgroup.it\/blog\/acf-tipi-campo-testo-immagine-relazione\/","title":{"rendered":"Tutti i Tipi di Campo ACF: Testo, Immagine, Relazione e Altro"},"content":{"rendered":"

Una Panoramica Completa dei Tipi di Campo ACF<\/h2>\n

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.<\/p>\n

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.<\/p>\n

Campi di Tipo Basic: Testo, Numero e Oltre<\/h2>\n

La categoria Basic<\/strong> comprende i campi più fondamentali e frequentemente utilizzati. Il campo Text<\/strong> è 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<\/strong> è 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.<\/p>\n

Il campo Number<\/strong> 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<\/strong> è una variante visuale del campo Number che presenta uno slider orizzontale: particolarmente intuitivo per valori percentuali o valutazioni su scala. Il campo Email<\/strong> valida automaticamente il formato dell’indirizzo email inserito, mentre il campo URL<\/strong> fa lo stesso per gli indirizzi web. Infine, il campo Password<\/strong> 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).<\/p>\n

\"Configurazione<\/p>\n

Campi di Tipo Content: Immagine, File e Media<\/h2>\n

La categoria Content<\/strong> include campi specifici per la gestione dei contenuti multimediali. Il campo Image<\/strong> è 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.<\/p>\n

Il campo File<\/strong> 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<\/strong> 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.<\/p>\n

Il campo oEmbed<\/strong> 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<\/strong> (disponibile solo nella versione PRO) permette di selezionare e ordinare più immagini, creando una galleria fotografica gestibile con drag and drop.<\/p>\n

Campi di Tipo Choice: Selezioni e Opzioni<\/h2>\n

I campi della categoria Choice<\/strong> permettono all’utente di scegliere tra opzioni predefinite. Il campo Select<\/strong> 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.<\/p>\n

Il campo Checkbox<\/strong> 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<\/strong> è 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<\/strong> è 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”).<\/p>\n

Il campo True\/False<\/strong> è 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.<\/p>\n

Campi di Tipo Relational: Post, Tassonomie e Utenti<\/h2>\n

I campi relazionali sono tra i più potenti di ACF e permettono di creare connessioni tra diversi tipi di contenuto. Il campo Post Object<\/strong> 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.<\/p>\n

Il campo Relationship<\/strong> è 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<\/strong> è 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.<\/p>\n

\"Gestione<\/p>\n

Il campo Taxonomy<\/strong> 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<\/strong> consente la selezione di utenti WordPress, filtrabili per ruolo: utile per associare autori, responsabili o referenti a specifici contenuti.<\/p>\n

Campi jQuery: Date Picker, Color Picker e Google Map<\/h2>\n

ACF include diversi campi che sfruttano componenti jQuery per offrire interfacce specializzate. Il campo Date Picker<\/strong> 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<\/strong> estende il precedente aggiungendo la selezione dell’ora. Il campo Time Picker<\/strong> è dedicato alla sola selezione dell’orario. Questi tre campi sono essenziali per gestire eventi, appuntamenti, scadenze e qualsiasi contenuto legato a riferimenti temporali.<\/p>\n

Il campo Color Picker<\/strong> 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<\/strong> 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.<\/p>\n

Campi di Layout: Tab, Group, Accordion e Message<\/h2>\n

I campi di layout non raccolgono dati ma servono a organizzare visivamente l’interfaccia di editing. Il campo Tab<\/strong> 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<\/strong> 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).<\/p>\n

Il campo Accordion<\/strong> 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<\/strong> 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.<\/p>\n

Campi PRO: Repeater, Flexible Content, Gallery e Clone<\/h2>\n

La versione PRO di ACF aggiunge quattro campi premium che estendono enormemente le possibilità del plugin. Il campo Repeater<\/strong> 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<\/strong> è 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.<\/p>\n

\"Strumenti<\/p>\n

Il campo Gallery<\/strong> 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<\/strong> 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.<\/p>\n

Come Scegliere il Tipo di Campo Giusto<\/h2>\n

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<\/strong>. Per testo medio senza formattazione, usa Text Area<\/strong>. Per contenuto formattato con grassetti, link e liste, usa Wysiwyg<\/strong>.<\/p>\n

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

Ricorda che ogni campo ACF viene salvato come meta nel database di WordPress, occupando una riga nella tabella wp_postmeta<\/code> 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.<\/p>\n

\n

Leggi anche gli altri articoli della serie ACF<\/h3>\n