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

# Produktbewertungs-Modul konfigurieren

> Wo die prodrating.config liegt, in welcher Reihenfolge der Shop danach sucht, welche Abschnitte sie enthält und welche Einstellungen stattdessen in der shop.config stehen.

Das Produktbewertungs-Modul bringt eine eigene Konfigurationsdatei mit. Sie heißt `prodrating.config` und steht neben der `shop.config`, nicht in ihr.

Das hat eine praktische Folge: Die Einstellungen der Produktbewertung sind an zwei Orten verteilt. Die Texte, die Mails und das Verhalten stehen in der `prodrating.config`, die Bewertungsgrafiken dagegen in der `shop.config`.

## Wo die Datei liegt

Die Datei liegt im Verzeichnis `konfiguration`, entweder für alle Subshops gemeinsam oder je Subshop in einem eigenen Unterverzeichnis.

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
konfiguration/
   prodrating.config              ← gilt für alle Subshops
   <SubshopID>/
      prodrating.config           ← gilt nur für diesen Subshop
```

Der Shop sucht in dieser Reihenfolge und nimmt die erste Datei, die er findet:

| Reihenfolge | Pfad |
| - | - |
| 1 | `konfiguration/<SubshopID>/prodrating.config` |
| 2 | `konfiguration/<SubshopID>/prodrating.ini` |
| 3 | `konfiguration/prodrating.config` |
| 4 | `konfiguration/prodrating.ini` |

Die Endung `.ini` ist die ältere Schreibweise und wird weiterhin gelesen. Legen Sie neue Dateien als `.config` an.

> [!WARNING]
>
> Eine subshop-eigene Datei **ersetzt** die gemeinsame vollständig, sie ergänzt sie nicht. Sobald für einen Subshop eine eigene `prodrating.config` existiert, wird die gemeinsame für diesen Subshop gar nicht mehr gelesen. Alles, was gelten soll, muss dann auch in der subshop-eigenen Datei stehen.
>
> Findet der Shop keine der vier Dateien, startet das Modul nicht und bricht mit einem Fehler ab. Dasselbe passiert, wenn der Abschnitt `NotifyMessages-Txt` fehlt.

## Was in der `prodrating.config` steht

| Abschnitt | Inhalt | Pflicht |
| - | - | - |
| `basic` | Grundverhalten, unter anderem die Bestätigung per E-Mail | nein |
| `NotifyMessages-Txt` | alle Fehlermeldungen des Moduls | **ja** |
| `Sort` | die Sortiermöglichkeiten der Bewertungsliste | nein |
| `FreeMessages-Txt` | frei definierbare Texte | nein |
| `ThankYouMail` | die Dankesmail nach einer Bewertung | nein |
| `ConfirmMail` | die Mail mit dem Bestätigungslink | nein |
| `SendNicknameMail` | die Mail mit dem vergessenen Spitznamen | nein |
| `NotifyNewRatingMail` | die Benachrichtigung an Sie bei einer neuen Bewertung | nein |

### Grundverhalten

Im Abschnitt `basic` legen Sie unter anderem fest, ob eine Bewertung vom Verfasser per E-Mail bestätigt werden muss und wie die angegebene Adresse geprüft wird. Ohne diesen Abschnitt arbeitet das Modul ohne Bestätigung und prüft die Adresse auf der Ebene der Domain.

### Fehlermeldungen

`NotifyMessages-Txt` ist der einzige Pflichtabschnitt. Er enthält einen allgemeinen Eintrag `Error` und darüber hinaus für jede erkannte Fehlersituation einen eigenen Eintrag.

Die Meldungen werden im Template über `PRODRATING-InputError` und `PRODRATING-InputErrorList` ausgegeben. Die Liste enthält alle Fehler, die auf die aktuelle Eingabe zutreffen, nicht nur den ersten.

### Sortierung

Im Abschnitt `Sort` legen Sie fest, welche Sortiermöglichkeiten der Besucher in der Bewertungsliste angeboten bekommt und wie sie heißen.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Sort>
   *DateNew = Neueste zuerst
   DateOld  = Älteste zuerst
   RatingDesc = Beste Bewertung zuerst
</Sort>
```

Ein vorangestellter Stern markiert die Voreinstellung. Genau ein Eintrag sollte ihn tragen. Der Name links vom Gleichheitszeichen ist fest vorgegeben, nur der Text rechts davon ist frei.

### Die vier Mails

Alle vier Mail-Abschnitte haben denselben Aufbau.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<ThankYouMail>
   Allow         = yes
   Subject-Txt   = Vielen Dank für Ihre Bewertung
   SenderAddress = shop@ihr-shop.de
   SenderName    = Ihr Shop
   Template      = mail_prodrating_thankyou.htm
   Charset       = UTF-8
</ThankYouMail>
```

| Parameter | Bedeutung |
| - | - |
| `Allow` | nur bei `ThankYouMail`: `yes` schaltet die Mail ein |
| `Subject-Txt` | der Betreff |
| `SenderAddress` | die Absenderadresse |
| `SenderName` | der angezeigte Absendername |
| `Template` | das Template des Mailinhalts |
| `Charset` | die Zeichenkodierung. Voreinstellung ist `ISO-8859-1` |

> [!WARNING]
>
> Bei den drei Abschnitten `ConfirmMail`, `SendNicknameMail` und `NotifyNewRatingMail` gibt es **kein** `Allow`. Allein das Vorhandensein des Abschnitts schaltet die Mail ein. Wenn Sie eine davon abschalten wollen, entfernen oder kommentieren Sie den ganzen Abschnitt. Nur `ThankYouMail` hat einen eigenen Schalter.
>
> Die Voreinstellung für `Charset` ist `ISO-8859-1`. Wenn Ihr Shop und Ihre Templates in UTF-8 arbeiten, setzen Sie den Wert in allen vier Abschnitten ausdrücklich, sonst kommen Umlaute in den Mails verstümmelt an.

Referenz: Konfiguration prodrating.config

## Was in der `shop.config` steht

Die Grafiken für die Bewertungspunkte liest das Modul nicht aus seiner eigenen Datei, sondern aus der `shop.config`.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<ProductRatingImages>
   Point1  = rating_1.png
   Point2  = rating_2.png
   Point3  = rating_3.png
   Point4  = rating_4.png
   Point5  = rating_5.png
   Point6  = rating_6.png
   Point7  = rating_7.png
   Point8  = rating_8.png
   Point9  = rating_9.png
   Point10 = rating_10.png
   back    = pfeil_zurueck.png
   next    = pfeil_weiter.png
</ProductRatingImages>
```

Es sind zehn Punktegrafiken, denn die Skala reicht von 1 bis 10. Wenn Sie nur fünf Stufen anbieten wollen, hinterlegen Sie im Eingabetemplate auch nur fünf Auswahlmöglichkeiten. Die mitgelieferten Beispiel-Templates tun genau das.

`back` und `next` sind die Grafiken der Blätterfunktion in der Bewertungsliste.

Zusätzlich gibt es den Abschnitt `<AdvancedProductRatingImages>` für eine feiner abgestufte Darstellung, beispielsweise mit halben Sternen.

Referenz: [Abschnitt ProductRatingImages](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/produkte-katalog-und-suche.md#productratingimages) · [Abschnitt AdvancedProductRatingImages](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/produkte-katalog-und-suche.md#advancedproductratingimages)

## Verwandte Themen

* Wegweiser: [Beschreibung des Produktbewertungs-Moduls](https://dokumentation.websale.de/v8s/websale-produktbewertung/beschreibung-des-produktbewertungs-moduls.md)
* Wegweiser: [Bewertungen beim Produkt anzeigen](https://dokumentation.websale.de/v8s/websale-produktbewertung/bewertungen-beim-produkt-anzeigen.md)
* Wegweiser: [Bewertungserinnerungen per E-Mail versenden](https://dokumentation.websale.de/v8s/websale-produktbewertung/bewertungserinnerungen-per-e-mail-versenden.md)
* Wegweiser: [Produkte nach Bewertung sortieren und filtern](https://dokumentation.websale.de/v8s/websale-produktbewertung/produkte-nach-bewertung-sortieren-und-filtern.md)
* Konfiguration: Templates für die Produktbewertung, auch für das Ändern des Spitznamens


## Related topics

- [Beschreibung des Produktbewertungs-Moduls](https://dokumentation.websale.de/v8s/websale-produktbewertung/beschreibung-des-produktbewertungs-moduls.md)
- [Materialien Produktbewertung](https://dokumentation.websale.de/v8s/materialien/materialien-produktbewertung.md)
- [Bewertungserinnerungen per E-Mail versenden](https://dokumentation.websale.de/v8s/websale-produktbewertung/bewertungserinnerungen-per-e-mail-versenden.md)
- [PRODRATING- (Bewertung abgeben und bestätigen)](https://dokumentation.websale.de/v8s/referenz/tags/prodrating/bewertung-abgeben-und-bestaetigen.md)
- [Bewertungen subshopübergreifend verwenden](https://dokumentation.websale.de/v8s/websale-produktbewertung/bewertungen-subshopuebergreifend-verwenden.md)


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