Warenkorb-Popularität — Dokumentation
Das Modul zur Warenkorb-Zählung auf der Produktseite installieren und konfigurieren.
Das Modul Warenkorb-Popularität zeigt auf der Produktseite ein Social-Proof-Badge an, das angibt, in wie vielen Warenkörben das Produkt enthalten ist, zum Beispiel „In über 20 Warenkörben“. Diese Anleitung behandelt die Installation, die Konfiguration jeder Einstellung, die Funktionsweise der Zählung und die Fehlerbehebung.
Installation
Das Modul wird wie jedes PrestaShop-Modul installiert, ohne externe Abhängigkeit.
- Öffnen Sie im Back-Office Module > Modul-Manager.
- Klicken Sie auf Modul hochladen und wählen Sie die Datei
dfcartpopularity.zipaus. - Klicken Sie nach Abschluss der Installation auf Konfigurieren.
Kompatibel mit PrestaShop 8.0 bis 9.x. Es ist keine Composer-Abhängigkeit oder externe JavaScript-Bibliothek erforderlich.
Konfiguration
Die Konfigurationsseite bündelt alle Anzeige- und Zählungseinstellungen.
Angezeigter Text
Die im Badge dargestellte Nachricht, pro Sprache übersetzbar. Verwenden Sie den Platzhalter {count}, um die Zahl dynamisch einzufügen. Beispiel: In über {count} Warenkörben. Die französische, englische, spanische, deutsche und italienische Übersetzung sind standardmäßig enthalten.
Anzeigeschwelle
Mindestanzahl an Warenkörben, ab der das Badge erscheint. Unterhalb dieser Schwelle wird nichts angezeigt, wodurch eine wenig vorteilhafte Zahl vermieden wird. Standardwert: 20.
Anzeigemodus der Zahl
- Gerundete Stufe: Der Zähler wird auf eine Stufe abgerundet (z. B. zeigt 23 Warenkörbe „über 20“ an). Ideal für einen glaubwürdigen Effekt, der sich in Schritten entwickelt.
- Exakte Zahl: Die tatsächliche Zahl wird angezeigt, für Shops, die vollständige Transparenz bevorzugen.
Rundungsstufe
Wird nur im Stufenmodus verwendet. Bestimmt das Rundungsintervall: Eine Stufe von 10 macht aus 23 „über 20“ und aus 37 „über 30“.
Zeitfenster (Stunden)
Zählt nur Warenkörbe, die innerhalb dieses Fensters aktualisiert wurden. Zum Beispiel 168 = 7 Tage. Auf 0 setzen, um keine Zeitbegrenzung anzuwenden.
Nur aktive Warenkörbe
Wenn diese Option aktiviert ist, werden bereits in eine Bestellung umgewandelte Warenkörbe von der Zählung ausgeschlossen. So spiegeln Sie nur die aktive Nachfrage wider.
Platzierung
Wählen Sie, wo das Badge auf der Produktseite erscheint: unter dem Warenkorb-Block (Zusatzinformationen) oder in der Nähe der Kaufbuttons.
Cache-Dauer (Sekunden)
Dauer, für die die Zählung vor einer Neuberechnung gespeichert wird. Standardmäßig 600 Sekunden (10 Minuten). Auf 0 setzen, um bei jeder Anzeige neu zu berechnen, was in der Produktion nicht empfohlen wird.
Bei jedem Speichern der Einstellungen wird der Zählungs-Cache automatisch geleert, damit Ihre neuen Parameter sofort wirksam werden.
Wie die Zählung funktioniert
Das Modul zählt die tatsächlichen Warenkörbe, die das Produkt enthalten. Die Zählung wird pro Warenkorb entdoppelt — derselbe Warenkorb wird nie zweimal gezählt — und im Multistore-Kontext auf den aktuellen Shop beschränkt. Das Zeitfenster und die Option „Nur aktive Warenkörbe“ verfeinern diese Zählung, damit sie die relevante Nachfrage widerspiegelt.
Leistung und Cache
Um eine Zählabfrage bei jeder Produktansicht zu vermeiden, wird das Ergebnis in einer dedizierten Cache-Tabelle mit konfigurierbarer Lebensdauer gespeichert. Die Zählung wird erst beim Ablauf des Caches neu berechnet, was die Leistung auch bei Shops mit hohem Traffic erhält.
Multistore und mehrsprachig
Im Multistore wird die Zählung auf den aufgerufenen Shop beschränkt. Sprachseitig ist der Badge-Text vollständig übersetzbar: Er wird für jede aktive Sprache des Shops unabhängig eingestellt, mit dem Platzhalter {count} für die Zahl.
Theme-Integration
Das Badge wird serverseitig über ein Modul-Template gerendert. Wenn Sie es in Ihrem Theme präzise positionieren möchten, enthält die Smarty-Variable {$dfcp_message} die gebrauchsfertige Nachricht und kann in ein Override der Produktseite eingefügt werden.
Fehlerbehebung
Das Badge erscheint nicht
Prüfen Sie, ob die tatsächliche Anzahl der Warenkörbe, die das Produkt enthalten, die festgelegte Schwelle erreicht. Wenn die Schwelle bei 20 liegt, das Produkt aber nur in 5 Warenkörben ist, erscheint kein Badge — das ist das erwartete Verhalten. Senken Sie die Schwelle vorübergehend, um die Anzeige zu testen.
Die Zahl wird nicht sofort aktualisiert
Das ist der Cache-Effekt. Warten Sie den Ablauf der konfigurierten Dauer ab, oder speichern Sie die Einstellungen, um eine sofortige Cache-Leerung zu erzwingen.
Der Zähler erscheint zu niedrig
Wenn die Option „Nur aktive Warenkörbe“ aktiviert und das Zeitfenster kurz ist, werden nur aktuelle, nicht bestellte Warenkörbe gezählt. Erweitern Sie das Zeitfenster oder deaktivieren Sie die Option für eine umfassendere Zählung.