Zum Hauptinhalt springen
WEBSALE V8s holt die bei eKomi abgegebenen Produktbewertungen regelmäßig ab und legt sie im Shop ab. Angezeigt werden sie in einem eigenen Template, das Sie in der Shopkonfiguration shop.config im Abschnitt ExternalProductRating unterhalb von Ekomi beim Parameter Template eintragen, beispielsweise incl_prodrating_ekomi.htm. In die Produktdetailansicht geholt wird dieses Template mit ~WS-Module(rating_ekomi)~. Die Tags dieser Seite gelten ausschließlich darin. Wegweiser: eKomi Produktbewertung · Referenz: Abschnitt ExternalProductRating · Referenz: WS-Module()
Die eKomi-Anbindung muss von der WEBSALE AG freigeschaltet werden, und die Interface-Kennungen bekommen Sie von eKomi. Ohne beides bleibt das Template leer.

​
Die Reihenfolge im Template

E-PRODRATING-EKOMI_Count() sieht wie eine bloße Einstellung aus, ist aber der Startschuss für alles Weitere. Erst dieses Tag zählt die vorhandenen Bewertungen, rechnet daraus die Seitenzahl aus und lädt die Bewertungen der aktuellen Seite.
E-PRODRATING-EKOMI_Count() gehört an den Anfang des Templates, vor jede Klammerung und jede Schleife. Fehlt es oder steht es weiter unten, bleibt E-PRODRATING-EKOMI_FeedbackData leer, die Bewertungsschleife läuft nicht, und die gesamte Blätterfunktion meldet, dass es nichts zu blättern gibt. Die Gesamtnote und die Bewertungsbalken erscheinen trotzdem, der Fehler fällt deshalb leicht spät auf.
Der Wert wird auf 1 bis 500 begrenzt. Eine 0 oder eine leere Angabe wird zu 1, ein größerer Wert als 500 zu 500.

​
Die Gesamtbewertung

E-PRODRATING-EKOMI_Votes eignet sich als äußere Klammerung für den ganzen Bewertungsblock, denn ohne Bewertungen gibt es weder eine Note noch Balken noch Kundenstimmen.
E-PRODRATING-EKOMI_Score gibt die Note mit einem Punkt als Dezimaltrennzeichen aus, also 4.5 und nicht 4,5. Für eine deutschsprachige Anzeige ersetzen Sie das Zeichen im Template oder zeigen stattdessen nur die Grafik.
E-PRODRATING-EKOMI_PositivePercentage ist eine ganze Zahl. Nachkommastellen werden abgeschnitten, nicht gerundet.

​
Die Bewertungsgrafiken

Welche Grafik zu welcher Note gehört, legen Sie in der Shopkonfiguration shop.config im Unterabschnitt AdvancedProductRatingImages fest. Jeder Bereich ist ein eigener Unterabschnitt <+Entry> mit From-Value, To-Value und Image. Im eKomi-Template gelten beide Grenzen einschließlich, und bei mehreren passenden Bereichen gewinnt der zuletzt eingetragene. Legen Sie die Bereiche deshalb lückenlos und aufsteigend an, dann landen Werte auf einer Grenze immer auf der höheren Grafik.
In Produktlisten wertet nicht das Modul, sondern der Shop-Kern dieselbe Konfiguration aus, und zwar mit ausschließlicher Obergrenze und dem ersten passenden Bereich. Ein Produkt mit glatt 5,0 bekommt im eKomi-Template die Fünf-Sterne-Grafik, in der Produktliste über PR-AdvRatingScoreImg(ekomi) dagegen gar keine. Setzen Sie die Obergrenze des letzten Bereichs daher über den Höchstwert, beispielsweise auf 5.1.
E-PRODRATING-EKOMI_ScoreImg lässt sich klammern. Der Bereich greift, wenn zur aktuellen Note überhaupt eine Grafik gefunden wurde, und fängt damit eine lückenhafte Konfiguration ab.

​
Die Bewertungsbalken

E-PRODRATING-EKOMI_Ratings läuft über die fünf möglichen Notenstufen, absteigend von 5 nach 1. Daraus bauen Sie die typische Balkenliste, in der jede Stufe zugleich ein Filterlink ist.
Innerhalb der Schleife brauchen die drei Tags keinen Parameter, sie beziehen sich dann auf die Notenstufe des laufenden Durchlaufs. Außerhalb der Schleife nennen Sie die Stufe in Klammern, beispielsweise ~E-PRODRATING-EKOMI_RatingVotes(5)~.
E-PRODRATING-EKOMI_Rating antwortet nur innerhalb von {@E-PRODRATING-EKOMI_Ratings}. Außerhalb bleibt das Tag unaufgelöst in der Seite stehen. Die Note einer einzelnen Kundenstimme liefert E-PRODRATING-EKOMI_FeedbackData_Rating.
Zulässig sind als Parameter die Werte 1 bis 5. Alles andere ergibt 0 beziehungsweise einen leeren Filterlink.
E-PRODRATING-EKOMI_RatingFilterParam ist ein reines Einzel-Tag. Eine Klammerung damit bleibt wirkungslos.

​
Den aktiven Filter anzeigen

E-PRODRATING-EKOMI_ActiveFilter gibt die Note aus, nach der gerade gefiltert wird, und greift als Klammerung genau dann, wenn überhaupt ein Filter gesetzt ist.
Der Weg zurück zu allen Bewertungen ist ein Link ohne Filter-Parameter, hier schlicht ~PR-Link~. Ohne diesen Ausstieg bleibt der Besucher in der gefilterten Ansicht gefangen, denn die Blätterlinks tragen den Filter immer mit.
Der Filter kommt aus dem URL-Parameter ws_ext_prodrating_filterByRating, die Seite aus ws_ext_prodrating_page. Beide brauchen Sie nur dann selbst, wenn Sie die Bewertungen per AJAX nachladen.

​
Die einzelnen Bewertungen

E-PRODRATING-EKOMI_FeedbackData ist zugleich die Prüfung auf vorhandene Bewertungen und die Schleife über die Bewertungen der aktuellen Seite.
Eine eKomi-Bewertung besteht immer aus einer Note, aber nicht immer aus einem Text. Die Klammerung um _Feedback hält leere Absätze aus der Liste heraus. E-PRODRATING-EKOMI_FeedbackData_Timestamp folgt dem Datumsformat, das für den jeweiligen Subshop eingestellt ist. In mehrsprachigen Shops stimmt die Schreibweise damit von selbst.

​
Datum und Uhrzeit in Einzelteilen

Wer das Datum selbst zusammensetzen möchte, bekommt jeden Bestandteil einzeln.
Ohne Parameter geben die Teil-Tags die Zahl ohne führende Null aus, also 7 für den siebten Tag. Der Parameter true füllt auf zwei Stellen auf und ergibt 07. Beim Jahr gibt es diese Auffüllung nicht, der Parameter bleibt dort wirkungslos. Als Klammerung vergleichen die Teil-Tags mit dem Parameter. {E-PRODRATING-EKOMI_FeedbackData_Timestamp_year(2026)} greift bei Bewertungen aus dem Jahr 2026, beispielsweise um ältere Stimmen zu kennzeichnen.
Ohne Parameter funktioniert die Klammerung der Teil-Tags nicht. {E-PRODRATING-EKOMI_FeedbackData_Timestamp_day} bleibt unaufgelöst in der Seite stehen.

​
Die Antwort des Händlers

Auf jede Bewertung können Sie bei eKomi antworten. Die Antwort wird mitimportiert und steht innerhalb der Bewertungsschleife bereit.
Die Zeit-Tags der Händlerantwort beginnen mit FeedbackData_, genau wie die der Bewertung. Die Teil-Tags verhalten sich ebenso: Parameter true füllt auf zwei Stellen auf, als Klammerung vergleichen sie mit dem Parameter.
Die Klammerung mit _Merchant_Answer ist Pflicht, denn die allermeisten Bewertungen haben keine Antwort. Ohne sie steht unter jeder zweiten Kundenstimme ein leerer Antwortkasten mit einem Datum aus dem Jahr 1970.

​
Übersetzte Bewertungen

Betreiben Sie den Shop mehrsprachig, kann WEBSALE V8s die eingehenden Bewertungen beim Import übersetzen lassen. Angezeigt wird dann die Übersetzung. Den ursprünglichen Wortlaut bekommen Sie ebenfalls.
Ein Hinweis auf die maschinelle Übersetzung gehört an die Bewertung. Eine übersetzte Kundenstimme unkommentiert als Originalzitat auszugeben, ist gegenüber dem Verfasser wie gegenüber dem Leser unsauber.
Werden die Bewertungen nicht übersetzt, sind Text und Original identisch und beide Sprachangaben gleich. Die Klammerung im Beispiel prüft deshalb auf die Sprache des Shops und blendet den Hinweis nur bei tatsächlich fremdsprachigen Bewertungen ein.

​
Blättern

Die Blätterfunktion arbeitet auf den Bewertungen, deren Seitengröße Sie mit E-PRODRATING-EKOMI_Count() festgelegt haben.
E-PRODRATING-EKOMI_Page und E-PRODRATING-EKOMI_PagingParam beziehen sich immer auf die Klammerung, in der sie stehen.
Außerhalb dieser Klammerungen sind beide Tags nicht verlässlich. Nach einem PagingBack- oder PagingNext-Block behalten sie sogar deren Wert bei, ein freistehendes ~E-PRODRATING-EKOMI_Page~ zeigt dort also die Nachbarseite statt der aktuellen. Schreiben Sie die aktuelle Seitenzahl daher nicht mit diesem Tag, sondern kennzeichnen Sie sie über die Lücke zwischen den beiden Schleifen.
Ohne Parameter oder bei einer unbrauchbaren Angabe rechnen alle vier Paging-Tags mit fünf Seiten. Setzen Sie in PagingBefore, PagingAfter, PagingMoreBefore und PagingMoreAfter denselben Wert, damit die Auslassungspunkte genau dann erscheinen, wenn die Leiste wirklich etwas auslässt. E-PRODRATING-EKOMI_PagingParam trägt einen aktiven Bewertungsfilter immer mit. Wer nach fünf Sternen gefiltert hat, bleibt beim Blättern in dieser Auswahl.

​
Bewertungen in Produktlisten

Auf Produktübersichts- und Suchergebnisseiten steht das eKomi-Template nicht zur Verfügung. Dort zeigen Sie die Bewertung mit den beiden Produkt-Tags, jeweils mit dem Parameter ekomi.
Ohne Parameter beziehen sich beide Tags auf die WEBSALE-eigene Produktbewertung. Der Parameter schaltet auf das externe Bewertungsmodul um. Referenz: PR-RatingVotes() · PR-AdvRatingScoreImg() · PR-Data

​
Die Tags im Überblick

​
Gesamtbewertung und Steuerung

​
Bewertungsbalken

​
Einzelne Bewertungen

<Teil> steht für day, month, year, hours, minutes oder seconds.

​
Blätterfunktion

Zulässig sind alle Tags dieser Seite ausschließlich im eKomi-Bewertungstemplate, das in der Shopkonfiguration shop.config im Abschnitt ExternalProductRating unterhalb von Ekomi beim Parameter Template eingetragen ist.

​
Verwandte Themen