PhPepperShop Login Post Modul Datum: 3. Dezember 2015 Version: 1.2 PhPepperShop Login Post Modul Anleitung Glarotech GmbH
Inhaltsverzeichnis 1. Einleitung...3 1.1 Funktionen...3 1.2 Beschreibung...3 2. Installation...3 2.1 Systemanforderungen...3 2.2 Dateien kopieren und hochladen...3 3. Modulinstallation...4 4. Konfiguration des Login Post Moduls...4 4.1 Login Post Aktivierung...5 4.2 Testmodus...6 4.3 Login erstellen Zwischenseite...6 4.4 Adressvalidierung Aktivierung...6 4.5 Adressvervollständigungen...6 4.5.1 Ort anhand der PLZ vervollständigen...6 4.5.2 Vervollständigung der Strasse...7 4.6 Secret und Client-ID...7 5. Anmelden über DIE POST...7 5.1 Direkt mit 'Anmelden mit DIE POST'...8 5.2 Bestehender Kunde verbinden...8 5.3 Bei der Kasse anmelden mit DIE POST...8 6. Adress-Validierung...8 7. Adressvervollständigung Beispielanzeige...9 Glarotech GmbH Seite 2 von 10
1. Einleitung Dieses Modul integriert Komfortfunktionen der Schweizerischen Post direkt in Ihren Shop: 1.1 Funktionen Anmeldung im Shop via Login Post Connector - keine zusätzlichen Passwörter mehr Adressdaten werden bei Login via der Schweizerischen Post vorausgefüllt, ebenso alternative Lieferadressen Adressänderungen werden automatisch übernommen Ohne Login: Ortseingabe und Strasse werden vom System vorgeschlagen und vervollständigt Es läuft eine Adress-Validierung, welche via Infoanzeige auf problematische Adressangaben hinweist 1.2 Beschreibung Wir sind es schon von Facebook, Twitter oder Google+ gewohnt, dass man auf weiteren Systemen kein eigenes Login und Passwort mehr anlegt, sondern nur noch mit dem Dienst verknüpft. Das Login über einen externen Dienstleister setzt viel Vertrauen voraus, welches die Schweizerische Post gegenüber den US-amerikanischen sozialen Netzen sehr attraktiv macht. Login direkt über die Schweizerische Post: Es müssen keine Kundendaten mehr eingegeben werden und keine weiteren Passwörter mehr gemerkt werden. Das Login kann mit einem Standard Shop-Account verknüpft werden oder auch nicht. Die alternativen Lieferadressen des Kunden / der Kundin werden automatisch aktualisiert und im Shop zur Auswahl angezeigt. Die Funktion ist lediglich für Login Post- Accounts von Privatkunden verfügbar. Mit dem Adress-Validator ist die Adresseingabe im PhPepperShop noch einfacher, der Kunde / die Kundin gibt die Postleitzahl ein und der Ort wird vollautomatisch ausgefüllt. Dieselbe Funktionalität gibt es auch für die Strassenangabe - alles optional aktivierbar. Sollte eine angegebene Adresse gemäss Post-Datenbank nicht verwendbar sein, wird der Kunde im Bestellprozess darauf hingewiesen. 2. Installation Glarotech GmbH Hostingkunden erhalten das Modul nach Bestellung fertig installiert, das Kapitel zwei kann daher ignoriert werden, da diese Schritte bereits durchgeführt worden sind. 2.1 Systemanforderungen Um das Login Post Modul einzusetzen, ist mindestens ein PhPepperShop v.5.0.0.31 Professional oder Enterprise erforderlich. Dieses Modul baut intern auf dem Identity Provider Framework des PhPepperShops auf. 2.2 Dateien kopieren und hochladen Das Login Post Modul kann nach dem Bezug im Download Bereich des eigenen PhPepperShop Accounts heruntergeladen werden. Es besteht aus zwei Verzeichnissen, die man in seinen installierten PhPepper- Shop kopieren muss. Dazu entpackt man zuerst das ZIP-Archiv. Kopieren Sie nun die Dateien analog der Ordnerstruktur im ZIP-Archiv in folgende Verzeichnisse: Glarotech GmbH Seite 3 von 10
{shopdir}/shop/admin/module/identity_provider/ {shopdir}/shop/module/identity_provider/ {shopdir}/shop/language/html_templates/ Verz. Verz. Verz. Die Dateien lassen sich einfach via FTP oder SCP zum Webserver hochladen. Der Platzhalter {shopdir} steht dabei für das Shopverzeichnis auf dem Webserver, wo unter anderem die Datei index.php zusammen mit README.txt zu finden ist. 3. Modulinstallation Nach dem Kopieren der Dateien wechselt man im Browser zur Shop- Administration und wechselt dort ins Menü 'Module'. Auf der linken Seite, bei den noch nicht installierten Modulen, sieht man nun das Identity Provider Modul aufgelistet. Hier einfach das Identity Provider Modul anwählen und auf den 'Installieren' Button klicken. Wenn die Installationsroutine ohne Probleme durchläuft, wird dies auf der darauf folgenden Seite kommuniziert; bitte bestätigen. Die Installation des Login Post Moduls auf Basis des PhPepperShop Identity Provider Moduls ist jetzt abgeschlossen. Damit das Modul eingesetzt werden kann, muss das Modul nun noch an die spezifische Konfiguration Ihres Login Post-Accounts angepasst werden, folgen Sie dazu den Anweisungen des nächsten Kapitels: Konfiguration des Login Post Moduls. 4. Konfiguration des Login Post Moduls Abbildung 1: Modulliste in der Shop-Administration (Module können variieren) Info: Es wird davon ausgegangen, dass Sie sich bei der Schweizerischen Post als Shop bereits angemeldet haben. Wenn Sie dies noch nicht gemacht haben, können Sie sich hier anmelden: https://www.phpeppershop.com/login_post_connector/index.php?bestellen_aktiv=true Klicken Sie auf den Button 'Zurück zur Modulverwaltung' und wählen Sie rechts das neu installierte Identity Provider Modul aus. Danach erscheint Ihnen die Konfigurationsmaske (Abbildung 2). Möglicherweise erscheinen Ihnen Fehlermeldung, welche Sie wie folgt beheben können: Hausnummern: Falls die Lieferung an Adressen ohne Hausnummern gesendet werden (MyPost24, Postlagernd, etc.) darf das Hausnummernfeld kein zwingendes Feld sein. Deshalb müssen Sie unter 'Shop-Einstellungen' 'Kundenattribute' den Haken für die Hausnummer bei prüfen entfernen und abspeichern. Tel.: Telefonnummern sind bei Login Connector Post keine Pflichtfelder, somit dürfen Sie im Shop auch nicht als Pflichtfelder definiert sein. In der Kasse sind die synchronisierten Adressdaten vor Veränderungen geschützt. SSL/TLS: Damit die Kundendaten geschützt werden, benötigt Ihr Shop eine Verschlüsselung. Diese aktivieren Sie indem Sie unter 'Shopeinstellungen' 'Allgemeine Einstellungen' 'Shop-Konfiguration' den Haken bei SSL/TLS aktivieren. Glarotech GmbH Seite 4 von 10
Bitte beachten Sie, dass nur folgende Attribute den Haken bei 'prüfen' gesetzt haben dürfen: Anrede, Vorname, Name, Strasse, Postleitzahl und Ort. Abbildung 2: Modulkonfiguration Info: Mit Klick auf das Schwimmring-Symbol (oben rechts) öffnet sich die Online-Hilfe des Moduls. 4.1 Login Post Aktivierung Mit dieser Einstellung aktivieren oder deaktivieren Sie die Funktion der Login-Möglichkeit mittels der Schweizerischen Post (Login Post Connector). Damit der Kunde die alternativen Lieferadressen aus seinem Post-Konto verwenden kann, müssen Sie Adressfelder für die Lieferadresse freigeben. Dies können Sie unter 'Shop-Einstellungen' 'Kundenattribute' machen. Setzen Sie dort in der Spalte 'in Lieferadresse' die Haken bei Strasse, Hausnummer, PLZ und Ort. Achtung: Wenn Sie den Shop eine Zeit lang mit aktivierter Login Post Anmeldemöglichkeit betrieben haben und diese Funktionalität nun deaktivieren, können Kundinnen / Kunden, welche sich im Shop via Login Post angemeldet haben und keinen Shop-Account damit verknüpft haben, sich im Shop nicht mehr anmelden. Es muss danach ein neuer Account erstellt werden. Glarotech GmbH Seite 5 von 10
4.2 Testmodus Sollte es eine Testphase geben, kann das Login Post Modul konfiguriert werden, dass es über eine Testplattform kommuniziert. In diesem Fall wird nicht mit Live-Daten operiert. Achtung: Wenn das Modul im Testmodus betrieben wird, können sich Ihre Kundinnen und Kunden nicht mit Ihren Login Post Accounts am Shop anmelden. 4.3 Login erstellen Zwischenseite Wir empfehlen Ihnen diese Seite zu deaktivieren, da es ein zusätzlicher Schritt für den Kunden bedeutet. Dieser erhält die Auswahl, ob er den bestehenden Account des Online-Shops mit dem Login Post Account vereinen will oder zwei separate Accounts haben möchte. 4.4 Adressvalidierung Aktivierung Sollen die Adressen vor der Bestellübersicht überprüft werden und allenfalls eine Infomeldung an den Kunden / die Kundin ausgegeben werden? Für die Infomeldung wird unterschieden zwischen Adressen, welche den richtigen Ort und die richtige Postleitzahl haben und zwischen Adressen, bei welchen Ort und PLZ nicht richtig ist. Adressen ohne korrekte PLZ-Ort-Kombination gelten als problematisch. Bei eingegangenen Bestellungen wird das Resultat der letzten Adressvalidierung mitgegeben. In der Bestellungs Detailanzeige ganz unten bei den Transaktionsinformationen findet man hierbei mindestens eine Transaktion mit PSP = 'schweizer_post' und Call-Typ 'Match'. Siehe auch Abbildung 3. Im Punkt 'Call Status' wird jeweils das Resultat der Adressvalidierung retourniert: CERTIFIED, USABLE oder UNUSABLE. Bei UNUSABLE ist Vorsicht geboten, da hier ein Versand problematisch sein kann. Mit Klick auf den Button 'Details' kann man die komplette Kommunikation nachvollziehen. Abbildung 3: Beispielinfo einer Adress-Validierung mit Resultat: CERTIFIED 4.5 Adressvervollständigungen In den Eingabeformularen der Kasse und des Neukundenformulars kann der Shop Adressvervollständigungen anbieten. Dieses Modul hat getrennte Aktivierungsmöglichkeiten für die Vervollständigungshilfen bei Orts- und Strasseineingaben: 4.5.1 Ort anhand der PLZ vervollständigen Soll der Ort anhand der Postleitzahl-Eingabe automatisch ausgefüllt werden? Es wird empfohlen dieses Feature zu aktivieren. Der natürliche Ausfüllablauf innerhalb der Kasse führt den Kunden / die Kundin zuerst zum PLZ Eingabefeld (CH-Standard) und würde in diesem Fall auch den Ort korrekt vor ausfüllen. Glarotech GmbH Seite 6 von 10
4.5.2 Vervollständigung der Strasse Soll der Shop beim Ausfüllen der Strasse eine Autovervollständigung anbieten? Dieses Feature arbeitet mit dem gesamten Adressdatensatz. Sollte vor der Strassenangabe bereits eine PLZ und / oder Ortschaft angegeben worden sein, werden als Möglichkeiten nur noch die Strassennamen angezeigt, welche auch in dieser Ortschaft vorkommen. Sollte PLZ / Ort noch leer sein (default), werden alle Strassen der Schweiz und dem Fürstentum Liechtenstein als Lösung vorgeschlagen. Diese Autovervollständigung ist angenehm, da Kunden nicht den vollen Strassennamen tippen müssen und auch falsch geschriebene Namen der Strassen verhindert werden. 4.6 Secret und Client-ID Sie erhalten das Secret zusammen mit der Client-ID bei der Anmeldung bei der Schweizerischen Post. Das Secret kann als Passwort verstanden werden. 5. Anmelden über DIE POST Sobald sich der Kunde über DIE POST anmeldet, kann er seine Adressdaten nicht mehr ändern. Zusatzfelder, Bestellanmerkungen und Bestellung bezogene Felder dieser Art sind vom Schreibschutz ausgenommen. Abweichende Lieferadressen mit einem anderen Land als der Kunde werden aus technischen Gründen ignoriert. Dies betrifft vor allem Kunden aus dem Fürstentum Liechtenstein, die eine abweichende Lieferadresse in der Schweiz haben und vice versa. Es gibt drei Arten, wie sich der Kunde über DIE POST anmelden kann. Abbildung 4: Beispielanzeige Kasse nach Anmeldung via Login Post - Felder schreibgeschützt Glarotech GmbH Seite 7 von 10
5.1 Direkt mit 'Anmelden mit DIE POST' Bei 'Mein Konto' über 'Anmelden mit DIE POST' oder bei 'Neukunden Anmeldung' über 'Login mit DIE POST'. In diesem Fall, kann der Kunde / die Kundin sich nachher nur noch über DIE POST anmelden, nötigenfalls kann der Shop-Administrator dem Kunden ein Login geben. Siehe auch Infomeldung zur Login Post Aktivierung im Kapitel 4.1. 5.2 Bestehender Kunde verbinden Wenn ein Kunde / eine Kundin bereits ein Shop-Konto besitzt und dieses mit den Adressdaten von DIE POST ergänzen will, kann im Kundenbereich bei 'Account mit Identity Provider verknüpfen' eine Verbindung des Shop-Kontos mit Login Post hergestellt (und wieder gelöst) werden. Wurde ein PhPepperShop Kundenaccount mit Login Post verknüpft, kann zukünftig ganz einfach im Bestellprozess ein Login über 'Anmelden mit DIE POST' erfolgen oder wahlweise auch mit dem bestehenden Shop Login. 5.3 Bei der Kasse anmelden mit DIE POST Wenn der Kunde / die Kundin sich während des Bestellens vor der Kasse entscheidet sich mit DIE POST anzumelden, dann kann er / sie nachher entscheiden, ob zukünftig nur noch über DIE POST angemeldet werden soll, oder ob zusätzlich noch ein Login + Passwort für einen Account direkt im PhPepperShop erstellt werden soll. 6. Adress-Validierung Die Adress-Validierung wird im Bestellprozess zwischen der Kasse (Adresseingaben) und der Bestellübersicht durchgeführt. Falls die Adress Validierung erfolgreich durchgeführt werden konnte und das Resultat eine annehmbare Adresse ist (CERTIFIED oder USABLE), merkt der Kunde / die Kundin nichts davon. Andernfalls wird eine Warnmeldung in der Bestellübersicht angezeigt. Der Kunde kann aber trotzdem noch bestellen. Es wird unterschieden zwischen Adressen, bei denen die Lieferungen wahrscheinlich ankommen, obwohl sie inkorrekt sind und Adressen, wo die Lieferungen wahrscheinlich nicht ankommen. Abbildung 5: Beispielhinweis der Adressvalidierung (Problem bei Strassenangabe) Glarotech GmbH Seite 8 von 10
7. Adressvervollständigung Beispielanzeige Nun folgen zwei Screenshots, welche je einmal die Vervollständigung des Strassennamens und einmal die Ortsnamenvorschläge aufgrund der PLZ-Eingabe zeigen: Abbildung 6: Strasennamen Vorschläge Glarotech GmbH Seite 9 von 10
Abbildung 7: Ortsangabe Vervollständigung nach PLZ Glarotech GmbH Seite 10 von 10