DataFirefly Guida delle taglie: documentazione

Panoramica

DataFirefly Guida delle taglie aggiunge al tuo negozio PrestaShop un sistema completo di guide delle taglie modulabili per categoria, produttore o prodotto, con tabelle di corrispondenza EU/US/UK/FR/JP, calcolatore interattivo di raccomandazione della taglia, pagina SEO indicizzabile dedicata per categoria e widget di feedback post-acquisto con punteggio di scostamento aggregato.

Il modulo si rivolge ai negozi di abbigliamento e calzature dove oltre il 20% dei resi è legato a un problema di taglia. Trasforma questo attrito in un percorso d’acquisto rassicurante: il cliente vede automaticamente la tabella giusta, può inserire le proprie misure per ottenere una raccomandazione personalizzata e tu recuperi feedback qualificati che ti permettono di individuare 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 limitate per id_shop)
• Polylang FR/EN/ES/DE pronto all’uso
• Temi classic, hummingbird e temi personalizzati (7 posizioni diverse disponibili)

Installazione

1. Carica lo ZIP dfsizeguide.zip da Moduli → Gestore moduli → Carica un modulo.
2. Clicca su Installa. Le 4 tabelle preimpostate (abbigliamento donna, abbigliamento uomo, calzature donna, calzature uomo) vengono create automaticamente in 4 lingue e viene creata un’assegnazione predefinita sulla tabella abbigliamento donna.
3. Appena terminata l’installazione, la scheda “Guida delle taglie” compare su tutte le tue pagine prodotto senza altra configurazione.
4. Vai su Moduli → DataFirefly Guida delle taglie → Configura per regolare le posizioni, l’unità predefinita e le funzioni attive.

Concetti chiave

Il risolutore di tabelle a 4 livelli

Quando un cliente arriva su una pagina prodotto, il modulo cerca quale tabella mostrare scendendo lungo una priorità rigorosa:

1. Prodotto: se hai assegnato esplicitamente una tabella a quel prodotto preciso, vince lei.
2. Produttore: altrimenti, la tabella assegnata al marchio del prodotto.
3. Categoria: altrimenti, la prima categoria del prodotto che possiede una tabella, partendo dalla più profonda (rispetto della specificità).
4. Predefinita: altrimenti, la tabella contrassegnata come fallback globale.

Questa gerarchia permette di mantenere una sola tabella per marchio o per reparto senza toccare le singole schede prodotto, conservando comunque la possibilità di un override chirurgico.

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 (ad esempio circonferenza torace 88-92 cm). Usata per indicare le misure che corrispondono a ciascuna taglia.

Il calcolatore interattivo si basa esclusivamente sulle colonne “misura” per determinare la taglia consigliata.

Configurazione

Posizioni sulla pagina prodotto

Il modulo espone 7 posizioni attivabili singolarmente in Configura → Posizioni pagina 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 appena sotto il prezzo.
• Vicino al pulsante “Aggiungi al carrello”: hook displayProductActions, mostra un pulsante compatto.
• Sotto le informazioni prodotto: hook displayProductAdditionalInfo, mostra un pulsante in evidenza.
• Nel blocco rassicurazione: hook displayReassurance, si integra visivamente con gli altri tuoi argomenti (spedizione, resi).
• Dopo le immagini prodotto: hook displayAfterProductThumbs, mostra un pulsante compatto appena sotto la galleria.
• In fondo alla pagina prodotto: hook displayFooterProduct, mostra un pulsante in evidenza a piè di pagina.

Puoi attivare più posizioni in parallelo: la modale della guida viene istanziata una sola volta nel DOM (anti-duplicato) e i pulsanti aggiuntivi aprono la stessa modale.

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

Parametri generali

• Unità predefinita: cm o pollici. Il cliente può passare da una all’altra al volo e la preferenza viene mantenuta nel calcolo.
• Calcolatore interattivo: attiva l’inserimento delle misure e la raccomandazione della taglia (attivo per impostazione predefinita).
• Feedback clienti post-acquisto: attiva il widget che chiede al cliente se la taglia era adatta (attivo per impostazione predefinita).
• Dati strutturati JSON-LD: attiva l’iniezione del markup Schema.org per migliorare il posizionamento (attivo per impostazione predefinita).
• Slug pagina SEO: prefisso dell’URL delle pagine guida dedicate (per impostazione predefinita size-guide, da tradurre in guida-delle-taglie se vuoi un URL in italiano).

Creare e modificare una tabella

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

Campi della tabella

• Codice interno: identificatore tecnico univoco (ad esempio donna-abiti-2026). Usato negli URL SEO e nei log.
• Tipo: abbigliamento parte superiore, abbigliamento parte inferiore, abito, calzature 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 richiudibile 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.
• Attiva: interruttore on/off. Una tabella inattiva non viene mai servita, anche se assegnata.

Modificare la tabella

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

1. Clicca su Colonna taglia per aggiungere una colonna testuale. Inserisci il codice (ad esempio eu, intl) e l’etichetta multilingua.
2. Clicca su Colonna misura per aggiungere una colonna numerica. Inserisci il codice (ad esempio chest_cm) e l’unità (cm, pollici, mm).
3. Clicca su Riga per aggiungere una riga. Compila le celle: testo semplice per le colonne “taglia”, valori min/max per le colonne “misura”.
4. Clicca su Salva. Il salvataggio avviene in una transazione SQL atomica: o viene registrato tutto, o niente.

Assegnare una tabella

Menu Moduli → Guide delle taglie → Assegnazioni.

1. Scegli la tabella da assegnare nell’elenco.
2. Scegli il tipo di destinazione: Predefinita (fallback globale), Categoria, Produttore o Prodotto.
3. A seconda del tipo, compare un secondo campo per scegliere la categoria (in un albero indentato), il marchio (menu a tendina) o l’ID prodotto (inserimento diretto).
4. Clicca su Aggiungi / Aggiorna. Se esiste già un’assegnazione per quella destinazione, viene sovrascritta (upsert).

Tutte le assegnazioni sono limitate per negozio in modalità multinegozio. Puoi avere una tabella diversa per la stessa categoria su due negozi dello stesso gruppo.

Il calcolatore di taglia

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

Algoritmo di scoring

Il cliente inserisce le proprie misure nei campi (un campo per colonna “misura”). All’invio:

1. I valori vengono normalizzati in centimetri (conversione automatica se l’utente ha scelto i pollici: ×2,54).
2. Per ogni riga della tabella il modulo calcola un punteggio: +2 punti se la misura del cliente cade esattamente nell’intervallo min/max della cella, +1 punto se è vicina (entro il ±5% dell’intervallo), 0 punti altrimenti.
3. La riga con il punteggio più alto viene dichiarata vincente.
4. In caso di parità si prende la riga i cui intervalli sono più centrati sui valori del cliente.
5. La taglia consigliata viene estratta in via prioritaria dalla colonna eu, poi fr, intl, uk, us, jp.

Riscontro all’utente

Il calcolatore mostra la taglia consigliata con un punteggio di affidabilità in percentuale, le prime 3 candidate possibili ciascuna con il proprio punteggio, l’evidenziazione della riga consigliata nella tabella soprastante e l’elenco delle misure che non corrispondono a nessuna riga (con avviso).

Feedback clienti post-acquisto

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

• Il cliente è connesso (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 feedback

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

Punteggio di scostamento

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

punteggio = ((troppo_grande × 2 + un_po_grande) − (troppo_piccola × 2 + un_po_piccola)) / totale

Un punteggio positivo indica che il prodotto veste sistematicamente grande (da rivedere di una misura verso il basso). Un punteggio negativo indica che veste piccolo (da rivedere di una misura 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://iltuonegozio.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 un markup JSON-LD WebPage Schema.org che aiuta Google a capire che la pagina è una guida pratica.

I tag meta title e meta description provengono dai campi SEO della tabella. Configurali correttamente per intercettare le ricerche a coda lunga del tipo “guida taglie abiti donna”.

Multilingua e multinegozio

Il modulo è multilingua a livello di tabelle (nome, introduzione, istruzioni, footer, meta), a livello di etichette delle colonne e a livello di etichette Polylang per gli URL.

In multinegozio, ogni assegnazione (guida verso destinazione) è limitata per id_shop. Puoi quindi mostrare la tabella A per la categoria “Calzature” sul negozio francese e la tabella B per la stessa categoria sul negozio tedesco.

Struttura tecnica

Database

7 tabelle con prefisso dfsg_: dfsg_guide, dfsg_guide_lang, dfsg_column, dfsg_column_lang, dfsg_row, dfsg_cell, dfsg_assignment, dfsg_feedback. Tutte le tabelle vengono rimosse in modo pulito alla disinstallazione.

Hook utilizzati

• actionFrontControllerSetMedia: iniezione CSS/JS front
• displayBackOfficeHeader: iniezione CSS/JS admin
• displayProductExtraContent: scheda pagina prodotto (consigliata)
• displayProductPriceBlock, displayProductActions, displayProductAdditionalInfo, displayReassurance, displayAfterProductThumbs, displayFooterProduct: posizioni alternative
• displayHeader: iniezione JSON-LD sulle pagine prodotto
• actionValidateOrder: trigger per eventuali solleciti (v2)
• moduleRoutes: pagina SEO dedicata

FAQ

La guida non compare sulla mia pagina prodotto, cosa fare?

Verifica prima in Configura → Posizioni pagina prodotto che almeno una posizione sia attiva (Scheda prodotto per impostazione predefinita). Se il tuo tema personalizzato non gestisce gli hook nativi di PrestaShop, attiva più posizioni in parallelo: almeno una delle 7 dovrebbe funzionare. Verifica anche che esista almeno una tabella attiva e un’assegnazione predefinita in Guide delle taglie → Assegnazioni.

Posso importare tabelle da un CSV?

Non nella versione 1.0. L’editor visivo permette di costruire le tabelle al volo. L’importazione CSV è prevista nella versione 1.1.

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 posizionamento.

C’è rischio di markup JSON-LD duplicato?

No. L’hook displayHeader emette un solo script JSON-LD per pagina prodotto e la pagina SEO dedicata ha il proprio markup WebPage distinto. Il validatore Schema.org di Google non segnala alcun duplicato.

È 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 usa alcuna API deprecata.

Come rimuovere tutti i dati del modulo?

La disinstallazione dal Gestore moduli elimina tutte le tabelle dfsg_* e tutte le configurazioni DFSG_*. Nessuna traccia resta nel database.

Supporto

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