Project:Sandbox

Das gesamte Projekt ist (natürlich) im SVN verankert. Diese Seite beschreibt, wie der Editor auf einem neuen Server und anschließend in Kundenshops installiert wird.

Einrichtung auf dem Server
Bei der Installation müssen auf die Folgenden Dateien/Ordner im jeweiligen Multizen-Verzeichnis abgelegt werden: Des weiteren müssen in den Folgenden Dateien Anpassungen vorgenommen werden: Damit ist die Server-Seitige Einrichtung abgeschlossen.
 * /admin/email_template_editor.php
 * /admin/includes/classes/PHPHtmlParser
 * /admin/includes/classes/StringEncode
 * /admin/includes/classes/cvs_html_css_parser.php
 * /admin/includes/classes/email_template_editor.php
 * /admin/includes/extra_datafiles/email_template_editor

Einrichtung im Kundenshop
Wenn der Editor auf dem Server verfügbar ist, muss dieser nur noch für den Kunden "freigegeben" werden.

Menü-Eintrag
Da sich der Email Template Editor bei dem ersten Aufruf von selbst konfiguriert, muss nur noch der Eintrag im Menü des Webman erfolgen. Hierfür liegt bereits ein fertiges SQL-Statement in /admin/includes/extra_datafiles/email_template_editor/sql/admin-menu-entry.sql

Sobald dieses Statement in der entsprechenden Datenbank ausgeführt worden ist, findet man den Email Template Editor im Webman-Menü unter der Kategorie Tools als letzten Eintrag.

First Run
Beim ersten Aufruf des Editors wird die Tabelle mzen_email_template_editor automatisch erzeugt.

Für die Einrichtung stehen drei Möglichkeiten zur Verfügung: Bei der Einrichtung wird immer ein automatisches Backup des aktuellen Email Template Ordners erzeugt. Die Backups sind mit Datumsangabe versehen und werden bis sie gelöscht werden, in /caches/email_template_editor_backup/ gespeichert
 * 1) (standard) es werden die neuen CVS-Tempates genutzt und eingerichtet
 * 2) die aktuellen E-Mail Templates werden versucht zu importieren.
 * 3) Hierbei kann es zu Problemen in der Darstellung kommen, wenn Syntax-Fehler im HTML vorliegen.
 * 4) Weitergehend kann es passieren, dass der Editor das CSS, welches nicht im Element selbst steht, nicht korrekt parst.  Dies liegt daran, da die Priorität vom CSS-Selector bezugnehmend auf die jeweiligen Elemente nicht beachtet wird.
 * 5) aus einer Konfigurations-Datei den Editor wiederherstellen/einrichten
 * 6) Die Datei muss im JSON-Format vorliegen und wird bei der Editor-eigenen Export-Funktion erstellt und zum Download bereitgestellt.  Die Konfigurations-Dateien sind nicht Shopspezifisch erstellt, womit eine Einrichtung in einem weiteren Shop problemfrei möglich ist.

Troubleshooting
Oftmals kann es vorkommen, dass der Template-Editor keine Schreibberechtigung für das Email Template Verzeichnis im Shop des Kunden hat. Hier müssen die Verzeichnis- und Datei-Rechte so gesetzt werden, dass der Editor schreibrechte bezitzt.

Sollte das Problem öfters auftreten, kann es sein, dass auf dem Server ein Cron-Job läuft, der die Verzeicnisrechte automatisch anpasst. Dieser muss dann ggf. ebenfalls angepasst werden.