Produkt-Bundles & Sets: Dokumentation

Installation

Das Modul wird wie jedes PrestaShop-Modul installiert, über das Back Office oder per FTP.

1. Klicken Sie unter Module und Modul-Manager auf Modul hochladen und legen Sie die Datei dfpackpro.zip ab.
2. Per FTP entpacken Sie das Archiv in den Ordner /modules/ Ihres Shops und installieren DataFirefly – Packs & Bundles aus dem Modul-Manager.
3. Leeren Sie den Cache unter Erweiterte Einstellungen und Leistung.

Die Installation legt sechs Tabellen mit dem Präfix ps_dfpackpro an, registriert die nötigen Hooks und fügt den Tab Packs & Bundles (DF) im Katalog-Menü hinzu.

Allgemeine Einstellungen

Der Button Konfigurieren auf der Modulseite öffnet die Einstellungen, die für alle Pakete gelten.

• Position des Blocks auf der Produktseite: unter dem Kaufblock, am Seitenende oder beides. Der Block listet die Pakete, die das angesehene Produkt enthalten.
• Paketblock aktiv: schaltet die Cross-Sell-Anzeige ab, ohne zu deinstallieren. Die Paketseiten bleiben erreichbar.
• Maximale Anzahl angezeigter Pakete: standardmäßig 3.
• Sortierung der Pakete: Position, Erstellungsdatum oder zufällig.
• Einzelpreise anzeigen: weist den Preis jeder Komponente auf der Paketseite aus.
• Ersparnis anzeigen: Badge und gesparter Betrag, im Produktseitenblock und auf der Paketseite.
• Verfügbarkeit anzeigen: Bestandsstatus des Pakets, aus den Beständen der Komponenten berechnet.
• Strikter Warenkorbmodus: entfernt der Kunde eine Komponente, werden das ganze Paket und sein Rabatt entfernt. Deaktiviert wird das Entfernen akzeptiert und der Rabatt auf dem Rest behalten.
• Nach dem Hinzufügen zum Warenkorb: Weiterleitung zum Warenkorb oder Bestätigung an Ort und Stelle.
• Akzentfarbe: Farbe der Badges, Buttons und Rahmen der Modulblöcke.

Ein Paket anlegen

Öffnen Sie Katalog und Packs & Bundles (DF) und klicken Sie auf Neues Paket.

Paketinformationen

• Name: übersetztes Feld, angezeigt im Produktseitenblock, auf der Paketseite und im Warenkorb-Badge.
• URL-Alias: wird automatisch aus dem Namen erzeugt, wenn Sie das Feld leer lassen. Er bildet die Adresse der Paketseite.
• Beschreibung: übersetzter Rich-Text, angezeigt auf der Paketseite.
• Badge: kurzer übersetzter Text auf den Cross-Sell-Karten. Leer lassen, um den Ersparnisprozentsatz anzuzeigen.
• Preismodus: die vier unten beschriebenen Modi. Das Formular blendet je nach Modus die unnötigen Felder aus.
• Bestehende Aktionen vererben: aktiviert dienen laufende Katalograbatte als Ausgangspreis der Paketberechnung.
• Gültigkeitsdaten: leer lassen für ein dauerhaftes Paket. Außerhalb des Zeitraums verschwindet das Paket aus dem Front Office.
• Aktiv: entspricht dem Aktivierungsschalter in der Liste.

Komponenten

Das Komponenten-Panel verwaltet den Paketinhalt.

• Produktsuche: mindestens zwei Zeichen eingeben. Die Suche umfasst Name, Referenz und ID. Ein Klick auf ein Ergebnis fügt es hinzu.
• Variante: bei einem Produkt mit Varianten listet der Selektor die Varianten mit ihrem Preis. Die gewählte Variante wird zur Standardvariante.
• Variantenwahl durch den Kunden: aktiviert wählt der Kunde seine Variante auf der Paketseite und im Produktseitenblock. Deaktiviert ist die Variante vorgegeben.
• Menge: Anzahl Einheiten der Komponente im Paket. Ein Paket kann ein einziges Produkt in Menge enthalten, für einen Mehrfachverkauf.
• Editierbare Menge: der Kunde kann die Menge dieser Komponente auf der Paketseite anpassen.
• Optional: der Kunde kann diese Komponente abwählen, der Preis wird neu berechnet.
• Rabatt pro Produkt: Prozentsatz oder Betrag, nur im Modus Rabatt pro Produkt sichtbar. Ein Rabatt von 100 % macht die Komponente gratis.
• Reihenfolge: Pfeile nach oben und unten zum Ordnen der Anzeige.

Der Preissimulator unter der Tabelle berechnet Gesamtpreis, Paketpreis und Ersparnis bei jeder Änderung live neu.

Die vier Preismodi

Ohne Rabatt

Das Paket verkauft die Komponenten zum aktuellen Preis. Nützlich für ein reines Komfortpaket oder um nur die Zusammenstellung hervorzuheben.

Globaler Prozentrabatt

Der Prozentsatz gilt für den Preis jeder Komponente. Ein Paket mit -15 % rabattiert jede Zeile um 15 %.

Rabatt pro Produkt

Jede Komponente trägt ihren eigenen Rabatt, als Prozentsatz oder Betrag. Das ist der Modus für Angebote wie Maschine plus Gratiszubehör: die Maschine bei 0 %, das Zubehör bei 100 %.

Festpreis

Sie kommunizieren den Paketpreis, brutto in der Standardwährung. Die Differenz zwischen der Summe der aktuellen Preise und dem angekündigten Preis wird proportional auf jede Zeile verteilt, netto. Jedes Produkt behält seinen Steuersatz.

Beispiel: ein Paket zu 49 € aus Produkt A zu 40 € und Produkt B zu 30 €. Die aktuelle Summe beträgt 70 €, der Rabatt 21 €. A trägt 12 € Rabatt, B 9 €, im Verhältnis zu ihrem Gewicht am Gesamtbetrag. Die Rechnung bleibt exakt, auch wenn A 19 % und B 7 % Steuer trägt.

Der Block auf den Produktseiten

Jedes Produkt, das zu einem Paket gehört, zeigt einen Block „dieses Produkt ist auch im Paket erhältlich“. Jede Karte zeigt die Miniaturen der Komponenten, den Paketnamen, die durchgestrichene Summe, den Paketpreis, das Ersparnis-Badge und den Bestandsstatus.

• Paket ansehen öffnet die Paketseite.
• Hinzufügen legt das Paket in seiner Standardkonfiguration direkt in den Warenkorb. Der Button wird zu Konfigurieren, wenn das Paket Auswahlmöglichkeiten enthält: freie Variante, optionale Komponente oder editierbare Menge.

Position des Blocks, Kartenanzahl und Sortierung werden in der Modulkonfiguration eingestellt.

Die Paketseite

Jedes Paket hat seine Seite unter /pack/12-mein-alias, mit der Paket-ID und dem Alias der aktuellen Sprache. Die Seite listet die Komponenten mit ihren Variantenselektoren, den Checkboxen der optionalen Produkte und den Mengenfeldern, sofern freigegeben.

Jede Änderung berechnet Gesamtpreis, Paketpreis, Ersparnis und Verfügbarkeit per Ajax neu, ohne Neuladen der Seite. Der Hinzufügen-Button sendet die aktuelle Auswahl an den Warenkorb.

Die Verfügbarkeit wird aus realen Beständen berechnet: das Paket ist verkäuflich, wenn jede erforderliche Komponente in der angefragten Menge verfügbar ist, unter Berücksichtigung der Nachbestellerlaubnis jedes Produkts.

Der Warenkorb

Beim Hinzufügen eines Pakets wird jede Komponente zu einer echten Warenkorbzeile, fakturiert zum Paketpreis über einen auf diesen Warenkorb begrenzten Spezialpreis. Es entsteht kein Phantomprodukt.

Paket-Badge

Jede zu einem Paket gehörende Zeile zeigt ein Badge mit dem Paketnamen, einem Link zur Paketseite und einem Button Ganzes Paket entfernen. Das Entfernen löscht alle Paketzeilen und ihre Rabatte in einer Aktion.

Zusätzliche Mengen

Der Paketpreis deckt nur die Paketmengen ab. Erhöht der Kunde die Menge einer Zeile, wendet das Modul einen gewichteten Durchschnittspreis an: Paketmenge zum Paketpreis, Mehrmenge zum Normalpreis.

Beispiel: Paket mit 2 Einheiten zu 8 € bei einem Normalpreis von 10 €. Der Kunde erhöht die Zeile auf 5 Einheiten. Der Einheitspreis wird (2 x 8 + 3 x 10) / 5 = 9,20 €, ein Gesamtbetrag von 46 €. Der Rabatt bleibt auf die 2 Paketeinheiten begrenzt.

Strikter Modus

Aktiviert entfernt das Löschen einer Komponente das ganze Paket samt Rabatt. Das verhindert, den Rabatt zu behalten und einen Teil des Sets zurückzugeben. Deaktiviert wird das Entfernen akzeptiert und der Rabatt auf den verbleibenden Zeilen behalten.

Bestellungen und Buchhaltung

Jedes Paketprodukt landet auf seiner eigenen Bestellzeile, zum Paketpreis. Rechnungen, Lieferscheine, Gutschriften und Teilretouren funktionieren nativ, Artikel für Artikel. Ihre Buchhaltungs- und ERP-Exporte sehen nur echte Referenzen aus Ihrem Katalog.

Das Bestelldetail im Back Office zeigt eine Übersicht der bestellten Pakete. Die Paketliste zeigt einen Verkaufszähler pro Paket.

Multistore und mehrsprachig

Jedes Paket wird den Shops seines Erstellungskontexts zugeordnet und kann Shop für Shop verwaltet werden. Die Felder Name, URL-Alias, Beschreibung und Badge werden in den installierten Sprachen übersetzt. Das Front Office folgt der Kundensprache, auch im Alias der Paketseite.

Anzeige an Ihr Theme anpassen

Drei Templates sind überschreibbar. Kopieren Sie sie von /modules/dfpackpro/views/templates/ nach /themes/ihr-theme/modules/dfpackpro/views/templates/ unter Beibehaltung der Unterordner.

• hook/product_packs.tpl: der Cross-Sell-Block der Produktseiten
• front/pack.tpl: die Paketseite
• hook/cart_line_badge.tpl: das Paket-Badge im Warenkorb

Das CSS ist unter dem Präfix dfpackpro isoliert und die Akzentfarbe liegt in der CSS-Variablen --dfpackpro-accent. Für punktuelle Anpassungen zielen Sie auf die Klassen aus dem Stylesheet Ihres Themes, statt views/css/front.css zu bearbeiten, das beim Update überschrieben würde.

Fehlerbehebung

Der Block erscheint nicht auf der Produktseite

1. Prüfen Sie, ob das Paket aktiv ist und das heutige Datum im Gültigkeitszeitraum liegt.
2. Prüfen Sie, ob das angesehene Produkt tatsächlich zu den Paketkomponenten gehört.
3. Kontrollieren Sie die Einstellung Paketblock aktiv und die gewählte Position in der Konfiguration.
4. Leeren Sie den Smarty-Cache und den Cache Ihres Servers.

Das Paket wird als nicht verfügbar angezeigt

Die Verfügbarkeit ist das Minimum der Bestände der erforderlichen Komponenten geteilt durch ihre Menge im Paket. Eine einzige ausverkaufte Komponente ohne Nachbestellerlaubnis reicht, um das Paket nicht verfügbar zu machen. Abgewählte optionale Komponenten zählen nicht.

Das Warenkorb-Badge erscheint an der falschen Stelle

Das Theme rendert das Badge in der Aktionsspalte, danach verschiebt es JavaScript in den Produktinformationsblock. Bei einem stark angepassten Theme ohne die Standardcontainer bleibt das Badge an seiner Ursprungsposition. Überschreiben Sie cart_line_badge.tpl, um es in Ihre Struktur einzupassen.

Der Paketpreis gilt für zu viele Einheiten

Dieser Fall wird durch den gewichteten Durchschnittspreis abgedeckt: prüfen Sie den auf der Zeile angezeigten Einheitspreis, er muss zwischen Paketpreis und Normalpreis liegen, sobald die Menge die Paketmenge übersteigt. Falls nicht, leeren Sie den Cache und ändern Sie die Menge, um eine Neuberechnung auszulösen.

Die Paketseite liefert einen 404

Prüfen Sie, ob das Paket aktiv und im Gültigkeitszeitraum ist. Nach einer Alias-Änderung leitet die alte Adresse per 301 auf die neue weiter, solange die Paket-ID korrekt ist.

Deinstallation

Die Deinstallation entfernt die sechs Tabellen des Moduls, seine Konfigurationsschlüssel und den Tab im Katalog-Menü. Vergangene Bestellungen behalten ihre Zeilen und Preise, Ihre Buchhaltungshistorie wird nicht verändert.