PS PrestaShop PrestaShop Anfänger

Geschenkverpackung & Nachricht — Vollständige Anleitung

Installieren, konfigurieren und betreiben Sie die kostenpflichtige Geschenkverpackung und die personalisierte Nachrichtenkarte im Checkout für PrestaShop 8 und 9.

Aktualisiert Modulversion 1.0.0

Überblick

Das Modul Geschenkverpackung & Nachricht (dfgiftwrap) fügt im Checkout die Wahl einer kostenpflichtigen Geschenkverpackung und einer personalisierten Nachrichtenkarte hinzu. Der Kunde wählt eine illustrierte Verpackungsoption, kann eine Freitext-Nachricht hinzufügen, und die entsprechende Gebühr fügt sich sauber in die Bestellsumme ein — wobei MwSt., Währung und Multishop vom PrestaShop-Kern verwaltet werden, bis hin zur Rechnung.

Die Gebühr ist keine reine Anzeige: Sie wird von einem dedizierten Gebühren-Produkt und einem auf den Warenkorb des Kunden begrenzten Spezialpreis getragen. Der Betrag erscheint daher natürlich in den Summen, der Bestellung und der Rechnung, mit der korrekten MwSt.

Kompatibilität

  • PrestaShop 8.0 bis 9.x
  • Einzelshop und Multishop
  • PHP 7.4 bis 8.3
  • Classic-Theme und benutzerdefinierte Themes
  • Oberfläche auf Französisch ausgeliefert und vollständig übersetzbar
  • Keine Abhängigkeiten (kein Composer, kein Framework)

Installation

  1. Öffnen Sie im Backoffice Module > Modul-Manager.
  2. Klicken Sie auf Modul hochladen und wählen Sie die Datei dfgiftwrap.zip.
  3. Klicken Sie nach der Installation auf Konfigurieren.

Bei der Installation erstellt das Modul seine Tabellen, registriert seine Hooks (Front-Ressourcen, Checkout-Block, Bestellvalidierung, Bestellseite im Backoffice, Bestätigung) und erzeugt ein verstecktes Gebühren-Produkt (Referenz DF-GIFTWRAP-FEE): virtuell, im Shop nicht sichtbar, Preis nicht angezeigt. Es trägt den Betrag für Verpackung + Karte im Warenkorb. Löschen Sie es nicht manuell.

Konfiguration

Allgemeine Einstellungen

  • Geschenkverpackung aktivieren: zeigt oder verbirgt den Block der Verpackungsoptionen im Checkout.
  • Nachrichtenkarte aktivieren: zeigt oder verbirgt die Option Karte + Nachricht.
  • Kartenpreis: Betrag (ohne Steuer), der berechnet wird, wenn der Kunde eine Nachrichtenkarte hinzufügt.
  • Maximale Nachrichtenlänge: Anzahl der erlaubten Zeichen (standardmäßig 200). Ein Zähler begleitet den Kunden beim Schreiben.
  • Steuerregelgruppe: MwSt.-Gruppe, die auf die Verpackungs- und Kartengebühren angewendet wird.

Verpackungsoptionen verwalten

Klicken Sie auf der Konfigurationsseite auf „Optionen verwalten“, um den dedizierten Bildschirm zu öffnen (Controller AdminDfGiftWrapOptions). Dort erstellen Sie so viele Optionen wie gewünscht, jede mit:

  • Name: mehrsprachige Bezeichnung der Option (z. B. „Elegantes Kraftpapier“, „Premium-Geschenkbox“).
  • Preis: Nettobetrag der Verpackungsoption.
  • Bild: Visual, das die Option illustriert (automatisch in JPG normalisiert).
  • Position: Anzeigereihenfolge, per Drag-and-drop änderbar.
  • Aktiv: zeigt oder verbirgt die Option im Shop, ohne sie zu löschen.

Der Name ist ein mehrsprachiges Feld: Wählen Sie jede Sprache im Selektor des Feldes, um die Bezeichnung der Option zu übersetzen.

Funktionsweise

Im Checkout

Der Verpackungs- und Kartenblock wird oben in der Bestellübersicht über den Hook displayCheckoutSummaryTop eingefügt. Der Kunde wählt eine Verpackungsoption, aktiviert gegebenenfalls die Karte und tippt seine Nachricht. Die Auswahl wird per AJAX gespeichert. Da die Wahl den Betrag ändert, wird die Summe aktualisiert, um die Gebühr widerzuspiegeln; die Nachricht selbst wird ohne unnötiges Neuladen gespeichert.

Gebührenmechanismus

Bei jeder Auswahl berechnet das Modul den Gesamtbetrag (Verpackungsoption + Karte) und erstellt einen Spezialpreis (SpecificPrice), der auf den aktuellen Warenkorb begrenzt ist und auf das versteckte Gebühren-Produkt angewendet wird. Dieses Produkt wird dem Warenkorb hinzugefügt, wenn der Betrag über null liegt, andernfalls entfernt. PrestaShop wendet dann MwSt., Währung und den Multishop-Kontext an, und die Gebühr erscheint als normale Zeile in den Summen, der Bestellung und der Rechnung.

Wo die Nachricht erscheint

Bei der Bestellvalidierung (actionValidateOrder) wird die Auswahl fixiert. Die vom Kunden eingegebene Nachricht ist an drei Stellen sichtbar:

  • auf der Bestellseite im Backoffice (dedizierter Block über displayAdminOrderMain);
  • auf der Bestätigungsseite, die dem Kunden nach dem Kauf angezeigt wird;
  • im nativen Geschenkfeld der Bestellung (gift_message, mit gift = 1), wodurch sie in den Standard-E-Mails von PrestaShop erscheint.

Da die Nachricht auch in das native Geschenkfeld geschrieben wird, zeigen Ihre E-Mail-Vorlagen und Ihre Kommissionierungstools, die dieses Feld bereits nutzen, die Notiz des Kunden ohne zusätzliche Konfiguration an.

FAQ und Fehlerbehebung

Ist das eine Geschenkkarte oder ein Gutschein?

Nein. Das Modul bietet einen Geschenkverpackungs-Service und eine Nachrichtenkarte zum Verschenken, kein Zahlungsmittel und keinen Gutschein. Der Kunde bezahlt eine Verpackung und kann eine Widmung hinzufügen.

Die Gebühr erscheint nicht in der Summe

Prüfen Sie, ob das versteckte Gebühren-Produkt (DF-GIFTWRAP-FEE) noch existiert und ob mindestens eine Verpackungsoption aktiv ist. Leeren Sie den PrestaShop-Cache und laden Sie die Bestellseite neu. Die Gebühr wird nur angewendet, wenn der berechnete Betrag über null liegt.

Die Startseite oder der Shop wird nach der Installation weiß

Stellen Sie sicher, dass Sie die neueste Version des Moduls verwenden, und leeren Sie den Cache. Das Gebühren-Produkt ist bewusst im Shop nicht sichtbar; machen Sie es nicht sichtbar und löschen Sie es nicht manuell.

Die Nachricht wird abgeschnitten

Die Nachricht ist durch die Einstellung Maximale Nachrichtenlänge begrenzt. Erhöhen Sie diesen Wert in der Konfiguration, wenn Ihre Kunden längere Texte benötigen.

Wie füge ich Englisch, Spanisch, Deutsch oder Italienisch hinzu?

Die Oberfläche wird auf Französisch ausgeliefert und ist vollständig übersetzbar. Gehen Sie zu Erweiterte Parameter > Übersetzungen > Übersetzungen der installierten Module, wählen Sie dfgiftwrap und die Sprache und übersetzen Sie die Zeichenketten. Die Namen der Verpackungsoptionen werden direkt in ihrem mehrsprachigen Feld übersetzt.

Ist es mit PrestaShop 9 kompatibel?

Ja. Das Modul ist von PrestaShop 8.0 bis 9.x konzipiert und getestet, mit einem Legacy-Admin-Controller, im Einzelshop wie im Multishop.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren