ACF (Advanced Custom Fields) & CPT (Custom Post Types) - Modulo PrestaShop

Presentazione

ACF Field Builder e il modulo PrestaShop che trasforma il tuo negozio in un vero CMS flessibile. Aggiungi campi personalizzati ai tuoi prodotti, categorie, pagine CMS e schede clienti, e crea i tuoi tipi di contenuto — il tutto senza scrivere una sola riga di codice.

PrestaShop offre campi limitati per prodotti e categorie. Per aggiungere informazioni specifiche al tuo settore, come specifiche tecniche, FAQ, badge o certificazioni, in genere e necessario modificare il database e programmare template personalizzati. ACF Field Builder elimina questa complessita: crea qualsiasi tipo di campo in pochi clic dal back-office e i dati sono automaticamente disponibili nei tuoi template Smarty tramite un'API semplice e intuitiva.

Punti di forza:

• Piu di 15 tipi di campi disponibili (testo, immagine, video, repeater, relazione...)
• Custom Post Types con URL personalizzate e SEO ottimizzato
• Tassonomie per categorizzare e filtrare i tuoi contenuti
• Multilingua nativo su tutti i campi
• Interfaccia drag & drop per riorganizzare i campi
• Template personalizzabili tramite il sistema di override di PrestaShop
• Sistema di widget per visualizzare i tuoi CPT ovunque nel sito

Funzionalita

Advanced Custom Fields

Il nucleo del modulo si basa su un sistema di gruppi di campi che associ liberamente alle tue entita PrestaShop. Crea un gruppo, definisci le sue regole di localizzazione (prodotti, categorie, pagine CMS, clienti o Custom Post Types) e aggiungi i campi di cui hai bisogno. Ogni campo dispone di opzioni di validazione, presentazione e traduzione multilingua.

I tipi di campi coprono tutte le esigenze: campi base (testo, textarea, editor WYSIWYG, numero, email, URL), campi di scelta (select, checkbox, radio, vero/falso, valutazione a stelle), campi media (immagine, galleria, video YouTube/Vimeo, file scaricabile) e campi avanzati (repeater per gruppi ripetibili, relazione con prodotti o categorie, selettore di colore, data e datetime).

Custom Post Types

Crea i tuoi tipi di contenuto indipendenti dal catalogo PrestaShop. Annunci immobiliari, portfolio, testimonianze, guide, eventi, ricette — le possibilita sono illimitate. Ogni tipo di contenuto ha il proprio slug, URL personalizzabili con prefisso, una pagina di archivio opzionale e meta tag SEO configurabili con variabili dinamiche come {title}, {shop_name} e {type_name}.

Tassonomie

Le tassonomie consentono di categorizzare e filtrare i tuoi contenuti personalizzati. Funzionano come le categorie di prodotti ma si applicano ai tuoi Custom Post Types. Crea tassonomie (Transazione, Tipo di immobile, Budget...) e definisci i termini associati (Vendita, Affitto, Casa, Appartamento...). Le tassonomie appaiono nella barra laterale durante la modifica di un post per una selezione rapida.

Sistema di Widget CPT

Visualizza i post dei tuoi Custom Post Types (blog, eventi, portfolio...) al di fuori della loro pagina di archivio, direttamente nella tua homepage, nel footer o in qualsiasi punto del tuo sito.

3 metodi di integrazione a scelta:

1. Tramite il back-office (hook PrestaShop)

Apri un tipo CPT nel builder > Step 2 > sezione "Widget". Attiva il widget, scegli l'hook (displayHome, displayFooter, ecc.), il numero di post e il titolo. Salva: il widget si visualizza automaticamente nel front-office.

2. Tramite un tag Smarty (page builder, template)

{acf_widget type="blog" limit="6"}
{acf_widget type="events" limit="3" title="Prossimi eventi" show_view_all=false}
{acf_widget type="blog" template="module:wepresta_acf/views/templates/front/cpt/widget-blog.tpl"}

Funziona in tutti i template .tpl e nei blocchi Smarty dei page builder (Creative Elements, ecc.).

3. Tramite uno shortcode (contenuto CMS)

[acf_widget type="blog" limit="6"]
[acf_widget type="blog" limit="3" show_title="false"]

Funziona nelle pagine CMS e nelle descrizioni (prodotti, categorie).

Parametri disponibili:

Parametro	Predefinito	Descrizione
type	obbligatorio	Slug del tipo CPT
limit	6	Numero di post visualizzati
show_title	true	Mostrare il titolo
title	nome del tipo	Titolo personalizzato
show_view_all	true	Collegamento alla pagina di archivio
template	auto	Template Smarty specifico (solo tag Smarty)

Template sovrascrivibili:

Crea un template specifico per tipo nel tuo tema:

themes/{theme}/modules/wepresta_acf/views/templates/front/cpt/widget-blog.tpl

Integrazione front-office con Smarty

La variabile $acf e automaticamente disponibile in tutti i tuoi template Smarty. Diversi metodi consentono di visualizzare i dati: field() per i valori testuali con escape, raw() per i dati grezzi, render() per il rendering HTML formattato di immagini e video, label() per le etichette tradotte dei campi di scelta, has() per verificare l'esistenza di un valore, e repeater() per iterare sui campi ripetibili.

Per visualizzare i campi ACF in un elenco di prodotti, usa il prefetch batch disponibile dalla versione 1.2.0:

{assign var='pAcf' value=$acf->forProduct($product.id_product)}
{$pAcf->field('field_slug')}

Shortcode

Integra i tuoi campi direttamente nelle pagine CMS o nelle descrizioni dei prodotti tramite l'editor WYSIWYG con gli shortcode: [acf field="marca"], [acf_render field="image"], [acf_group id="1"] o [acf_repeater slug="specs"]...[/acf_repeater].

Installazione

1. Scarica il file ZIP del modulo da PrestaShop Addons
2. Nel back-office PrestaShop, vai su Moduli > Gestore moduli
3. Clicca su Installa un modulo e seleziona il file ZIP
4. Una volta installato, clicca su Configura

Il modulo crea automaticamente le tabelle necessarie nel database durante l'installazione ed e immediatamente operativo.

Configurazione

Gruppi di Campi

Accedi all'interfaccia tramite Moduli > ACF Field Builder, scheda Advanced Custom Fields. Clicca su + Add Group per creare un nuovo gruppo. Inserisci il titolo, verifica lo slug generato automaticamente, aggiungi una descrizione opzionale e definisci le regole di localizzazione per associare il gruppo alle entita desiderate (prodotti, categorie, pagine CMS, clienti o Custom Post Types).

Configurazione dei Campi

Ogni campo si configura tramite tre schede: General Settings (titolo multilingua, slug, istruzioni contestuali, attivazione), Validation (campo obbligatorio, valori min/max, espressione regolare) e Presentation (visualizzazione dell'etichetta nel front-office, traduzione del valore, classe CSS e ID HTML personalizzati).

Tipi di Contenuto Personalizzati

Dalla scheda Custom Post Types, crea i tuoi tipi di contenuto con un nome multilingua, uno slug tecnico, una descrizione e un'icona Material Design. Configura poi gli URL (prefisso, pagina di archivio) e i meta tag SEO con le variabili dinamiche disponibili.

Widget CPT

Nel builder di ogni tipo CPT, la scheda Step 2 espone una sezione Widget che consente di configurare la visualizzazione automatica tramite gli hook PrestaShop senza scrivere codice. Consulta la sezione Sistema di Widget CPT per tutti i dettagli delle opzioni.

Requisiti

• PrestaShop 8.0+ o 9.x
• PHP 8.1 o superiore
• Estensione PHP intl attivata (per il multilingua)
• Accesso al back-office con diritti di amministratore

FAQ

Il modulo e compatibile con il multistore?

Si, i campi possono essere configurati per negozio o condivisi tra piu negozi in modalita multistore.

I dati vengono conservati durante un aggiornamento?

Si, tutti i dati sono memorizzati in tabelle dedicate e non vengono mai eliminati durante gli aggiornamenti del modulo.

Posso usare ACF su piu tipi di entita contemporaneamente?

Si, lo stesso gruppo di campi puo essere associato a piu tipi di contenuto tramite le regole di localizzazione. Ad esempio, un gruppo puo applicarsi simultaneamente a prodotti e categorie.

Posso esportare e importare le mie configurazioni?

Si, la scheda Sync consente di esportare i tuoi gruppi di campi in JSON e importarli in un altro negozio.

Il modulo e compatibile con il mio tema?

Si, il modulo e compatibile con i temi Classic, Hummingbird e tutti i temi conformi agli standard PrestaShop.

Che tipi di Custom Post Types posso creare?

Il modulo e totalmente flessibile: annunci immobiliari, articoli di blog, portfolio, testimonianze di clienti, guide, eventi, ricette, schede tecniche — qualsiasi tipo di contenuto strutturato di cui la tua attivita abbia bisogno.

Come visualizzare i miei CPT al di fuori della pagina di archivio?

Usa il sistema di widget CPT introdotto nella versione 1.3.0. Sono disponibili tre metodi: tramite il back-office (hook PrestaShop), tramite un tag Smarty nei template, o tramite uno shortcode nelle pagine CMS. Consulta la sezione Sistema di Widget CPT per i dettagli.

Supporto

Per qualsiasi domanda tecnica o richiesta di assistenza, contattaci tramite la messaggistica PrestaShop Addons o consulta la documentazione inclusa con il modulo.

Changelog

Versione 1.3.0

Sistema di Widget CPT

Nuova funzionalita principale che consente di visualizzare i post dei tuoi Custom Post Types (blog, eventi, portfolio...) al di fuori della loro pagina di archivio — nella homepage, nel footer o in qualsiasi punto del sito — tramite tre metodi di integrazione: hook PrestaShop dal back-office, tag Smarty nei template, o shortcode nelle pagine CMS. I template sono sovrascrivibili per tipo direttamente dal tuo tema.

Template di archivio refactorizzati

I template di archivio utilizzano ora partial riutilizzabili (_partials/posts-grid.tpl, _partials/pagination.tpl). Nessuna modifica visiva — stesso rendering di prima.

Correzione

• Corretta la salvataggio dei campi config e seo_config nell'API di aggiornamento dei tipi CPT

Aggiornamento

Carica i file del modulo e clicca su "Upgrade" nel back-office (Moduli > WePresta ACF). Gli hook widget vengono registrati automaticamente. Nessuna migrazione del database richiesta.

---

Versione 1.4.0

Nuova struttura di navigazione

• Sezione "ACF / CPT" nella sidebar del back-office, in sostituzione della precedente scheda "WePresta".
• Schede ACF e CPT separate, ciascuna estensibile con sotto-schede dinamiche.
• Sotto-schede dinamiche per ogni gruppo ACF creato (appaiono sotto la scheda ACF).
• Sotto-schede dinamiche per ogni tipo di CPT creato (appaiono sotto la scheda CPT).
• Le sotto-schede vengono create, rinominate ed eliminate automaticamente durante le operazioni CRUD.

Versione 1.2.0

• Prefetch ACF in batch per gli elenchi di prodotti (actionProductSearchComplete)
• Campi personalizzati sulle miniature dei prodotti
• Nuovo helper Smarty per l'integrazione nelle pagine delle categorie
• Prestazioni di rendering dei campi migliorate

Per utilizzare l'helper Smarty sulle miniature dei prodotti, inserisci nel tuo template:

{assign var='pAcf' value=$acf->forProduct($product.id_product)}
{$pAcf->field('field_slug')}

---

Versione 1.0.0

• Versione iniziale
• 15+ tipi di campi personalizzati
• Custom Post Types con URL SEO
• Sistema di tassonomie
• Supporto multilingua nativo
• Interfaccia drag & drop
• Template personalizzabili
• Shortcode per pagine CMS
• Esportazione/importazione JSON delle configurazioni
• Compatibilita con PrestaShop 8.x e 9.x