Auf 4.7.0/5.0.0 aktualisieren Diese Anleitung beschreibt das Update auf OXID eShop Version 4.7.0 (Community und Professional Edition) und Version 5.0.0 (Enterprise Edition). Es unterscheidet sich grundlegend vom Standard-Update und kann nur auf einen OXID eShop Version 4.6.5, 4.6.6, 4.6.7 oder 4.6.8 angewandt werden. Haben Sie eine vorhergehende Shopversion im Einsatz, muss diese zuerst auf eine dieser Versionen aktualisiert werden. Hinweis: Um das Update nach dieser Anleitung ausführen zu können, müssen OXID eShop 4.6.5 bis 4.6.8 und OXID eShop 4.7.0/5.0.0 auf dem gleichen Server installiert sein. Der OXID eShop 4.6.5 bis 4.6.8 ist der zu aktualisierende Shop. Beim OXID eShop 4.7.0/5.0.0 handelt es sich um eine komplette Neuinstallation. Wir empfehlen dringend, das Update erst in einer Test- oder Entwicklungsumgebung, einer Kopie Ihres aktuellen Shops, auszuführen. Testen Sie anschließend den Shop und legen Sie dabei besonderen Wert auf die Funktionen des Bestellprozesses, auf Zahlungs- und Versandarten. Arbeitet der Shop korrekt, kann der Shop im Live-System durch den aus der Test- oder Entwicklungsumgebung ersetzt werden. Alternativ können Sie das Update auch im Live-System erneut ausführen. Kopieren Sie während des Updates im Live-System eine index.html in das Hauptverzeichnis des Shops, in der Sie auf aktuelle Wartungsarbeiten hinweisen. Sie können den Shop auch deaktivieren und die Datei offline.html zur Informationen Ihrer Kunden nutzen. Das Update kann unter Verwendung der Anwendung updateApp ausgeführt werden. Dabei wird die Datenbank aktualisiert und es werden ein eigenes Theme und/oder installierte Module in den neuen Shop verschoben. Wenn Sie einen stark angepassten Shop haben und Theme und/oder Module selbst kopieren oder verschieben wollen, lesen Sie bitte den Abschnitt Manuelles Update . Update per Script 1. Sicherungskopien anfertigen Erstellen Sie eine Sicherungskopie aller Shopdateien und der Datenbank Ihres bestehenden OXID eShop 4.6.5 bzw. 4.6.6. 2. Neuen Shop installieren Installieren Sie einen OXID eShop 4.7.0/5.0.0 auf dem gleichen Server, auf dem der OXID eShop 4.6.5 bzw. 4.6.6 läuft. 3. Alte Datenbank verbinden Verbinden Sie den OXID eShop 4.7.0/5.0.0 mit der Datenbank des OXID eShop 4.6.5 bzw. 4.6.6. Editieren Sie dafür die Konfigurationsdatei config.inc.php des OXID eShop 4.7.0/5.0.0 und ändern Sie die Einträge für den Datenbanknamen, den Datenbankbenutzer und dessen Passwort. 4. updateApp ausführen Das Update-Paket enthält das Verzeichnis /updateApp mit einem kleinen Programm, welches die Datenbank bearbeitet sowie Theme und/oder Module in den neuen Shop verschiebt. Kopieren Sie das Verzeichnis /updateApp in das Hauptverzeichnis des installierten OXID eShop 4.7.0/5.0.0. Rufen Sie in Ihrem Browser www.ihreshopurl.de/updateApp auf. Ersetzen Sie dabei www.ihreshopurl.de durch die URL Ihres OXID eShop 4.7.0/5.0.0. Das Programm fragt, ob es Theme und Module in den neuen Shop verschieben soll. Bejahen Sie diese Frage, müssen Sie den Pfad zum OXID eShop 4.6.5 bzw. 4.6.6 angeben. Sie finden den Pfad in der Konfigurationsdatei config.inc.php des OXID eShop 4.6.5 bzw. 4.6.6. Bitte beachten Sie, dass Updates bei großen Datenbanken viel Zeit beanspruchen können. Setzen Sie den Parameter max_execution_time in der php.ini der Test- oder Entwicklungsumgebung auf einen angemessenen Wert, um ein Timeout bei der Verarbeitung zu vermeiden. Löschen Sie das Verzeichnis /updateApp, wenn das Datenbank-Update fertig ist. 5. Views aktualisieren Gehen Sie im Administrationsbereich des OXID eShop 4.7.0/5.0.0 zu Service -> Tools und aktualisieren Sie die Views. Falls Sie sich nicht im Administrationsbereich anmelden können, setzen Sie vorübergehend den Parameter blSkipViewUsage in der Konfigurationsdatei config.inc.php auf "true". 6. Artikelbilder kopieren Kopieren Sie alle Artikelbilder aus dem OXID eShop 4.6.5 bzw. 4.6.6 in den OXID eShop 4.7.0/5.0.0. Diese befinden sich standardmäßig im Verzeichnis /out/pictures. 7. Templates anpassen Passen Sie die Templates eines eigenen Themes an den OXID eShop 4.7.0/5.0.0 an. Die Template-Dokumentation befindet sich im Update-Paket und unterteilt sich in /templ_docu_application_views_admin, /templ_docu_application_views_azure und /templ_docu_out_azure. Theme "Basic" ist nicht mehr länger Bestandteil des Shops. Basiert Ihr eigenes Theme darauf, sollten Sie auf Theme "Azure" umstellen. Wie das Theme "Basic" weiter mit OXID eShop 4.7.0/5.0.0 verwendet werden kann, erklärt dieses englische Tutorial auf OXIDforge: http://oxidforge.org/en/use-basic-theme-from-version-4-7-and-5-0-on.html. 8. Temporäre Dateien löschen Löschen Sie alle Dateien und Ordner außer der .htaccess aus dem Verzeichnis /tmp des Shops. 9. Theme und Module aktivieren Aktivieren Sie im Administrationsbereich ggf. das eigene Theme und/oder die Module. Manuelles Update 1. Sicherungskopien anfertigen Erstellen Sie eine Sicherungskopie aller Shopdateien und der Datenbank Ihres bestehenden Erstellen Sie eine Sicherungskopie aller Shopdateien und der Datenbank Ihres bestehenden OXID eShop 4.6.5 bzw. 4.6.6. 2. Neuen Shop installieren Installieren Sie einen OXID eShop 4.7.0/5.0.0 auf dem gleichen Server, auf dem der OXID eShop 4.6.5 bzw. 4.6.6 läuft. 3. Alte Datenbank verbinden Verbinden Sie den OXID eShop 4.7.0/5.0.0 mit der Datenbank des OXID eShop 4.6.5 bzw. 4.6.6. Editieren Sie dafür die Konfigurationsdatei config.inc.php des OXID eShop 4.7.0/5.0.0 und ändern Sie die Einträge für den Datenbanknamen, den Datenbankbenutzer und dessen Passwort. 4. Datenbank aktualisieren Führen Sie die SQL-Anweisungen aus der Datei 49955.sql aus. Verwenden Sie dafür beispielsweise die Eingabemöglichkeiten im Administrationsbereich des Shops unter Service -> Tools oder Tools wie phpMyAdmin. Die Datei 49955.sql befindet sich im Verzeichnis /updateApp/updates/sql des Update-Paketes. 5. Views aktualisieren Gehen Sie im Administrationsbereich des OXID eShop 4.7.0/5.0.0 zu Service -> Tools und aktualisieren Sie die Views. 6. Theme installieren Soll ein eigenes Theme verwendet werden, führen Sie bitte nachfolgende Installationsschritte aus. Legen Sie Verzeichnisse für das Theme unter /out und /application/views an Kopieren Sie die Verzeichnisse mit den Sprachdateien, den Templates und die Metadata-Datei theme.php in das Verzeichnis /application/views/[theme] Kopieren Sie die Verzeichnisse mit den Stylesheet- und JavaScript-Dateien sowie Bilder des Themes nach /out/[theme] 7. Module installieren Stellen Sie sicher, dass die Module für die neue Shopversion vorbereitet sind. Kopieren Sie die Module in das Verzeichnis /modules 8. Artikelbilder kopieren Kopieren Sie alle Artikelbilder aus dem OXID eShop 4.6.5 bzw. 4.6.6 in den OXID eShop 4.7.0/5.0.0. Diese befinden sich standardmäßig im Verzeichnis /out/pictures. 9. Templates anpassen Passen Sie die Templates eines eigenen Themes an den OXID eShop 4.7.0/5.0.0 an. 10. Theme und Module aktivieren Aktivieren Sie im Administrationsbereich ggf. das eigene Theme und/oder die Module. Das Update ist abgeschlossen. Tragen Sie die korrekte Shop-URL in die Konfigurationsdatei config.inc.php des OXID eShop 4.7.0/5.0.0 ein. Die Dateien des OXID eShop 4.6.5 bzw. 4.6.6 werden nicht mehr benötigt, sobald der aktualisierte Shop live geht. Auch die bei der Neuinstallation des OXID eShop 4.7.0/5.0.0 erstellte Datenbank kann gelöscht werden.