# Trend-Produkte & Beliebte Suchanfragen Modul — Komplettanleitung

> Überblick DF Trending ergänzt Ihren PrestaShop-8- oder -9-Shop um ein Trend-Widget mit drei unabhängigen Bereichen: die aktuellen beliebten Suchanfragen (anklickbare Tag-Wolke), aufsteigende Produkte (Erkennung über Verkaufsgeschwindigkeit) und ein automatisch generierter…

- Seite: <https://www.datafirefly.com/de/documentation/dftrending/>
- Sprache: de
- Aktualisiert am: 2026-07-12
- Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dftrending/index.md), [en](https://www.datafirefly.com/en/documentation/dftrending/index.md), [es](https://www.datafirefly.com/es/documentation/dftrending/index.md), [it](https://www.datafirefly.com/it/documentation/dftrending/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftrending/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftrending/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftrending/index.md)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

## Überblick

DF Trending ergänzt Ihren PrestaShop-8- oder -9-Shop um ein Trend-Widget mit drei unabhängigen Bereichen: die aktuellen **beliebten Suchanfragen** (anklickbare Tag-Wolke), **aufsteigende Produkte** (Erkennung über Verkaufsgeschwindigkeit) und ein automatisch generierter **„Gerade jetzt“**-Bereich, der Produktaufrufe und aktuelle Verkäufe kombiniert. Ein eigener Backoffice-Tab liefert die analytische Sicht auf diese drei Datenströme.

## Installation

1. Öffnen Sie im Backoffice **Module > Modul-Manager** und klicken Sie auf **Modul hochladen**.
2. Wählen Sie das Archiv `dftrending.zip` und bestätigen Sie.
3. Das Modul legt seine Datentabellen, die Standardkonfiguration und den Tab **Trend-Statistiken** an und hängt sich automatisch an die Startseite.

Keine Composer-Abhängigkeit, kein externes Framework: Das Archiv ist eigenständig und verhält sich von PrestaShop 8.0 bis 9.x identisch, im Einzelshop wie im Multishop.

## Konfiguration

Öffnen Sie die Modulkonfiguration über den Modul-Manager. Verfügbare Einstellungen:

- **Beliebte Suchanfragen anzeigen** — blendet die Tag-Wolke ein oder aus.
- **Aufsteigende Produkte anzeigen** — blendet den Geschwindigkeitsbereich ein oder aus.
- **Den Gerade-jetzt-Bereich anzeigen** — blendet die Kombination Aufrufe + Verkäufe ein oder aus.
- **Anzahl der anzuzeigenden Suchanfragen** — Größe der Tag-Wolke (Standard 8).
- **Anzahl aufsteigender Produkte** und **Anzahl der Gerade-jetzt-Produkte** — Größe der beiden Produktraster (Standard 4).
- **Analysezeitraum (Tage)** — Länge des aktuellen Zeitfensters, das mit dem vorherigen Zeitfenster gleicher Länge verglichen wird (Standard 7).
- **Mindestverkäufe zur Qualifikation** — Schwelle, unter der ein Produkt nie als aufsteigend gilt (Standard 2).
- **Cache-Lebensdauer (Sekunden)** — Zeitraum, in dem Trendberechnungen ohne neue Abfrage wiederverwendet werden (Standard 3600).

Jedes Speichern der Einstellungen leert automatisch den internen Cache: Neue Werte sind sofort im Storefront sichtbar.

## Funktionsweise

### Beliebte Suchanfragen

Das Modul hört auf die native PrestaShop-Suche. Jede Anfrage wird normalisiert (Kleinschreibung, reduzierte Leerzeichen, Länge zwischen 2 und 64 Zeichen) und pro Tag, Sprache und Shop aggregiert. Die Wolke zeigt die häufigsten Anfragen des Analysezeitraums; jeder Tag verlinkt auf die passende Ergebnisseite.

### Aufsteigende Produkte

Die im aktuellen Zeitfenster verkauften Mengen werden mit denen des vorherigen Zeitfensters gleicher Länge verglichen. Nur gültige Bestellungen werden gezählt. Der Ranking-Score gewichtet das Wachstum nach dem aktuellen Volumen: ein Produkt, das von 50 auf 90 Verkäufe steigt, überholt eines, das von 2 auf 4 steigt. Inaktive oder unsichtbare Produkte sind ausgeschlossen.

### „Gerade jetzt“-Bereich

Jede besuchte Produktseite sendet ein leichtgewichtiges Signal aus dem Browser, einmal pro Produkt und Sitzung. Diese clientseitige Zählung bleibt hinter einem Full-Page-Cache exakt. Der Score kombiniert Aufrufe und aktuelle Verkäufe (ein Verkauf wiegt fünfmal so viel wie ein Aufruf); bereits im Aufsteiger-Bereich gezeigte Produkte werden automatisch dedupliziert.

## Widget-Platzierung

Standardmäßig erscheint das Widget auf der Startseite (Hook `displayHome`). Das Modul implementiert die Widget-Schnittstelle von PrestaShop: Über **Designs > Positionen** können Sie es an jeden Anzeige-Hook Ihres Themes hängen. Die Produkte werden mit den nativen Miniaturen Ihres Themes gerendert, in einem eigenständigen Raster, das nicht von dessen Styles abhängt.

## Backoffice-Dashboard

Der Tab **Trend-Statistiken** (unter Module) zeigt drei Panels: die Top-Suchanfragen der letzten 30 Tage mit ihrer Trefferzahl, aufsteigende Produkte mit aktuellen Verkäufen, vorherigen Verkäufen und Wachstumsprozentsatz sowie die meistgesehenen Produkte des Analysezeitraums. Jedes Produkt verlinkt direkt auf seine Bearbeitungsseite.

## Daten und Datenschutz

Das Modul speichert keine personenbezogenen Daten: keine Kundenkennung, keine IP-Adresse, kein Tracking-Cookie. Es werden nur anonyme Tageszähler (Anfrage + Anzahl, Produkt + Anzahl) gespeichert, und alle Daten, die älter als 90 Tage sind, werden automatisch gelöscht.

## Fehlerbehebung

- **Das Widget zeigt nichts an** — das ist in einem Shop ohne Historie normal: Jeder Bereich bleibt ausgeblendet, bis er relevante Daten hat. Prüfen Sie auch, ob die Bereiche in der Konfiguration aktiviert sind.
- **Produkte stapeln sich vertikal** — leeren Sie den PrestaShop-Cache und erzwingen Sie das Neuladen der Stylesheets (Strg+F5) nach einem Modul-Update.
- **Aufrufe werden nicht gezählt** — prüfen Sie, ob kein Blocker die Datei `front.js` des Moduls filtert und der Front-Controller `track` antwortet (eine JSON-Antwort wird erwartet).

## Versionshistorie

- **1.0.2** (2026-07-12) — erste öffentliche Version: beliebte Suchanfragen, Verkaufsgeschwindigkeit, Gerade-jetzt-Bereich, Dashboard, interner Cache, automatische Löschung.
