Raggruppare Prodotti come Varianti in PrestaShop: Documentazione del Modulo (dfproductlinker)
Installare e configurare dfproductlinker: gruppi di varianti, visualizzazione del selettore, assistente di raggruppamento, importazione CSV, un solo prodotto per gruppo e impostazioni SEO.
Il modulo DF ProductLinker (dfproductlinker) collega schede prodotto distinte per mostrarle come un unico articolo con un selettore di colore, taglia o qualsiasi altro attributo. Ogni variante resta un prodotto completo, con il proprio URL. È il movimento inverso di DF ProductSplitter, che divide un prodotto con combinazioni in prodotti separati.
Installazione
- Scaricate lo ZIP dal vostro account cliente DataFirefly.
- Nel back-office, andate in Moduli > Gestione moduli > Carica un modulo e inviate lo ZIP.
- All’installazione il modulo crea le sue tabelle e la scheda Catalogo > Varianti collegate.
- Aprite Catalogo > Varianti collegate > Impostazioni per verificare la posizione del selettore.
Il modulo funziona su PrestaShop da 1.7.8 a 9.x con lo stesso ZIP, in multinegozio e in multilingua. È stato testato su PrestaShop 1.7.8.11, 8.2.1 e 9.1.5. I testi sono forniti in francese, inglese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.
Aggiornamento da una versione 1.x
Caricate lo ZIP 2.0.0 sopra il vecchio modulo: PrestaShop esegue l’aggiornamento. I vostri gruppi, l’ordine dei prodotti, i valori, i colori e le impostazioni vengono mantenuti.
- La versione 1.x nascondeva i prodotti secondari di un gruppo cambiandone la visibilità. La 2.0.0 non modifica più alcun prodotto: l’aggiornamento restituisce la visibilità originale ai prodotti il cui valore è ancora quello impostato dal modulo.
- Se nel frattempo avete modificato a mano la visibilità di un prodotto, il vostro valore viene mantenuto.
- La pagina Strumenti mostra il registro di ogni prodotto trattato (ripristinato, già corretto, mantenuto, prodotto eliminato) e un pulsante per rilanciare il ripristino.
- Le impostazioni passano dal prefisso
DFPL_al prefissoDFPLK_, perchéDFPL_è usato anche da un altro modulo. I valori vengono ripresi.
L’aggiornamento svuota la cache Smarty. Se la visualizzazione non cambia, svuotate la cache da Parametri avanzati > Prestazioni.
Principio: gruppi e assi
Un gruppo riunisce più prodotti. Un asse è un gruppo di attributi nativo di PrestaShop, ad esempio Colore o Taglia: valori, colori esadecimali, texture e traduzioni inseriti in Catalogo > Attributi e caratteristiche vengono riutilizzati così come sono. Ogni prodotto del gruppo riceve un valore su ogni asse.
Un prodotto può appartenere a un solo gruppo. I prodotti stessi non vengono modificati: il gruppo è salvato nelle tabelle del modulo.
Pannello dei gruppi
Catalogo > Varianti collegate apre il pannello dei gruppi. In alto, alcuni indicatori mostrano il numero di gruppi attivi, di prodotti collegati e di gruppi da verificare. Ogni riga mostra le varianti, il numero di prodotti e una colonna Stato che segnala:
- prodotti inattivi o esauriti;
- valori mancanti, o due prodotti con gli stessi valori;
- un colore senza campione (né codice esadecimale né texture);
- un prodotto assente dal negozio corrente;
- meno di due prodotti attivi, o nessun asse;
- un asse già usato nelle combinazioni native del prodotto.
Potete filtrare per nome, riferimento o ID, mostrare solo i gruppi da verificare e attivare, disattivare o eliminare più gruppi alla volta.
Creare o modificare un gruppo
Fate clic su Crea un gruppo. L’editor visuale ha tre parti.
- Generale: il nome del gruppo (uso interno), un riferimento del gruppo facoltativo, usato come
productGroupIDnei dati strutturati, e lo stato. - Assi: aggiungete uno o più gruppi di attributi. Per ogni asse scegliete la visualizzazione (automatica, campione colore, foto del prodotto, pulsante di testo, menu a tendina) e la proprietà dei dati strutturati (colore, taglia, materiale, motivo, età, genere o non dichiarata).
- Prodotti del gruppo: cercate per nome, riferimento, EAN o ID, con un filtro per categoria e un filtro Non ancora collegati. I valori presenti nel nome del prodotto vengono compilati automaticamente. Trascinate le righe, o usate le frecce, per definire l’ordine dei campioni. Il pulsante Ordina secondo l’ordine degli attributi dispone le righe nell’ordine del catalogo, comodo per taglie S, M, L, XL.
Per ogni prodotto potete forzare il campione: automatico, colore scelto, foto del prodotto o testo. L’anteprima in tempo reale mostra il selettore come apparirà sulla scheda di uno dei prodotti, e il blocco Controlli elenca i valori mancanti o doppi prima del salvataggio. Il modulo vi avvisa se lasciate la pagina senza salvare.
Cosa vede il cliente
Su ogni scheda del gruppo, il selettore mostra il nome dell’asse e il valore corrente, ad esempio Colore: Rosso, poi i valori disponibili. Al passaggio del mouse l’etichetta mostra il valore puntato. Il valore corrente è evidenziato; gli altri sono link alla scheda corrispondente.
- Sui pulsanti il modulo può mostrare la differenza di prezzo (+2,00 €), il prezzo intero o nessun prezzo.
- Con più assi, un clic su un colore apre il prodotto che mantiene la taglia corrente. Se questa combinazione non esiste, il modulo apre la variante più vicina privilegiando un prodotto disponibile, e il campione viene disegnato con bordo tratteggiato.
- Se i prodotti hanno combinazioni native, la combinazione scelta (ad esempio la taglia) viene mantenuta passando a un’altra variante, quando esiste.
- Una variante esaurita è barrata e resta cliccabile, sbiadita e non cliccabile, oppure nascosta, secondo l’impostazione.
- Il selettore compare anche nell’anteprima rapida degli elenchi.
- Le frecce della tastiera passano da un valore all’altro e i lettori di schermo annunciano il valore selezionato. La dimensione media dei campioni offre un’area tattile di 44 px.
- Nei browser compatibili, la pagina della variante viene precaricata quando il puntatore vi si ferma, e il passaggio da una variante all’altra avviene con una transizione morbida, disattivata se il visitatore chiede meno animazioni.
Impostazioni
Aprite Catalogo > Varianti collegate > Impostazioni. Un’anteprima del selettore si aggiorna mentre modificate le opzioni.
- Posizione del selettore: sotto il prezzo (consigliato, anche nelle anteprime rapide), prima o dopo il blocco delle combinazioni (spostato da script), sotto il pulsante di aggiunta al carrello (
displayProductAdditionalInfo) o solo nell’hook del temadisplayDfProductLinker. - Selettore CSS del blocco delle combinazioni: usato dalle posizioni prima e dopo. Per impostazione predefinita
.product-variants, .product__variants. Se nulla corrisponde, il selettore resta sotto il pulsante del carrello. - Prezzo sui pulsanti, varianti esaurite, formato immagine dei campioni con foto.
- Mostrare il nome del valore scelto, mantenere la combinazione scelta, precaricare la pagina della variante, transizione morbida tra varianti.
- Aspetto: forma (rotonda o quadrata con angoli arrotondati), dimensione (piccola, media 44 px, grande) e colore di accento del valore scelto.
- Elenchi di prodotti: campioni sotto le miniature, foto della variante al passaggio del mouse o al focus, valori di testo (taglie) quando il gruppo non ha un asse colore, numero massimo di campioni per miniatura.
- Una scheda per gruppo e motori di ricerca: vedere le due sezioni seguenti.
Per un posizionamento su misura, scegliete la posizione hook del tema e aggiungete questa riga nel template prodotto del vostro tema: {hook h='displayDfProductLinker' product=$product}.
Una scheda per gruppo negli elenchi
Questa opzione mostra una sola scheda per gruppo negli elenchi. Viene calcolata alla visualizzazione: nessuna visibilità di prodotto viene modificata, la paginazione e il numero totale di prodotti restano esatti, e un filtro (ad esempio Rosso) mostra la variante corrispondente. Le altre varianti restano raggiungibili tramite i campioni e mantengono la propria scheda.
- Pagine interessate: categorie, marchi e fornitori, novità, più venduti e promozioni, risultati di ricerca. Spuntate quelle che volete.
- Prodotto mostrato sulla scheda: il primo del gruppo presente nell’elenco, il primo disponibile (altrimenti il primo del gruppo) o il primo secondo l’ordinamento dell’elenco (prezzo, nome…).
- Con ps_facetedsearch, DF Faceted Filter o DF Live Search il raggruppamento è esatto su tutte le pagine. Con l’elenco nativo di PrestaShop è esatto sui primi 240 prodotti, poi viene applicato pagina per pagina. La pagina Strumenti indica il motore rilevato.
- Disattivando l’opzione o il modulo si torna subito alla visualizzazione originale, senza nulla da ripristinare.
SEO: dati strutturati e URL canonico
Il modulo aggiunge su ogni scheda del gruppo un blocco JSON-LD ProductGroup con productGroupID (il riferimento del gruppo, altrimenti un identificativo generato), variesBy e hasVariant. La variante mostrata è descritta per intero; le altre sono indicate dal loro URL, perché ognuna ha la propria pagina. Il blocco Product del vostro tema, o di DF All in One SEO, viene collegato al gruppo tramite isVariantOf invece di essere duplicato. Disattivate l’opzione se un altro modulo genera già questo blocco.
Per impostazione predefinita, ogni variante mantiene un URL canonico verso sé stessa: ogni colore può essere indicizzato separatamente. L’opzione Tutte le varianti puntano al prodotto principale del gruppo fa puntare il canonico al primo prodotto attivo del gruppo.
Usate il prodotto principale solo se le schede sono quasi identiche (stesso testo, cambia solo il colore). I motori di ricerca in genere conservano allora solo la pagina principale: le altre varianti possono sparire dai risultati, anche nella ricerca immagini e per un colore preciso. Su queste pagine il modulo rimuove i link hreflang, e le loro voci nella sitemap diventano incoerenti. Il modulo non garantisce alcun posizionamento né alcun risultato arricchito.
Assistente di raggruppamento automatico
Dal pannello dei gruppi, fate clic su Rileva gruppi automaticamente. Nulla viene creato prima dell’ultimo passaggio.
- Prodotti da analizzare: una categoria (con o senza sottocategorie) o tutto il catalogo, con o senza i prodotti inattivi. I prodotti già collegati a un gruppo non vengono mai proposti, e si analizzano al massimo 5.000 prodotti alla volta.
- Regola di rilevamento: stesso nome una volta tolti i valori (Tee Cielo – Rosso e Tee Cielo – Blu), stessa radice del riferimento (TEE-RED e TEE-BLUE: viene tolto l’ultimo segmento dopo – _ . /) o stesso valore di caratteristica (ad esempio Modello = Cielo).
- Assi da rilevare: i valori vengono cercati prima nelle caratteristiche del prodotto, poi nel suo nome.
- Anteprima: ogni gruppo proposto indica perché i prodotti sono stati riuniti e dove è stato trovato ogni valore. Il riepilogo elenca anche i prodotti non proposti (senza valore rilevato, soli nel loro gruppo, stessi valori di un altro prodotto). Togliete la spunta a ciò che volete ignorare, poi create i gruppi.
Importazione ed esportazione CSV
La pagina Importazione CSV riunisce esportazione e importazione. L’esportazione produce una riga per prodotto, nell’ordine delle varianti, in UTF-8 con BOM: il file si apre direttamente in Excel o LibreOffice. Le celle che iniziano con = + – @ sono protette dall’esecuzione di formule. Colonne:
group_id;group_name;group_reference;group_active;axes;product_id;product_reference;product_name;values;swatch ;T-shirt Basic;TSH01;1;Colore|Taglia;;TSH01-NAVY-M;;Colore:Blu navy|Taglia:M;auto
group_idogroup_nametrova un gruppo esistente; un nome nuovo crea un gruppo.- Un prodotto viene trovato tramite
product_id, altrimenti tramiteproduct_reference, che deve essere univoco.product_nameè informativo. valuescontiene coppie Asse:Valore separate da|, con i nomi in qualsiasi lingua del negozio.swatch(facoltativo):auto,text,imageo un colore#rrggbb.- Separatore
;,,o tabulazione; codifica UTF-8 (con o senza BOM), UTF-16 o Windows-1252; massimo 5 MB e 20.000 righe.
L’importazione avviene in due fasi. Scegliete prima come trattare i gruppi esistenti: Aggiungi e aggiorna (gli altri prodotti del gruppo vengono mantenuti) o Sostituisci i loro prodotti con il file. Due opzioni: spostare i prodotti che appartengono a un altro gruppo e creare i valori di attributo mancanti. Simula l’importazione non cambia nulla e mostra il rapporto: gruppi creati o aggiornati, prodotti aggiunti, spostati o rimossi, valori da creare e ogni riga in errore con il motivo. Importa la esegue poi.
I gruppi interessati vengono salvati prima dell’importazione. La cronologia elenca le importazioni con il loro risultato, e l’ultima si può annullare: i gruppi tornano allo stato precedente.
Scheda nella pagina prodotto
Nella pagina prodotto del back-office, la scheda del modulo indica il gruppo del prodotto, ogni variante con il suo stato (online, inattiva, esaurita, assente da questo negozio) e i link per vedere o modificare il gruppo. Se il prodotto non appartiene a nessun gruppo, il modulo cerca prodotti con nome simile e propone di creare un gruppo con essi, oppure a partire da questo solo prodotto.
Strumenti
La pagina Strumenti mostra una diagnostica: motore degli elenchi rilevato, stato dell’opzione una scheda per gruppo, canonico, posizione del selettore e moduli DataFirefly rilevati (DF All in One SEO, DF Hreflang, DF Sitemap, DF Quick View, DF Live Search) con il modo in cui il modulo si adatta a ciascuno. Contiene anche il registro e il pulsante di ripristino delle visibilità modificate dalla versione 1.x, oltre alla riga da copiare per l’hook del tema.
Permessi dei dipendenti
La scheda segue i permessi di PrestaShop. Un dipendente con il solo permesso di lettura può consultare gruppi, impostazioni e strumenti, ma non modificarli: un avviso lo indica, i campi dell’editor sono disattivati e il server rifiuta qualsiasi modifica.
Domande frequenti
Il selettore non compare su una scheda
Verificate che il gruppo sia attivo, che la scheda faccia parte del gruppo, che almeno due prodotti del gruppo siano attivi e che almeno un asse abbia due valori diversi. La colonna Stato del pannello dei gruppi segnala questi casi. Se avete scelto la posizione hook del tema, l’hook displayDfProductLinker deve essere presente nel template prodotto.
Il selettore compare sotto il pulsante del carrello
Con le posizioni prima o dopo il blocco delle combinazioni, il selettore CSS non corrisponde ad alcun elemento del vostro tema. Indicate la classe del blocco delle combinazioni del vostro tema, oppure scegliete la posizione sotto il prezzo.
I campioni non compaiono negli elenchi
L’opzione deve essere attiva e il vostro tema deve chiamare l’hook nativo displayProductListReviews nella miniatura del prodotto, come fa il tema Classic. Senza asse colore, attivate la visualizzazione dei valori di testo.
Posso combinare il modulo con le combinazioni native?
Sì. Un caso comune: un prodotto per colore, ciascuno con combinazioni di taglia. Il selettore del modulo gestisce i colori, il blocco nativo gestisce le taglie, e la taglia scelta viene mantenuta cambiando colore. Evitate di usare lo stesso gruppo di attributi come asse e come combinazione: la colonna Stato lo segnala.
Disattivare il modulo lascia tracce sui miei prodotti?
No. La versione 2.0.0 non modifica alcun prodotto. Alla disattivazione o alla disinstallazione, il modulo svuota anche le cache delle miniature perché i campioni spariscano subito dagli elenchi.