DataFirefly Pack Variants: Dokumentation

Was das Modul leistet

In PrestaShop verlangt ein natives Pack, für jedes seiner Produkte eine konkrete Kombination festzulegen, im Tab Pack des Back Office. Dieses Paar aus Produkt und Kombination steht in der Datenbank, und der Kunde kann es nicht ändern. Ein Pack mit einem T-Shirt in vier Größen zu verkaufen bedeutet daher, vier Packs anzulegen.

DataFirefly Pack Variants ergänzt die Pack-Produktseite um eine Auswahl. Für jeden Artikel, den Sie konfigurierbar machen, wählt der Kunde seine Kombination. Die Auswahl wird serverseitig geprüft, mit der Warenkorbzeile gespeichert, bis zur Rechnung mitgeführt, und abgebucht wird der Bestand der tatsächlich gewählten Kombination.

Installation

1. Öffnen Sie im Back Office Module > Modul-Manager, klicken Sie auf Modul hochladen und senden Sie die ZIP-Datei.
2. Das Modul legt seine Tabellen an und fügt unter Katalog einen Tab Pack-Kombinationen hinzu.
3. Öffnen Sie die Modulkonfiguration, um Titel und Position des Blocks sowie das Verhalten der nativen Liste einzustellen.

Das Modul installiert sich auf PrestaShop 8.0 bis 8.x. Es benötigt keine Composer-Abhängigkeit und keine Überschreibung von Theme-Templates.

Ein Pack konfigurieren

Gehen Sie zu Katalog > Pack-Kombinationen. Das Suchfeld oben listet nur als Pack markierte Produkte: Name, Referenz oder ID eingeben und das Pack auswählen. Bereits konfigurierte Packs erscheinen direkt darunter.

Der Bearbeitungsbildschirm zeigt jeden Artikel des Packs mit Menge, hinterlegter Kombination und Vorschaubild. Produkte ohne Kombinationen werden gekennzeichnet und bieten keine Einstellung.

Die drei Modi

• Feste Kombination: natives Verhalten, keine Auswahl auf Kundenseite. Das ist der Standard.
• Kunde wählt eine beliebige Kombination: alle Kombinationen des Produkts werden angeboten.
• Kunde wählt aus den ausgewählten Kombinationen: Sie haken die erlaubten Kombinationen in der Liste an. Mindestens zwei sind nötig, sonst wird das Speichern abgelehnt.

Die Auswahl auf eine Attributgruppe beschränken

Ein Produkt mit Größe und Farbe erzeugt schnell Dutzende Kombinationen. Die Beschränkung auf eine Attributgruppe löst den häufigsten Fall: Sie wählen Größe, und die übrigen Attribute bleiben auf den Werten der im Back Office hinterlegten Kombination. Der Kunde sieht nur eine Größenliste, die Farbe bleibt die von Ihnen für das Pack gesetzte.

Massenimport

Wenn Ihr Katalog schon Dutzende Packs enthält, wendet der Bereich Massenimport auf der Startseite des Moduls dieselbe Regel auf alle an. Sie wählen:

• Zu verarbeitende Packs: nur die noch nicht konfigurierten, oder alle Packs unter Überschreiben bestehender Einstellungen.
• Nur aktive Packs: um deaktivierte Packs zu überspringen.
• Anzuwendende Konfiguration: freie Wahl auf allen Artikeln, oder Zurücksetzen auf die nativen festen Kombinationen.
• Beschränkung auf eine Attributgruppe: zum Beispiel Größe, überall dort angewendet, wo diese Gruppe existiert.
• Artikel ohne diese Gruppe: fest belassen oder alle ihre Kombinationen anbieten.

Die Schaltfläche Vorschau zählt die betroffenen Packs und simuliert den ersten Stapel, ohne etwas zu schreiben. Import starten verarbeitet den Katalog anschließend in Stapeln von 25, mit Fortschrittsbalken. Die Seitenverwaltung läuft über einen Cursor auf der Produkt-ID, was Verschiebungen während des Schreibens und Timeouts bei großen Katalogen vermeidet.

Allgemeine Einstellungen

In der Modulkonfiguration:

• Titel des Blocks: die Überschrift über den Auswahlfeldern, je Sprache übersetzbar.
• Position des Blocks: unter den Produktinformationen über den nativen Hook, oder direkt über dem Button In den Warenkorb per JavaScript-Verschiebung.
• Native Pack-Liste ausblenden: standardmäßig aktiv. Das Modul stellt den gesamten Pack-Inhalt selbst dar, und eine sichtbare native Liste würde die hinterlegten Kombinationen zeigen und damit der Kundenauswahl widersprechen.
• CSS-Selektor der nativen Liste: .product-pack für Classic und Hummingbird. Nur ändern, wenn Ihr Theme den Pack-Inhalt an anderer Stelle ausgibt.
• Produktpreise anzeigen: der Einzelpreis jedes Produkts im Pack.
• Nicht vorrätige Kombinationen ausblenden: wenn deaktiviert, bleiben sie wählbar, sofern das Produkt Bestellungen bei Nichtverfügbarkeit erlaubt.
• Natives Personalisierungsfeld ausblenden: aktiv lassen, siehe folgender Abschnitt.

Was der Kunde sieht

Auf der Pack-Produktseite zeigt das Modul eine Karte mit dem gesamten Inhalt: ein Auswahlfeld für jeden konfigurierbaren Artikel, die hinterlegte Kombination im Klartext für die übrigen. Jede Zeile trägt Vorschaubild, Menge und, wenn die Option aktiv ist, den Einzelpreis.

Bestätigt der Kunde ohne vollständige Auswahl, erscheint unter dem Block eine Fehlermeldung und das Hinzufügen zum Warenkorb wird blockiert. Nicht vorrätige Kombinationen werden je nach Einstellung deaktiviert oder ausgeblendet.

Warenkorb, Bestellung und Rechnung

Die Auswahl wird im nativen Personalisierungsmechanismus von PrestaShop gespeichert. Genau das hält zwei identische Packs mit unterschiedlicher Zusammenstellung auf zwei getrennten Warenkorbzeilen, während der Core Zeilen mit demselben Produkt normalerweise zusammenführt. Legt ein Kunde exakt dieselbe Zusammenstellung zweimal hinzu, steigt einfach die Menge der bestehenden Zeile auf zwei.

Die Zusammenfassung der Auswahl erscheint automatisch im Warenkorb, in der Bestellbestätigung, in den E-Mails, in der Kundenhistorie, in der Bestelldetailansicht des Back Office und auf der PDF-Rechnung.

Bestand

Ein natives Pack bucht den Bestand der in der Pack-Tabelle hinterlegten Kombination ab, nicht den der vom Kunden gewählten. Bei Bestellbestätigung korrigiert das Modul: die hinterlegte Kombination wird zurückgebucht, die gewählte abgezogen, Shop für Shop.

Diese Korrektur gilt nur für Packs, deren Bestandsverwaltung die enthaltenen Produkte abbucht. Ein Pack, das nur seinen eigenen Bestand abbucht, ist nicht betroffen, und der Bearbeitungsbildschirm weist Sie darauf hin.

Fehlerbehebung

Der Block erscheint nicht auf der Produktseite

Der Block erscheint nur, wenn das Pack mindestens einen wirklich konfigurierbaren Artikel enthält: ein Modus außer fest, ein Produkt mit Kombinationen und mindestens zwei verbleibende Kandidaten nach Positivliste, Attributgruppe und Bestandsfilter. Prüfen Sie außerdem, ob der Hook displayProductAdditionalInfo in Ihrem Theme registriert ist.

Die native Pack-Liste bleibt sichtbar

Ihr Theme verwendet nicht .product-pack. Untersuchen Sie die Seite, notieren Sie Klasse oder ID des Containers und tragen Sie sie in der Einstellung für den CSS-Selektor ein.

Ein leeres Textfeld erscheint auf der Seite

Das ist das Personalisierungsfeld des Moduls, das manche Themes ausgeben. Aktivieren Sie die Einstellung zum Ausblenden.

Die Auswahl erscheint nicht im Warenkorb

Leeren Sie den PrestaShop-Cache und prüfen Sie, ob ein Drittmodul das Formular für den Warenkorb ersetzt. Das Modul fängt den Klick auf den Button in der Capture-Phase ab, um vor dem Theme-Skript zu laufen, aber ein komplett von einem anderen Modul neu aufgebautes Formular kann diesen Ansatzpunkt umgehen.

Bekannte Grenzen

• Der Preisaufschlag der Kombinationen wird ignoriert. Ein natives Pack wird zu einem einzigen Preis verkauft, den eine Personalisierung nicht ändern kann. Der Bearbeitungsbildschirm kennzeichnet die betroffenen Artikel, damit Sie diese Kombinationen aus der Positivliste ausschließen können.
• Die Rechnung bleibt eine einzige Zeile zum Steuersatz des Packs, mit den Details der Auswahl in der Personalisierungszusammenfassung. Muss jede Komponente getrennt mit eigenem Satz abgerechnet werden, sehen Sie sich DataFirefly Pack Pro oder Pack VAT Pro an.
• Diese Version richtet sich an PrestaShop 8.0 bis 8.x. Da sich der Bildschirm zur Pack-Verwaltung in PrestaShop 9 technisch verändert hat, folgt die Portierung als eigene Version.

Kompatibilität

• PrestaShop 8.0.0 bis 8.x
• Multistore: die Einstellungen werden pro Shop gespeichert
• Mehrsprachig: Moduloberfläche in Deutsch, Englisch, Französisch, Spanisch, Italienisch, Niederländisch, Polnisch und Portugiesisch
• Getestet mit dem Classic-Theme