{"id":167167,"date":"2025-05-26T09:00:00","date_gmt":"2025-05-26T09:00:00","guid":{"rendered":"https:\/\/gtechgroup.it\/blog\/acf-options-page-impostazioni-globali-tema\/"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T22:00:00","slug":"acf-options-page-impostazioni-globali-tema","status":"publish","type":"post","link":"https:\/\/gtechgroup.it\/blog\/acf-options-page-impostazioni-globali-tema\/","title":{"rendered":"ACF e le Options Page: Impostazioni Globali per il Tema"},"content":{"rendered":"

Cosa Sono le Options Page di ACF<\/h2>\n

Le Options Page<\/strong> di Advanced Custom Fields PRO rappresentano una funzionalità fondamentale per qualsiasi progetto WordPress professionale. Si tratta di pagine di amministrazione personalizzate dove puoi inserire campi ACF i cui valori sono globali<\/strong>, ovvero non legati a un singolo post o a una singola pagina, ma disponibili ovunque nel sito. Pensa alle informazioni che restano costanti in tutte le pagine: il numero di telefono aziendale, l’indirizzo della sede, i link ai profili social, il logo nel footer, il testo del copyright, le impostazioni SEO globali o i colori personalizzabili del tema.<\/p>\n

Senza le Options Page, queste informazioni globali vengono tipicamente hardcodate nei file del tema oppure gestite attraverso il Customizer di WordPress, che ha limitazioni significative sia nella varietà dei campi sia nella organizzazione dell’interfaccia. ACF PRO risolve questo problema permettendo di creare pagine di opzioni completamente personalizzabili, con tutta la potenza e la flessibilità dei campi ACF, organizzate in modo logico e intuitivo per gli amministratori del sito.<\/p>\n

Le Options Page sono disponibili esclusivamente nella versione ACF PRO<\/strong> e rappresentano, insieme al Repeater e al Flexible Content, uno dei principali motivi per cui la versione premium è considerata indispensabile dalla maggior parte degli sviluppatori WordPress. In questo articolo vedremo come creare e configurare le Options Page, come associarvi gruppi di campi e come recuperare i valori nel frontend del sito.<\/p>\n

Registrare una Options Page nel Tema<\/h2>\n

A differenza dei gruppi di campi, che si creano dall’interfaccia grafica di ACF, le Options Page devono essere registrate tramite codice PHP nel file functions.php<\/code> del tema o in un plugin personalizzato. La funzione principale è acf_add_options_page()<\/code>, che accetta un array di parametri per configurare la pagina. Ecco un esempio base:<\/p>\n

<?php\nif( function_exists(acf_add_options_page) ) {\n    acf_add_options_page(array(\n        page_title    => Impostazioni Tema,\n        menu_title    => Impostazioni Tema,\n        menu_slug     => impostazioni-tema,\n        capability    => edit_posts,\n        redirect      => false\n    ));\n}\n?><\/code><\/pre>\n
Il parametro page_title<\/strong> è il titolo che appare nella parte superiore della pagina, menu_title<\/strong> è il testo che appare nel menu laterale della dashboard, menu_slug<\/strong> è l’identificativo univoco della pagina (usato nell’URL), capability<\/strong> definisce quale livello di permessi serve per accedere alla pagina e redirect<\/strong> determina se la pagina principale deve reindirizzare alla prima sottopagina (utile quando hai sottopagine).<\/p>\n
\"Configurazione<\/p>\n
È fondamentale avvolgere la chiamata a acf_add_options_page()<\/code> all’interno del controllo function_exists()<\/code>: questo previene errori fatali nel caso in cui ACF PRO non sia attivo. È una pratica difensiva che dovresti adottare sempre quando utilizzi funzioni specifiche di un plugin nel file functions.php del tema.<\/p>\n
Creare Sottopagine di Opzioni<\/h2>\n
Per progetti complessi, una singola pagina di opzioni potrebbe non essere sufficiente o diventare troppo lunga. ACF PRO permette di creare sottopagine<\/strong> (child pages) che appaiono come voci del sottomenu della pagina principale. La funzione da utilizzare è acf_add_options_sub_page()<\/code>:<\/p>\n
<?php\nif( function_exists(acf_add_options_page) ) {\n\n    acf_add_options_page(array(\n        page_title    => Impostazioni Generali,\n        menu_title    => Impostazioni Sito,\n        menu_slug     => impostazioni-sito,\n        capability    => edit_posts,\n        redirect      => true\n    ));\n\n    acf_add_options_sub_page(array(\n        page_title    => Informazioni Aziendali,\n        menu_title    => Azienda,\n        parent_slug   => impostazioni-sito,\n    ));\n\n    acf_add_options_sub_page(array(\n        page_title    => Social Media,\n        menu_title    => Social,\n        parent_slug   => impostazioni-sito,\n    ));\n\n    acf_add_options_sub_page(array(\n        page_title    => Footer e Copyright,\n        menu_title    => Footer,\n        parent_slug   => impostazioni-sito,\n    ));\n}\n?><\/code><\/pre>\n
In questo esempio, nel menu laterale apparirà la voce “Impostazioni Sito” con tre sottovoci: “Azienda”, “Social” e “Footer”. Il parametro parent_slug<\/strong> deve corrispondere al menu_slug<\/strong> della pagina principale. Nota che nella pagina principale abbiamo impostato redirect<\/code> su true<\/code>: questo significa che cliccando su “Impostazioni Sito” l’utente verrà automaticamente reindirizzato alla prima sottopagina, evitando di avere una pagina principale vuota o duplicata.<\/p>\n
Opzioni Avanzate di Registrazione<\/h2>\n
La funzione acf_add_options_page()<\/code> supporta diversi parametri aggiuntivi per personalizzare la pagina. Il parametro icon_url<\/strong> permette di specificare un’icona per la voce del menu, utilizzando le classi Dashicons di WordPress (ad esempio dashicons-admin-generic<\/code>) o un URL a un’immagine personalizzata. Il parametro position<\/strong> determina la posizione della voce nel menu laterale: un numero più basso la posiziona più in alto.<\/p>\n
Il parametro update_button<\/strong> personalizza il testo del pulsante di salvataggio (predefinito: “Update”), mentre updated_message<\/strong> personalizza il messaggio di conferma dopo il salvataggio. Il parametro post_id<\/strong> è particolarmente importante: definisce l’identificativo utilizzato per salvare e recuperare i valori dei campi. Il valore predefinito è options<\/code>, ma puoi cambiarlo se hai necessità di separare i dati di diverse pagine di opzioni.<\/p>\n
Un parametro spesso trascurato è autoload<\/strong>, che controlla se i valori della pagina di opzioni vengono caricati automaticamente all’avvio di WordPress. Se impostato su true<\/code> (il default), i valori vengono inclusi nell’autoload delle opzioni WordPress, rendendo il recupero dei dati più veloce ma aumentando leggermente il consumo di memoria iniziale. Per pagine di opzioni con molti campi che non vengono utilizzati in ogni pagina del sito, impostare autoload<\/code> su false<\/code> può migliorare le performance generali.<\/p>\n
Associare i Campi alla Options Page<\/h2>\n
Una volta registrata la Options Page nel codice, devi creare un gruppo di campi ACF e associarlo alla pagina di opzioni tramite le Location Rules<\/strong>. Vai su ACF > Field Groups<\/strong>, crea un nuovo gruppo o modifica uno esistente, e nella sezione “Location” imposta la regola: Options Page<\/strong> è uguale a [nome della tua pagina di opzioni]<\/strong>.<\/p>\n
\"Creazione<\/p>\n
Se hai creato sottopagine, puoi associare gruppi di campi diversi a ciascuna sottopagina. Ad esempio, il gruppo “Informazioni Aziendali” con campi per nome azienda, indirizzo, telefono ed email verrà associato alla sottopagina “Azienda”, mentre il gruppo “Link Social” con campi URL per Facebook, Instagram, LinkedIn e Twitter verrà associato alla sottopagina “Social”. Questa organizzazione mantiene l’interfaccia pulita e ogni sezione rimane focalizzata su un ambito specifico.<\/p>\n
Puoi utilizzare qualsiasi tipo di campo ACF nelle Options Page, inclusi Repeater, Flexible Content, Gallery e tutti gli altri. Non ci sono limitazioni rispetto ai campi utilizzabili nei post o nelle pagine. Questo rende le Options Page estremamente versatili: puoi gestire slider globali con un Repeater, sezioni personalizzabili del footer con un Flexible Content, o gallerie di partner e clienti con un campo Gallery.<\/p>\n
Recuperare i Valori delle Options Page nel Frontend<\/h2>\n
La differenza principale tra i campi delle Options Page e quelli associati ai post riguarda il modo in cui vengono recuperati nel frontend. Per i campi dei post, usi semplicemente get_field(nome_campo)<\/code> e ACF recupera automaticamente il valore dal post corrente. Per i campi delle Options Page, devi specificare esplicitamente il parametro option<\/code> come secondo argomento:<\/p>\n
<?php\n\/\/ Campi semplici\n$telefono = get_field(telefono_aziendale, option);\n$indirizzo = get_field(indirizzo_sede, option);\n\n\/\/ Campo immagine (formato Array)\n$logo = get_field(logo_footer, option);\nif($logo) {\n    echo <img src=\" . esc_url($logo[url]) . \" alt=\" . esc_attr($logo[alt]) . \">;\n}\n\n\/\/ Repeater nelle Options Page\nif( have_rows(link_social, option) ):\n    while( have_rows(link_social, option) ): the_row();\n        $icona = get_sub_field(icona);\n        $url = get_sub_field(url);\n        echo <a href=\" . esc_url($url) . \"> . esc_html($icona) . <\/a>;\n    endwhile;\nendif;\n?><\/code><\/pre>\n
La stringa option<\/code> (al singolare, non “options”) indica ad ACF di cercare il valore nella tabella wp_options<\/code> invece che in wp_postmeta<\/code>. Se hai cambiato il post_id<\/code> nella registrazione della Options Page, dovrai usare quel valore personalizzato al posto di option<\/code>. Questo è un errore comune che causa ore di debugging: ricorda sempre di specificare il secondo parametro quando recuperi valori dalle Options Page.<\/p>\n
Struttura Consigliata per le Options Page<\/h2>\n
Sulla base dell’esperienza in decine di progetti WordPress, ecco una struttura di Options Page che funziona bene per la maggior parte dei siti aziendali e dei portali informativi. La pagina principale “Impostazioni Sito” con le seguenti sottopagine copre tutte le esigenze più comuni.<\/p>\n
Informazioni Generali<\/strong>: nome azienda, partita IVA, indirizzo sede legale, indirizzo sede operativa, telefono principale, telefono secondario, email generale, email PEC, orari di apertura (Repeater con giorno, apertura mattina, chiusura mattina, apertura pomeriggio, chiusura pomeriggio). Social Media<\/strong>: URL Facebook, URL Instagram, URL LinkedIn, URL Twitter\/X, URL YouTube, URL TikTok, URL Pinterest (tutti campi URL con placeholder esplicativo).<\/p>\n
Header e Navigazione<\/strong>: logo principale (Image), logo alternativo per sfondo scuro (Image), messaggio banner superiore (Text con toggle True\/False per mostrarlo\/nasconderlo), pulsante CTA header (Group con testo e URL). Footer<\/strong>: testo copyright (Text), colonne del footer (Repeater con titolo colonna e contenuto Wysiwyg), badge e certificazioni (Gallery), link pagine legali (Repeater con titolo e Page Link).<\/p>\n
SEO e Analytics<\/strong>: codice Google Tag Manager (Text), codice Google Analytics (Text), meta description globale (Text Area), immagine OG default (Image), script personalizzati header (Text Area per codice), script personalizzati footer (Text Area per codice). Questa struttura copre il 90% delle esigenze di un sito aziendale e può essere facilmente estesa con sottopagine aggiuntive per funzionalità specifiche.<\/p>\n
Options Page e Multilinguismo<\/h2>\n
Se il tuo sito WordPress è multilingue (utilizzando plugin come WPML o Polylang), le Options Page richiedono una configurazione aggiuntiva. Per impostazione predefinita, i valori delle Options Page sono gli stessi per tutte le lingue. Per avere valori diversi per ogni lingua, devi registrare la pagina di opzioni come “traducibile” nel plugin di multilinguismo.<\/p>\n
\"Strumenti<\/p>\n
Con WPML, vai su WPML > Translation Options<\/strong> e abilita la traduzione per le Options Page. Con Polylang, potrebbe essere necessario un plugin aggiuntivo come “ACF Options for Polylang”. In alternativa, puoi gestire il multilinguismo manualmente creando campi separati per ogni lingua (ad esempio telefono_it<\/code>, telefono_en<\/code>) e recuperando quello corretto in base alla lingua corrente, ma questo approccio diventa rapidamente ingestibile con molti campi e molte lingue.<\/p>\n
Caching e Performance delle Options Page<\/h2>\n
I valori delle Options Page sono salvati nella tabella wp_options<\/code> di WordPress, che ha un meccanismo di caching interno molto efficiente. Quando l’opzione autoload<\/code> è attiva (impostazione predefinita), tutti i valori vengono caricati in memoria con una singola query SQL all’avvio di WordPress e restano disponibili per tutta la durata della richiesta senza query aggiuntive. Questo rende il recupero dei valori dalle Options Page estremamente veloce.<\/p>\n
Tuttavia, se hai molte Options Page con centinaia di campi, il volume di dati caricati in autoload può diventare significativo. In questi casi, valuta di disabilitare l’autoload per le pagine meno utilizzate. Ad esempio, le informazioni aziendali e i link social sono usati in ogni pagina (header e footer) e beneficiano dell’autoload, mentre le impostazioni SEO avanzate potrebbero essere usate solo in contesti specifici e possono essere escluse dall’autoload senza impatti negativi.<\/p>\n
Un’altra considerazione importante riguarda i plugin di caching come WP Rocket, W3 Total Cache o WP Super Cache. Quando il caching delle pagine è attivo, le modifiche alle Options Page non saranno immediatamente visibili nel frontend finché la cache non viene svuotata o scade. Assicurati che il tuo workflow di aggiornamento delle opzioni includa lo svuotamento della cache, o configura il plugin di caching per svuotare automaticamente la cache quando le opzioni vengono aggiornate.<\/p>\n
Sicurezza delle Options Page<\/h2>\n
La sicurezza delle Options Page è gestita principalmente dal parametro capability<\/strong> nella registrazione. Il valore predefinito edit_posts<\/code> consente l’accesso a Editor, Autori e Amministratori. Per pagine con impostazioni sensibili (come codici di tracking, script personalizzati o credenziali API), è consigliabile restringere l’accesso usando capability più restrittive come manage_options<\/code> (solo Amministratori) o addirittura capability personalizzate create con un plugin di gestione ruoli.<\/p>\n
I campi che accettano codice HTML o JavaScript (come Text Area per script personalizzati) rappresentano un potenziale vettore di attacco XSS se accessibili a utenti non fidati. Assicurati che solo gli amministratori del sito possano modificare questi campi. Inoltre, quando visualizzi i valori delle Options Page nel frontend, utilizza sempre le funzioni di escaping di WordPress (esc_html()<\/code>, esc_attr()<\/code>, esc_url()<\/code>, wp_kses_post()<\/code>) per prevenire vulnerabilità di sicurezza, esattamente come faresti con qualsiasi altro dato dinamico.<\/p>\n
Le Options Page di ACF PRO sono uno strumento indispensabile per qualsiasi progetto WordPress professionale. Permettono di centralizzare la gestione delle impostazioni globali del sito in un’interfaccia intuitiva e potente, eliminando la necessità di hardcodare informazioni nei file del tema e dando ai gestori del sito il pieno controllo su ogni aspetto, senza dover toccare il codice.<\/p>\n
\n
Leggi anche gli altri articoli della serie ACF<\/h3>\n