{"id":167170,"date":"2025-06-16T09:00:00","date_gmt":"2025-06-16T09:00:00","guid":{"rendered":"https:\/\/gtechgroup.it\/blog\/acf-woocommerce-campi-personalizzati-prodotti\/"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T22:00:00","slug":"acf-woocommerce-campi-personalizzati-prodotti","status":"publish","type":"post","link":"https:\/\/gtechgroup.it\/blog\/acf-woocommerce-campi-personalizzati-prodotti\/","title":{"rendered":"ACF e WooCommerce: Aggiungere Campi Personalizzati ai Prodotti"},"content":{"rendered":"

Perché Aggiungere Campi Personalizzati ai Prodotti WooCommerce<\/h2>\n

WooCommerce è la piattaforma e-commerce più utilizzata al mondo, alimentando oltre il 25% di tutti i negozi online. Tuttavia, le schede prodotto predefinite offrono un set limitato di informazioni: titolo, descrizione, prezzo, immagini, categorie e poco altro. Per molti negozi, questo non basta. Un e-commerce di elettronica ha bisogno di specifiche tecniche dettagliate. Un negozio di abbigliamento necessita di tabelle taglie personalizzate. Un portale di prodotti alimentari deve mostrare valori nutrizionali, allergeni e certificazioni. Ed è qui che ACF e WooCommerce<\/strong> insieme diventano uno strumento indispensabile.<\/p>\n

Advanced Custom Fields ti permette di aggiungere qualsiasi tipo di informazione personalizzata<\/strong> alle schede prodotto di WooCommerce, con un’interfaccia intuitiva per l’inserimento dei dati e la massima flessibilità nella visualizzazione frontend. In questo articolo vedremo come configurare ACF per WooCommerce, come posizionare i campi nell’editor del prodotto, come visualizzare i dati personalizzati nella scheda prodotto e come sfruttare le funzionalità avanzate per creare un’esperienza di acquisto unica.<\/p>\n

L’integrazione ACF-WooCommerce funziona sia con la versione gratuita che con ACF PRO, anche se quest’ultima offre funzionalità aggiuntive come i Repeater (perfetti per specifiche tecniche e tabelle dati) e le Options Page (utili per impostazioni globali del negozio). WooCommerce stesso non richiede configurazioni speciali: ACF si integra nativamente perché i prodotti WooCommerce sono implementati come custom post type di WordPress.<\/p>\n

Configurare il Gruppo di Campi per i Prodotti<\/h2>\n

La configurazione di ACF per i prodotti WooCommerce segue lo stesso processo di qualsiasi altro gruppo di campi, con una particolarità nella regola di posizionamento. Crea un nuovo gruppo di campi in ACF > Field Groups > Aggiungi Nuovo<\/strong> e assegnagli un titolo descrittivo, ad esempio “Specifiche Tecniche Prodotto”. Nella sezione Location Rules<\/strong>, imposta la regola: Post Type è uguale a Product<\/strong>. Il tipo “Product” è il custom post type registrato da WooCommerce per i prodotti.<\/p>\n

\"Schermata<\/p>\n

Puoi anche creare regole più specifiche se non tutti i prodotti necessitano degli stessi campi. Ad esempio, puoi usare la regola Product Category è uguale a Elettronica<\/strong> per mostrare le specifiche tecniche solo per i prodotti della categoria Elettronica, oppure Product Type è uguale a Simple Product<\/strong> per differenziare i campi tra prodotti semplici e variabili. Questa granularità è particolarmente utile per negozi con cataloghi eterogenei dove diverse categorie di prodotti richiedono informazioni diverse.<\/p>\n

Per quanto riguarda la posizione del gruppo<\/strong> nell’editor, la scelta “Normal” posiziona il metabox ACF sotto il pannello dei dati prodotto di WooCommerce, che è generalmente il posto più intuitivo. Se preferisci che i campi personalizzati siano più visibili, puoi scegliere la posizione “High (after title)” per posizionarli subito dopo il titolo del prodotto. La posizione “Side” funziona bene per campi brevi come toggle, select o campi numerici che non richiedono molto spazio.<\/p>\n

Campi Comuni per i Prodotti E-Commerce<\/h2>\n

Ecco una selezione di campi ACF comunemente utilizzati per arricchire le schede prodotto WooCommerce. Specifiche Tecniche<\/strong>: un campo Repeater con sottocampi “Nome Specifica” (Text) e “Valore” (Text) permette di creare tabelle di specifiche completamente personalizzabili. Materiali e Composizione<\/strong>: un campo Text Area per la descrizione dei materiali, utile per abbigliamento, arredamento e prodotti artigianali.<\/p>\n

Tabella Taglie<\/strong>: un Repeater con sottocampi per taglia, misure in cm (petto, vita, fianchi, lunghezza) che genera automaticamente una tabella taglie completa. Certificazioni<\/strong>: un campo Checkbox con opzioni come “Bio”, “Vegan”, “Senza Glutine”, “Made in Italy”, “ISO 9001”, utile per mostrare badge di certificazione nella scheda prodotto. Documenti Allegati<\/strong>: un campo File per caricare schede tecniche PDF, manuali d’uso o certificati di conformità.<\/p>\n

Video Prodotto<\/strong>: un campo oEmbed per inserire l’URL di un video YouTube o Vimeo che mostra il prodotto in azione. FAQ Prodotto<\/strong>: un Repeater con domanda e risposta specifiche per il singolo prodotto, diverse dalle FAQ generali del sito. Informazioni Nutrizionali<\/strong>: per prodotti alimentari, un Group con sottocampi per calorie, proteine, carboidrati, grassi e allergeni. La scelta dei campi dipende ovviamente dal tipo di prodotti venduti e dalle informazioni che i clienti cercano prima di acquistare.<\/p>\n

Visualizzare i Campi nella Scheda Prodotto<\/h2>\n

Per visualizzare i campi ACF nella pagina del prodotto WooCommerce, hai diverse opzioni a seconda del livello di personalizzazione desiderato. Il metodo più semplice è utilizzare gli hook di WooCommerce<\/strong> per inserire il contenuto nel punto esatto della scheda prodotto dove vuoi che appaia. WooCommerce offre numerosi hook (action e filter) in punti strategici della pagina prodotto.<\/p>\n

Per inserire le specifiche tecniche sotto la descrizione breve del prodotto, aggiungi questo codice al file functions.php<\/code> del tuo tema:<\/p>\n

<?php\nadd_action(woocommerce_single_product_summary, mostra_specifiche_acf, 25);\nfunction mostra_specifiche_acf() {\n    if( have_rows(specifiche_tecniche) ):\n        echo <div class=\"product-specs\">;\n        echo <h3>Specifiche Tecniche<\/h3>;\n        echo <table>;\n        while( have_rows(specifiche_tecniche) ): the_row();\n            echo <tr>;\n            echo <th> . esc_html(get_sub_field(nome)) . <\/th>;\n            echo <td> . esc_html(get_sub_field(valore)) . <\/td>;\n            echo <\/tr>;\n        endwhile;\n        echo <\/table>;\n        echo <\/div>;\n    endif;\n}\n?><\/code><\/pre>\n
\"Impostazioni<\/p>\n
Il numero 25<\/code> nel terzo parametro di add_action<\/code> rappresenta la priorità: WooCommerce usa priorità specifiche per i suoi elementi (titolo=5, valutazione=10, prezzo=10, descrizione breve=20, pulsante aggiungi al carrello=30), quindi con priorità 25 il nostro contenuto apparirà tra la descrizione breve e il pulsante di acquisto.<\/p>\n
Aggiungere Tab Personalizzati alla Scheda Prodotto<\/h2>\n
Un approccio più elegante per organizzare le informazioni aggiuntive è creare tab personalizzati<\/strong> nella sezione delle schede prodotto di WooCommerce (la zona con “Descrizione”, “Informazioni aggiuntive” e “Recensioni”). Puoi aggiungere tab personalizzati utilizzando il filtro woocommerce_product_tabs<\/code>:<\/p>\n
<?php\nadd_filter(woocommerce_product_tabs, aggiunta_tab_acf);\nfunction aggiunta_tab_acf($tabs) {\n    if( get_field(specifiche_tecniche) ) {\n        $tabs[specifiche] = array(\n            title     => Specifiche Tecniche,\n            priority  => 15,\n            callback  => contenuto_tab_specifiche\n        );\n    }\n    if( get_field(documenti_allegati) ) {\n        $tabs[documenti] = array(\n            title     => Documenti,\n            priority  => 20,\n            callback  => contenuto_tab_documenti\n        );\n    }\n    return $tabs;\n}\n\nfunction contenuto_tab_specifiche() {\n    if( have_rows(specifiche_tecniche) ):\n        echo <table class=\"shop_attributes\">;\n        while( have_rows(specifiche_tecniche) ): the_row();\n            echo <tr><th> . esc_html(get_sub_field(nome)) . <\/th>;\n            echo <td> . esc_html(get_sub_field(valore)) . <\/td><\/tr>;\n        endwhile;\n        echo <\/table>;\n    endif;\n}\n\nfunction contenuto_tab_documenti() {\n    $file = get_field(documenti_allegati);\n    if($file) {\n        echo <a href=\" . esc_url($file[url]) . \" target=\"_blank\">;\n        echo Scarica  . esc_html($file[filename]);\n        echo  ( . size_format($file[filesize]) . )<\/a>;\n    }\n}\n?><\/code><\/pre>\n
I tab personalizzati vengono mostrati solo quando il campo ACF corrispondente ha un valore (grazie al controllo if(get_field(...))<\/code> prima di aggiungere il tab). Questo è importante: non vuoi mostrare un tab “Specifiche Tecniche” vuoto per i prodotti che non hanno specifiche compilate. La classe CSS shop_attributes<\/code> riutilizza lo stile della tabella “Informazioni aggiuntive” di WooCommerce, garantendo un aspetto coerente senza CSS aggiuntivo.<\/p>\n
ACF e Variazioni Prodotto<\/h2>\n
Un aspetto avanzato dell’integrazione ACF-WooCommerce riguarda i prodotti variabili<\/strong>. WooCommerce gestisce le variazioni come post separati (di tipo product_variation<\/code>), e ACF può essere configurato per aggiungere campi a ciascuna variazione individualmente. Tuttavia, l’interfaccia predefinita di ACF non è ottimale per le variazioni perché i metabox appaiono nel pannello generale del prodotto, non all’interno di ciascuna variazione.<\/p>\n
Per gestire campi ACF a livello di variazione, puoi utilizzare gli hook di WooCommerce woocommerce_product_after_variable_attributes<\/code> (per aggiungere campi al pannello variazione nel backend) e woocommerce_save_product_variation<\/code> (per salvare i valori). Questa integrazione richiede codice PHP personalizzato e una buona conoscenza della struttura dati di WooCommerce, ma permette scenari avanzati come mostrare informazioni diverse per ogni variazione di colore o taglia.<\/p>\n
\"Status<\/p>\n
Visualizzare i Campi ACF con Elementor e WooCommerce<\/h2>\n
Se utilizzi Elementor Pro per personalizzare le pagine prodotto di WooCommerce, puoi sfruttare i Dynamic Tag<\/strong> per collegare i widget di Elementor ai campi ACF dei prodotti, esattamente come faresti per qualsiasi altro custom post type. Crea un template Single Product nel Theme Builder di Elementor e usa i Dynamic Tag ACF per mostrare le informazioni personalizzate nel layout che preferisci.<\/p>\n
Questo approccio è particolarmente potente perché ti dà il pieno controllo visuale sulla posizione e lo stile di ogni campo ACF nella scheda prodotto. Puoi creare sezioni con icone per le certificazioni, banner promozionali condizionali basati su campi True\/False, slider video basati su campi oEmbed e qualsiasi altro layout creativo che desideri. La combinazione ACF + WooCommerce + Elementor Pro è la triade perfetta per e-commerce con schede prodotto ricche e personalizzate.<\/p>\n
Performance e Considerazioni SEO<\/h2>\n
Aggiungere campi ACF ai prodotti WooCommerce ha implicazioni sulle performance e sulla SEO che vale la pena considerare. Dal punto di vista delle performance<\/strong>, ogni campo ACF aggiunge una riga nella tabella wp_postmeta<\/code>. Per un catalogo con migliaia di prodotti e decine di campi per prodotto, la tabella postmeta può diventare molto grande. Assicurati di avere indici adeguati sulla tabella e considera l’uso di un plugin di caching per le pagine prodotto.<\/p>\n
Dal punto di vista SEO<\/strong>, i dati ACF visibili nel frontend contribuiscono al contenuto della pagina e vengono indicizzati dai motori di ricerca. Questo è un vantaggio significativo: specifiche tecniche dettagliate, descrizioni dei materiali e FAQ specifiche per prodotto arricchiscono il contenuto della pagina, migliorando le possibilità di posizionamento per query long-tail. Considera anche l’aggiunta di structured data<\/strong> (schema.org) basati sui campi ACF: puoi generare dinamicamente il markup Product con specifiche, recensioni e disponibilità basate sui dati personalizzati.<\/p>\n
L’integrazione ACF-WooCommerce apre possibilità infinite per personalizzare l’esperienza di acquisto. Dai semplici campi informativi ai complessi sistemi di configurazione prodotto, ACF fornisce la flessibilità necessaria per trasformare un negozio WooCommerce standard in una piattaforma e-commerce completamente su misura per il tuo settore e il tuo pubblico.<\/p>\n
\n
Leggi anche gli altri articoli della serie ACF<\/h3>\n