DataFirefly Guida delle taglie: documentazione

Panoramica

DataFirefly Guida delle taglie aggiunge al vostro negozio PrestaShop un sistema completo di guide alle taglie assegnabili per categoria, produttore, combinazione marchio × categoria o prodotto, con tabelle di corrispondenza EU/US/UK/FR/JP, calcolatore interattivo, pagina SEO indicizzabile per categoria e widget di riscontro post-acquisto con punteggio di scostamento aggregato.

Il modulo si rivolge ai negozi di abbigliamento e calzature, dove oltre il 20% dei resi dipende da un problema di taglia. Trasforma quell’attrito in un percorso d’acquisto rassicurante: il cliente vede automaticamente la tabella giusta, può inserire le proprie misure per ottenere un consiglio personalizzato, e voi raccogliete riscontri qualificati che rivelano i prodotti mal graduati.

Compatibilità

• PrestaShop 8.0.x, 8.1.x, 8.2.x, 9.0.x
• PHP 8.1, 8.2, 8.3
• Multinegozio (tutte le assegnazioni sono delimitate da id_shop)
• Polylang FR/EN/ES/DE/IT/NL/PL pronto all’uso
• Temi classic, hummingbird e temi personalizzati (8 posizioni diverse disponibili)

Installazione

1. Caricate l’archivio dfsizeguide.zip da Moduli → Module Manager → Carica un modulo.
2. Cliccate su Installa. Le 13 tabelle preimpostate (parte superiore e inferiore donna e uomo, abiti, reggiseni, calzature donna, uomo e bambino, abbigliamento bambino, guanti, cappelli, anelli, cinture) vengono create automaticamente in 7 lingue, e viene creata un’assegnazione predefinita sulla tabella abbigliamento donna.
3. Appena terminata l’installazione, la scheda “Guida alle taglie” compare su tutte le schede prodotto senza altra configurazione.
4. Andate in Moduli → DataFirefly Guida delle taglie → Configura per regolare le posizioni, l’unità predefinita, la tolleranza del calcolatore e le funzioni attive.

Concetti chiave

Il risolutore di tabelle a 5 livelli

Quando un cliente arriva su una scheda prodotto, il modulo cerca quale tabella mostrare percorrendo una priorità rigorosa:

1. Prodotto — se avete assegnato esplicitamente una tabella a quel preciso prodotto, vince.
2. Categoria + Produttore — altrimenti la tabella assegnata alla coppia formata da una categoria del prodotto e dal suo marchio. Più specifica di ciascuna delle due dimensioni presa singolarmente, quindi questo livello prevale sui due successivi. Le categorie vengono percorse dalla più profonda alla più generale.
3. Produttore — altrimenti la tabella assegnata al marchio del prodotto.
4. Categoria — altrimenti la prima categoria del prodotto che ha una tabella, partendo dalla più profonda.
5. Predefinito — altrimenti la tabella indicata come ripiego globale.

Questa gerarchia consente di mantenere una sola tabella per marchio o per reparto senza toccare le singole schede prodotto, conservando la possibilità di sovrascritture chirurgiche.

Restringere una regola: esclusioni e combinazioni strette

I livelli Categoria e Predefinito si applicano per natura a tutti i marchi. Due meccanismi indipendenti li restringono.

Le esclusioni tolgono dall’ambito di una regola marchi o prodotti precisi. Il prodotto escluso ignora quella regola e prosegue la catena: categoria superiore, poi ripiego globale, poi nessuna guida. Ogni tipo di destinazione accetta ciò che ha senso per esso:

• Predefinito e Categoria — esclusioni di marchi e di prodotti
• Produttore e Categoria + Produttore — esclusioni di prodotti
• Prodotto — nessuna, la destinazione indica già una singola scheda

L’impostazione Combinazioni categoria + produttore strette, nella configurazione del modulo, agisce diversamente: appena una categoria porta almeno una combinazione, diventa esclusiva ai marchi che vi hanno la propria. I prodotti degli altri marchi di quella categoria non ereditano più né la regola di categoria né la guida predefinita. Una tabella assegnata esplicitamente al loro marchio continua ad applicarsi, perché quell’assegnazione è deliberata, e un prodotto senza produttore mantiene i ripieghi abituali. L’impostazione è disattivata per impostazione predefinita.

Tipi di colonna

Ogni tabella è composta da colonne tipizzate:

• Colonna “taglia” — un solo valore testuale per riga (S, M, 38, XL). Usata per le corrispondenze internazionali (EU, US, UK, FR, JP).
• Colonna “misura” — un intervallo numerico min/max per riga (es. circonferenza seno 88–92 cm). Usata per indicare quali misure corrispondono a ciascuna taglia.

Il calcolatore interattivo si basa esclusivamente sulle colonne “misura”.

Colonne raggruppate: una misura, più varianti

Alcune tabelle descrivono la stessa misura su più colonne. In una tabella di reggiseni le colonne coppa B, C, D ed E non sono quattro misure: sono una sola circonferenza seno declinata in varianti. Chiederle tutte e quattro alla cliente non ha senso, lei ne ha una sola.

Assegnando a quelle colonne lo stesso codice di gruppo nell’editor, il calcolatore mostra un unico campo per il gruppo. La risposta combina allora la taglia della riga con l’etichetta di variante della colonna trovata: 4B invece di 4. Una stessa misura può rientrare in più varianti, nel qual caso vengono proposte tutte.

Tre campi per colonna di misura, visibili nell’editor solo sulle colonne di tipo misura:

• Gruppo — il codice comune alle colonne che descrivono la stessa misura (es. bust). Lasciato vuoto, la colonna resta indipendente.
• Variante — il suffisso aggiunto alla taglia nel risultato (es. B, C, D).
• Etichetta del gruppo — il testo del campo condiviso nel calcolatore (es. “Circonferenza seno”). Da compilare su una sola colonna del gruppo.

Le tabelle senza gruppi mantengono esattamente il comportamento originario: un campo per colonna, una risposta per riga.

Configurazione

Posizioni sulla scheda prodotto

Il modulo espone 8 posizioni attivabili singolarmente in Configura → Posizioni scheda prodotto:

• Scheda prodotto (attiva per impostazione predefinita, consigliata) — hook displayProductExtraContent, aggiunge una scheda pulita accanto a “Descrizione” e “Dettagli”. Funziona sulla quasi totalità dei temi PS 1.7+.
• Sotto il prezzo — hook displayProductPriceBlock (tipo after_price), mostra un link compatto subito sotto il prezzo.
• Vicino al pulsante “Aggiungi al carrello” — hook displayProductActions, mostra un pulsante compatto.
• Sotto le informazioni prodotto — hook displayProductAdditionalInfo, mostra un pulsante prominente.
• Nel blocco garanzie — hook displayReassurance, si integra con gli altri vostri argomenti (spedizione, resi).
• Dopo le immagini prodotto — hook displayAfterProductThumbs, mostra un pulsante compatto sotto la galleria.
• In fondo alla pagina prodotto — hook displayFooterProduct, mostra un pulsante prominente a piè di pagina.
• Anteprima rapida — mostra la guida nella finestra di anteprima rapida, nelle posizioni sopra elencate che il vostro tema vi visualizza.

Potete attivare più posizioni in parallelo: la modale della guida viene istanziata una sola volta nel DOM, e i pulsanti aggiuntivi aprono la stessa modale.

La scheda prodotto è l’unica posizione che mostra la tabella inline. Le altre mostrano un pulsante che apre la modale.

Parametri generali

• Unità predefinita — cm o pollici. Il cliente può commutare al volo e la preferenza viene mantenuta nel calcolo.
• Calcolatore interattivo — attiva l’inserimento delle misure e il consiglio di taglia (attivo per impostazione predefinita).
• Tolleranza taglie vicine (cm) — dopo le taglie che corrispondono esattamente, il calcolatore elenca quelle vicine entro questo margine. 0 nasconde la seconda lista, ed è il valore predefinito. Ridefinibile tabella per tabella.
• Combinazioni categoria + produttore strette — vedi sopra. Disattivata per impostazione predefinita.
• Riscontri dei clienti dopo l’acquisto — attiva il widget che chiede al cliente se la taglia era adatta (attivo per impostazione predefinita).
• Dati strutturati JSON-LD — attiva l’inserimento della marcatura Schema.org (attivo per impostazione predefinita).
• Colore d’accento — colore dei pulsanti, dell’unità attiva e della riga evidenziata. Da accordare al vostro tema; la sfumatura al passaggio del mouse viene calcolata automaticamente.
• Slug pagina SEO — prefisso dell’URL delle pagine guida dedicate (per impostazione predefinita size-guide).

Creare e modificare una tabella

Menu Moduli → Guide alle taglie → Tabelle. Cliccate su “Aggiungi” per creare una nuova tabella, o sull’icona matita per modificarne una esistente.

Campi della tabella

• Codice interno — identificativo tecnico univoco (es. donna-abiti-2026). Usato negli URL SEO e nei log.
• Tipo — parte superiore, parte inferiore, abito, reggiseno, calzature, bambino, guanti, cappelli, anelli, cinture o personalizzato.
• Nome — etichetta multilingua mostrata ai clienti (titolo della scheda, titolo della modale, h1 della pagina SEO).
• Introduzione (HTML) — contenuto multilingua mostrato sopra la tabella.
• Istruzioni di misurazione (HTML) — riquadro a scomparsa che spiega come prendere ogni misura.
• Footer (HTML) — contenuto multilingua mostrato sotto la tabella (avvertenza, link alla politica di reso, ecc.).
• Meta title / Meta description — per la pagina SEO dedicata.
• Tolleranza taglie vicine (cm) — ridefinisce l’impostazione del negozio solo per questa tabella. Lasciato vuoto la eredita, 0 nasconde qui l’elenco delle taglie vicine. È il campo da usare quando lo stesso negozio vende reggiseni e calzature: 3 cm sono un vicinato sui primi e quattro numeri interi sulle seconde.
• Attiva — interruttore on/off. Una tabella inattiva non viene mai servita, anche se assegnata.

Modificare la tabella

Sotto il modulo della tabella, un editor visuale permette di costruirla:

1. Cliccate su Colonna taglia per aggiungere una colonna testuale. Inserite il codice (es. eu, intl) e l’etichetta multilingua.
2. Cliccate su Colonna misura per aggiungere una colonna numerica. Inserite il codice (es. chest_cm) e l’unità (cm, pollici, mm). Su questo tipo di colonna compaiono tre campi aggiuntivi: gruppo, variante ed etichetta del gruppo, descritti sopra.
3. Cliccate su Riga per aggiungere una riga. Compilate le celle: testo semplice per le colonne “taglia”, valori min/max per le colonne “misura”.
4. Cliccate su Salva. Il salvataggio avviene in una transazione SQL atomica: o viene scritto tutto, o niente.

Duplicare una tabella

Il pulsante Duplica nell’elenco ricopia la tabella, le sue traduzioni, le sue colonne e le relative etichette, le sue righe e tutte le celle. Utile per derivare una variante da una tabella esistente invece di ripartire da una vuota.

Due punti da conoscere. Le assegnazioni non vengono copiate: sono univoche per destinazione, quindi duplicarle ruberebbe le destinazioni della tabella originale. E la copia viene creata inattiva, perché non possa essere servita prima della vostra rilettura. Il codice interno viene derivato automaticamente (donna-sopra diventa donna-sopra-copy) poiché deve restare univoco.

Assegnare una tabella

Menu Moduli → Guide alle taglie → Assegnazioni.

1. Scegliete la tabella da assegnare dall’elenco.
2. Scegliete il tipo di destinazione: Predefinito (ripiego globale), Categoria, Produttore, Categoria + Produttore, o Prodotto.
3. A seconda del tipo compare un secondo campo per scegliere la categoria (in un albero indentato), il marchio (elenco a discesa) o l’ID prodotto (inserimento diretto).
4. Compilate se necessario le esclusioni, descritte qui sotto.
5. Cliccate su Aggiungi / Aggiorna. Se esiste già un’assegnazione per quella destinazione, viene sovrascritta (upsert).

Tutte le assegnazioni sono delimitate per negozio in multinegozio. Potete avere una tabella diversa per la stessa categoria su due negozi dello stesso gruppo.

Escludere marchi o prodotti

Due campi compaiono a seconda del tipo di destinazione scelto:

• Marchi da escludere — elenco a selezione multipla, proposto sulle destinazioni Categoria e Predefinito. Ctrl o Cmd per selezionarne più di uno, clic di nuovo per deselezionare.
• Prodotti da escludere — ID separati da virgole (es. 12, 45, 78), proposto su tutte le destinazioni tranne Prodotto.

Le esclusioni sono visibili nella tabella delle assegnazioni, risolte in nomi, sotto la destinazione interessata. Vengono eliminate insieme all’assegnazione e abbandonate quando spostate la regola verso un tipo già specifico per un marchio o un prodotto.

Un prodotto escluso da una combinazione non attiva la modalità stretta: escludere significa “prosegui la catena”, quindi l’esclusione non può essere ciò che blocca i ripieghi.

Modificare un’assegnazione

La matita a fine riga ricarica l’assegnazione nel modulo, con la sua tabella, il tipo di destinazione, la destinazione e le esclusioni. Potete allora cambiare tabella, ma anche spostare l’assegnazione su un’altra destinazione o trasformare un’assegnazione semplice in combinazione categoria + produttore. La riga viene evidenziata nell’elenco, e un pulsante Annulla permette di uscire senza modificare nulla.

Spostare un’assegnazione su una destinazione già occupata da un’altra viene rifiutato con un messaggio esplicito, poiché ogni destinazione può portare una sola tabella.

Il calcolatore di taglia

Il calcolatore compare sotto la tabella, solo se questa ha almeno una colonna “misura”.

Come viene costruito il consiglio

Il cliente inserisce le proprie misure, un campo per ciascun gruppo di misura della tabella. All’invio:

1. I valori vengono normalizzati in centimetri (conversione automatica se ha scelto i pollici: ×2,54).
2. Il modulo tiene prima le taglie esatte: le righe i cui intervalli contengono ciascuno il valore inserito per il gruppo corrispondente. Quando un gruppo conta più varianti, ogni variante che corrisponde produce un risultato distinto.
3. Tiene poi le taglie vicine, allargando ogni intervallo della tolleranza nei due sensi ed escludendo quelle già elencate nel primo gruppo. Questo secondo gruppo compare solo se la tolleranza è maggiore di 0.
4. Se nulla corrisponde, tolleranza compresa, il modulo indica la riga meno distante invece di non rispondere.
5. La taglia viene estratta in via prioritaria dalla colonna corrispondente alla lingua del negozio, poi eu, fr, intl, uk, us, jp.

Esempio

Tabella di reggiseni con una colonna sottoseno e quattro colonne di coppa raggruppate. La cliente inserisce 87 cm di circonferenza sottoseno e 101 cm di circonferenza seno, la tabella è impostata su 3 cm di tolleranza.

• Taglie esatte: 4B e 4C. 87 rientra nell’intervallo 83–87 della riga 4, e 101 rientra sia nella coppa B (99–101) sia nella coppa C (101–103) di quella riga.
• Taglie vicine: 5B e 4D. Con 3 cm di margine, 87 raggiunge la riga 5 (88–92) la cui coppa B è 104–106, e 101 raggiunge la coppa D della riga 4 (103–105).

Cosa vede il cliente

Le taglie esatte compaiono in pastiglie piene, le taglie vicine in pastiglie con bordo e il margine applicato. Le righe corrispondenti vengono evidenziate nella tabella soprastante, e i campi lasciati vuoti vengono segnalati.

Riscontri dei clienti dopo l’acquisto

Un widget “La taglia era adatta?” compare in fondo alla scheda prodotto con 5 scelte: troppo piccolo, un po’ piccolo, perfetto, un po’ grande, troppo grande. Viene mostrato solo alle condizioni seguenti:

• Il cliente è autenticato (sessione attiva).
• Il cliente ha effettivamente acquistato quel prodotto (join con orders e order_detail, stato valido).
• Il cliente non ha già lasciato il proprio parere su quel prodotto.

Il controllo è interamente lato server, senza rischio di aggiramento.

Dashboard dei riscontri

Menu Moduli → Guide alle taglie → Riscontri clienti. Una sintesi sopra la tabella mostra il numero di risposte in ciascuna delle 5 categorie. Sotto, l’elenco completo dei riscontri per prodotto con l’ID cliente, la taglia acquistata e la data.

Punteggio di scostamento

Per ogni prodotto con almeno 3 riscontri viene calcolato un punteggio di scostamento:

punteggio = ((too_large × 2 + slightly_large) − (too_small × 2 + slightly_small)) / totale

Un punteggio positivo indica che il prodotto veste sistematicamente largo (da spostare di una tacca verso il basso). Un punteggio negativo indica che veste stretto (da spostare di una tacca verso l’alto). Un punteggio vicino a zero indica una buona gradazione.

Pagina SEO dedicata

Il modulo espone una rotta pubblica per categoria: /{slug}/{category-link-rewrite}, dove {slug} è il prefisso configurato (per impostazione predefinita size-guide).

Esempio: https://ilvostronegozio.com/size-guide/abiti-donna

La pagina contiene un percorso di navigazione, il titolo h1 della tabella, l’introduzione, le istruzioni di misurazione e la tabella completa, il calcolatore (se attivo), il footer HTML della tabella e una marcatura JSON-LD WebPage Schema.org che aiuta Google a capire che si tratta di una guida pratica.

Meta title e meta description provengono dai campi SEO della tabella. Configurateli con cura per intercettare ricerche a coda lunga come “guida taglie abiti donna”.

Multilingua e multinegozio

Il modulo è multilingua a livello di tabella (nome, introduzione, istruzioni, footer, meta), a livello di etichette di colonna e di gruppo, e a livello di etichette Polylang per gli URL.

In multinegozio ogni assegnazione (guida → destinazione) è delimitata da id_shop. Potete quindi mostrare la tabella A per la categoria “Calzature” sul negozio francese e la tabella B per la stessa categoria su quello tedesco.

Struttura tecnica

Base di dati

9 tabelle con prefisso dfsg_: dfsg_guide, dfsg_guide_lang, dfsg_column, dfsg_column_lang, dfsg_row, dfsg_cell, dfsg_assignment, dfsg_assignment_exclusion, dfsg_feedback. Tutte le tabelle vengono eliminate correttamente alla disinstallazione.

Hook utilizzati

• actionFrontControllerSetMedia — inserimento CSS/JS front
• displayBackOfficeHeader — inserimento CSS/JS back office
• displayProductExtraContent — scheda prodotto (consigliato)
• displayProductPriceBlock, displayProductActions, displayProductAdditionalInfo, displayReassurance, displayAfterProductThumbs, displayFooterProduct — posizioni alternative
• displayHeader — inserimento JSON-LD sulle schede prodotto
• actionValidateOrder — trigger per eventuali solleciti (v2)
• moduleRoutes — pagina SEO dedicata

FAQ

La guida non compare sulla mia scheda prodotto, cosa devo controllare?

Verificate anzitutto in Configura → Posizioni scheda prodotto che almeno una posizione sia attiva (Scheda prodotto per impostazione predefinita). Se il vostro tema personalizzato non visualizza gli hook nativi di PrestaShop, attivate più posizioni in parallelo: almeno una delle sette dovrebbe funzionare. Verificate inoltre che esista almeno una tabella attiva e un’assegnazione predefinita in Guide alle taglie → Assegnazioni. Se la modalità combinazioni strette è attiva, verificate infine che il prodotto non appartenga a una categoria che porta combinazioni non coprenti il suo marchio.

Ho creato una combinazione marchio × categoria ma gli altri marchi mostrano comunque una tabella

È il comportamento normale della catena di risoluzione: una combinazione dà la priorità a un marchio, non esclude gli altri, che continuano a scendere fino alla regola di categoria e poi alla guida predefinita creata all’installazione. Perché la categoria diventi esclusiva ai marchi che vi hanno una combinazione, attivate Combinazioni categoria + produttore strette nella configurazione del modulo. Per escludere solo due o tre marchi, mantenete la regola di categoria e compilate piuttosto Marchi da escludere.

La guida non si apre dall’anteprima rapida

Verificate che la posizione Anteprima rapida sia attiva nella configurazione: quando non lo è, il modulo non carica volutamente né il proprio foglio di stile né il proprio script sulle pagine di elenco, e il pulsante non può funzionare da un’anteprima. Verificate poi che sia attiva almeno una posizione visualizzata dalla vostra anteprima rapida: non tutti i temi vi visualizzano gli stessi hook, e la scheda prodotto non vi viene mai visualizzata.

Si possono importare tabelle da un CSV?

Non ancora. L’editor visuale permette di costruire e modificare le tabelle al volo, colonna per colonna e riga per riga. L’import CSV è allo studio per una versione futura.

Il calcolatore funziona senza JavaScript?

No, il calcolatore è interattivo e richiede JavaScript per la chiamata AJAX al server. La tabella statica invece si visualizza perfettamente senza JS, il che preserva accessibilità e indicizzazione.

C’è il rischio di marcatura JSON-LD duplicata?

No. L’hook displayHeader emette un solo script JSON-LD per pagina prodotto, e la pagina SEO dedicata ha la propria marcatura WebPage distinta. Il validatore Schema.org di Google non segnala duplicati.

Compatibile con la migrazione da PrestaShop 8 a 9?

Sì. Il modulo dichiara ps_versions_compliancy da 8.0.0 a 9.99.99, usa le classi ObjectModel e HelperForm che restano supportate in PS 9 e non ricorre ad alcuna API deprecata.

Come elimino tutti i dati del modulo?

La disinstallazione dal Module Manager elimina tutte le tabelle dfsg_* e tutte le configurazioni DFSG_*. Non resta alcuna traccia nel database.

Assistenza

Email: support@datafirefly.com. Risposta entro 5 giorni lavorativi, in francese o in inglese.