Trinkgeld / Tip im Checkout — Vollständige Anleitung
Das optionale Trinkgeld (Prozentsatz, Festbetrag oder freier Betrag) im Warenkorb und Checkout für PrestaShop 8 und 9 installieren, konfigurieren und nutzen.
Überblick
Das Modul Trinkgeld / Tip im Checkout (dftip) fügt auf der Warenkorbseite Ihres Shops einen Block «Trinkgeld hinzufügen» hinzu, mit dem der Kunde ein optionales Trinkgeld geben kann: einen Prozentsatz, einen Festbetrag oder einen freien Betrag. Das Trinkgeld wird anschließend nativ in die Bestellung integriert, ohne Core-Override von PrestaShop. Ideal für Handwerker, Kreative und Gastronomie.
Das Trinkgeld wird von einer eigenen Bestellposition getragen, deren Preis für den aktuellen Warenkorb über einen warenkorbgebundenen specific_price festgelegt wird. Es fließt daher sauber in Zahlbetrag, MwSt., Rechnung und etwaige Gutschriften ein — genau der Mechanismus, den PrestaShop für benutzerdefinierte Preise beim Bearbeiten einer Bestellung verwendet.
Kompatibilität
- PrestaShop 8.0 bis 9.x
- PHP 7.4 bis 8.3
- Einzelshop und Multishop
- 5 Sprachen: FR, EN, ES, DE, IT
- Classic-Theme und eigene Themes
- Keine Abhängigkeit (kein Composer, kein Framework)
Installation
- Öffnen Sie im Back Office Module > Modul-Manager.
- Klicken Sie auf Modul hochladen und wählen Sie die Datei
dftip.zip. - Klicken Sie nach der Installation auf Konfigurieren.
Bei der Installation registriert das Modul seine Hooks, erstellt ein verborgenes virtuelles Produkt «Trinkgeld» (außerhalb von Katalog und Suche, ohne Versand), das den Trinkgeldbetrag trägt, und wendet seine Standardeinstellungen an: prozentuales Trinkgeld 5, 10, 15 %, freier Betrag erlaubt, ohne MwSt.
Konfiguration
Alle Einstellungen befinden sich auf der Konfigurationsseite des Moduls.
- Modul aktivieren: zeigt oder verbirgt den Trinkgeld-Block.
- Titel und Untertitel: Texte des Blocks, anpassbar und in jeder Sprache übersetzbar.
- Trinkgeld-Typ: Prozentsatz, Festbetrag oder Beides.
- Angebotene Prozentsätze: durch Kommas getrennte Liste, zum Beispiel
5,10,15. - Angebotene Festbeträge: durch Kommas getrennte Liste in der Standardwährung, zum Beispiel
1,2,5. - Berechnungsbasis des Prozentsatzes: Produktsumme inkl. MwSt. oder exkl. MwSt.
- Freien Betrag zulassen: fügt ein Eingabefeld hinzu.
- Freier Betrag Minimum / Maximum: Grenzen für den freien Betrag.
- Auf das Trinkgeld angewandte Steuer: Keine Steuer standardmäßig; Sie können bei Bedarf eine Steuerregelgruppe auswählen.
- Block auf der Warenkorbseite anzeigen: aktiviert die Auswahl auf der Warenkorbseite.
Titel und Untertitel sind mehrsprachige Felder: Wählen Sie jede Sprache im Feldselektor, um den Text anzupassen. Standardwerte werden bei der Installation in allen fünf Sprachen bereitgestellt.
Funktionsweise
Wie das Trinkgeld hinzugefügt wird
Wenn der Kunde ein Trinkgeld wählt, speichert das Modul seine Wahl (Typ und Wert) für den aktuellen Warenkorb, fügt die Position «Trinkgeld» zum Warenkorb hinzu und legt ihren genauen Preis über einen warenkorbgebundenen specific_price fest. Der Vorgang läuft per Ajax, ohne Neuladen, und die Summe aktualisiert sich sofort.
Prozentsatz automatisch neu berechnet
Bei einem prozentualen Trinkgeld folgt der Betrag dem Warenkorbinhalt: Fügt der Kunde ein Produkt hinzu oder entfernt es, berechnet das Modul den Betrag neu und synchronisiert die Position vor der Zahlung neu. Die Basis (Produktsumme inkl. oder exkl. MwSt.) wird in der Konfiguration festgelegt und schließt immer die Trinkgeldposition selbst sowie die Versandkosten aus.
Native Integration in die Bestellung
Da das Trinkgeld eine echte Warenkorbposition ist, wird es im tatsächlich gezahlten Betrag berücksichtigt und bei der Validierung in der Bestellung erfasst. Es erscheint sauber in der Rechnung, der Buchhaltung und etwaigen Gutschriften, ohne Core-Override.
MwSt. des Trinkgelds
Da ein freiwilliges Trinkgeld in der Regel außerhalb des MwSt.-Anwendungsbereichs liegt, wird die Position standardmäßig ohne Steuer geliefert. Wenn Sie dem Trinkgeld eine Steuerregelgruppe zuweisen, wird der eingegebene oder berechnete Betrag als Nettobasis behandelt.
Das vom Modul erstellte Produkt «Trinkgeld» darf nicht gelöscht oder im Katalog sichtbar gemacht werden: Es trägt nur den Trinkgeldbetrag. Es ist aus Suche und Listen ausgeblendet und bleibt versandfrei.
Trinkgeld entfernen
Der Kunde kann sein Trinkgeld jederzeit über die Option «Kein Trinkgeld» entfernen. Entfernt er die Position «Trinkgeld» manuell aus dem Warenkorb, löscht das Modul auch die gespeicherte Wahl, damit sie nicht erneut hinzugefügt wird.
FAQ und Fehlerbehebung
Der Trinkgeld-Block erscheint nicht auf der Warenkorbseite
Prüfen Sie, ob das Modul aktiviert und die Option «Block auf der Warenkorbseite anzeigen» aktiviert ist. Leeren Sie dann den PrestaShop-Cache (Erweiterte Parameter > Leistung) und deaktivieren Sie während des Tests Kombinieren/Komprimieren (CCC). Der Block erscheint, wenn der Warenkorb mindestens einen Artikel enthält.
Das prozentuale Trinkgeld aktualisiert sich nicht, wenn ich den Warenkorb ändere
Die Neuberechnung erfolgt beim Speichern des Warenkorbs und beim Laden der Warenkorb- oder Checkout-Seite. Wenn Sie den Warenkorb über eine Ajax-Aktion des Themes ändern, laden Sie die Seite neu: Der Betrag wird vor der Zahlung neu synchronisiert.
Erscheint das Trinkgeld auf der Rechnung?
Ja. Das Trinkgeld ist eine vollständige Bestellposition: Es erscheint im Bestelldetail und auf der Rechnung und wird in Gutschriften berücksichtigt.
Kann ich auf das Trinkgeld MwSt. anwenden?
Ja, indem Sie in der Konfiguration eine Steuerregelgruppe auswählen. Standardmäßig ist das Trinkgeld steuerfrei, entsprechend der Natur eines freiwilligen Trinkgelds.
Ist es mit PrestaShop 9 und Multishop kompatibel?
Ja. Das Modul ist mit PrestaShop 8 und 9 kompatibel, im Einzelshop wie im Multishop, und mehrsprachig, ohne Composer- oder Framework-Abhängigkeit.