ANLEITUNG ZUM UPDATE AUF ZEN-CART 1.3.9

Dies ist eine Anleitung, um eine bestehende Zen Cart™ Installation (z.B. 1.2.x oder 1.3.x auf Zen-Cart 1.3.9 zu aktualisieren. Falls Sie Zen Cart™ bisher noch nicht installiert haben sollten, lesen Sie bitte die Anleitung für eine Neuinstallation


Systemvoraussetzungen
Bitte beachten Sie, dass für Zen-Cart 1.3.9 mindestens PHP 5.2.3 und MySQL 5.x erforderlich sind

Kreditkarten-Offline-Processing
Falls Sie in ihrem derzeitigen Shop Kreditkarten- Offline-Processing einsetzen, beachten Sie bitte, dass dieses Modul aus Sicherheitsgründen in Version 1.3.9 nicht mehr enthalten ist. Ein Update auf 1.3.9 löscht in diesem Fall die in der Datenbank gespeicherten Kreditkartendaten!

Wartungsmodus nach dem Update
Nach einem Update auf Zen-Cart 1.3.9 wird der Shop automatisch in den Wartungsmodus geschaltet.


Vorweg:

HINWEIS ZU DEN ZAHLUNGS- UND VERSANDMODULEN

Sie müssen Ihre momentan genutzen Zahlungs- und Versandmodule im Rahmen des Upgrades neu installieren:

BEVOR SIE UPGRADEN:
Notieren Sie sich die Login IDs, Transaktionsschlüssel, E-Mail Adressen und andere Einstellungen, die Sie bereits in JEDEM Zahlungs- und Versandmodul eingegeben haben. Sie benötigen diese Information später bei der Neuinstallation dieser Module.
Entfernen Sie jedes Modul indem Sie auf den Butten "Entfernen" klicken.

NACH DEM UPGRADE:
Installieren Sie alle Zahlungs- und Versandmodule, die Sie benötigen, erneut. Nur so profitieren Sie von den Fehlerbehebungen und den neuen Funktionen in jedem Modul. Nicht benötigte Module brauchen Sie nicht auf diese Weise zu behandeln. Sollten Sie noch Module haben, die zwar installiert sind, aber nicht mehr genutzt werden, empfehlen wir Ihnen diese aus Performancegründen zu deinstallieren.
Geben Sie die zuvor notieren Einstellungen für jedes Modul erneut ein. TESTEN SIE JEDES MODUL um sicherzugehen, dass alle Einstellungen korrekt sind, bevor Sie Ihren Shop wieder für Ihre Kunden freigeben.

ABLAUF UND VORBEREITUNG DES UPDATES

Um Ihr Zen Cart™ zu aktualisieren brauchen Sie die gleichen Programme, die Sie für die Erstinstallation und evtl. Anpassungen benutzt haben. Ein FTP Programm, einen Texteditor für HTML/PHP Code, phpMyAdmin or Ähnliches um auf Ihre MySQL Datenbank zugreifen zu können, and den Adminbereich Ihres Webspaces.

Zusätzlich ist ein Dateienvergleichsprogramm wie WinMerge, Beyond Compare oder ExamDiff (Linux) sehr hilfreich. (Für Mac gibt es z.B. BBedit.)

Die Aktualisierung erfolgt in 3 einfachen Schritten. Nehmen Sie sich bitte Zeit und studieren Sie die einzelnen Schritte und Methoden sorgfältig. Überstürzen Sie nichts!
Und wie immer: VOR Beginn eine Sicherung aller relevanten Daten durchführen!!!

Wir empfehlen Ihnen, besonderes Augenmerk auf die Demodaten zu legen, um sich mit den neuen Features der neuen Version von Zen Cart™ vertraut zu machen.

1. Vorbereitung

Entpacken Sie alle Dateien der neuen Version von Zen Cart™, laden Sie diese auf Ihren Webserver in ein "demo" Verzeichnis und installieren Sie die neue Version - mit den Demodaten - in eine eigene Datenbank.
Diese Installation soll als Referenz dienen und Sie können sich mit den neuen Funktionen vertraut machen. Diese Installation können Sie nach der Konvertierung wieder löschen.

Studieren Sie die neuen Funktionen, die dokumentierten Änderungen der Template Struktur und ebenso die Datei "changelog.txt". Verwenden Sie die Demodateien im Demoshop als Beispielvorlage und lesen alle Supportdokumente dieser neuen Version.

Erstellen Sie eine komplette Sicherung Ihrer Datenbank (SQL Dateidump). Speichern Sie diese Datei auf Ihrem PC.

Erstellen Sie eine komplette Sicherung Ihres Webordners via FTP auf Ihrem PC und packen Sie diese dann zusätzlich in eine ZIP Datei.
Heben Sie die Sicherung auf Ihrem PC gut auf - sie wird in den weiteren Schritten der Aktualisierung noch benötigt. Eventuell benennen Sie diesen Sicherungsordner in "\zen_backup" um.

Lassen Sie uns nun die Unterschiede und notwendigen Anpassungen zwischen Ihrer Installation und den originalen Zen Cart™ Dateien herausfinden.

Entpacken Sie eine Kopie Ihrer ursprünglich installierten bzw. aktualisierten Zen Cart™ Version (z.B. v1.2.7 oder auch v1.3. in ein eigenes Arbeitsverzeichnis (z.B. "\zen_orig").

Machen Sie sich zur späteren Verwendung eine Liste Ihrer installierten Module und Add-Ons.

Vergleichen Sie nun mit einem Programm wie z.B. WinMerge o.ä. Ihre "originalen" Zen Cart™ Dateien des Ordners "\zen_orig" mit den Dateien Ihres Sicherungsordners "\zen_backup".
Schreiben Sie alle Dateien die "unterschiedlich" sind auf. Doppelklicken Sie in WinMerge auf jede Datei und notieren sich die die jeweiligen Unterschiede.
Wenn die Unterschiede nur in Sprachdateien (Ordner Languages) sind, dann sind diese leicht zu übertragen.
Alle anderen Unterschiede der Programmierung/Codes müssen detailiert aufgeschrieben werden um diese in die neue Version zu übertragen.

HINWEIS:
Eigene Modifikationen, Module und Add-Ons, die Sie bisher installiert haben, enthalten zahlreiche Änderungen in der Programmierung und können möglicherweise nicht mehr mit der neuen Zen Cart™ Version kompatibel sein.

Ihre Liste der installierten Module und Add-Ons kann Ihnen helfen, die Anzahl der gefundenen Unterschiede zu schmälern. Ebenso kann es vorkommen, dass Sie diese Module und Add-Ons noch einmal herunter laden müssen, um sich deren Readme- Datei bzw. den Code durchzusehen. Eventuell müssen Sie die Autoren der Module bezüglich einer Aktualisierung des Codes kontaktieren.

Eventuell wollen Sie an diesem Punkt einige der Änderungen direkt (gemäß der Zen Cart™ Template Override Struktur) in die neue Version einbauen. Hilfe hierzu erhalten Sie unter Zen Cart™ Webseite in den FAQ's für das Template System.


2. Durchführung

Laden Sie sich die neueste Version von Zen Cart 1.3.9 auf Ihren PC herunter. Speichern Sie diese in ein eigenes, drittes Verzeichnis (z.B. "\zen_neu").

Nehmen Sie Ihre erstellte Liste der geänderten Dateien, arbeiten Sie diese Schritt für Schritt durch und übertragen Sie Ihre Änderungen von der alten Version auf die neue Version.
Einfache Änderungen Ihrer Sprachdateien können Sie über "kopieren-und-einfügen" leicht übertragen.
Änderungen, die Sie im Programmcode durchgeführt haben, sich mit Bedacht zu übertragen und benötigen ausführliche Tests.
Das Programm WinMerge kann Ihnen hierbei sehr hilfreich sein. Wie auch immer - Sie werden viele zusätzliche Unterschiede feststellen, die nichts mit Ihren Modifikationen zu tun haben. Seien Sie bitte sehr vorsichtig bei Ihren Anpassungen des Codes, sie könnten sonst zu erheblichen Konflikten führen.

Beachten Sie bitte, dass Sie eventuell noch Änderungen Ihres selbst erstellten Templates durchführen müssen. Vergleichen Sie deshalb bitte im Bedarfsfall die Dateien Ihres Template Ordners /includes/templates/MEINTEMPLATE/* mit /includes/template/template_default/* ... dasselbe gilt auch für Dateien der Sprachfiles, Sideboxen etc.


3. Testen

Erstellen Sie eine NEUE Datenbank für die Installation Ihrer neuen Version von Zen Cart™.

Stellen Sie sicher, dass Ihre vorhandene Sicherung der Datenbank die aktuellsten Daten enthält, ansonsten führen Sie jetzt erneut eine aktuelle Sicherung Ihrer Datenbank durch.
Führen Sie nun eine Wiederherstellung der aktuellen Sicherung der Datenbank, die Sie vorher in Schritt 1 erstellt haben, in Ihrer NEUEN Datenbank durch.

Wenn in Ihrem Ordner /zen_new keine Dateien "/includes/configure.php" und "/admin/includes/configure.php" sind, kopieren Sie diese aus den alten Ordner "\zen_backup".

BEARBEITEN Sie nun die Datei "/zen_new/includes/configure.php" und stellen Sie sicher, dass der Eintrag DATABASE_NAME mit Ihrer NEUEN Datenbank übereinstimmt. Verifizieren Sie ebenso den Benutzernamen und das Passwort der Datenbank, sollten sich diese geändert haben. Speichern Sie die Datei und stellen Sie sicher, dass Sie diese in nächsten Schritt mit hochladen. Wiederholen Sie das auch für die Datei /admin/includes/configure.php.

Laden Sie die Dateien Ihrer modifizierten "neuen Version" (in Schritt 2 erstellt) auf Ihren Server in einen alternativen Ordner - z.B "/shop_neu" - hoch.

Stellen Sie sicher, dass Sie den Ordner "/zen_new/zc_install" auf Ihren Server hochgeladen haben.

Starten Sie Ihren Internetbrowser und geben Sie als Adresse "www.ihredomain.de/zc_install/index.php" ein und wählen Sie die Option "Upgrade" (Wählen Sie keinesfalls "installieren", ansonsten wir Ihre Datenbank überschrieben!). (Sollte die Option "Upgrade" nicht zur Verfügung stehen, konnte das Installationsprogramm keine Verbindung zu Ihrer Datenbank herstellen. Überprüfen Sie in diesem Fall Ihre Einstellungen in der Datei configure.php.)

Testen Sie Ihre Anpassungen, bearbeiten Sie diese ggf. und vergleichen Sie Ihre "Testinstallation" mit der Installation Ihrer neuen Version.

Wenn Sie zufrieden feststellen, dass alles OK ist, können Sie online gehen.

Sollte seit Ihrer letzten Datenbanksicherung bereits eine signifikante Zeit vergangen sein, können Sie die Schritte im Punkt "Testen" mit einer neueren, aktuelleren Datenbanksicherung wiederholen. Sie brauchen nicht noch einmal alle Dateien auf Ihren Webserver hoch laden... Eine einfache Wiederherstellung der Datenbank genügt. Anschließend starten Sie das Installationsprogramm mit der Option "Upgrade" erneut.

Wenn Sie mit Ihrem neuen Shop nun online gehen, versetzten sie diesen - über das Administrationsmenü - in den Modus "Wegen Wartungsarbeiten geschlossen". Stellen Sie sicher, dass Ihre aktuelle IP Adresse in der Liste der erlaubten IP Adressen eingetragen ist.
Wenn alle Punkte korrekt durchgeführt wurden, benennen sie auf Ihrem Webserver das Verzeichnis Shop "shop_neu" in "shop" um (vorher müssen Sie noch Ihr altes Verzeichnis "shop" in irgendetwas Anderes umbenennen).
Kontrollieren Sie, ob alle Dinge wie gewünscht funktionieren. Wenn Sie kleinere Probleme zu beheben haben, schalten Sie den Modus "Wegen Wartungsarbeiten geschlossen" nach Bedarf ein oder aus.