Rating-Suite

Beschreibung

Die Rating-Suite erweitert das ProductRatingSlider Portlet im OnPage Composer (OPC) um umfangreiche Filter- und Auswahlmöglichkeiten für Produktbewertungen. Die Extension ermöglicht es, Bewertungen nach verschiedenen Kriterien zu filtern und gezielt auszuwählen, welche Bewertungen angezeigt werden sollen.

Die Rating-Suite arbeitet ausschließlich im Backend und ist für die Konfiguration von Bewertungs-Portlets im OnPage Composer zuständig.

Anwendungsbereiche

Die Extension eignet sich für folgende Anwendungsfälle:

• Anzeige von Top-Bewertungen auf der Startseite
• Filterung nach bestimmten Produktkategorien
• Darstellung von Bewertungen eines bestimmten Herstellers
• Anzeige von Bewertungen ab einer bestimmten Sternezahl
• Mehrsprachige Shops: Bewertungen nach Sprache filtern
• Manuelle Auswahl spezifischer Bewertungen für Marketing-Zwecke
• Automatische Anzeige der aktuellsten positiven Bewertungen

Integration mit OnPage Composer

Die Rating-Suite ist in das ProductRatingSlider Portlet integriert und erweitert dessen Konfigurationsmöglichkeiten. Sie erfordert das salepix_templater Plugin mit dem ProductRatingSlider Portlet.

Die Rating-Suite funktioniert nur im Zusammenhang mit dem ProductRatingSlider Portlet im OnPage Composer.

Auswahlmodi

Die Rating-Suite bietet zwei Modi zur Auswahl von Bewertungen:

Modus 1: Dynamische Auswahl (Automatisch)

Bei der dynamischen Auswahl werden Bewertungen automatisch anhand von Filterkriterien ausgewählt. Die neuesten Bewertungen, die den Filterkriterien entsprechen, werden angezeigt.

Anwendungsfall: Automatische Anzeige der neuesten 5-Sterne-Bewertungen aus einer bestimmten Kategorie.

Modus 2: Manuelle Auswahl

Bei der manuellen Auswahl können Sie gezielt einzelne Bewertungen über eine Suchfunktion finden und auswählen.

Anwendungsfall: Spezifische Auswahl von besonders aussagekräftigen Bewertungen für Marketing-Zwecke.

Verfügbare Filter

Die Rating-Suite bietet vier verschiedene Filtertypen:

Filter 1: Bewertungssterne

Filtert Bewertungen nach der Anzahl der Sterne (ab X Sternen).

Filter	Beschreibung
Ab 1 Stern	Zeigt alle Bewertungen (1-5 Sterne)
Ab 2 Sternen	Zeigt Bewertungen mit 2-5 Sternen
Ab 3 Sternen	Zeigt Bewertungen mit 3-5 Sternen
Ab 4 Sternen	Zeigt Bewertungen mit 4-5 Sternen
Ab 5 Sternen	Zeigt nur 5-Sterne-Bewertungen

Filter 2: Sprache

Filtert Bewertungen nach der Sprache, in der sie verfasst wurden.

Verfügbare Sprachen: Alle im Shop aktivierten Sprachen (z.B. Deutsch, Englisch, Französisch)

Anwendungsfall: In mehrsprachigen Shops nur deutschsprachige Bewertungen auf der deutschen Startseite anzeigen.

Filter 3: Hersteller

Filtert Bewertungen nach dem Hersteller des bewerteten Produkts.

Verfügbare Hersteller: Alle im Shop vorhandenen Hersteller

Anwendungsfall: Nur Bewertungen für Produkte eines bestimmten Herstellers anzeigen (z.B. auf einer Hersteller-Landingpage).

Filter 4: Kategorie

Filtert Bewertungen nach der Produktkategorie.

Verfügbare Kategorien: Alle im Shop vorhandenen Produktkategorien mit vollständigem Pfad

Anwendungsfall: Nur Bewertungen aus der Kategorie "Elektronik" auf einer Elektronik-Landingpage anzeigen.

Einrichtung im OnPage Composer

Schritt 1: Portlet hinzufügen

1.1: Öffnen Sie den OnPage Composer für die gewünschte Seite

1.2: Fügen Sie das Portlet "ProductRatingSlider" hinzu

1.3: Öffnen Sie die Portlet-Konfiguration (Zahnrad-Symbol)

Schritt 2: Auswahlmodus wählen

2.1: Wählen Sie zwischen "Dynamisch" und "Manuell"

Schritt 3A: Dynamische Auswahl konfigurieren

Bei Auswahl des dynamischen Modus:

3.1: Im Bereich "Filter" sehen Sie vier Filterkategorien:
- Bewertungssterne
- Sprache
- Hersteller
- Kategorie

3.2: Klicken Sie auf die gewünschten Filter-Buttons, um sie zu aktivieren

3.3: Aktivierte Filter werden grün/blau hervorgehoben

3.4: Sie können mehrere Filter gleichzeitig aktivieren (UND-Verknüpfung)

3.5: Die Anzahl verfügbarer Bewertungen wird in Klammern angezeigt: z.B. "Ab 5 Sternen (23)"

3.6: Legen Sie die maximale Anzahl anzuzeigender Bewertungen fest

Schritt 3B: Manuelle Auswahl konfigurieren

Bei Auswahl des manuellen Modus:

3.1: Geben Sie im Suchfeld Suchbegriffe ein (Name, Titel oder Text der Bewertung)

3.2: Die Suche erfolgt live während der Eingabe

3.3: Gefundene Bewertungen werden mit folgenden Informationen angezeigt:
- Datum (TT.MM.JJJJ)
- Sternezahl
- Name des Bewerters
- Titel der Bewertung

3.4: Klicken Sie auf eine Bewertung, um sie auszuwählen

3.5: Ausgewählte Bewertungen werden in einer Liste angezeigt

3.6: Entfernen Sie Bewertungen durch erneutes Klicken

Schritt 4: Speichern

4.1: Klicken Sie auf "Speichern"

4.2: Speichern Sie die OnPage Composer Seite

4.3: Die Bewertungen werden nun im Frontend angezeigt

Praxisbeispiele

Beispiel 1: Top-Bewertungen auf der Startseite

Ziel: Die 5 neuesten 5-Sterne-Bewertungen auf der Startseite anzeigen

Konfiguration:

• Modus: Dynamisch
• Filter: "Ab 5 Sternen" aktivieren
• Maximale Anzahl: 5

Ergebnis: Automatische Anzeige der neuesten 5-Sterne-Bewertungen. Bei neuen Bewertungen wird die Liste automatisch aktualisiert.

Beispiel 2: Kategorie-spezifische Bewertungen

Ziel: Bewertungen aus der Kategorie "Smartphones" mit mindestens 4 Sternen

Konfiguration:

• Modus: Dynamisch
• Filter: "Ab 4 Sternen" aktivieren
• Filter: Kategorie "Elektronik > Smartphones" aktivieren
• Maximale Anzahl: 10

Ergebnis: Zeigt die 10 neuesten Bewertungen aus der Smartphone-Kategorie mit mindestens 4 Sternen.

Beispiel 3: Hersteller-Landingpage

Ziel: Alle positiven Bewertungen für Produkte von "Apple" anzeigen

Konfiguration:

• Modus: Dynamisch
• Filter: "Ab 4 Sternen" aktivieren
• Filter: Hersteller "Apple" aktivieren
• Maximale Anzahl: 20

Ergebnis: Zeigt die 20 neuesten Bewertungen für Apple-Produkte mit mindestens 4 Sternen.

Beispiel 4: Mehrsprachiger Shop

Ziel: Nur deutschsprachige Bewertungen auf der deutschen Startseite

Konfiguration:

• Modus: Dynamisch
• Filter: "Ab 3 Sternen" aktivieren
• Filter: Sprache "Deutsch" aktivieren
• Maximale Anzahl: 8

Ergebnis: Zeigt nur deutschsprachige Bewertungen mit mindestens 3 Sternen.

Beispiel 5: Marketing-Auswahl

Ziel: Spezifische, besonders aussagekräftige Bewertungen für eine Kampagne

Konfiguration:

• Modus: Manuell
• Suche nach: "hervorragend", "perfekt", "empfehlenswert"
• Auswahl von 3-5 besonders positiven Bewertungen

Ergebnis: Zeigt nur die manuell ausgewählten Bewertungen an. Diese bleiben konstant, auch wenn neue Bewertungen hinzukommen.

Beispiel 6: Kombination mehrerer Filter

Ziel: Premium-Bewertungen für eine spezielle Aktion

Konfiguration:

• Modus: Dynamisch
• Filter: "Ab 5 Sternen" aktivieren
• Filter: Kategorie "Premium-Produkte" aktivieren
• Filter: Sprache "Deutsch" aktivieren
• Maximale Anzahl: 6

Ergebnis: Zeigt die 6 neuesten deutschsprachigen 5-Sterne-Bewertungen aus der Premium-Kategorie.

Filter-Kombinationen

Mehrere Filter werden mit UND verknüpft. Das bedeutet:

Aktive Filter	Ergebnis
Ab 5 Sternen	Alle 5-Sterne-Bewertungen
Ab 5 Sternen + Deutsch	Nur deutschsprachige 5-Sterne-Bewertungen
Ab 4 Sternen + Kategorie "Schuhe"	Bewertungen mit 4-5 Sternen aus der Schuh-Kategorie
Ab 5 Sternen + Hersteller "Nike" + Deutsch	Deutschsprachige 5-Sterne-Bewertungen für Nike-Produkte

Suchfunktion (Manueller Modus)

Die Suchfunktion durchsucht folgende Felder:

• Name des Bewerters
• Titel der Bewertung
• Text der Bewertung

Die Suche erfolgt:

• Teilwort-Suche (z.B. findet "super" auch "superschnell")
• Nicht case-sensitive (Groß-/Kleinschreibung wird ignoriert)
• Maximal 100 Ergebnisse
• Nur aktive Bewertungen werden durchsucht

Anzeigeformat im Frontend

Die ausgewählten Bewertungen werden im Frontend als Slider angezeigt mit:

• Sternebewertung (visuell)
• Name des Bewerters
• Titel der Bewertung
• Bewertungstext
• Datum der Bewertung
• Produktbild und Name (verlinkbar)

Caching und Performance

Die Rating-Suite nutzt das JTL-Shop Caching-System:

• Filteroptionen werden gecacht
• Bewertungslisten werden gecacht
• Cache wird automatisch aktualisiert bei neuen Bewertungen
• Unterschiedliche Cache-Keys für verschiedene Filter-Kombinationen

Bei Änderungen an Bewertungen oder Produkten wird der Cache automatisch geleert. Die Änderungen sind sofort im Frontend sichtbar.

Besonderheiten bei Kategorien

Bei der Kategorie-Filterung wird der vollständige Kategoriepfad angezeigt:

• Format: "Hauptkategorie > Unterkategorie > Produkt-Kategorie"
• Beispiel: "Elektronik > Computer > Notebooks"
• Sortierung: Alphabetisch nach Kategoriepfad

Mehrere Kategorien können gleichzeitig ausgewählt werden (ODER-Verknüpfung bei mehreren Kategorien).

Technische Hinweise

Die Rating-Suite arbeitet mit folgenden JTL-Shop Komponenten:

• tbewertung (Bewertungstabelle)
• tartikel (Produkttabelle für Hersteller-Filter)
• tkategorieartikel (Kategorie-Zuordnung)
• tkategorie (Kategorien)
• thersteller (Hersteller)

Nur aktive Bewertungen (nAktiv = 1) werden berücksichtigt.

Limitierungen

• Maximale Suchergebnisse: 100
• Die Rating-Suite funktioniert nur im OnPage Composer
• Bewertungen müssen im Shop aktiv sein
• Filter werden mit UND verknüpft (außer mehrere Kategorien = ODER)

Unterschied zu Standard-Bewertungsanzeige

Feature	Standard	Mit Rating-Suite
Auswahl	Nur produktspezifisch	Shop-weit mit Filtern
Filter	Keine	4 Filter-Typen
Manuelle Auswahl	Nicht möglich	Per Suche möglich
Cross-Category	Nicht möglich	Über Kategorien hinweg
Hersteller-Filter	Nicht möglich	Verfügbar