Zum Hauptinhalt springen
eKomi ist ein externer Bewertungsdienst. Die Bewertungen entstehen dort, werden dort moderiert und dort gespeichert. WEBSALE V8s holt sie ab und zeigt sie in Ihrem Shop an. Ekomi Bewertung Diese Arbeitsteilung ist der Kern der Sache und bestimmt, an wen Sie sich mit welcher Frage wenden. Alles, was das Zustandekommen einer Bewertung betrifft, klären Sie deshalb mit Ihrem Ansprechpartner bei eKomi, nicht mit WEBSALE.

Voraussetzungen

Beauftragung bei eKomi

Fragen Sie bei eKomi die Interface-ID und das zugehörige Passwort an. Betreiben Sie mehrere Sprachen oder Subshops, erhalten Sie unter Umständen mehrere Interface-IDs mit je eigenem Passwort.

Test-Bewertungen

Für den Aufbau der Anzeige brauchen Sie Bewertungen, sonst bleiben alle Bereiche leer und Sie sehen nicht, was Sie bauen. eKomi stellt Ihnen dafür Test-Bewertungen bereit und löscht sie nach Abschluss der Integration wieder.

Freischaltung bei WEBSALE

Beantragen Sie bei der WEBSALE AG die Freischaltung der eKomi-Produktbewertung und teilen Sie dabei die Interface-IDs und Passwörter mit, dazu für jede Interface-ID den Subshop, für den sie gelten soll. Die Zuordnung Interface-ID zu Subshop nimmt WEBSALE vor, nicht Sie. Sie steht in der Administrationskonfiguration, auf die Sie keinen Zugriff haben. Das ist auch der Grund, warum diese Angaben im Antrag vollständig sein müssen. Einem Subshop lassen sich mehrere Interface-IDs zuordnen. Genau das macht es möglich, Bewertungen aus dem Desktop-Shop im Mobile-Shop anzuzeigen und umgekehrt. Teilen Sie im Antrag mit, ob Sie eine solche Verknüpfung wünschen und für welche Subshops.

Warenwirtschaft

eKomi versendet die Bewertungs-E-Mails auf Basis Ihrer Bestelldaten. Ihr angeschlossenes ERP-System muss diese Daten an eKomi übergeben können. Klären Sie das vorab, denn ohne diese Übergabe entstehen keine Bewertungen und die schönste Anzeige bleibt leer.

Einrichtung auf der Produktdetailansicht

Die folgenden vier Schritte gelten für beide Varianten, mit und ohne AJAX. Was die AJAX-Variante zusätzlich braucht, steht im übernächsten Abschnitt.

Schritt 1: Die Shopkonfiguration ergänzen

Legen Sie in der shop.config den Abschnitt <ExternalProductRating> an, darin den Unterabschnitt <Ekomi>. Die Stelle innerhalb der Datei ist beliebig. Hinter Template tragen Sie den Namen des Templates ein, das die eKomi-Bewertungen anzeigt. Im Unterabschnitt <AdvancedProductRatingImages> ordnen Sie jedem Wertebereich eine Grafik zu, je Bereich ein <+Entry>.
Beachten Sie den letzten Eintrag: Er reicht bis 5.1, nicht bis 5.0. Die Skala von eKomi geht bis 5, und in den Produktlisten gilt die Obergrenze ausschließend. Ein Produkt mit der glatten Durchschnittsnote 5,0 fiele bei To-Value = 5.0 durch alle Bereiche und bekäme gar keine Grafik. Es träfe also ausgerechnet die bestbewerteten Produkte.
Legen Sie hier keinen Auffangeintrag mit einem weiten Bereich an, wie Sie ihn aus der WEBSALE Produktbewertung kennen. Im Bewertungstemplate des Moduls gilt der letzte passende Eintrag, nicht der erste. Ein Auffangeintrag am Ende würde dort jede andere Grafik verdrängen. Der Parameter Template darf nicht leer sein. Ohne ihn lässt sich das Modul nicht aufrufen. Referenz: Abschnitt ExternalProductRating

Schritt 2: Das Bewertungstemplate anlegen

Ekomi Bewertungsbalken Das Bewertungstemplate enthält die Tags und Klammerungen für die Anzeige der eKomi-Bewertungen. Über dieses Template gestalten Sie die Anzeige. Legen Sie es unter genau dem Namen an, den Sie in Schritt 1 hinter Template eingetragen haben, und speichern Sie es in Ihrem Templateverzeichnis, beispielsweise benutzer/templates/translation. Materialien: incl_prodrating_ekomi.htm Nehmen Sie die Vorlage aus den Materialien als Ausgangspunkt. Sie enthält die Tags und die Klassennamen für die Bewertungsbalken bereits in der richtigen Verschachtelung.

Schritt 3: Die Bewertungsbalken gestalten

Die Vorlage bringt die Klassennamen für die Bewertungsbalken mit, die Gestaltung selbst liegt bei Ihnen. Ergänzen Sie Ihre Styles-Datei um die folgenden Regeln.
Die Klasse rating_ekomi_graphic_line_0 gilt für Bewertungsstufen ohne eine einzige Stimme. Der Balken bleibt dort leer, und der Link führt ins Leere, weil es nichts zu filtern gibt. Deshalb ist er in diesen Regeln ausgegraut und nicht anklickbar gestaltet. Materialien: styles.css für die Bewertungsbalken

Schritt 4: Das Modul auf der Produktdetailansicht aufrufen

Ekomi Bewertung Produktliste WS-Module(rating_ekomi) lädt das in Schritt 1 eingetragene Template an die Stelle des Aufrufs. Die Stelle innerhalb von <body> ist frei wählbar.
Der Aufruf gehört in den <body>, nicht in den <head>. Das Modul liefert sichtbaren Seiteninhalt.
Referenz: WS-Module() Damit ist die Variante ohne AJAX fertig. Bei ihr wird beim Blättern oder Filtern die komplette Seite neu geladen.

Zusätzliche Schritte für die Variante mit AJAX

Mit AJAX wird beim Blättern und Filtern nur der Bewertungsbereich neu geladen, die übrige Seite bleibt stehen. Der Unterschied ist für den Käufer deutlich spürbar, sobald er mehrere Bewertungsseiten durchsieht. Die vier Schritte oben gelten unverändert. Dazu kommen die folgenden. Wegweiser: AJAX-Funktionen

Schritt A: System-Bibliothek und Design-Komponente einbinden

Prüfen Sie, ob die WEBSALE System-Bibliothek und Ihre WEBSALE Design-Komponente auf der Produktdetailansicht ws_product.htm eingebunden sind, und ergänzen Sie sie gegebenenfalls.
Materialien: WEBSALE JavaScript-Bibliothek

Schritt B: Die Design-Komponente erweitern

Fügen Sie die vier Funktionen in Ihre Design-Komponente ein. Sie sind die Anknüpfungspunkte für Ihre eigenen Effekte, beispielsweise für eine Ladeanzeige oder eine Fehlermeldung.
Die Schreibweise der Namen ist uneinheitlich: Die ersten beiden Funktionen beginnen mit ws_AJAX, die letzten beiden mit wsAJAX ohne Unterstrich. Übernehmen Sie die Namen genau so, sonst werden die Funktionen nicht gefunden und Sie suchen den Fehler an der falschen Stelle.
Legen Sie die vier Funktionen auch dann an, wenn Sie zunächst keine Effekte einbauen wollen. Sie bleiben dann leer, und Sie haben später einen fertigen Platz dafür.

Schritt C: Hinweisbereiche anlegen (optional)

Wenn Sie Meldungen anzeigen wollen, legen Sie dafür Bereiche auf der Produktdetailansicht an. Diese blenden Sie aus den Funktionen in Schritt B heraus ein und aus.
Blenden Sie diese Bereiche im Ausgangszustand per CSS aus und erst aus den Funktionen heraus ein. Sonst stehen beim Seitenaufruf alle drei Meldungen gleichzeitig da.

Schritt D: Den Anzeigebereich festlegen

Der nachzuladende Bereich braucht ein HTML-Element mit einer ID. Diese ID ist die Klammer zwischen Seite und AJAX-Template, sie muss an beiden Stellen gleich lauten.
Der Modulaufruf steht hier innerhalb des div. Das ist der Aufruf aus Schritt 4, nur jetzt mit dem umschließenden Element.

Schritt E: Das AJAX-Template anlegen

Legen Sie ein Template an, beispielsweise ws_ajax_ekomi.htm, und speichern Sie es in Ihrem Templateverzeichnis. Darin legen Sie einen AJAX-Bereich an, dessen Name sich aus WS-Ajax- und der ID aus Schritt D zusammensetzt. Innerhalb dieses Bereiches steht wiederum der Modulaufruf.
Der Name des Bereiches muss die ID aus Schritt D exakt enthalten, einschließlich Groß- und Kleinschreibung. Heißt das div product_rating_ekomi, heißt der Bereich WS-Ajax-product_rating_ekomi. Weicht eines der beiden ab, wird nichts nachgeladen und es erscheint auch keine Fehlermeldung.
Referenz: WS-Ajax-”ID” · WS-Module() Materialien: ws_ajax_eKomi.htm

Bewertungen in Produktlisten anzeigen

Auf der Produktübersichtsseite ws_category.htm, auf der Suchergebnisseite ws_search.htm und in anderen Produktlisten zeigen Sie die Bewertung direkt am Produkt an, ohne das Modul aufzurufen. Dafür gibt es eigene Tags, die Sie mit dem Parameter ekomi aufrufen. Die Tags gehören in die Schleife @PR-Data.
Die Klammerung {PR-RatingVotes(ekomi)} greift nur, wenn das Produkt mindestens eine Bewertung hat. Unbewertete Produkte bleiben damit ohne leere Sterne, und Sie brauchen keine zusätzliche Abfrage.
PR-AdvRatingScoreImg(ekomi) liefert den Dateinamen genau so, wie er in der Konfiguration steht, ohne das Bildverzeichnis davorzusetzen. Das ist der Unterschied zum Tag ohne Parameter. Tragen Sie in der Konfiguration deshalb einen Pfad ein, der von der Seite aus stimmt, oder ergänzen Sie den Pfad im Template vor dem Tag.PR-RatingScoreImg(ekomi) gibt es nicht. Für die Grafik zur eKomi-Note ist ausschließlich PR-AdvRatingScoreImg(ekomi) zuständig, und damit auch der Abschnitt <AdvancedProductRatingImages> aus Schritt 1.
Ohne Freischaltung durch die WEBSALE AG liefern alle diese Tags nichts, und die Klammerung bleibt leer. Wenn also im Template alles richtig steht und trotzdem nichts erscheint, prüfen Sie zuerst die Freischaltung. Referenz: PR-RatingVotes() · PR-RatingScore() · PR-AdvRatingScoreImg() · PR-Data

Bewertungen als Rich Snippet übergeben

Die eKomi-Bewertungen lassen sich über Mikrodaten an die Suchmaschinen übergeben. Damit erscheinen die Sterne in den Suchergebnissen und nicht erst auf Ihrer Seite. Wegweiser: Mikrodaten (Rich Snippets), Abschnitt Mikrodaten aus eKomi Produktbewertungen

Verwandte Themen