Zum Hauptinhalt springen
Mit dem $wsProductRating Modul können Sie Produktbewertungen laden, prüfen und im Frontend anzeigen. Produktbewertungen sind ein wichtiges Element für Kaufentscheidungen. Sie zeigen Kunden die Erfahrungen anderer Käufer und erhöhen das Vertrauen in Produkte.

​
Modulübersicht

Beispiel / Ausschnitt über $wsProductRating 
{{= $wsProductRating | json }}
JSON-Ausgabe 
{
  "checkRatingExistence": "ƒ()",
  "loadAllProductRatings": "ƒ()",
  "loadLatestRatingForAccount": "ƒ()",
  "loadRatingByAccount": "ƒ()",
  "loadRatingStatistics": "ƒ()",
  "loadSingleRating": "ƒ()"
}
Anmerkung: “ƒ()” kennzeichnet eine Funktion. Methoden in der Übersicht
MethodeRückgabe-TypBeschreibung
checkRatingExistence()boolPrüft, ob für ein Produkt in Verbindung mit einer Bestellung eine Bewertung existiert.
loadAllProductRatings()arrayLädt alle Bewertungen eines Produkts.
loadRatingStatistics()mapLädt Statistiken zu den Bewertungen eines Produkts.
loadSingleRating()mapLädt eine einzelne Bewertung anhand von Produkt- und Bestell-ID.
loadLatestRating()mapLädt die neueste Bewertung des aktuell eingeloggten Kunden.
loadRatingByAccount()mapLädt eine Produktbewertung des aktuell eingeloggten Kunden.

​
Templates

Produktbewertungen werden typischerweise auf der Produktdetailseite (product.htm) angezeigt. Sie können aber auch auf Kategorieseiten oder in der Bestellhistorie eingebunden werden, um Kunden zur Bewertung aufzufordern.

​
Variablen

Für $wsProductRating stehen keine Variablen zur Verfügung.

​
Methoden

​
$wsProductRating.checkRatingExistence()

Prüft, ob für ein Produkt in Verbindung mit einer Bestellung bereits eine Bewertung existiert. Signatur
$wsProductRating.checkRatingExistence(productId, orderId) Rückgabe
bool - true wenn eine Bewertung existiert, sonst false. Parameter
NameTypPflichtBeschreibung
productIdstringjaID des Produkts.
orderIdstringjaID der Bestellung.
Beispiel, das prüft ob eine Bewertung existiert. 
{{ if $wsProductRating.checkRatingExistence(productId, orderId) }}
   // Bewertung vorhanden
{{ /if }}

​
$wsProductRating.loadAllProductRatings()

Lädt alle Bewertungen eines Produkts. Signatur
$wsProductRating.loadAllProductRatings(productId) Rückgabe
array - Liste mit allen Bewertungen des Produkts. Parameter
NameTypPflichtBeschreibung
productIdstringjaID des Produkts.
Beispiel, das alle Bewertungen eines Produkts lädt. 
{{ var $myProductRatings = $wsProductRating.loadAllProductRatings(productId) }}

​
$wsProductRating.loadRatingStatistics()

Lädt Statistiken zu den Bewertungen eines Produkts. Signatur
$wsProductRating.loadRatingStatistics(productId) Rückgabe
map - Map mit Bewertungsstatistiken (z.B. Durchschnitt, Anzahl). Parameter
NameTypPflichtBeschreibung
productIdstringjaID des Produkts.
Beispiel, das die Statistik eines Produkts lädt. 
{{ var $myRatingStatistics = $wsProductRating.loadRatingStatistics(productId) }}

​
$wsProductRating.loadSingleRating()

Lädt eine einzelne Bewertung anhand von Produkt- und Bestell-ID. Signatur
$wsProductRating.loadSingleRating(productId, orderId) Rückgabe
map - Map mit den Bewertungsdaten. Parameter
NameTypPflichtBeschreibung
productIdstringjaID des Produkts.
orderIdstringjaID der Bestellung.
Beispiel, das eine einzelne Bewertung lädt. 
{{ var $myRating = $wsProductRating.loadSingleRating(productId, orderId) }}

​
$wsProductRating.loadLatestRatingForAccount()

Lädt die neueste Bewertung des aktuell eingeloggten Kunden. Signatur
$wsProductRating.loadLatestRatingForAccount() Rückgabe
map - Map mit den Bewertungsdaten. Beispiel, das die neueste Bewertung des Kunden lädt. 
{{ var $myLatestRating = $wsProductRating.loadLatestRatingForAccount() }}

​
$wsProductRating.loadRatingByAccount()

Lädt eine Produktbewertung des aktuell eingeloggten Kunden. Signatur
$wsProductRating.loadRatingByAccount(productId) Rückgabe
map - Map mit den Bewertungsdaten des Kunden. Parameter
NameTypPflichtBeschreibung
productIdstringjaID des Produkts.
Beispiel, das die Bewertung des Kunden für ein Produkt lädt. 
{{ var $myProductRating = $wsProductRating.loadRatingByAccount(productId) }}

​
Aktionen

Für $wsProductRating sind keine Aktionen vorhanden.

​
Beispiele

​
Durchschnittsbewertung anzeigen

In diesem Beispiel wird die Durchschnittsbewertung und die Anzahl der Bewertungen eines Produkts angezeigt. 
{{ var $statistics = $wsProductRating.loadRatingStatistics($product.id) }}
{{ if $statistics.totalCount > 0 }}
  Bewertung: {{= $statistics.averageRating }} / 5 ({{= $statistics.totalCount }} Bewertungen)
{{ /if }}

​
Alle Bewertungen eines Produkts auflisten

In diesem Beispiel werden alle Bewertungen eines Produkts geladen und angezeigt. 
{{ var $ratings = $wsProductRating.loadAllProductRatings($product.id) }}
{{ if $ratings }}
  {{ foreach $rating in $ratings }}
    <p><strong>{{= $rating.author }}</strong>: {{= $rating.rating }} Sterne</p>
    <p>{{= $rating.text }}</p>
  {{ /foreach }}
{{ else }}
  <p>Noch keine Bewertungen vorhanden.</p>
{{ /if }}

​
Prüfen, ob Kunde bereits bewertet hat

In diesem Beispiel wird geprüft, ob der Kunde ein Produkt bereits bewertet hat, bevor das Bewertungsformular angezeigt wird. 
{{ if !$wsProductRating.checkRatingExistence($product.id, $order.id) }}
  
{{ else }}
  <p>Sie haben dieses Produkt bereits bewertet.</p>
{{ /if }}