Produktbewertungs-Modul konfigurieren

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.

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.

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.

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

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

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.

<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 · Abschnitt AdvancedProductRatingImages

Wegweiser

Produktbewertungs-Modul konfigurieren

Wo die Datei liegt

Was in der `prodrating.config` steht

Grundverhalten

Fehlermeldungen

Sortierung

Die vier Mails

Was in der `shop.config` steht

Verwandte Themen

​Wo die Datei liegt

​Was in der prodrating.config steht

​Grundverhalten

​Fehlermeldungen

​Sortierung

​Die vier Mails

​Was in der shop.config steht

​Verwandte Themen

Wo die Datei liegt

Was in der `prodrating.config` steht

Grundverhalten

Fehlermeldungen

Sortierung

Die vier Mails

Was in der `shop.config` steht

Verwandte Themen