> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# E-PRODRATING-EKOMI_ (eKomi Produktbewertung)

> Die von eKomi importierten Produktbewertungen im Shop anzeigen: Gesamtnote, Bewertungsbalken, einzelne Kundenstimmen, Händlerantworten, Filter und Blätterfunktion.

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](https://dokumentation.websale.de/v8s/interaktive-funktionen/ekomi-produktbewertung.md) · Referenz: Abschnitt ExternalProductRating · Referenz: [WS-Module()](https://dokumentation.websale.de/v8s/referenz/tags/ws/shop-seite-und-technik.md)

> [!WARNING]
>
> 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.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
~E-PRODRATING-EKOMI_Count(15)~
```

> [!WARNING]
>
> `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

| Tag | Liefert |
| - | - |
| `E-PRODRATING-EKOMI_Score` | die Durchschnittsnote mit einer Nachkommastelle |
| `E-PRODRATING-EKOMI_ScoreImg` | die Adresse der passenden Bewertungsgrafik |
| `E-PRODRATING-EKOMI_Votes` | die Gesamtzahl der Bewertungen |
| `E-PRODRATING-EKOMI_PositiveVotes` | die Zahl der Bewertungen über 3 |
| `E-PRODRATING-EKOMI_PositivePercentage` | den Anteil der Bewertungen über 3 in Prozent |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{E-PRODRATING-EKOMI_Votes}
   <p class="bewertung_gesamt">
      <img src="~E-PRODRATING-EKOMI_ScoreImg~" alt="">
      ~E-PRODRATING-EKOMI_Score~ von 5 aus ~E-PRODRATING-EKOMI_Votes~ Bewertungen.
      ~E-PRODRATING-EKOMI_PositivePercentage~% davon waren positiv.
   </p>
{/E-PRODRATING-EKOMI_Votes}

{!E-PRODRATING-EKOMI_Votes}
   <p>Für dieses Produkt liegt noch keine Bewertung vor.</p>
{/!E-PRODRATING-EKOMI_Votes}
```

`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.

> [!WARNING]
>
> `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.

> [!WARNING]
>
> 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`.

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<ExternalProductRating>
  <Ekomi>
    Template = incl_prodrating_ekomi.htm
    <AdvancedProductRatingImages>
      <+Entry>
        From-Value = 0.0
        To-Value   = 1.0
        Image      = bewertung_1.png
      </+Entry>
      ...
      <+Entry>
        From-Value = 4.0
        To-Value   = 5.1
        Image      = bewertung_5.png
      </+Entry>
    </AdvancedProductRatingImages>
  </Ekomi>
</ExternalProductRating>
```

`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.

| Tag | Liefert |
| - | - |
| `E-PRODRATING-EKOMI_Rating` | die Notenstufe des aktuellen Durchlaufs |
| `E-PRODRATING-EKOMI_RatingVotes()` | die Zahl der Bewertungen mit dieser Note |
| `E-PRODRATING-EKOMI_RatingPercentage()` | den Anteil dieser Note in Prozent |
| `E-PRODRATING-EKOMI_RatingFilterParam()` | den Link-Parameter, der auf diese Note filtert |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@E-PRODRATING-EKOMI_Ratings}
   <div class="rating_ekomi_graphic_line">
      <div class="rating_ekomi_graphic_line_complete">
         <div class="rating_ekomi_graphic_line_filler"
              style="width:~E-PRODRATING-EKOMI_RatingPercentage~%"></div>
         <span class="rating_ekomi_graphic_score">~E-PRODRATING-EKOMI_RatingVotes~</span>
      </div>
      <a href="~PR-Link~&~E-PRODRATING-EKOMI_RatingFilterParam~">
         ~E-PRODRATING-EKOMI_Rating~ Sterne
      </a>
   </div>
{/@E-PRODRATING-EKOMI_Ratings}
```

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)~`.

> [!WARNING]
>
> `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.

> [!WARNING]
>
> `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.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{E-PRODRATING-EKOMI_ActiveFilter}
   <p>
      Es werden nur Bewertungen mit ~E-PRODRATING-EKOMI_ActiveFilter~ Sternen angezeigt.
      <a href="~PR-Link~">Alle Bewertungen anzeigen</a>
   </p>
{/E-PRODRATING-EKOMI_ActiveFilter}
```

> [!WARNING]
>
> 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.

| Tag | Liefert |
| - | - |
| `E-PRODRATING-EKOMI_FeedbackData_Feedback` | den Bewertungstext |
| `E-PRODRATING-EKOMI_FeedbackData_Rating` | die Note dieser Bewertung |
| `E-PRODRATING-EKOMI_FeedbackData_RatingImage` | die Bewertungsgrafik zu dieser Note |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp` | Datum und Uhrzeit der Abgabe |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{!E-PRODRATING-EKOMI_FeedbackData}
   <p>Zu diesem Produkt liegt noch keine Kundenstimme vor.</p>
{/!E-PRODRATING-EKOMI_FeedbackData}

{E-PRODRATING-EKOMI_FeedbackData}
   {@E-PRODRATING-EKOMI_FeedbackData}
      <article class="bewertung">
         <img src="~E-PRODRATING-EKOMI_FeedbackData_RatingImage~" alt="">
         <time>~E-PRODRATING-EKOMI_FeedbackData_Timestamp~</time>
         {E-PRODRATING-EKOMI_FeedbackData_Feedback}
            <p>~E-PRODRATING-EKOMI_FeedbackData_Feedback~</p>
         {/E-PRODRATING-EKOMI_FeedbackData_Feedback}
      </article>
   {/@E-PRODRATING-EKOMI_FeedbackData}
{/E-PRODRATING-EKOMI_FeedbackData}
```

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.

| Tag | Liefert |
| - | - |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_day` | den Tag |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_month` | den Monat |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_year` | das Jahr |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_hours` | die Stunde |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_minutes` | die Minute |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_seconds` | die Sekunde |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@E-PRODRATING-EKOMI_FeedbackData}
   Bewertet am
   ~E-PRODRATING-EKOMI_FeedbackData_Timestamp_day(true)~.~E-PRODRATING-EKOMI_FeedbackData_Timestamp_month(true)~.~E-PRODRATING-EKOMI_FeedbackData_Timestamp_year~
   um
   ~E-PRODRATING-EKOMI_FeedbackData_Timestamp_hours(true)~:~E-PRODRATING-EKOMI_FeedbackData_Timestamp_minutes(true)~ Uhr
{/@E-PRODRATING-EKOMI_FeedbackData}
```

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.

> [!WARNING]
>
> 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.

| Tag | Liefert |
| - | - |
| `E-PRODRATING-EKOMI_FeedbackData_Merchant_Answer` | den Text der Antwort |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_Merchant_Answer` | Datum und Uhrzeit der Antwort |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_Merchant_Answer_day` | den Tag der Antwort |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_Merchant_Answer_month` | den Monat der Antwort |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_Merchant_Answer_year` | das Jahr der Antwort |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_Merchant_Answer_hours` | die Stunde der Antwort |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_Merchant_Answer_minutes` | die Minute der Antwort |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_Merchant_Answer_seconds` | die Sekunde der Antwort |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@E-PRODRATING-EKOMI_FeedbackData}
   <p>~E-PRODRATING-EKOMI_FeedbackData_Feedback~</p>

   {E-PRODRATING-EKOMI_FeedbackData_Merchant_Answer}
      <aside class="haendlerantwort">
         <p>Unsere Antwort vom ~E-PRODRATING-EKOMI_FeedbackData_Timestamp_Merchant_Answer~</p>
         <p>~E-PRODRATING-EKOMI_FeedbackData_Merchant_Answer~</p>
      </aside>
   {/E-PRODRATING-EKOMI_FeedbackData_Merchant_Answer}
{/@E-PRODRATING-EKOMI_FeedbackData}
```

> [!WARNING]
>
> 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.

| Tag | Liefert |
| - | - |
| `E-PRODRATING-EKOMI_FeedbackData_FeedbackOrg` | den Bewertungstext im Original |
| `E-PRODRATING-EKOMI_FeedbackData_Merchant_AnswerOrg` | die Händlerantwort im Original |
| `E-PRODRATING-EKOMI_FeedbackData_Language` | die Sprache der angezeigten Fassung |
| `E-PRODRATING-EKOMI_FeedbackData_LanguageOrg` | die Sprache des Originals |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@E-PRODRATING-EKOMI_FeedbackData}
   <p>~E-PRODRATING-EKOMI_FeedbackData_Feedback~</p>

   {!E-PRODRATING-EKOMI_FeedbackData_LanguageOrg(deu)}
      <details class="uebersetzungshinweis">
         <summary>Automatisch aus dem Original übersetzt</summary>
         <p lang="~E-PRODRATING-EKOMI_FeedbackData_LanguageOrg~">
            ~E-PRODRATING-EKOMI_FeedbackData_FeedbackOrg~
         </p>
      </details>
   {/!E-PRODRATING-EKOMI_FeedbackData_LanguageOrg(deu)}
{/@E-PRODRATING-EKOMI_FeedbackData}
```

> [!WARNING]
>
> 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.

| Tag | Greift, wenn |
| - | - |
| `E-PRODRATING-EKOMI_Paging` | es überhaupt mehr als eine Seite gibt |
| `E-PRODRATING-EKOMI_PagingBack` | eine Seite zurück möglich ist |
| `E-PRODRATING-EKOMI_PagingNext` | eine Seite vor möglich ist |
| `E-PRODRATING-EKOMI_PagingFirst` | die aktuelle Seite nicht die erste ist |
| `E-PRODRATING-EKOMI_PagingLast` | die aktuelle Seite nicht die letzte ist |
| `E-PRODRATING-EKOMI_PagingBefore()` | Schleife über die x Seiten davor |
| `E-PRODRATING-EKOMI_PagingAfter()` | Schleife über die x Seiten danach |
| `E-PRODRATING-EKOMI_PagingMoreBefore()` | davor noch weitere Seiten liegen |
| `E-PRODRATING-EKOMI_PagingMoreAfter()` | danach noch weitere Seiten liegen |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{E-PRODRATING-EKOMI_Paging}
   <nav class="blaettern">
      {E-PRODRATING-EKOMI_PagingBack}
         <a href="~PR-Link~&~E-PRODRATING-EKOMI_PagingParam~">zurück</a>
      {/E-PRODRATING-EKOMI_PagingBack}

      {E-PRODRATING-EKOMI_PagingMoreBefore(2)}
         {E-PRODRATING-EKOMI_PagingFirst}
            <a href="~PR-Link~&~E-PRODRATING-EKOMI_PagingParam~">~E-PRODRATING-EKOMI_Page~</a>
         {/E-PRODRATING-EKOMI_PagingFirst}
         …
      {/E-PRODRATING-EKOMI_PagingMoreBefore(2)}

      {@E-PRODRATING-EKOMI_PagingBefore(2)}
         <a href="~PR-Link~&~E-PRODRATING-EKOMI_PagingParam~">~E-PRODRATING-EKOMI_Page~</a>
      {/@E-PRODRATING-EKOMI_PagingBefore(2)}

      {@E-PRODRATING-EKOMI_PagingAfter(2)}
         <a href="~PR-Link~&~E-PRODRATING-EKOMI_PagingParam~">~E-PRODRATING-EKOMI_Page~</a>
      {/@E-PRODRATING-EKOMI_PagingAfter(2)}

      {E-PRODRATING-EKOMI_PagingMoreAfter(2)}
         …
         {E-PRODRATING-EKOMI_PagingLast}
            <a href="~PR-Link~&~E-PRODRATING-EKOMI_PagingParam~">~E-PRODRATING-EKOMI_Page~</a>
         {/E-PRODRATING-EKOMI_PagingLast}
      {/E-PRODRATING-EKOMI_PagingMoreAfter(2)}

      {E-PRODRATING-EKOMI_PagingNext}
         <a href="~PR-Link~&~E-PRODRATING-EKOMI_PagingParam~">weiter</a>
      {/E-PRODRATING-EKOMI_PagingNext}
   </nav>
{/E-PRODRATING-EKOMI_Paging}
```

`E-PRODRATING-EKOMI_Page` und `E-PRODRATING-EKOMI_PagingParam` beziehen sich immer auf die Klammerung, in der sie stehen.

| Umgebung | `Page` und `PagingParam` meinen |
| - | - |
| `PagingBack` | die vorherige Seite |
| `PagingNext` | die nächste Seite |
| `PagingFirst` | die erste Seite |
| `PagingLast` | die letzte Seite |
| `PagingBefore()` und `PagingAfter()` | die Seite des laufenden Durchlaufs |

> [!WARNING]
>
> 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`.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@PR-Data}
   {PR-RatingVotes(ekomi)}
      <img src="~PR-AdvRatingScoreImg(ekomi)~" alt="">
      ~PR-RatingVotes(ekomi)~ Bewertungen
   {/PR-RatingVotes(ekomi)}
{/@PR-Data}
```

Ohne Parameter beziehen sich beide Tags auf die WEBSALE-eigene Produktbewertung. Der Parameter schaltet auf das externe Bewertungsmodul um.

Referenz: [PR-RatingVotes()](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md) · [PR-AdvRatingScoreImg()](https://dokumentation.websale.de/v8s/referenz/tags/e-prodrating-ekomi.md#die-bewertungsgrafiken) · [PR-Data](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md#die-tags-im-uberblick)

## Die Tags im Überblick

### Gesamtbewertung und Steuerung

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `E-PRODRATING-EKOMI_Count()` | ja | – | – | – |
| `E-PRODRATING-EKOMI_Score` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_ScoreImg` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_Votes` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_PositiveVotes` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_PositivePercentage` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_ActiveFilter` | ja | ja | ja | – |

### Bewertungsbalken

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `E-PRODRATING-EKOMI_Ratings` | – | – | – | ja |
| `E-PRODRATING-EKOMI_Rating` | ja | – | – | – |
| `E-PRODRATING-EKOMI_RatingVotes()` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_RatingPercentage()` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_RatingFilterParam()` | ja | – | – | – |

### Einzelne Bewertungen

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `E-PRODRATING-EKOMI_FeedbackData` | – | ja | ja | ja |
| `E-PRODRATING-EKOMI_FeedbackData_Feedback` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_FeedbackData_FeedbackOrg` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_FeedbackData_Rating` | ja | – | – | – |
| `E-PRODRATING-EKOMI_FeedbackData_RatingImage` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_FeedbackData_Merchant_Answer` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_FeedbackData_Merchant_AnswerOrg` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_FeedbackData_Language` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_FeedbackData_LanguageOrg` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_<Teil>` | ja | nur mit Parameter | nur mit Parameter | – |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_Merchant_Answer` | ja | ja | ja | – |
| `E-PRODRATING-EKOMI_FeedbackData_Timestamp_Merchant_Answer_<Teil>` | ja | nur mit Parameter | nur mit Parameter | – |

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

### Blätterfunktion

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `E-PRODRATING-EKOMI_Paging` | – | ja | ja | – |
| `E-PRODRATING-EKOMI_Page` | ja | – | – | – |
| `E-PRODRATING-EKOMI_PagingParam` | ja | – | – | – |
| `E-PRODRATING-EKOMI_PagingBack` | – | ja | ja | – |
| `E-PRODRATING-EKOMI_PagingNext` | – | ja | ja | – |
| `E-PRODRATING-EKOMI_PagingFirst` | – | ja | ja | – |
| `E-PRODRATING-EKOMI_PagingLast` | – | ja | ja | – |
| `E-PRODRATING-EKOMI_PagingMoreBefore()` | – | ja | ja | – |
| `E-PRODRATING-EKOMI_PagingMoreAfter()` | – | ja | ja | – |
| `E-PRODRATING-EKOMI_PagingBefore()` | – | – | – | ja |
| `E-PRODRATING-EKOMI_PagingAfter()` | – | – | – | ja |

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

* Wegweiser: [eKomi Produktbewertung](https://dokumentation.websale.de/v8s/interaktive-funktionen/ekomi-produktbewertung.md)
* Wegweiser: [Bewertungen beim Produkt anzeigen](https://dokumentation.websale.de/v8s/websale-produktbewertung/bewertungen-beim-produkt-anzeigen.md)
* Wegweiser: Mikrodaten aus eKomi Produktbewertungen
* Wegweiser: [AJAX-Funktionen](https://dokumentation.websale.de/v8s/templates/ajax-funktionen.md)
* Referenz: [Abschnitt ExternalProductRating](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/produkte-katalog-und-suche.md#externalproductrating)


## Related topics

- [Materialien eKomi Produktbewertung](https://dokumentation.websale.de/v8s/materialien/materialien-ekomi-produktbewertung.md)
- [eKomi Produktbewertung](https://dokumentation.websale.de/v8s/interaktive-funktionen/ekomi-produktbewertung.md)
- [Strukturierte Daten und Rich Snippets](https://dokumentation.websale.de/v8s/seo/strukturierte-daten-rich-snippets.md)
- [Produkte, Katalog und Suche](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/produkte-katalog-und-suche.md)
- [Produktlisten sortieren](https://dokumentation.websale.de/v8s/funktionen-fuer-produktlisten/produktlisten-sortieren.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.