Handbuch ekomimeetsmage

Handbuch ekomimeetsmage für Version 1.0.0, 1.1.0, 1.2.0, 1.3.0, 1.4.0 Handbuch Version 0.6 Zuletzt geändert 16.05.2013

Inhaltsverzeichnis 1 Einleitung...3 1.1 Voraussetzungen...3 1.2 Funktionsübersicht...3 2 Installation...3 2.1 Vorbereitung und Hinweise zur eigenhändigen Installation...4 2.2 Installation Testversion...4 2.2.1 Vorbereitung...4 2.2.2 Installation ioncube...4 2.2.3 Registrierung Test-Lizenz...5 2.2.4 Installation der Extension...5 2.2.5 Eintragung der Lizenz...6 2.3 Installation Kaufversion...6 3 Benutzung der Extension...7 3.1 Erste Konfiguration...7 3.1.1 Magento CronJob als Voraussetzung...8 3.1.2 ekomimeetsmage konfigurieren...8 3.2 ekomimeetsmage Lifecycle...11 3.3 ekomi Bestandskunden...12 3.4 Review Übersicht...12 3.5 Sendestatus...13 3.6 Frontend - Sichtbarkeit für den Kunden...14 (c) 2013 meets-ecommerce Online Agentur GmbH Seite 2 von 16

1 Einleitung In diesem Handbuch finden Sie eine Übersicht über die Installation und Funktionsweise von ekomimeetsmage. Wenn Sie zu einem bestimmten Thema keine Antworten in dieser Anleitung finden, schreiben Sie uns eine E-Mail support@meets-ecommerce.de. 1.1 Voraussetzungen LexMeetsMage hat folgende Voraussetzungen: PHP Version 5.3.x, 5.4.x Magento Commerce Community Edition 1.4.2, 1.5.x, 1.6.x, 1.7.x ekomi Account (ekomi.de) 1.2 Funktionsübersicht Funktion Automatischer Import Leichte Konfiguration Automatischer E-Mail Versand Beschreibung Alle Reviews werden automatisiert von ekomi in Ihr Magento importiert und den richtigen Produkten zu gewiesen. Über das Magento Admin Interface können Sie einfach und bequem Ihre ekomi Account Daten hinterlegen. Kunden die bei Ihnen bestellt haben, bekommen automatisiert eine E-Mail zur Bewertung Ihres Shop und Ihrer Produkte. Review Übersicht Sie können sich alle Review zu den Produkten in einer Übersicht anzeigen lassen und einfach aktivieren und deaktivieren. Wenn Sie weitere Funktionalitäten wünschen oder brauchen, schreiben Sie uns via E-Mail an support@meets-ecommerce.de. 2 Installation Die Installation von ekomimeetsmage ist nach dem Magento Standard aufgebaut. Dieses Kapitel beschreibt alle notwendigen Schritte zur Installation der Extension. (c) 2013 meets-ecommerce Online Agentur GmbH Seite 3 von 16

2.1 Vorbereitung und Hinweise zur eigenhändigen Installation Eigenständige Installation Warnung: für die eigenständige Installation von ekomimeetsmage übernimmt meets-ecommerce keinerlei Haftung. Wir empfehlen eindringlich die Installation auf einem Test Shop von Ihnen durchzuführen. Des Weiteren empfehlen wir bei der Übernahme in den Live Shop folgendes zu tun: Backup Ihrer Datenbank Backup Ihres kompletten Magento Ordners bzw. Systems Extension installieren 2.2 Installation Testversion Die Testversion erfordert einige Schritte mehr als die Installation der Kaufversion. Bitte folgenden Sie den Schritten in diesem Kapitel. 2.2.1 Vorbereitung Damit Sie unsere Extension testen können, benötigen Sie eine Testversion. Die Testversion können Sie auf der Produktseite von ekomimeetsmage herunterladen. Zu finden unter meets-ecommerce.de/extensions. 2.2.2 Installation ioncube ioncube ist notwendig, damit die Test-Extension einwandfrei läuft. ioncube dient meets-ecommerce zur Verschlüsslung des Source Codes der Extension und speichert generell keine weiteren Daten bzw. hat für Sie als Nutzer keine weiteren Nachteile. Die Nutzung von ioncube verschlüsselter Software setzt einen so genannten Loader voraus. Die Loader von ioncube sind für alle gängigen Systeme auf der ioncube Homepage 1 verfügbar. Die einfachste Art der Installation funktioniert über den Loader Wizard von ioncube selbst. Der Loader Wizard wird mit jedem Download von einem Loader selbst mitgeliefert (Loader Download, siehe Fußnote 2). 1 http://www.ioncube.com/loaders.php (c) 2013 meets-ecommerce Online Agentur GmbH Seite 4 von 16

Die selbstständige Installation oder durch uns durchgeführter Installation setzt die Zugriffsrechte in Ihren PHP bzw. Web Server Einstellungen voraus. Bitte erfragen Sie dies bei Ihrem Hoster. Gehen Sie mit dem Loader Wizard wie folgt vor: 1. Laden Sie den passenden Loader für Ihr Betriebssystem herunter (http://www.ioncube.com/loaders.php) 2. Entpacken Sie das Archiv 3. Kopieren Sie den loader-wizard.php in Ihr Web Verzeichnis 4. Rufen Sie die loader-wizard.php mit Ihrem Browser auf bspw. www.example.com/loader-wizard.php 5. Folgen Sie den Anweisungen in Anleitungen 6. Nach der Befolgung der Anleitung sollte alles funktionieren Falls Sie dennoch Probleme haben sollten, fragen Sie bei Ihrem Hoster an oder lassen Sie uns die Installation durchführen - fragen Sie uns via support@meetsecommerce.de - die Installation ist kostenpflichtig! 2.2.3 Registrierung Test-Lizenz Folgende Schritte sind notwendig, damit Sie eine Testversion registrieren können. 1. Erstellen Sie ein Nutzerkonto auf meets-ecommerce.de 2. Loggen Sie sich in Ihrem Nutzerkonto ein 3. Gehen Sie in Ihrem Nutzerkonto auf Lizenzen a. Sofern Sie noch keine Lizenz gekauft oder angelegt haben, erhalten Sie automatisch generierte Lizenzdaten, sobald Sie die erste Lizenz gekauft bzw. angelegt haben. Wenn das bereits geschehen ist, gehen Sie zu Schritt 4. 4. Wählen Sie die richtige Lizenz für das zu testende Produkt aus bspw. ekomimeetsmage v0.9.0 und speichern Sie dies 5. Jetzt sollten Sie oben Ihre Lizenz-Zugangsdaten sehen sowie unten Ihre erstellte Lizenz sehen (c) 2013 meets-ecommerce Online Agentur GmbH Seite 5 von 16

2.2.4 Installation der Extension Die Installation der Extension gestaltet sich sehr einfach. Folgen Sie bitte den folgenden Schritten: 1. Laden Sie sich die Extension herunter (die Test-Version auf der Produktdetailseite der jeweiligen Extension) 2. Entpacken Sie das Archiv 3. Kopieren Sie den gesamten Inhalt aus dem Ordner src/ in Ihren Magento Hauptordner 4. Loggen Sie sich in Ihr Magento Backend > dort sollten Sie den Punkt meetsecommerce sehen. Wenn nicht, löschen Sie den Cache und loggen sich neu ein. Achtung: Es kann auch dazu kommen, dass Sie eine weiße Seite sehen oder eine Fehlermeldung, dass ioncube nicht vorhanden ist. Dann haben Sie voraussichtlich einen Fehler bei der Installation von ioncube gemacht. Damit Sie das verifizieren können, sollten Sie noch mal den Loader (aus dem Kapitel Installation ioncube laden. 2.2.5 Eintragung der Lizenz Sofern Sie eine Lizenz erstellt haben müssen in Ihr Magento Backend gehen und diese eintragen, falls nicht gehen in das Kapitel Registrierung Test-Lizenz. Gehen dazu wie folgt vor: 1. Loggen Sie sich in Ihrem Magento Backend ein 2. Gehen Sie auf meets-ecommerce > Lizenz Magement 3. Tragen Sie ein a. Lizenz-Benutzer: E-Mail (im Nutzeraccount auf Lizenzen) b. Lizenz-Passwort: Passwort (im Nutzeraccount auf Lizenzen) 4. Oben rechts sehen Sie ein Button mit Lizenz-Account updaten 5. Betätigen Sie diesen, damit Ihre Extension mit dem Server verbunden wird 6. Sobald Sie erfolgreich verbunden wurden, bestätigt Ihnen das eine grün hinterlegte Nachricht. (c) 2013 meets-ecommerce Online Agentur GmbH Seite 6 von 16

7. Wenn Sie zu diesem Account eine Lizenz besitzen oder auch mehrere, sehen Ihre Lizenz Details 8. Jetzt können Sie Ihre Extension nutzen 2.3 Installation Kaufversion Die Installation der Extension gestaltet sich sehr einfach. Folgen Sie bitte den folgenden Schritten: 1. Laden Sie sich die Extension herunter (den Link zum Download finden Sie in Ihrem Nutzerkonto unter Downloads) 2. Entpacken Sie das Archiv 3. Kopieren Sie den gesamten Inhalt aus dem Ordner src/ in Ihren Magento Hauptordner 4. Loggen Sie sich in Ihr Magento Backend > dort sollten Sie den Punkt meetsecommerce sehen. Wenn nicht, löschen Sie den Cache und loggen sich neu ein. Information: den Cache können Sie im Magento Backend unter System -> Cache Management löschen bzw. invalidieren. 3 Benutzung der Extension Der Aufbau der Extension ist simpel. Sie finden alle nötigen Konfigurationsmasken in Ihrem Magento Backend unter meets-ecommerce > ekomimeetsmage (siehe Abbildung 1). Abbildung 1: Menüstruktur ekomimeetsmage Im Folgenden eine kurze Übersicht der einzelnen Menüpunkte. (c) 2013 meets-ecommerce Online Agentur GmbH Seite 7 von 16

Konfiguration In diesem Bereich müssen die API Daten für Ihren ekomi Account hinterlegen, sowie alle nötigen Informationen für den Sendeprozess der Bewertungsemails. Review Übersicht Alle importierten Kundenmeinungen von ekomi können Sie hier übersehen und wenn Sie möchten auch deaktivieren. Sendestatus Der Sendestatus zeigt Ihnen an, welche Kundenbefragungs-E-Mails bereits versendet worden sind bzw. welche ausstehen oder fehlgeschlagen sind. Weiterhin haben Sie die Möglichkeit fehlgeschlagene E-Mails noch mal zu versenden. 3.1 Erste Konfiguration ekomimeetsmage ist so konzipiert, dass alle notwendigen Daten automatisiert von ekomi nach Magento importiert werden. Damit diese Informationen einwandfrei in Ihr Magento geladen werden können, müssen Sie ein paar kurze Konfigurationen vornehmen. 3.1.1 Magento CronJob als Voraussetzung Als Grundbestandteil von ekomimeetsmage ist der Magento CronJob. Dieser muss zwingend installiert und konfiguriert sein. Die Konfiguration des Magento CronJobs für Ihr System entnehmen Sie bitte der folgenden Seite: http://www.magentocommerce.com/wiki/1_- _installation_and_configuration/how_to_setup_a_cron_job 3.1.2 ekomimeetsmage konfigurieren Als Voraussetzung der Nutzung von ekomimeetsmage ist ein ekomi Account zwingend erforderlich. Diesen können Sie auf http://www.ekomi.de bestellen, dieser ist kostenpflichtig! Bitte denken Sie daran die API Variante von ekomi zu beantragen. Bei Zweifeln, fragen Sie uns bitte support@meets-ecommerce.de Eingabe der API Daten Nach dem Sie den CronJob installiert haben und einen ekomi Account haben, müssen die API Daten bei Magento hinterlegen. (c) 2013 meets-ecommerce Online Agentur GmbH Seite 8 von 16

Gehen Sie dazu in Magento Backend unter meets-ecommerce > ekomimeetsmage > Konfiguration. Sobald Sie auf der Einrichtungsseite sind, wählen Sie bitte den ekomi Modus aus. Wählen Single Store aus. Single Store bedeutet, dass Sie für alle Stores in Ihrem Magento System ein ekomi Account verwenden (siehe auch Abbildung 2). Im Multi Store würden Sie pro Store in Magento ein ekomi Account benötigen. Abbildung 2: Wählen Sie den passenden ekomi Modus Information: Seit der Version 1.0.0 ist nun auch der Multi Store / Multi Account Betrieb verfügbar. Wenn Sie nun den passenden Modus ausgewählt haben, müssen Sie Ihre API Daten hinterlegen. Diese erhalten Sie von ekomi, im Normalfall finden Sie diese im ekomi Kundenbackend. Im Single Store Betrieb werden Ihnen direkt alle nötigen Felder angezeigt, die Sie zum Betrieb von ekomimeetsmage brauchen. Im Multi Store Betrieb müssen Sie zuvor den jeweiligen Store auswählen und dann die Daten eingeben (siehe Abbildung 3). Abbildung 3: Multi Store Betrieb Zunächst geben Sie bitte Ihre ekomi API ID sowie das dazugehörende ekomi API Passwort an (siehe Abbildung 4) Sobald alles eingetragen ist, klicken Sie bitte oben rechts auf Konfiguration speichern. Nach erfolgreicher Eingabe sehen Sie, dass der API Verbindungsstatus verifiziert ist und Sie sehen Ihre Account Details über der Eingabe Maske (siehe Abbildung 5). (c) 2013 meets-ecommerce Online Agentur GmbH Seite 9 von 16

Abbildung 4: API Daten hinterlegen Abbildung 5: ekomi Account Details Wenn Ihr Account verifiziert wurde können Sie noch die E-Mail Versandprozess Einstellungen vornehmen. Wenn Sie nichts angeben, wird der Standardprozess von ekomi genutzt. Um die Einstellungen vorzunehmen, gehen Sie wie folgt vor. Wählen Sie aus den folgenden E-Mail-Sendemodus Optionen: Option Senden deaktiviert Sende E-Mail wenn ekomi Tage erreicht Sende E-Mail wenn Bestellstatus valide Beschreibung Sie können einstellen, dass das E-Mails nicht automatisch versendet werden sollen. Im ekomi Backend können Sie einstellen, nach wie vielen Tagen nach einer Bestellung die E-Mail versendet werden soll. Diese wird hier genutzt. Wenn Sie nur bei einem bestimmten Bestellstatus versenden möchten, dann wählen Sie diese Option + den zugehörenden Bestellstatus. Sende E-Mail wenn ekomi Tage erreicht und Bestellstatus valide Dieser Modus ist ein Mix aus den beiden oberen, es wird erst dann eine E-Mail versendet, wenn der Bestellstatus und die Tage erreicht sind. Wenn eines nicht gegeben ist, wird die E-Mail nicht versendet. Jetzt nur noch über den oberen Button speichern und es kann los gehen. Im Zuge des ausführlichen Loggings von ekomimeetsmage kann es vorkommen, dass die Logging-Datei ekomimeetsmage.log schnell sehr groß werden kann. Aus diesem Grund kann seit Version 1.0.0 das Logging an und ausgeschaltet werden. (c) 2013 meets-ecommerce Online Agentur GmbH Seite 10 von 16

Abbildung 6: Logging aktivieren bzw. deaktivieren In Version 1.1.0 wurde Google Rich Snippets implementiert, damit eine noch bessere Darstellung der Bewertungen auch für Google möglich ist. Abbildung 7: ekomimeetsmage mit Google Rich Snippets Google Rich Snippets Support können Sie jederzeit aktivieren und deaktivieren in der Konfiguration. Abbildung 8: Google Rich Snippets Support Einstellungen Achtung: Dieses Feature funktioniert nur, wenn Sie unsere Standard Templates verwenden. Achten Sie darauf, dass Sie alles von dem Block MeetsEcommerce_Ekomimeetsmage_Block_Frontend_Product_Richsnippets korrekt übernehmen, wenn Sie die Templates bearbeiten. 3.2 ekomimeetsmage Lifecycle Bevor wir tiefer in die folgenden Kapitel einsteigen, möchten wir Ihnen hier erklären, wie ekomimeetsmage funktioniert bzw. wie der generelle Ablauf von der Bestellung bis hin zu der Rückführung in Ihr System ist. (c) 2013 meets-ecommerce Online Agentur GmbH Seite 11 von 16

Abbildung 9: Lifecycle ekomi und ekomimeetsmage Kunde bestellt in Ihrem Shop: Der Kunde bestellt in Ihrem Online-Shop, die Daten werden bei ekomimeetsmage gespeichert. ekomimeetsmage sendet Bewertungs-Link an Kunden: Der Bewertungs-Link wird von ekomimeetsmage bei ekomi angefordert und zum konfigurierten Zeitpunkt versendet. Kunden bewertet auf ekomi.de: Der Bewertungs-Link für den Kunden auf ekomi.de, wo er die Ware und den Shop bewertet. ekomi gibt Bewertung frei: ekomi gibt die Bewertung frei, bzw. bearbeitet diese. ekomimeetsmage importiert Bewertungen: Die Produktbewertungen werden von ekomi automatisch in Ihr System importiert. Kunde sieht Bewertung in Ihrem Shop: Ihre Kunden sehen dann die richtigen Bewertungen. 3.3 ekomi Bestandskunden Wenn Sie bereits seit längerem einen ekomi Account betreiben müssen Sie bei der Einführung von ekomimeetsmage beachten, dass das Matching, der Produktbewertungen bei ekomimeetsmage über die so genannte SKU bzw. Artikelnummer funktioniert. Warnung: Das bedeutet, dass ekomimeetsmage nur Produkte zu ordnen kann, die auch die korrekte SKU s bzw. Artikelnummern beinhalten. Wenn Sie nicht sicher sind, dann Fragen Sie bitte bei ekomi (www.ekomi.de) nach oder Ihren aktuellen Dienstleister. (c) 2013 meets-ecommerce Online Agentur GmbH Seite 12 von 16

Bei weiteren Fragen steht Ihnen natürlich auch unser Support unter support@meetsecommerce.de zur Verfügung. Wenn Änderungen an ekomimeetsmage nötig sind, wird meets-ecommerce kostenpflichtig unterstützend zur Seite stehen, fragen Sie bitte auch hier bei support@meets-ecommerce.de an für weitere Informationen. 3.4 Review Übersicht Als zentrale Stelle von ekomimeetsmage dient Ihnen die Review Übersicht. Dort finden Sie alle Kundenbewertungen und -meinungen zu all Ihren Produkten. Sie können dort Bewertungen zu Produkten suchen und auch Administrieren (de- und aktivieren) (siehe Abbildung 10). Zur Review Übersicht kommen Sie über meetsecommerce > ekomimeetsmage > Review Übersicht. Abbildung 10: Review Übersicht Wie auf Abbildung 8 zu sehen, können Sie hier alle Reviews einsehen und bei Bedarf auch sortieren nach Zeit, Status, Bewertung, Artikel und Kundenmeinungen. Klicken Sie hierzu einfach auf den Tabellennamen. Eine oder mehrere Bewertungen können Sie aktivieren bzw. deaktivieren in dem in der Tabelle die gewünschten Bewertungen anklicken und dann oben rechts auf Aktionen und dann Aktivieren bzw. Deaktivieren wählen und abschließend mit ausführen bestätigen. Siehe auch Abbildung 11. Abbildung 11: Bewertungen deaktivieren / aktivieren 3.5 Sendestatus Jeder Kunde der im Online Shop kauft, in dem ekomimeetsmage installiert und konfiguriert ist, bekommt nach einer bestimmten Zeit bzw. bei einem bestimmten (c) 2013 meets-ecommerce Online Agentur GmbH Seite 13 von 16

Bestellstatus eine E-Mail mit der Aufforderung bzw. Bitte eine Bewertungen abzugeben (siehe dazu auch 3.1.2). Information: Die Texte und die Zeit, wann der Kunde diese E-Mail bekommt, können Sie bequem in Ihrem ekomi Kundenbackend definieren. Die E-Mails werden automatisch durch den CronJob versendet. Oftmals ist es schwierig festzustellen ob E-Mails überhaupt rausgesendet wurden. Wir haben daher den Sendestatus implementiert, damit Sie sehen, welche E-Mails bereits raus sind, welche ausstehend und welche fehlgeschlagen sind. Siehe auch Abbildung 9). Seit der Version 1.0.0 wurde zusätzlich noch die Funktion implementiert, dass wenn eine Bestellung vor dem Versand der Anfrage storniert wurde (Magento intern canceled ), dann wird der Status ebenfalls auf canceled bzw. storniert gesetzt. Information: Seit der Version 1.0.0 können Sie E-Mails die beim Versand fehlgeschlagen sind über E-Mail nochmal senden erneut versenden. Abbildung 12: E-Mail Sende-Status Wie im Abbildung 12 zu sehen, haben Sie alle wichtigen Informationen auf einen Blick um immer auf dem Laufenden zu bleiben! Folgend die Bedeutung der Status: Option AUSSTEHEND ABGESCHLOSSEN FEHLGESCHLAGEN STORNIERT Beschreibung Die Anfrage an den Kunden wurde noch nicht versendet. Die Anfrage wurde bereits versendet. Der Versand der E-Mail ist aus technischen Gründen fehlgeschlagen. Die jeweilige Bestellung zu der E-Mail ist storniert und daher wird die Mail nicht versendet. (c) 2013 meets-ecommerce Online Agentur GmbH Seite 14 von 16

3.6 Frontend - Sichtbarkeit für den Kunden ekomimeetsmage ist eine Standard-Software und ist im Shop-Frontend nicht immer komplett auf Ihre Bedürfnisse angepasst. Aufgrund dessen haben wir für Sie ein Standard-Layout vorbereitet, dass auf dem Standard-Layout von Magento basiert. Siehe dazu Abbildung 13 und 14. Abbildung 13: ekomi Durchschnittbewertung unter dem Produktnamen (c) 2013 meets-ecommerce Online Agentur GmbH Seite 15 von 16

Abbildung 14: Detailbewertungen Damit Sie in der Lage sind, diese Layout selbstständig anzupassen bzw. anpassen zu lassen möchten wir Ihnen hier eine Übersicht der wichtigen Dateien für die Anpassungen von ekomimeetsmage im Frontend geben. magento/app/design/frontend/default/default/layout/ekomimeetsmage.xml Hier finden Sie die Layout-Einstellungen für das Frontend. magento/app/design/frontend/default/default/layout/template/ekomimeetsmage /product/name.phtml In dieser Datei befindet sich das HTML für die Darstellung unter dem Produktnamen (siehe auch Abbildung 10). magento/app/design/frontend/default/default/layout/template/ekomimeetsmage /product/feedback.phtml In dieser Datei befindet sich das HTML für die Darstellung der Detailbewertungen auf der Produktseite (siehe auch Abbildung 11). magento/skin/frontend/default/default/css/ekomimeetsmage/style.css Alle CSS Definition finden Sie in dieser Datei. Information: Wenn Sie selber nicht ekomimeetsmage anpassen möchten oder können, helfen wir Ihnen gerne weiter. Dieser Service ist allerdings kostenpflichtig und kommt ganz auf Ihre Anforderungen an. Fragen Sie doch einfach unter support@meets-ecommerce.de an. Angebote und Anfragen sind kostenlos und unverbindlich! (c) 2013 meets-ecommerce Online Agentur GmbH Seite 16 von 16