Ratenkauf by EasyCredit für JTL Shop V. 3.20 Installation und Konfiguration Version: 0.1.0
Inhaltsverzeichnis 1. Einleitung... 3 2. Voraussetzung... 3 2.1 Komptabilität... 3 2.2 Templates... 3 3. Installation... 3 4. Konfiguration... 3 4.1 Plugin Spezifische Einstellungen... 3 4.1.1 Artikeldetailseite... 4 4.1.2 Bestellbestätigungsseite... 4 4.1.3 Bestellstatusseite... 5 4.1.4 Bestellabschlussseite... 6 4.1.5 Allgemein... 6 4.2 Konfiguration der Zahlart... 7 4.2.1 Zugangsdaten von EasyCredit... 7 4.2.2 Minimaler und Maximaler Bestellwert... 7 4.2.3 Zuweisen zu Versandart(en)... 7 Ratenkauf by EasyCredit für JTL Shop V. 3.20 Seite 1 von 7
ÄNDERUNGSHISTORIE Datum Autor Änderung 21.02.2017 support@senbyte.com INITIALE VERSION Ratenkauf by EasyCredit für JTL Shop V. 3.20 Seite 2 von 7
1. Einleitung Diese Dokument beschreibt wie Sie das Plugin Ratenkauf by EasyCredit in Ihren JTL Shop installieren und konfigurieren können. Bitte beachten Sie unbedingt die unter Punkt 2 genannten Voraussetzungen für eine reibungslose Funktionalität des Plugins. 2. Voraussetzung Bitte beachten Sie vor der Installation des Plugins folgende Hinweise. Bei Fragen hierzu wenden Sie sich gerne an den Support. 2.1 Komptabilität Dieses Plugin ist auf Kompatibilität mit der Software JTL Shop in Version 3.20 getestet worden. Eine reibungslose Funktionalität für ältere Versionen kann nicht garantiert werden. 2.2 Templates Das Plugin fügt an einigen Stellen mittels JTL Hook 140 eigene Template Schnipsel ein, um z.b. alle notwendigen Informationen auf der Zahlungsauswahl-Seite darzustellen. Diese Template Dateien wurden auf Basis des JTL Standard Templates Evo entwickelt. Um die Kompatibiliät mit anderen Themes / Templates sicher zu stellen sind gegebenenfalls Anpassungen notwendig. 3. Installation Entpacken Sie die zip Datei des Plugins und kopieren den darin enthaltenen Ordner sb_easycredit via FTP Auf Ihren Server in das Unterverzeichnis includes/plugins Ihres JTL Shops. Melden Sie sich nun in dem Administrationsbereich Ihres Shops an und wechseln über das Menü Plugins zur Pluginverwaltung. Dort markieren Sie den Eintrag Easy Credit Ratenkauf unter Verfügbare (nicht installierte ) Plugins und klicken auf installieren. Ihnen wird nun die erfolgreiche Installation bestätigt: 4. Konfiguration Bevor das Plugin produktiv genutzt werden kann, sind noch einige wenige Einstellungen notwendig. 4.1 Plugin Spezifische Einstellungen Wechseln Sie in die Konfiguration des Easy Credit Plugins. Gehen Sie hierzu über das Menü Plugins auf den Unterpunkt Easy Credit Ratenkauf. Ratenkauf by EasyCredit für JTL Shop V. 3.20 Seite 3 von 7
4.1.1 Artikeldetailseite Wechseln Sie auf den Reiter Artikelseite 4.1.1.1 Ratenkauf Widget auf der Artikeldetailseite aktivieren? Legen Sie fest ob das Ratenkauf - Widget auf der Artikeldetailseite angezeigt werden soll oder nicht. 4.1.1.2 PHPQuery Selector Der Selector identifiziert die Stelle, an der das Widget eingefügt werden soll. Änderungen sind nur bei Inkompatibilitäten mit dem verwendeten Template bzw. Theme notwendig. 4.1.1.3 PHP Query Methode Beschreibt die Methode, wie das Widget in Verhältnis zu dem Selector eingefügt werden soll. Mögliche Methoden sind: - After -> NACH dem Selector - Before -> VOR dem Selector - Append -> am ENDE INNERHALB des Selectors - Prepend -> am ANFANG INNERHALB des Selectors 4.1.2 Bestellbestätigungsseite Wechseln Sie auf den Reiter Bestellbestätigungsseite 4.1.2.1 PHPQuery Selector Der Selector identifiziert die Stelle, an der die Ratenkaufinformationen wie z.b. Zinsen eingefügt werden sollen. Ratenkauf by EasyCredit für JTL Shop V. 3.20 Seite 4 von 7
4.1.2.2 PHP Query Methode Beschreibt die Methode, wie die Ratenkaufinformationen in Verhältnis zu dem Selector eingefügt werden sollen. Mögliche Methoden sind: - After -> NACH dem Selector - Before -> VOR dem Selector - Append -> am ENDE INNERHALB des Selectors - Prepend -> am ANFANG INNERHALB des Selectors 4.1.3 Bestellstatusseite Wechseln Sie auf den Reiter Bestellstatusseite 4.1.3.1 Ratenkauf Informationen auf der Bestellstatusseite anzeigen? Nur notwendig, wenn Sie in Ihrem Shop die Bestellstatusseite als Bestellabschluss verwenden. Legen Sie fest ob dem Kunden hier noch einmal die Ratenkaufinformationen angezeigt werden sollen. 4.1.3.2 PHPQuery Selector Der Selector identifiziert die Stelle, an der die Ratenkaufinformationen eingefügt werden sollen. 4.1.3.3 PHP Query Methode Beschreibt die Methode, wie die Ratenkaufinformationen in Verhältnis zu dem Selector eingefügt werden sollen. Mögliche Methoden sind: - After -> NACH dem Selector - Before -> VOR dem Selector - Append -> am ENDE INNERHALB des Selectors - Prepend -> am ANFANG INNERHALB des Selectors Ratenkauf by EasyCredit für JTL Shop V. 3.20 Seite 5 von 7
4.1.4 Bestellabschlussseite Wechseln Sie auf den Reiter Bestellabschlussseite 4.1.4.1 Ratenkauf Informationen auf der Bestellabschlussseite anzeigen? Nur notwendig, wenn Sie in Ihrem Shop die Bestellabschlussseite als Bestellabschluss verwenden. Legen Sie fest ob dem Kunden hier noch einmal die Ratenkaufinformationen angezeigt werden sollen. 4.1.4.2 PHPQuery Selector Der Selector identifiziert die Stelle, an der die Ratenkaufinformationen eingefügt werden sollen. 4.1.4.3 PHP Query Methode Beschreibt die Methode, wie die Ratenkaufinformationen in Verhältnis zu dem Selector eingefügt werden sollen. Mögliche Methoden sind: - After -> NACH dem Selector - Before -> VOR dem Selector - Append -> am ENDE INNERHALB des Selectors - Prepend -> am ANFANG INNERHALB des Selectors 4.1.5 Allgemein Wechseln Sie auf den Reiter Allgemein 4.1.5.1 Logging aktivieren? Zusätzlich zu dem JTL Shop eigenen Logging gibt es die Möglichkeit das Logging für die reine Kommunikation mit der Easy Credit API zu aktivieren. Üblicherweise ist dies auf einem Produktiv System nicht mehr notwendig. Während der Integration und für Tests kann dies aufschlussreich sein. Die Logdateien (wenn aktiviert) finden Sie in dem Plugin Verzeichnis in dem Ordner log. 4.1.5.2 Log Level Legen Sie fest ob Sie nur Fehler oder alle Debug ausgaben sehen möchten. Ratenkauf by EasyCredit für JTL Shop V. 3.20 Seite 6 von 7
4.2 Konfiguration der Zahlart Nach der Konfiguration des Plugins an sich, müssen Sie die Zahlart noch einrichten und mindestens einer Versandart zuordnen. 4.2.1 Zugangsdaten von EasyCredit Wechseln Sie in die Übersicht der Zahlarten über das Menü Kaufabwicklung -> Zahlungsarten. Klicken Sie dort neben der Zahlart Easy Credit Ratenkauf auf einstellen : Tragen Sie dort die von Easy Credit erhaltene Webshop-ID sowie den Easy Credit Token ein: 4.2.2 Minimaler und Maximaler Bestellwert Anschließend stellen Sie bitte auf der gleichen Seite den Mindest- und Maximalbestellwert wie folgt ein: - Mindestbestellwert: 200 - Maximaler Bestellwert: 3000 Bestellungen außerhalb dieser Grenzen werden von Easy Credit NICHT akzeptiert. Speichern Sie die Einstellungen. 4.2.3 Zuweisen zu Versandart(en) Weisen Sie mindestens einer Ihrer Versandarten unter dem Menü Kaufabwicklung -> Versandarten die Zahlart Easy Credit Ratenkauf zu, damit diese für Endkunden bei Auswahl der entsprechenden Versandart(en) zur Verfügung steht. Ratenkauf by EasyCredit für JTL Shop V. 3.20 Seite 7 von 7