Solidarische Aufrundung & Spende im Checkout — Komplette Anleitung
Solidarische Aufrundung und Mikrospende im Checkout installieren, konfigurieren und nutzen (drei Modi, Spende ohne MwSt., Spendenverfolgung) für PrestaShop 8 und 9.
Überblick
Das Modul Solidarische Aufrundung & Spende im Checkout (dfsolidarityround) ermöglicht es Ihren Kunden, eine Organisation in Sekunden zu unterstützen, direkt im Warenkorb: indem sie ihre Bestellung auf den nächsten Euro aufrunden, einen vordefinierten Spendenbetrag wählen oder einen freien Betrag eingeben. Die Spende fügt sich sauber in die Gesamtsumme ein — MwSt., Währung und Multishop werden vom PrestaShop-Kern verwaltet, bis hin zur Rechnung.
Die Spende ist keine bloße Anzeige: Sie wird von einem eigenen virtuellen 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.
Kompatibilität
- PrestaShop 8.0 bis 9.x
- Einzelshop und Multishop
- PHP 7.4 bis 8.3
- Classic-Theme und individuelle Themes
- Oberfläche in Französisch, Englisch, Spanisch, Deutsch und Italienisch geliefert
- Keine Abhängigkeit (weder Composer noch Framework)
Installation
- Öffnen Sie im Back-Office Module > Modul-Manager.
- Klicken Sie auf Ein Modul hochladen und wählen Sie die Datei
dfsolidarityround.zip. - Klicken Sie nach der Installation auf Konfigurieren.
Bei der Installation erstellt das Modul seine Verlaufstabelle, registriert seine Hooks (Front-Ressourcen, Block im Warenkorb und im Checkout, Bestellbestätigung), fügt den Back-Office-Reiter Solidarische Spenden hinzu und erzeugt ein ausgeblendetes virtuelles Produkt „Solidarische Spende“: nicht im Shop sichtbar, ohne MwSt., ohne Versandkosten. Es trägt den Spendenbetrag im Warenkorb. Löschen Sie es nicht manuell.
Konfiguration
Spendenmodi
Drei Modi stehen zur Verfügung und lassen sich unabhängig aktivieren. Sie können nur einen anbieten oder alle drei gleichzeitig.
- Aufrundung auf den nächsten Euro: schlägt dem Kunden vor, seine Bestellung auf den nächsten runden Betrag zu bringen. Der Aufrundungsschritt ist konfigurierbar (
1,00für den nächsten Euro,0,50für den halben Euro usw.). - Feste Beträge: zeigt klickfertige Schaltflächen an. Die Liste der Beträge ist konfigurierbar (zum Beispiel
1;2;5). - Freier Betrag: lässt den Kunden den Betrag seiner Wahl eingeben, begrenzt durch eine Mindestspende und eine Höchstspende.
Wenn im Aufrundungsmodus die Warenkorbsumme bereits ein runder Betrag ist, bietet das Modul eine Spende von einem vollen Schritt an, damit die Zustimmung des Kunden stets sinnvoll bleibt.
Anpassung der Organisation
- Titel des Blocks: oben im Block angezeigte Überschrift (mehrsprachiges Feld).
- Name der Organisation: Name der unterstützten Sache (mehrsprachiges Feld).
- Beschreibung: kurzer Begleittext (mehrsprachiges Feld).
- Logo der Organisation: im Block angezeigtes Bild (PNG, JPG, GIF, WEBP oder SVG).
Anzeigeorte
- Auf der Warenkorbseite anzeigen: zeigt den Block am unteren Rand der Warenkorbseite an (Hauptort, zuverlässig).
- Im Bestellprozess anzeigen: zeigt den Block in der Bestellübersicht an, sofern Ihr Theme den entsprechenden Ort bereitstellt.
Funktionsweise für den Kunden
Aufrundung auf den nächsten Euro
Der Kunde sieht eine Schaltfläche wie „Aufrunden und 0,73 € spenden“. Der vorgeschlagene Betrag ist die Differenz zwischen seiner Summe und dem nächsten runden Betrag, gemäß dem konfigurierten Schritt.
Feste Beträge
Der Kunde klickt auf einen der vorgeschlagenen Beträge (1 €, 2 €, 5 €…). Die entsprechende Spende wird sofort hinzugefügt.
Freier Betrag
Der Kunde gibt den Betrag seiner Wahl ein und bestätigt. Der Wert wird gegen das definierte Minimum und Maximum geprüft.
Sobald die Spende hinzugefügt ist, zeigt der Block einen Dank und einen Link „Spende entfernen“ an. Der Kunde behält die Kontrolle: Er kann den Betrag ändern oder seine Spende jederzeit vor der Zahlung entfernen.
Wie die Spende dem Warenkorb hinzugefügt wird
Bei jeder Auswahl erstellt das Modul einen Spezialpreis (SpecificPrice), der auf den aktuellen Warenkorb (id_cart) begrenzt ist, und wendet ihn auf das virtuelle Produkt „Solidarische Spende“ an. Dieses Produkt wird dem Warenkorb hinzugefügt, wenn der Betrag größer als null ist, andernfalls entfernt. PrestaShop wendet dann die Währung und den Multishop-Kontext an, und die Spende erscheint als klare Zeile in den Summen, der Bestellung und der Rechnung.
Automatische Neuberechnung der Aufrundung
Im Aufrundungsmodus wird der Spendenbetrag bei jeder Anzeige des Blocks neu berechnet. Wenn der Kunde seinen Warenkorb nach der Wahl der Aufrundung ändert, bleibt die Spende somit bis zur Zahlung mit der neuen Summe konsistent.
Spende ohne MwSt.
Das Produkt „Solidarische Spende“ wird ohne Steuerregel erstellt: Der angezeigte und gesammelte Betrag entspricht genau der Geste des Kunden, ohne MwSt.-Überraschung.
Spendenverfolgung im Back-Office
Unter Bestellungen wird ein Reiter Solidarische Spenden hinzugefügt (Controller AdminDfDonations). Er listet jede Spende auf mit:
- dem Betrag der Spende;
- dem verwendeten Modus (Aufrundung, fester Betrag oder freier Betrag);
- dem Kunden und der zugehörigen Bestellung;
- dem Datum der Spende.
Ein Übersichtsbanner zeigt die Gesamtsumme und die Anzahl der Spenden an. Die Spende wird bei der Bestellbestätigung (actionValidateOrder) im Verlauf eingefroren.
Weiterleitung an die Organisation
Das Modul leitet die Spenden nicht automatisch an die Organisation weiter: Das ist beabsichtigt. Es sammelt die Spenden innerhalb Ihrer Bestellungen und liefert Ihnen die Gesamtsumme und den Verlauf. Sie behalten die Kontrolle darüber, wann und wie Sie die Mittel nach Ihrem eigenen Prozess an Ihre Partnerorganisation weiterleiten.
PrestaShop-9-Kompatibilität
Das Modul ist von PrestaShop 8.0 bis 9.x konzipiert und getestet:
- der Back-Office-Controller verwendet
ModuleAdminController, kompatibel mit 8 und 9; - der Code vermeidet die in PrestaShop 9 entfernten Methoden (portabler AJAX-Token und Preisformatierung);
- der AJAX-Controller gibt JSON direkt zurück, ohne inkompatibles Signatur-Override.
FAQ und Fehlerbehebung
Der Block erscheint nicht im Bestellprozess
Der Block wird zuverlässig am unteren Rand der Warenkorbseite angezeigt. In der Bestellübersicht hängt die Anzeige vom Theme ab, das den entsprechenden Ort bereitstellen muss. Die auf der Warenkorbseite gewählte Spende bleibt in jedem Fall bis zur Zahlung erhalten.
Die Summe wird nach dem Klick nicht aktualisiert
Der Block löst nach dem Hinzufügen oder Entfernen der Spende eine Aktualisierung des Warenkorbs aus. Leeren Sie den PrestaShop-Cache und laden Sie die Seite neu. Prüfen Sie auch, dass das Produkt „Solidarische Spende“ nicht manuell gelöscht wurde.
Der Shop wird nach der Installation weiß
Stellen Sie sicher, dass Sie die neueste Version des Moduls verwenden, und leeren Sie den Cache. Das Spendenprodukt ist bewusst nicht im Shop sichtbar; machen Sie es nicht sichtbar und löschen Sie es nicht manuell.
Die Aufrundungsspende erscheint mir falsch
Prüfen Sie den konfigurierten Aufrundungsschritt. Im Aufrundungsmodus wird die Spende bei jeder Anzeige des Blocks aus der Summe ohne Spende neu berechnet; ändert sich der Warenkorb, wird der Betrag automatisch angepasst.
Wie übersetze ich den Block in eine andere Sprache?
Der Titel, der Name der Organisation und die Beschreibung sind mehrsprachige Felder: Wählen Sie jede Sprache in der Konfiguration, um sie zu übersetzen. Oberflächentexte werden über Erweiterte Einstellungen > Übersetzungen > Übersetzungen der installierten Module übersetzt, indem Sie dfsolidarityround auswählen.
Ist es mit PrestaShop 9 kompatibel?
Ja. Das Modul ist von PrestaShop 8.0 bis 9.x konzipiert und getestet, im Einzelshop wie im Multishop.
Deinstallation
Die Deinstallation entfernt das Produkt „Solidarische Spende“, den Back-Office-Reiter und die Tabelle des Spendenverlaufs. Wenn Sie den Verlauf behalten möchten, deaktivieren Sie das Modul, ohne es zu deinstallieren.