Lieferformular für Schwere Artikel — Installations- und Konfigurationsanleitung
Das Lieferformular-Modul für schwere Artikel installieren und konfigurieren: Auslösung, Feld-Builder, bedingte Felder, Benachrichtigung und Bestellverfolgung.
Das Modul Lieferformular für schwere & sperrige Artikel zeigt im Versandschritt des Checkouts einen Fragebogen zu den Zugangsbedingungen (Etage, Aufzug, Treppen, enge Durchgänge, Hindernisse) für schwere oder sperrige Produkte an: Möbel, Haushaltsgeräte, große Fernseher, Gewerbe- oder Praxismobiliar. Die Felder sind vollständig im Backoffice konfigurierbar, ohne eine einzige Zeile Code zu schreiben.
Dieses Modul ist für PrestaShop 8.0 bis 9.x entwickelt, funktioniert im Multistore und ist vollständig mehrsprachig. Es nutzt keine externe Abhängigkeit: Vanilla JavaScript, kein jQuery, kein Composer.
Installation
- Öffnen Sie im Backoffice Module > Modulmanager und klicken Sie auf Modul hochladen.
- Wählen Sie die Datei
dfdeliveryform.zipund starten Sie die Installation. - Klicken Sie nach Abschluss der Installation auf Konfigurieren, um die Einstellungen zu öffnen.
Bei der Installation erstellt das Modul automatisch seine Tabellen, registriert seine Hooks und installiert einen Satz von 17 sofort einsatzbereiten Feldern vor (Anwesenheitszeiten, LKW-Zufahrt, Parkdistanz, Etage, Aufzug, Treppen, enge Durchgänge, Hindernisse, Richtigkeitsbestätigung). Behalten Sie sie, passen Sie sie an oder beginnen Sie neu.
Allgemeine Einstellungen
Die Konfigurationsseite hat zwei Bereiche: die Einstellungen (oben) und den Feld-Builder (unten).
- Modul aktivieren — zeigt oder verbirgt das Formular im Shop.
- Checkout sperren, bis ausgefüllt — wenn aktiviert, kann der Kunde den Lieferschritt nicht bestätigen, bevor er das Formular abgeschickt hat. Wenn deaktiviert, bleibt das Formular optional.
- Auslösemodus — legt fest, wann das Formular angezeigt wird (siehe nächster Abschnitt).
- Benachrichtigungs-E-Mail — Adresse, die das ausgefüllte Formular bei der Bestellvalidierung erhält. Leer lassen, um die Shop-E-Mail zu verwenden.
- Formulartitel und Einleitungstext — pro Sprache anpassbar.
Auslösemodi
Das Formular soll nur bei den betroffenen Bestellungen erscheinen. Vier Modi stehen zur Verfügung:
- Jede Bestellung — das Formular wird immer angezeigt.
- Produktgewichtsschwelle — das Formular erscheint, sobald ein Warenkorbprodukt das definierte Gewicht erreicht (standardmäßig 30 kg). Ideal für Haushaltsgeräte und Möbel. Verwendet wird das in der Produktdatei angegebene Einzelgewicht.
- Bestimmte Produkte — geben Sie eine kommagetrennte Liste von Produkt-IDs ein (z. B.
12,45,102). - Bestimmte Kategorien — geben Sie eine kommagetrennte Liste von Kategorie-IDs ein. Jedes Produkt, das zu einer dieser Kategorien gehört, löst das Formular aus.
Das Formular zeigt dem Kunden, welche Warenkorbprodukte betroffen sind, damit er versteht, warum diese Fragen gestellt werden.
Feld-Builder
Der Builder unterhalb der Einstellungen listet alle Formularfelder auf. Für jedes Feld können Sie es neu anordnen (Pfeile hoch/runter), aktivieren/deaktivieren, bearbeiten oder löschen.
Ein Feld hinzufügen oder bearbeiten
Klicken Sie auf Feld hinzufügen oder auf das Stift-Symbol eines vorhandenen Feldes. Der Editor bietet:
- Typ — 7 verfügbare Typen: Abschnittstitel, Text, Zahl, Langtext, Schalter, Ja/Nein, Auswahlliste.
- Beschriftung und Hilfetext — pro Sprache eingegeben. Die Beschriftung in der Standardsprache ist Pflicht; leer gelassene Sprachen übernehmen diese Beschriftung.
- Optionen (nur Typ Auswahlliste) — eine Option pro Zeile, unabhängig für jede Sprache.
- Nur anzeigen, wenn — Anzeigebedingung (siehe unten).
- Pflichtfeld und Aktiv.
Der technische Code eines Feldes wird bei der Erstellung automatisch aus der Beschriftung generiert und bleibt danach stabil, auch wenn Sie die Beschriftung umbenennen.
Feldtypen
- Abschnittstitel — visueller Trenner, ohne Eingabe.
- Text — einzeiliges Eingabefeld.
- Zahl — numerische Eingabe (Distanz, Breite, Stufenanzahl…).
- Langtext — mehrzeiliges Textfeld für Beschreibungen.
- Schalter — stilisierter Ein/Aus-Umschalter, ideal für eine Bestätigung.
- Ja / Nein — zwei exklusive Pills, oft als übergeordnetes Feld eines bedingten Feldes verwendet.
- Auswahlliste — Auswahl aus pro Sprache definierten Optionen.
Bedingte Felder
Ein Feld kann nur abhängig von der Antwort auf ein übergeordnetes Feld vom Typ Ja/Nein oder Schalter angezeigt werden.
- Öffnen Sie im Editor des untergeordneten Feldes die Liste Nur anzeigen, wenn und wählen Sie das übergeordnete Feld.
- Wählen Sie den erwarteten Wert: = Ja / angekreuzt oder = Nein / nicht angekreuzt.
Beispiel: Das Feld „Breite der Aufzugstür“ erscheint nur, wenn die Frage „Aufzug / Lastenaufzug“ aktiviert ist; das Feld „Stufenanzahl“ erscheint nur, wenn „Treppen“ aktiviert ist. Ein durch seine Bedingung ausgeblendetes Feld ist nie erforderlich, auch wenn es als Pflichtfeld markiert ist.
Kundenseite
Im Versandschritt sieht der Kunde eine Karte mit dem Formularstatus (Auszufüllen / Ausgefüllt) und eine Schaltfläche zum Öffnen. Das Formular öffnet sich in einem modernen Modal: Auswahlkarten, Schalter, Ja/Nein-Pills, Live-Validierung der Pflichtfelder.
- Antworten werden pro Warenkorb gespeichert: ein zurückkehrender Kunde findet seine Antworten vorausgefüllt.
- Im Sperrmodus öffnet die Bestätigungsschaltfläche des Lieferschritts das Formular automatisch erneut, bis es ausgefüllt ist.
Antworten verfolgen
Die Kundenantworten sind an drei Stellen nutzbar:
- Benachrichtigungs-E-Mail — bei der Bestellvalidierung wird eine HTML-E-Mail mit der Zusammenfassung aller Antworten an die konfigurierte Adresse gesendet (Logistikteam, Spediteur oder Lager). FR- und EN-Vorlagen sind enthalten.
- Bestellseite — ein eigenes Panel zeigt die Frage/Antwort-Übersicht in der Bestellung im Backoffice.
- Datenbank — die Antworten werden gespeichert, mit dem Warenkorb und dann mit der validierten Bestellung verknüpft.
Deinstallation
Die Deinstallation über den Modulmanager entfernt sauber die Modultabellen (Felder, Antworten) und seine Konfiguration.
Häufige Fragen
Das Formular wird nicht angezeigt
Prüfen Sie, ob das Modul aktiviert ist, ob der Auslösemodus zum Testwarenkorb passt (z. B. dass ein Produkt die Gewichtsschwelle tatsächlich erreicht) und ob mindestens ein Feld aktiv ist.
Kann ich die Bezeichnungen übersetzen?
Ja. Jede Beschriftung, jeder Hilfetext und jede Listenoption wird pro Sprache direkt im Feld-Builder eingegeben. Formulartitel und Einleitung sind ebenfalls mehrsprachig.
Ist das Modul mit PrestaShop 9 und Multistore kompatibel?
Ja, das Modul ist für PrestaShop 8.0 bis 9.x entwickelt und funktioniert im Multistore-Kontext.