Handbuch LexMeetsMage CE

Transkript

1 Handbuch LexMeetsMage CE für Version Handbuch Version 0.2 Zuletzt geändert

2 Inhaltsverzeichnis 1 Einleitung Voraussetzungen Funktionsübersicht Installation Vorbereitung / eigenständige Installation Installation ioncube Loader Lizenz erstellen und eintragen Installation Extension Benutzung der Extension Aufbau der Extension Lizenzverwaltung Katalogimport Bestellexport (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 2 von 18

3 1 Einleitung In diesem Handbuch finden Sie eine Übersicht über die Installation und Funktionsweise von LexMeetsMage CE sowie eine kurze Anleitung über die Lizensierung bei meets-ecommerce.de. Wenn Sie zu einem bestimmten Thema keine Antworten in dieser Anleitung finden, schreiben Sie uns eine 1.1 Voraussetzungen LexMeetsMage hat folgende Voraussetzungen: PHP Version 5.3.x Magento Commerce Community Edition 1.5.x, 1.6.x ioncube Loader ( Lexware Produkte mit ebusiness Schnittstelle Aus Sicht von Lexware muss die ebusiness Schnittstelle vorhanden sein. 1.2 Funktionsübersicht LexMeetsMage CE besitzt zwei Grundfunktionalitäten: Bestellexport Export von Bestellungen Export in XML Format Artikelimport Import aus Lexware Artikel Export Simple Product Import bzw. Abgleich Multishop-fähig Bilder können mit importiert werden 1 Automatische Erkennung der MwSt. Verschiedene Zahlungsarten konfigurierbar Kategorie Import bzw. Abgleich Eingeschränkt Multishop-fähig Wenn Sie weitere Funktionalitäten wünschen oder brauchen, schreiben Sie uns via an support@meets-ecommerce.de. 1 Der Bilder Import verlangsamt die Geschwindigkeit, daher sollte man eventuell vorher testen und die PHP Einstellungen dahingehend optimieren. (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 3 von 18

4 2 Installation Die Installation von LexMeetsMage ist gesplittet in zwei Schritte: erstens die Installation der Extension selbst und zweitens die Erstellung einer Lizenz. 2.1 Vorbereitung / eigenständige Installation Eigenständige Installation Warnung: für die eigenständige Installation von LexMeetsMage CE übernimmt meets-ecommerce keinerlei Haftung. Wir empfehlen 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 Extension installieren Lizenz Daten hinterlegen 2.2 Installation ioncube Loader ioncube ist notwendig, damit die Extension einwandfrei läuft. ioncube dient meetsecommerce 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 2 verfügbar. Die einfachste Art der Installation funktioniert über den Loader Wizard von ioncube selbst. Der Loader Wizard wird zum einem mit unserem Download mitgeliefert und zum anderen mit jedem Download von einem Loader selbst (Loader Download, siehe Fußnote 2). 2 (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 4 von 18

5 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 ( 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 Folgen Sie den Anweisungen in Anleitungen 6. Nach der Befolgung der Anleitung sollte alles funktionieren Gehen Sie ohne den Loader Wizard wie folgt vor: 1. Laden Sie den passenden Loader für Ihr Betriebssystem herunter ( 2. Entpacken Sie das Archiv 3. Kopieren Sie die korrekte *.so Datei in einen Ordner in Ihrer Wahl bspw. in /usr/lib/php5/ / 4. Erweitern Sie Ihre php.ini mit folgenden Eintrag zend_extension = /usr/lib/php5/ /*.so 3 5. Starten Sie Ihren Web Server neu 6. Jetzt sollte alles funktionieren Die zweite Variante bedeutet am Ende viel Testing und daher empfehlen wir immer nach der ersten Variante vorzugehen. 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@meets-ecommerce.de - die Installation ist kostenpflichtig. 3 * steht für die den Loader Namen bspw. ioncube_loader_lin_5.3.so (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 5 von 18

6 2.3 Lizenz erstellen und eintragen Zu jedem unserer Produkte benötigen Sie eine Lizenz. Die Lizenzen von meetsecommerce werden online geprüft, sodass auch Ihre Installation eine ständige Online Verbindung benötigt. meets-ecommerce verspricht jedem Nutzer, dass keinerlei Kundendaten oder Nutzungsdaten übertragen werden. Die Daten, die übertragen werden, dienen nur der Validierung Ihrer Lizenz. Ebenfalls sind alle Übertragungen verschlüsselt. Jedes Produkt von meets-ecommerce kann 14 Tage getestet werden und anschließend bei Bedarf gekauft werden - eine Testlizenz wird bei Kauf automatisch in eine gekaufte Lizenz umgewandelt werden. Erstellung einer Testlizenz 1. Erstellen Sie Nutzerkonto auf meets-ecommerce.de 2. Login 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 Wählen Sie die richtige Lizenz für das zu testende Produkt aus bspw. LexMeetsMage v0.1.0 und speichern Sie dies 5. Jetzt sollten Sie oben Ihre Lizenz-Zugangsdaten sehen und unten Ihre erstellte Lizenz sehen Erstellung einer gekauften Lizenz 1. Gehen Sie auf meets-ecommerce.de 2. Gehen Sie auf das Produkt, was Sie erwerben möchten 3. Legen Sie dieses in Ihren Warenkorb 4. Gehen Sie in Ihrem Warenkorb auf zur Kasse 5. Führen Sie den Kaufprozess durch 6. Bestätigen Sie alles nötige und schließen den Kauf ab 7. Nach Abschluss des Kaufes gehen Sie in Ihr Benutzerkonto und dort auf Lizenzen (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 6 von 18

7 8. Dort sehen Sie Ihre Lizenz und Ihre Login Daten für den Lizenz Server Bereits zuvor erstellte Testlizenzen werden in gekaufte Lizenzen umgewandelt, daher müssen Ihre Daten in Ihrem Magento Backend nicht ändern. Eintragung Ihrer Lizenz in der Extension Sofern Sie eine Lizenz erstell haben (ob gekauft oder zum Testen), müssen in Ihr Magento Backend gehen. Gehen dazu wie folgt vor: 1. Loggen Sie sich in Ihrem Magento Backend ein 2. Gehen Sie auf LexMeetsMage CE > Lizenzverwaltung 3. Trage Sie ein a. Lizenz Benutzer: (im Nutzeraccount auf Lizenzen) b. Lizenz Passwort: Passwort (im Nutzeraccount auf Lizenzen) 4. Oben rechts sehen Sie ein Button mit Lizenz Daten updaten 5. Betätigen Sie diesen, damit Ihre Extension mit dem Server verbunden wird 6. Sobald Sie erfolgreich verbunden sind, sehen unter Verbindungsüberprüfung folgende Nachricht: Sie sind erfolgreich mit dem Lizenz Server verbunden. 7. Wenn Sie zu diesem Account eine Lizenz besitzen oder auch mehrere, sehen Ihre Lizenz Details 8. Jetzt können Sie Ihre Extension nutzen Mehr zur Oberfläche zum Lizenz Management unter 3.2 Lizenzverwaltung. 2.4 Installation Extension Die Installation der Extension gestaltet sich sehr einfach. Folgen Sie bitte den folgenden Schritten: 1. Laden Sie sich die Extension herunter (in Nutzerkonto 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 LexMeetsMage CE sehen. Wenn nicht, löschen Sie den Cache und loggen sich neu ein. (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 7 von 18

8 3 Benutzung der Extension Hier finden Sie alle Details zur Nutzung der Extension. 3.1 Aufbau der Extension Der allgemeine Aufbau ist sehr simpel. Sie finden in dem Hauptmenübalken alle wichtigen Punkte der Extension (siehe Abbildung 1). Abbildung 1: Menüaufbau LexMeetsMage Lizenzverwaltung Hier können Sie Ihre Lizenz Daten verwalten und haben einen Überblick über Ihre aktuellen Lizenzen. Katalogimport Der Katalogimport wird dazu genutzt die exportierte XML Datei aus Lexware zu verarbeiten. Des Weiteren sehen Sie die Historieneinträge Ihrer letzten Importe. Bestellexport In dieser Sektion können Sie die Bestellungen exportieren, die durch Ihre Kunden getätigt wurden. Des Weiteren sehen Sie hier Historieneinträge über Ihre letzten Exporte. (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 8 von 18

9 3.2 Lizenzverwaltung Die Lizenzverwaltung ist unterteilt in zwei Teile: 1. Lizenz Server Daten Hier hinterlegen Sie Ihre Lizenz Account Daten und können prüfen ob Sie eine Verbindung zum Lizenz Server haben. 2. Ihre gekauften Lizenz Hier sehen Sie alle Ihre gekauften Lizenzen und deren Details. Abbildung 2: Lizenzverwaltung bevor Daten hinterlegt sind Lizenzdaten eintragen In dem Bereich Lizenz Server Daten müssen Sie Ihre Lizenz Daten hinterlegen. Um dies zu tun, gehen Sie bitte wie folgt vor: 1. Tragen Sie die ein in dem Feld Lizenz Benutzer 2. Tragen Sie das Passwort in dem Feld Lizenz Passwort ein 3. Speichern Sie die Daten in dem Sie auf Lizenz Daten updaten oben rechts drücken. Die Daten wurden zuvor bei der Lizenzerstellung generiert. Abbildung 3: Nach erfolgreicher Verbindung zum Lizenz Server (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 9 von 18

10 Lizenzdetails Wenn Sie erfolgreich mit dem Lizenz Server verbunden sind, dann sehen Sie die Details Ihrer Lizenzen bzw. Lizenz siehe Abbildung 4 und Abbildung 5. Abbildung 4: Lizenzdetails von einer gekauften Lizenz Abbildung 5: Lizenzdetails einer abgelaufenen Lizenz Wenn Ihre Lizenz bereits abgelaufen ist, wie in Abbildung 5 zu sehen, dann haben Sie nur die Möglichkeit diese durch den Erwerb der Lizenz weiter zu nutzen. Um eine Lizenz zu erwerben, gehen Sie bitte auf unsere Internetseite und erwerben Sie die Lizenz zum gewünschten Produkt. Überprüfung der Lizenz Die Extension überprüft in regelmäßigen Abständen, ob die Lizenz noch gültig ist, daher muss der betriebene Shop über eine ständige Internetverbindung verfügen. Wenn das nicht der Fall ist, kann es passieren, dass sich die Extension automatisch sperrt. In dem Fall kontaktieren Sie bitte support@meets-ecommerce.de. (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 10 von 18

11 3.3 Katalogimport Der Katalogimport bietet generell den Import von Katalogen aus Lexware (catalog.xml). Diese XML-Dateien können Sie generieren in Ihrem Lexware über die ebusiness Standard Katalog Export. Wichtige Informationen vorab Leider bietet die Standard ebusiness Schnittstelle von Lexware nur die Möglichkeit, so genannte Simple Products zu exportieren. Komplexe Produkte mit Konfigurationen oder ähnlichem werden daher nicht exportiert und somit auch nicht von unserer Schnittstelle unterstützt! Diese Funktionalität richtet sich an alle Shop Besitzer, die einfache Produkte, mit einfachen Kategorien, Beschreibungen und ein paar Bildern haben. Dieser Nachteil bringt aber zu gleich einen Vorteil mit sich, diese Extension benötigt keine weitere Installation auf dem Lexware Client. Problematik mit großen Katalogen bzw. vielen Produkten und Bildern PHP und Apache verhalten sich auf verschiedenen Servern mit verschiedenen Konfiguration sehr unterschiedlich. Deswegen kann meets-ecommerce keine Garantie dafür geben, dass Ihr Katalog vollständig importiert wird. An dieser Stelle möchten wir Ihnen nur ein paar Tipps geben, wie Sie die Schnittstelle optimieren können, sodass auch Ihr Katalog importiert werden kann: 1. Anpassung der maximalen Ausführungszeit von PHP 4 2. Anpassung des Speichers (Memory) pro Ausführung von PHP 5 Die einfache Anpassung dieser Werte für den gesamten Server wirkt sich ebenfalls auf andere Seiten bzw. auf Ihren Shop aus. Aufgrund dessen empfehlen wir, diese Einstellungen nur auf das Backend von Magento zu begrenzen, sodass Sie an anderer Stelle keine Probleme haben (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 11 von 18

12 Eine Möglichkeit, die Anpassung der Werte nur für das Magento Backend könnten Sie in der VHOST Datei Ihres Shops anpassen: <LocationMatch "index.php/lexmeetsmage-ce"> php_value memory_limit 1024M # 1GB for each request php_value set_time_limit 600 # 10 minutes for each request </LocationMatch> Wenn Ihnen die Art von Einstellungen nicht verständlich sind, Fragen Sie bitte Ihren Hoster bzw. kontaktieren Sie support@meets-ecommerce.de. Nutzung der Import Schnittstelle Lexware bietet über Ihre Standard ebusiness Schnittstelle ein standardisierten Export von XML Dateien. Bitte gehen Sie folgt vor: 1. Exportieren Sie Ihren Katalog aus Lexware 6 2. Laden Sie die Produktbilder aus Lexware via FTP oder SSH in den folgenden Ordner von Ihrem Magento Hauptordner aus gesehen: media/lexmeetsmage/ 7 3. Loggen Sie sich nun in Ihr Magento Backend ein und gehen Sie auf LexMeetsMage CE > Katalog Import Abbildung 6: Menüauswahl Katalogimport 6 Die Funktion zum Export über die ebusiness Schnittstelle von Lexware entnehmen Sie bitte aus dem Handbuch von Ihrer Lexware Version. 7 Der Speicherort für die Artikelbilder Ihrer Produkte entnehmen Sie bitte dem Handbuch von Ihrer Lexware Version. (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 12 von 18

13 4. Auf der geöffneten Unterseite betätigen Sie bitte oben rechts den Button Lade einen neuen Lexware Katalog hoch Abbildung 7: Button "Lade einen neuen Lexware Katalog hoch" 5. Sobald Sie diesen betätigt haben, öffnet sich dort drunter ein Upload Formular Abbildung 8: Upload Formular für catalog.xml 6. Wählen Sie nun die catalog.xml auf Ihrem PC aus und drücken Sie wieder oben rechten den Button Start upload file. Jetzt wird die XML Datei hochgeladen Wenn der Upload erfolgreich war erhalten Sie eine Statusnachricht und sehen einen Eintrag in der unteren Tabelle. Abbildung 9: Erfolgreicher Upload der catalog.xml 8. Nun klicken Sie auf den Eintrag den Sie zuvor hochgeladen haben 9. Jetzt müssen die Einstellungen für diesen Import vornehmen Allgemeine Einstellungen Wählen Sie den Store, in dem Sie die Produkte importieren möchten. (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 13 von 18

14 Produkt-Einstellungen Katalogpreise inkl. Steuern: konfigurieren Sie hier, ob die Produktpreise in Ihrem Shop inkl. Steuern sind (Ja) oder ohne (Nein) Status für importierte Produkte: sind die Produkte direkt nach dem Import aktiv (Aktiviert) oder müssen diese erst manuell im Backend freigeschaltet werden (Deaktiviert). Achtung, bestehende aktivierte Produkte werden dann ebenfalls deaktiviert. Attribute: Aus Ihrem Lexware werden Attribute mit exportiert. Wir empfehlen an dieser Stelle, die Voreinstellungen zu behalten wir weisen diese automatisch zu. Kategorie-Einstellungen Status für importierte Kategorien: Sollen die importierten Kategorien sofort nach dem Import sichtbar sein (Aktiviert) oder nicht sichtbar sein (Deaktiviert). Wähle Kategorie, in der importiert wird: Wählen Sie die Kategorie, in dem der Katalog importiert werden soll. Achtung, es wird der gesamte Kategorienbaum aus Lexware ausgebaut. Wenn Kategorien vorhanden, wird diese nicht überschrieben! (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 14 von 18

15 Produktbild-Einstellungen Vorhandene Bilder löschen?: Sollen vorhandene Bilder gelöscht werden (Ja) oder sollen diese überschrieben werden (Nein). Achtung, die Identifizierung geschieht über den Dateinamen und die Bildgröße ab. 10. Wenn alle Einstellungen vorgenommen worden sind, dann betätigen Sie den Button oben rechts Verarbeite Katalogdatei 11. Die Ladezeit der Seite hängt von der Menge der Produkte und Bilder des Katalogs ab. Wir bitten um Geduld bei der Ausführung bzw. Fertigstellung des Ladevorgangs. Wenn der Ladevorgang mit einer weißen Seite Ihres Browsers endet, dann bedeutet das in 99% der Fälle, dass entweder Ihr Speicher voll gelaufen ist oder die Ausführungszeit war zu kurz. Bitte schauen Sie auch noch mal unter 3.3 den Punkt Problematik mit großen Katalogen bzw. vielen Produkten und Bildern nach. (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 15 von 18

16 3.4 Bestellexport Der Bestellexport exportiert Bestellungen aus Magento in das XML Format für die Lexware ebusiness Schnittstelle im OpenTrans Format. Wichtige Informationen vorab Der Bestellexport merkt sich generell jede exportierte Bestellung aus Magento in Richtung Lexware. Diese Funktion hat den Vorteil, dass keine Bestellungen mehrfach exportiert werden und dadurch Probleme in der Buchhaltung entstehen. Der Nachteil dieses Features ist allerdings, dass Shops, die bereits viele Bestellungen vor Nutzung von LexMeetsMage haben, den Export mit sehr vielen Bestellungen machen. Generell kann es passieren, dass Sie dann jedes mal eine weiße Seite angezeigt bekommen, wenn Sie den Export ausführen. Wenn dies der Fall ist, bitte kontaktieren Sie Nutzung der Export Schnittstelle 1. Gehen Sie auf LexMeetsMage CE > Bestellexport > Exportieren 2. Wenn Sie das erste Mal auf den Export gehen, werden Sie automatisch auf die Einstellungen weitergeleitet. Wenn nicht mit Schritt 3 weiter. Allgemeine Einstellungen Preise im Katalog?: Wählen Sie bitte die korrekte Einstellung aus. (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 16 von 18

17 Zahlungseinstellungen Lexware unterstützt leider nur eine begrenzte Anzahl von Zahlungsarten für den Import über die Standard ebusiness Schnittstelle. Bitte weisen Sie hier die passenden Zahlungsarten für Lexware zu. Auf der linken Seite finden Sie die installierten Zahlungsarten von Magento. Auf der rechten Seite die verfügbaren Zahlungsarten von Lexware. Bitte weisen die korrekten Arten zu. Wir empfehlen bei Payment Gateways wie Paypal die Zahlungsart Vorkasse auf Lexware Seite zu nehmen. Aktuell steht aus sicherheitstechnischen Gründen die Zahlungsart Kreditkarte seitens Lexware nicht zur Verfügung. Diese Funktion soll aber spätestens zur nächsten Version nachgeliefert werden. Speichern der Einstellungen Bitte speichern Sie die Einstellungen über den oberen rechten Button Einstellungen speichern. 3. Wenn nun offene Bestellungen verfügbar sind, sehen Sie oben rechts einen Button Aktuelle Bestellungen exportieren (3). Die 3 hier steht für die gesamte Anzahl der offenen Bestellungen. 4. Bitte betätigen Sie den, in 3. genannten, Button - es öffnet sich ein Formular unter dem Button. (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 17 von 18

18 5. In diesem Formular können Sie auswählen, für welchen Store bzw. für alle Stores, Sie die Bestellungen exportieren wollen. 6. Wenn Sie den Store ausgewählt haben, betätigen Sie nochmals den oberen rechten Button zum Export der Bestellungen. 7. Nach erfolgreichem Export der Bestellungen, sehen Sie einen neuen Eintrag in der Tabelle im unteren Bereich. 8. Aus Sicherheitsgründen können Sie diese Datei nicht aus dem Backend von Magento herunterladen. Gehen Sie nun via FTP oder SSH auf Ihren Server und gehen vom Magento Hauptordner aus in das Verzeichnis var/lexmeetsmage/ und laden Sie die in der Tabelle aufgeführte XML Datei. 9. Nun öffnen Sie Ihr Lexware und gehen Sie in die Lexware ebusiness Schnittstelle und importieren Sie XML Datei Sie haben die Bestellungen erfolgreich exportiert! 8 Die Funktion zum Import der Bestellungen und weiterem Verfahren mit der ebusiness Schnittstelle von Lexware entnehmen Sie bitte aus dem Handbuch von Ihrer Lexware Version. (c) 2012 meets-ecommerce Online Agentur GmbH v0.1 Seite 18 von 18