Produkte als Varianten Verknüpfen in PrestaShop: Moduldokumentation (dfproductlinker)

Das Modul DF ProductLinker (dfproductlinker) verknüpft separate Produktseiten, damit sie als ein Artikel mit einer Auswahl nach Farbe, Größe oder einem anderen Attribut erscheinen. Jede Variante bleibt ein vollständiges Produkt mit eigener URL. Es ist der umgekehrte Weg von DF ProductSplitter, das ein Produkt mit Kombinationen in separate Produkte aufteilt.

Installation

1. Laden Sie die ZIP-Datei aus Ihrem DataFirefly-Kundenkonto herunter.
2. Gehen Sie im Backoffice zu Module > Modulmanager > Modul hochladen und laden Sie die ZIP-Datei hoch.
3. Bei der Installation legt das Modul seine Tabellen und den Menüpunkt Katalog > Verknüpfte Varianten an.
4. Öffnen Sie die Modulkonfiguration, um die Position der Auswahl zu prüfen.

Das Modul läuft auf PrestaShop 8.0 bis 9.x mit derselben ZIP-Datei, in Multistore- und mehrsprachigen Installationen. Die Texte werden auf Französisch, Englisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch und Portugiesisch geliefert.

Prinzip: Gruppen und Achsen

Eine Gruppe vereint mehrere Produkte. Eine Achse ist eine native PrestaShop-Attributgruppe, zum Beispiel Farbe oder Größe: Werte, Hex-Farben, Texturen und Übersetzungen aus Katalog > Attribute & Merkmale werden unverändert übernommen. Jedes Produkt der Gruppe erhält einen Wert auf jeder Achse.

Ein Produkt kann nur zu einer Gruppe gehören. Die Produkte selbst werden nicht verändert: Die Gruppe wird in den Tabellen des Moduls gespeichert.

Eine Gruppe anlegen

Gehen Sie zu Katalog > Verknüpfte Varianten und dann Gruppe hinzufügen.

1. Geben Sie den Gruppennamen ein. Er dient intern und als Ersatzname in den strukturierten Daten.
2. Klicken Sie unter Achsen auf Achse hinzufügen. Das Modul schlägt zuerst eine Attributgruppe vom Typ Farbe vor. Wählen Sie für jede Achse die Anzeige (automatisch, Farbfeld, Produktfoto, Text-Button, Dropdown-Liste) und die Eigenschaft der strukturierten Daten (Farbe, Größe, Material, Muster oder nicht angegeben).
3. Suchen Sie unter Produkte der Gruppe nach Name, Referenz oder ID. Mit den Pfeiltasten und Enter wählen Sie ein Ergebnis aus. Produkte, die bereits in einer anderen Gruppe sind, sind ausgegraut.
4. Prüfen Sie für jedes Produkt den Wert jeder Achse. Er wird vorausgefüllt, wenn er im Produktnamen vorkommt. Ein fehlender Wert wird orange hervorgehoben, und die Statuszeile unter der Tabelle zeigt, wie viele Produkte betroffen sind oder ob zwei Produkte dieselben Werte haben.
5. Speichern Sie. Das Modul warnt Sie, wenn Sie die Seite mit ungespeicherten Änderungen verlassen.

Die Reihenfolge der Gruppenzeilen ist die Reihenfolge der Farbfelder im Shop. Der Button Nach Attributreihenfolge sortieren ordnet die Zeilen in der im Katalog festgelegten Reihenfolge, praktisch für Größen S, M, L, XL.

Was der Kunde sieht

Auf jeder Seite der Gruppe zeigt die Auswahl den Namen der Achse und den aktuellen Wert, zum Beispiel Farbe: Rot, danach die verfügbaren Werte. Beim Überfahren zeigt die Beschriftung den angezeigten Wert. Der aktuelle Wert ist umrandet, die anderen verlinken auf die jeweilige Seite.

• Bei mehreren Achsen öffnet ein Klick auf eine Farbe das Produkt mit der aktuellen Größe. Gibt es diese Kombination nicht, öffnet das Modul die nächstliegende Variante, bevorzugt ein vorrätiges Produkt, und das Farbfeld erhält einen gestrichelten Rahmen.
• Eine nicht vorrätige Variante wird abgeblendet und durchgestrichen oder je nach Einstellung ausgeblendet.
• Ein Farbwert ohne Hex-Code und ohne Textur wird als Text in einem länglichen Feld angezeigt.
• Die Auswahl erscheint auch in der Schnellansicht der Kategorieseiten, über dem Warenkorb-Button.

Moduleinstellungen

• Position der Auswahl: vor dem nativen Variantenblock (empfohlen), danach, im Hook displayProductAdditionalInfo oder nur im Theme-Hook displayDfProductLinker.
• CSS-Selektor des nativen Variantenblocks: standardmäßig .product-variants, .product__variants. Passt nichts in Ihrem Theme, bleibt die Auswahl im Hook.
• Achsenbeschriftung, Preis jeder Variante (Bild- und Button-Modus), Bildformat der Vorschaubilder.
• Nicht vorrätige Varianten: abgeblendet oder ausgeblendet.
• Akzentfarbe, Form (rund oder quadratisch mit abgerundeten Ecken) und Größe der Farbfelder. Die mittlere Größe ergibt eine Tippfläche von 44 px, empfohlen auf Mobilgeräten.
• Farbfelder in Produktlisten, maximale Anzahl und Bildwechsel beim Überfahren.
• Ein Produkt pro Gruppe, Sichtbarkeit der übrigen Produkte und angezeigtes Produkt: siehe nächster Abschnitt.
• Kanonische URL der Varianten und strukturierte Daten ProductGroup: siehe Abschnitt SEO.

Für eine eigene Platzierung wählen Sie die Position Theme-Hook und fügen diese Zeile in das Produkt-Template Ihres Themes ein: {hook h='displayDfProductLinker' product=$product}.

Ein Produkt pro Gruppe in Kategorien

Diese Option zeigt in Kategorielisten nur eine Karte pro Gruppe. Die übrigen Produkte der Gruppe erhalten die Sichtbarkeit Nur Suche (oder Nirgendwo, je nach Einstellung): Ihre Seiten bleiben mit ihrer URL online, und die Farbfelder der Karte verlinken auf sie.

• Angezeigtes Produkt: das erste der Gruppe oder das erste vorrätige. Im zweiten Fall wird es bei jeder Bestandsänderung neu berechnet.
• Die ursprüngliche Sichtbarkeit jedes Produkts wird gesichert. Sie wird wiederhergestellt, wenn Sie die Option oder die Gruppe deaktivieren, ein Produkt aus seiner Gruppe entfernen oder das Modul deinstallieren.
• Ändern Sie die Sichtbarkeit eines ausgeblendeten Produkts von Hand, wird Ihr Wert zum neuen Ausgangswert.
• Der Button Sichtbarkeit neu synchronisieren in der Konfiguration wendet die Regel erneut auf alle Gruppen an. Nutzen Sie ihn, wenn Produkte von einem Mitarbeiter ohne Rechte auf das Modul bearbeitet wurden, da PrestaShop die Hooks des Moduls dann nicht ausführt.

SEO: strukturierte Daten und kanonische URL

Das Modul fügt auf jeder Seite der Gruppe einen JSON-LD-Block ProductGroup mit hasVariant und variesBy ein. Jede Variante erscheint mit Name, URL, Referenz, gültiger EAN13, Bild, Wert auf jeder Achse, dem dem Kunden angezeigten Preis und ihrer Verfügbarkeit. Der Gruppenname wird aus dem Produktnamen ohne seine Werte gebildet, in der Sprache des Besuchers. Deaktivieren Sie die Option, wenn ein anderes Modul diesen Block bereits ausgibt.

Standardmäßig behält jede Variante eine selbstreferenzierende kanonische URL: Jede Farbe wird separat indexiert. Sind Ihre Farbseiten nahezu identisch, lässt die Option Kanonisch auf das Hauptprodukt der Gruppe die Canonical aller Varianten auf das Hauptprodukt zeigen. Das ist das in Listen angezeigte Produkt, wenn die Option ein Produkt pro Gruppe aktiv ist, sonst das erste aktive Produkt der Gruppe.

Automatischer Gruppierungsassistent

Klicken Sie in der Gruppenliste auf Assistent für automatische Gruppierung. Er findet Produkte, die derselbe Artikel in mehreren Farben oder Größen sind.

1. Wählen Sie eine Kategorie oder den gesamten Katalog.
2. Kreuzen Sie die zu erkennenden Attributgruppen an, zum Beispiel Farbe und Größe. Die Werte müssen als Attributwerte existieren und im Produktnamen vorkommen.
3. Wählen Sie die Regel: Namen ohne die Werte identisch, oder Referenzen mit demselben Stamm (TSH01-RED und TSH01-BLUE).
4. Klicken Sie auf Vorschau, entfernen Sie die Häkchen bei den Gruppen, die Sie nicht wollen, dann Ausgewählte Gruppen erstellen.

Produkte, die bereits in einer Gruppe sind, werden übersprungen; die Analyse umfasst 5.000 Produkte pro Durchlauf.

CSV-Import und -Export

Der Button CSV-Import / -Export öffnet die zugehörige Seite. Der Export schreibt eine Zeile pro Produkt, im gleichen Format wie der Import. Spalten:

group_id;group_name;group_active;axes;product_id;product_reference;product_name;values
;T-Shirt Basic;1;Farbe|Größe;;TSH01-NAVY-M;;Farbe:Marineblau|Größe:M

• Eine Gruppe wird über group_id erkannt, sonst über ihren exakten Namen. Jede Gruppe in der Datei wird durch ihre Zeilen ersetzt; nicht enthaltene Gruppen bleiben unverändert.
• Ein Produkt wird über product_id gefunden, sonst über product_reference, die im Katalog eindeutig sein muss. product_name dient nur der Information.
• values enthält Paare Achse:Wert, getrennt durch |, mit den Namen der Attributgruppen und Werte in einer beliebigen Sprache des Shops.
• Das Trennzeichen ; oder , wird automatisch erkannt. UTF-8-Datei, maximal 5 MB.

Der Import läuft in zwei Schritten: Datei analysieren zeigt die erstellten oder ersetzten Gruppen, die anzulegenden Attributwerte und jede abgelehnte Zeile mit Grund; Import starten führt ihn dann aus. Zwei Optionen: Produkte verschieben, die bereits zu einer anderen Gruppe gehören und Fehlende Attributwerte anlegen (ihre Farbe bleibt leer und ist im Katalog zu ergänzen).

Produktseite im Backoffice

Im Reiter Module der Produktseite zeigt das Panel DF ProductLinker die Gruppe des Produkts und den Wert jedes Produkts der Gruppe, mit einem Link zum Bearbeiten der Gruppe. Gehört das Produkt zu keiner Gruppe, legt ein Link eine Gruppe aus diesem Produkt an.

Häufige Fragen

Die Auswahl erscheint auf einer Seite nicht

Prüfen Sie, ob die Gruppe aktiv ist, ob die Seite zur Gruppe gehört, ob mindestens zwei Produkte der Gruppe aktiv sind und ob mindestens eine Achse zwei verschiedene Werte hat. Haben Sie die Position Theme-Hook gewählt, muss der Hook displayDfProductLinker im Produkt-Template stehen.

Die Auswahl erscheint unter dem Warenkorb-Button

Der CSS-Selektor des nativen Variantenblocks passt zu keinem Element Ihres Themes. Tragen Sie die Klasse des Variantenblocks Ihres Themes in der Konfiguration ein.

In den Listen erscheinen keine Farbfelder

Die Option muss aktiv sein, und die erste Achse der Gruppe muss als Farbfeld oder Fotovorschau angezeigt werden. Ihr Theme muss den nativen Hook displayProductListReviews in der Produktminiatur aufrufen, wie es das Theme Classic tut.

Kann ich das Modul mit nativen Kombinationen kombinieren?

Ja. Ein häufiger Fall: ein Produkt pro Farbe, jedes mit Größenkombinationen. Die Auswahl des Moduls regelt die Farben, der native Block die Größen.