Funktionsweise der Schnittstelle
Hinweis:
Die Schnittstelle arbeitet unter anderem mit der PHP Funktion file_get_contents
Stellen Sie sicher, dass file_get_contents in Ihrer PHP Konfiguration aktiviert ist, bevor Sie diese Schnittstelle nutzen.
Sie bekommen sonst beim Einrichten der Schnittstelle in Ihrem Mandantenportal die Meldung:
Plugin nicht erreichbar (err: 21)
Das verwendete Plugin kann nicht aufgerufen werden
Ebenso ratsam ist ein ausreichendes memory_limit von mindestens 256 MB oder besser 512 MB.
Bei Fragen zu file_get_contents und memory_limit wenden Sie sich bitte an Ihren Provider.
Die IT Recht Kanzlei „pusht“ aktualisierte Rechtstexte für AGB, Datenschutz und Widerrufsrecht an Ihren Zen Cart Shop.
Eine automatische Aktualisierung des Impressums ist ebenfalls vorgesehem, möglicherweise in Ihrem Mandantenportal aber nicht aktiviert.
Bei dieser Aktualisierung werden die entsprechenden Inhaltsseiten im Shop automatisch aktualisiert und es werden falls aktiviert entsprechende pdf Dateien im Shop gespeichert.
Die benötigten Inhaltsseiten wurden bei der Installation der deutschen Zen Cart Version bereits als EZ Pages angelegt.
Es müssen EZ Pages sein, da nur bei EZ Pages der Seiteninhalt in der Datenbank hinterlegt ist, so dass die hinterlegten Texte dann automatisch datenbankseitig aktualisiert werden.
Diese EZ Pages dienen rein der Speicherung der automatisierten Rechtstexte. Sie sind daher so konfiguriert, dass sie weder in Sideboxes oder Header und Footer aufscheinen, sie benötigen auch kein Kapitel oder Inhaltsverzeichnis. In der EZ Pages Administration sind sie mit einer speziellen Kennung versehen itrk-…:
ITRK EZ Pages
In Zen Cart arbeiten Sie für die Seiten AGB, Datenschutz, Widerrufsrecht und Impressum normalerweise mit den „Define Pages“ unter Tools > Seiteneditor.
Das sind im Frontend die Seiten
index.php?main_page=conditions (AGB)
index.php?main_page=privacy (Datenschutz)
index.php?main_page=widerrufsrecht (Widerrufsrecht)
index.php?main_page=impressum (Impressum)
Da diese Define Pages normalerweise im Checkout und in der Sidebox Information verlinkt sind, macht es Sinn, für diese Seiten auch weiterhin die dafür vorgesehenen Define Pages anzusprechen.
In der deutschen Zen Cart Version wurden die 4 betroffenen Define Pages so verändert, dass ihr Aufruf bei aktivierter IT Recht Kanzlei Schnittstelle nicht mehr den Inhalt der hinterlegten Textdateien liefert, sondern den Inhalt der 4 IT Recht Kanzlei EZ Pages.
Um diese EZ Pages korrekt ansprechen zu können, wurde die Tabelle ezpages mit einem neuen Feld page_key erweitert.
Diese Kennung ist nur für die 4 speziellen EZ Pages nötig und es wurde die entsprechende Kennung bereits hinterlegt.
Sie müssen die Inhalte dieser EZ Pages nie manuell bearbeiten, Sinn der Sache ist ja, dass die 4 Seiten automatisch mit den Rechtstexten der IT Recht Kanzlei befüllt werden.
Ebensowenig müssen Sie die Seiten define_conditions, define_privacy, define_widerruf und define_impressum unter Tools > Seiteneditor je wieder bearbeiten.
Falls Sie in Ihrem Zen Cart Shop derzeit die Seiten AGB, Datenschutz, Widerruf und Impressum mit EZ Pages statt wie normalerweise mit Define Pages abbilden, empfehlen wir, diese „alten“ EZ Pages zu deaktivieren oder zu löschen und stattdessen die vom Modul mitgelieferten bereits vollständig konfigurierten neuen 4 EZ Pages zu verwenden.
Konfiguration unter Konfiguration > IT Recht Kanzlei
Unter Konfiguration > IT Recht Kanzlei finden Sie in Ihrer Zen Cart Administration nun folgende Menüpunkte vor:
IT Recht Kanzlei – Ist das Modul aktiv?
Steht nach der Installation auf nein.
Stellen Sie erst dann auf ja, wenn Sie die Grundkonfiguration so wie hier beschrieben abgeschlossen und sich mit dem Handling vertraut gemacht haben
IT Recht Kanzlei – API Token
Um mit Ihrem Shop sicher komunizieren zu können, benötigt die Schnittstelle eine API Token.
Diese wurde bei der Installation des Moduls automatisch generiert und muss normalerweise nicht geändert werden. Sollten Sie eine neue Token generieren wollen, dann ist das unter Tools > IT Recht Kanzlei möglich.
Notieren Sie sich die angezeigte Token, Sie benötigen sie für Ihr Mandentenportal bei der IT Recht Kanzlei.
Die Token wird Ihnen auch unter Tools > IT Recht Kanzlei angezeigt, so dass Sie sie später leicht herauskopieren können
IT Recht Kanzlei – API Version
zeigt die aktuelle Version der API Schnittstelle
IT Recht Kanzlei – EZ Page Kennung für Rechtstext AGB
Diese Kennung müssen Sie nicht ändern, sie wurde bereits bei der Modulinstallation voreingestellt.
Die Kennung legt fest, welche EZ Page für die Speicherung der AGB Texte verwendet wird.
Voreinstellung: itrk-agb
IT Recht Kanzlei – EZ Page Kennung für Rechtstext Datenschutzerklärung
Diese Kennung müssen Sie nicht ändern, sie wurde bereits bei der Modulinstallation voreingestellt.
Die Kennung legt fest, welche EZ Page für die Speicherung der Datenschutz Texte verwendet wird.
Voreinstellung: itrk-datenschutz
IT Recht Kanzlei – EZ Page Kennung für Rechtstext Widerrufsbelehrung
Diese Kennung müssen Sie nicht ändern, sie wurde bereits bei der Modulinstallation voreingestellt.
Die Kennung legt fest, welche EZ Page für die Speicherung der Widerrufsbelehrung Texte verwendet wird.
Voreinstellung: itrk-widerruf
IT Recht Kanzlei – EZ Page Kennung für Rechtstext Impressum
Diese Kennung müssen Sie nicht ändern, sie wurde bereits bei der Modulinstallation voreingestellt.
Die Kennung legt fest, welche EZ Page für die Speicherung der Impressum Texte verwendet wird.
Voreinstellung: itrk-impressum
IT Recht Kanzlei – AGB auch als pdf abrufen?
Hier können Sie einstellen, ob die AGB auch als pdf verfügbar sein sollen.
Falls ja wird auf der AGB Seite das von der IT Recht Kanzlei gepushte pdf zum Download verfügbar sein.
Falls Sie das Zen Cart Modul pdf Rechnung installiert haben, kann dieses Modul darauf zugreifen und die AGB gleich bei der Bestellung mit der Bestellbestätigung mitmailen.
IT Recht Kanzlei – Datenschutzerklärung auch als pdf abrufen?
Hier können Sie einstellen, ob die Datenschutzerklärung auch als pdf verfügbar sein soll.
Falls ja wird auf der Datenschutz Seite das von der IT Recht Kanzlei gepushte pdf zum Download verfügbar sein.
IT Recht Kanzlei – Widerrufsbelehrung auch als pdf abrufen?
Hier können Sie einstellen, ob die Widerrufsbelehrung auch als pdf verfügbar sein soll.
Falls ja wird auf der Widerrrufsrecht Seite das von der IT Recht Kanzlei gepushte pdf zum Download verfügbar sein.
Falls Sie das Zen Cart Modul pdf Rechnung installiert haben, kann dieses Modul darauf zugreifen und die Widerrufsbelehrung gleich bei der Bestellung mit der Bestellbestätigung mitmailen.
IT Recht Kanzlei – Speicherort der pdf Dateien
In welchem Ordner am Server sollen die pdf Dateien gespeichert werden?
Lassen Sie diese Einstellung auf includes/pdf, damit das Modul pdf Rechnung falls installiert auf die pdf Dateien zugreifen kann.
Infos unter Tools > IT Recht Kanzlei
Unter Tools > IT Recht Kanzlei finden Sie eine Übersicht der wichtigsten aktuellen Einstellungen. So können Sie z.B. Ihre Shop URL und API Token auslesen, die Sie für Ihr Mandantenportal der IT Recht Kanzlei benötigen. Und falls Sie eine neue API Token generieren wollen ist das ebenfalls hier möglich.
Hinweise für die Aktualisierung/Bearbeitung des Impressums
In Ihrem Mandantenportal ist möglicherweise die Übertragung des Impressums nicht vorgesehen. Sollte diese Funktion in Ihrem Mandantenportal nicht verfügbar sein, müssen Sie das Impressum in Ihrem Shop manuell editieren.
Verwenden Sie dazu die entsprechende EZ Page mit der Kennung itrk-impressum.
Hinweise für mehrsprachige Shops
Normalerweise werden von der IT Recht Kanzlei nur deutschsprachige Texte bereitgestellt. Die Schnittstelle ist aber so konfiguriert, dass sie auch z.B. englischsprachige Texte – falls in Ihrem Paket verfügbar – unterstützt.
Falls Sie in ihrem Paket nur deutschsprachige Rechtstexte haben, dann werden ausschließlich die 4 deutschen EZ Pages mit den Inhalten befüllt.
Die 4 EZ Pages für deutsch und englisch sind bereits vorinstalliert.
Sollten Sie in ihrem Shop auch die englische Sprache aktiv haben, dann müssen Sie die entsprechenden englischen EZ Pages selbst mit Inhalt befüllen.
Seit Zen Cart 1.5.6 deutsch sind die EZ Pages multilingual. Für eine EZ Page in verschiedenen Sprachen wird also immer die EZ Page mit derselben ID verwendet. Und es ist nicht mehr nötig, die Shopadministration auf die jeweilige Sprache umzuschalten, um EZ Pages der jeweiligen Sprache zu bearbeiten.
Um die Inhalte der entsprechenden IT Recht Kanzlei EZ Pages für englisch zu bearbeiten, editieren Sie also einfach in der deutschen Shopadministration die bestehenden 4 speziellen EZ Pages mit den Kennungen itrk-agb, itrk-datenschutz, itrk-widerruf und itrk-impressum.
Achten Sie darauf, dass Sie die Kennungen dieser Seiten nicht ändern.
Sollten in Ihrem Paket später einmal englische Texte für den Push verfügbar sein, dann werden die englischen Texte genau in diese englischen EZ Pages gepusht.
Sollten Sie in Ihrem Shop weitere Sprachen aktiv haben, dann werden diese 4 EZ Pages genauso mür den Push des Inhalts verwendet.
Hinweise für das Modul pdf Rechnung
Falls Sie die pdf Rechnung in Zen Cart deutsch aktiv haben, dann lassen Sie vermutlich AGB und Widerruf gleich mit der Bestellbestätigung als pdf Anhänge mitmailen. Die pdfs der IT Kanzlei Schnittstelle werden – falls aktiviert – im selben Verzeichnis abgelegt, das auch die pdf Rechnung für AGB und Widerruf nutzt: includes/pdf
Das pdf der AGB ist dabei immer benannt als agb_de.pdf
Das pdf der Widerrufsbelehrung ist dabei immer benannt als widerruf_de.pdf
Stellen Sie daher unter Konfiguration > pdf Rechnung Ihre gewünschten Dateianhänge ein auf:
agb_de.pdf|widerruf_de.pdf
Sie müssen nie wieder selbst ein neues AGB pdf erstellen und per FTP in includes/pdf hochladen wenn sich Ihre AGB ändern. Die pdf Rechnung verwendet einfach immer die stets aktuellen pdfs der IT Recht Kanzlei