Registrierung erweitern

Transkript

1 Shopware-Plugin: Registrierung erweitern RHIEM Intermedia GmbH Gildeweg Voerde Germany Phone: +49 (0) Board of Directors: Franz Rhiem, Dr.-Ing. Stefan Rhiem, René Tanzer, Marco Spittka Commercial Register: HRB 10187, Duisburg VAT-ID: DE

2 Inhaltsverzeichnis 1 Übersicht Installation Benutzung des Plugins Anlegen von Feldern Standard Gruppen Felder Anzeige im Account Nutzen der Daten Anzeige im Backend Anzeige im Frontend Verwendung eigener Logik Support... 9 Bewerten Sie uns! Lizenzbestimmungen... 9 Montag, 01. April 2019 Jonas Lasinski - RHIEM Intermedia GmbH Seite 2

3 1 Übersicht Das Plugin Registrierung erweitern zusätzliche Felder ermöglicht Ihnen, während der Registrierung weitere Informationen von Ihren Kunden zu erfragen. Diese können nach der Registrierung sowohl von dem Kunden in seinem Account als auch von Ihnen über das Backend bearbeitet werden. 2 Installation Installieren Sie das Plugin ganz einfach durch den Plugin-Manager. (Details zum Plugin-Manager finden Sie im Shopware Wiki.) 3 Benutzung des Plugins Nach der erfolgreichen Installation befindet sich unter dem Menü Inhalt ein neuer Punkt Registrierungsfelder. Über diesen Menüpunkt können Sie der Registrierung neue Gruppen und Felder zuweisen. 4 Anlegen von Feldern 4.1 Standard Die Registrierung besteht im Standard aus den Gruppen Persönlich (unter Ich bin Neukunde ) und Adresse (unter Ihre Adresse ). Diese werden bei der Installation unter den Namen personal und address im Plugin-Menüpunkt angelegt, können aber nicht verändert oder gelöscht werden. Sie können jedoch sowohl die Gruppe als auch die Felder der Gruppe neu sortieren, falls Änderungen gewünscht sind. Ebenso können beiden Gruppen neue Felder hinzugefügt werden, die dann innerhalb der Gruppe dargestellt werden. Das Anlegen neuer Felder wird in Punkt 4.3 genauer erläutert. Achtung: Wenn Sie neue Felder in der Adress-Gruppe anlegen, werden diese nicht zu der Adresse gespeichert, sondern ebenfalls unter den persönlichen Daten des Kunden. Die Unterteilung dient lediglich der Darstellung im Frontend. 4.2 Gruppen Über das Plugin können Sie nun weitere Gruppen hinzufügen. Beim Anlegen einer Gruppe können folgende Werte angegeben werden: Name* Label* Beschreibung Der interne Name der Gruppe. Wird nicht im Frontend angezeigt. Die Beschriftung der Gruppe. Wird im Frontend über der Gruppe dargestellt, so wie z.b. Ihre Adresse. Die Beschreibung der Gruppe. Wird im Frontend unter dem Label dargestellt. Montag, 01. April 2019 Jonas Lasinski - RHIEM Intermedia GmbH Seite 3

4 Aktiv Position Wenn aktiv gewählt ist, wird die Gruppe im Frontend angezeigt. Ansonsten wird sie nicht eingebunden, Die Position der Gruppe, um bei mehreren Gruppen eine Reihenfolge festzulegen. *Pflichtfeld Nach dem Anlegen einer Gruppe wird Sie folgendermaßen im Frontend dargestellt: 4.3 Felder Darstellung einer Gruppe im Frontend / 1: Label / 2: Beschreibung / 3: Felder Sobald Sie eine Gruppe gespeichert haben, können Sie innerhalb dieser Gruppe Felder anlegen, um bei der Registrierung zusätzliche Informationen abzufragen. Beim Anlegen von Feldern können folgende Felder angelegt werden: Name* Der interne Name des Felds. Wird nicht im Frontend angezeigt. Aufgrund der Hintergrundlogik von Shopware muss jeder Name einzigartig sein. Um Komplikationen mit bereits registrierten Kunden zu verhindern, darf der Name lediglich Buchstaben enthalten und kann nach dem erstmaligen Speichern nicht mehr bearbeitet werden. Hier können Sie den Typ des Felds wählen. Dazu stehen drei Typen zur Auswahl: Typ* Label* Beschreibung 1. Text: Normaler Text, auch Zahlen und Sonderzeichen möglich 2. Nummer: Nur Nummern möglich, Eingabe anderer Zeichen wird verhindert 3. Auswahlfeld: Ein Auswahlfeld, für das Sie vorgegebene Werte definieren können Die Beschriftung des Felds. Wird im Frontend als Platzhalter des Felds dargestellt, wie bei den anderen Feldern in der Registrierung. Die Beschreibung des Felds. Wird im Frontend unter dem Feld dargestellt. Montag, 01. April 2019 Jonas Lasinski - RHIEM Intermedia GmbH Seite 4

5 Aktiv Wenn aktiv gewählt ist, wird das Feld im Frontend angezeigt. Ansonsten wird es nicht eingebunden, Nur ausfüllbar, wenn der Typ Auswahlfeld ausgewählt wurde. Labels Auswahlfeld Hier können kommasepariert die Beschreibungen für die einzelnen Optionen eines Auswahlfelds angegeben werden. WICHTIG: Dabei handelt es sich nicht um die Werte, die in der Datenbank gespeichert werden, sondern lediglich um die Beschriftung, die im Frontend angezeigt wird. Nur ausfüllbar, wenn der Typ Auswahlfeld ausgewählt wurde. Werte Auswahlfeld Pflichtfeld Fehlermeldung Pflichtfeld Feldlänge beschränken Minimale Länge Fehlermeldung Minimale Länge Maximale Länge Fehlermeldung Maximale Länge Position Hier können Sie kommasepariert die Werte der einzelnen Optionen eines Auswahlfelds angeben. Der Wert der jeweiligen Option wird in der Datenbank gespeichert. Wenn das Feld ein Pflichtfeld ist, kann die Registrierung nicht abgeschlossen werden, falls das Feld nicht gefüllt ist. Die Meldung, die ausgegeben wird, falls das Feld während der Registrierung nicht gefüllt wurde. Falls die Länge des Felds (Zeichenanzahl) beschränkt werden soll, aktivieren Sie diese Checkbox. Nur ausfüllbar, wenn die Checkbox Feldlänge beschränken aktiv ist. Die minimale Länge (Zeichenanzahl) des Felds. Falls Sie dieses Feld leer lassen, gibt es keine minimale Länge. Nur ausfüllbar, wenn die Checkbox Feldlänge beschränken aktiv ist. Die Meldung, die ausgegeben wird, falls zu wenig Zeichen eingegeben wurden. Nur ausfüllbar, wenn die Checkbox Feldlänge beschränken aktiv ist. Die maximale Länge (Zeichenanzahl) des Felds. Falls Sie dieses Feld leer lassen, gibt es keine maximale Länge. Nur ausfüllbar, wenn die Checkbox Feldlänge beschränken aktiv ist. Die Meldung, die ausgegeben wird, falls zu viele Zeichen eingegeben wurden. Die Position des Felds, um bei mehreren Feldern eine Reihenfolge festzulegen. *Pflichtfeld 5 Anzeige im Account Montag, 01. April 2019 Jonas Lasinski - RHIEM Intermedia GmbH Seite 5

6 Nachdem sich ein Kunde registriert hat, werden ihm seine gespeicherten Daten im Frontend unter seiner Accountübersicht dargestellt: Darstellung der Gruppen im Account. Bei einem Klick auf Ändern können die Daten von dem Kunden selbst geändert werden: Montag, 01. April 2019 Jonas Lasinski - RHIEM Intermedia GmbH Seite 6

7 Ändern von Daten im Frontend. Eigene Gruppen werden dabei separat angezeigt, eigene Felder in einer der Standard-Gruppen werden unter den persönlichen Daten angezeigt. Montag, 01. April 2019 Jonas Lasinski - RHIEM Intermedia GmbH Seite 7

8 6 Nutzen der Daten 6.1 Anzeige im Backend Auf die gespeicherten Werte können Sie ganz einfach über das Backend zugreifen. Öffnen Sie einfach einen Kunden über das normale Kunden-Modul, alle angelegten Felder werden unter dem Punkt Freitextfelder aufgeführt: Darstellung der Felder im Backend. (Wichtig: Bei Auswahlfeldern wird Ihnen hier der gewählte Wert angezeigt, nicht das Label der Option) 6.2 Anzeige im Frontend Falls Sie einen Wert im Frontend nutzen wollen, können Sie ihn über die Variable $suserdata nutzen. Der Zugriff erfolgt dabei folgendermaßen: {$suserdata.additional.user[name des Felds]} 6.3 Verwendung eigener Logik Falls Sie die Werte in Ihrer eigenen Logik verwenden wollen, können Sie einfach auf die Tabelle s_user_attributes zugreifen. Hier werden alle Felder mit Ihrem Namen und dem jeweiligen Nutzerwert gespeichert. Montag, 01. April 2019 Jonas Lasinski - RHIEM Intermedia GmbH Seite 8

9 7 Support Sie haben Fragen oder wünschen eine individuelle Anpassung dieses Plugins auf Ihre Bedürfnisse? Bitte nutzen Sie die Shopware-Plugin-Support Funktion in Ihrem Shopware-Account. Sie benötigen Unterstützung bei der Umsetzung Ihrer Shopware-Anforderungen? Schreiben uns gerne eine oder rufen Sie uns an unter: +49 (0) Wir freuen uns auf Sie! Bewerten Sie uns! Ihre Meinung ist uns wichtig, daher würden wir uns über ein Feedback von Ihnen freuen. Sie können das Plugin über Ihren Shopware-Account im Bereich Lizenzen bewerten. Vielen Dank! 8 Lizenzbestimmungen Bitte beachten Sie unsere Lizenzbestimmungen: Mit der Benutzung unseres Plugins bestätigen Sie, dass Sie die Lizenzbestimmungen gelesen haben und damit einverstanden sind. Montag, 01. April 2019 Jonas Lasinski - RHIEM Intermedia GmbH Seite 9