Copyright Karl-Heinz. Derhake 2012 Seite 2 Version 1.6

Transkript

1

2 1 Vorwort: Fast vier Jahre lang mussten die Joomla Nutzer warten, bis die neue Joomla 2.5 Version verfügbar war. Während dieser Zeit wurden hunderttausende Joomla 1.5 Websites erstellt, die nun aktualisiert werden wollen. Dies ist aber leider mit einem einfachen Kopieren der neuen Dateien nicht gemacht. Deshalb habe ich eine Schritt für Schritt Anleitung dazu erstellt. Die Umstellung bedarf einiger Planung und Vorbereitung, wenn sie auf Anhieb Erfolg haben soll. Man benötigt außerdem einige Stunden Zeit und sollte in der Handhabung von Joomla kein Anfänger sein. In diesem Migrations- Handbuch behandele ich grundsätzlich zwei Themen. Zum einen zeige ich die Umstellung von Joomla 1.5 nach Joomla 2.5, zum anderen die Migration von VirtueMart zu VirtueMart 2.0.x. Da besonders bei der Migration von VirtueMart einige vorbereitende Arbeiten notwendig sind und diese sehr stark auch Joomla selbst betreffen, habe ich beide Themen zusammengefasst. Wenn sie nur Joomla 1.5 nach Joomla 2.5 umstellen möchten, ignorieren Sie einfach die Beschreibungen für den jeweiligen VirtueMart-Teil. Sie betreiben einen Onlineshop unter Joomla 1.5.x und VirtueMart 1.1.x und möchten auf die neue Joomla Version 2.5 und VirtueMart 2.0.x umsteigen. Wir zeigen Ihnen in diesem Handbuch Schritt für Schritt die Migration von Joomla 1.5.x nach Joomla 2.5 und des Shops VirtueMart 1.1.x nach VirtueMart 2.0x. Das Ganze ist nicht ganz simpel. Deshalb zeigen wir die Migration an drei realen Beispielen, da es derzeit drei verschiedene Möglichkeiten gibt, auf die neuen Versionen zu wechseln. VirtueMart 2.0.x ist kein Update von 1.1.x-Version sondern eine komplette neue Entwicklung. Aus diesem Grund ist ein einfaches Upgrade/Update nicht möglich, sondern es ist eine Migration notwendig. Migration heißt in unserem Fall, Joomla 2.5.x und VirtueMart 2.0.x müssen neu installiert werden und die Daten, so weit wiemöglich aus Joomla 1.5.x und VirtueMart 1.1.x übernommen werden. Copyright Karl-Heinz. Derhake 2012 Seite 2 Version 1.6

3 Wichtig zu wissen: Bei der Migration werden nicht alle Daten aus VirtueMart 1.1.x übernommen. Es wird also evtl. Verluste geben. So werden z.b. keine Produkttypen-, Produktattribut- Daten übertragen. Hier ist dann eine manuelle Nachpflege notwendig. Wenn Sie einen Shop für downloadbare Produkte, zum Beispiel Software, ebooks usw. umstellen wollen, ist hier zusätzliche Arbeit angesagt. Achtung: Lesen Sie zunächst das gesamte ebook, bevor Sie mit der Umstellung beginnen. Die neue VirtueMart Version 2.0.x unterstützt den Verkauf von Downloadprodukten nur über eine kostenpflichtige Zusatzsoftware. Die ist zwar sehr preiswert und funktioniert hervorragend, aber die Logik unterscheidet sich total von der der alten VirtueMart Version. Deshalb müssen für alle Downloadartikel nach der Migration, die zu verkaufenden Dateien manuell eingespielt und den Produkten zugeordnet werden. Je nach Umfang der Joomla 1.5.x und VirtueMart 1.1.x Installation kann das nachträgliche Anpassen aufwendig sein und einiges an Zeit beanspruchen. Es gibt eine weitere Hürde, die Sie evtl. umschiffen müssen: Wenn Sie in Ihrer Joomla 1.5.x und VirtueMart 1.1.x Installation SEO Erweiterungen (z.b. von Yagendoo) installiert haben, werden sich die daraus resultierenden Links von denen in der späteren Joomla 2.5.x und VirtueMart 2.0.x unterscheiden. Das ist leider nicht trivial, da dann alle bereits bei den Suchmaschinen gelisteten Links zu Ihren Seiten ins Leere laufen. Das muss natürlich unbedingt verhindert werden. Auch auf diese Problematik gehen wir im Zuge dieser Dokumentation ein und zeigen Ihnen eine Lösung dazu auf. 1.1 Tools für eine Migration: Für eine Migration von Joomla 1.5.x und VirtueMart 1.1.x nach Joomla 2.5 und VirtueMart 2.0.x sind, je nach der Variante, die Sie bevorzugen, unterschiedliche Copyright Karl-Heinz. Derhake 2012 Seite 3 Version 1.6

4 Migrationstools notwendig: Die Migration der Daten von Joomla 1.5.x nach Joomla 2.5.x kann zum Beispiel mit dem kostenlosen Tool jupgrade erfolgen. Hierbei müssen allerdings einige Einschränkungen berücksichtigt werden, auf die wir im Zuge dieser Dokumentation entsprechend eingehen werden. Sie finden Sie das Tool hier. SP Upgrade, SP Upgrade ist eine kommerzielle Lösung für die Joomla Migration. Für knapp 25 Euro erhält man dieses Tool, das auch die meisten Joomla Links (nicht VirtueMart) korrekt (ausgenommen mehrsprachige Webseiten) setzt und weniger Nacharbeit erforderlich macht. Hier finden Sie es. Die VirtueMart 2.0.x Komponente beinhaltet ein eigenes Migrationstool, hier muss nichts zusätzlich installiert werden. 2 Die generelle Vorbereitung: Die aktuelle Website unter Joomla 1.5.x und VirtueMart 1.1.x muss zunächst einmal gesichert werden, damit im Fall, dass etwas schief geht, eine Rekonstruktion generell möglich ist. Dazu benutzt man am besten die Erweiterung Akeeba Backup (Die Handhabung finden Sie in unseren Handbüchern.). Noch viel besser ist es, die Migration an einer exakt gleichen Testumgebung, also einer hundertprozentigen Kopie Ihrer Website durchzuführen. Die Testversion kann entweder eine lokale Installation unter XAMPP oder eine parallele Installation unter einer Subdomain auf Ihren Online-Server sein. Ratschlag: Wenn Sie noch keine Erfahrungen mit Joomla 2.5.x und VirtueMart 2.0.x haben, sollten Sie sich in einer lokalen Testumgebung zunächst einmal mit Joomla 2.5 und VirtueMart 2.0.x vertraut machen. Nur mit diesem Wissen können Sie letztendlich beurteilen, welche Arbeiten nach der Migration noch manuell notwendig sind und wie diese durchgeführt werden müssen. Ohne umfangreiche Erfahrung mit Joomla 2.5.x und VirtueMart 2.0.x benötigen Sie in jedem Fall ein gutes Handbuch zu beiden Systemen. Hier finden Sie es. Sollten Sie sich unsicher sein, ob Sie die Umstellung selbst durchführen wollen, bieten wir Ihren die Umstellung auch als Serviceleistung Copyright Karl-Heinz. Derhake 2012 Seite 4 Version 1.6

5 an. 3 Drei unterschiedliche Wege führen zum Ziel: Generell kann eine Migration auf drei unterschiedliche Arten durchgeführt werden: Migration Variante 1: In der ersten Variante migriert man Joomla 1.5.x nach Joomla 2.5.x mit dem Tool jupgrade. Da das Tool jupgrade in der derzeitigen Version nicht mit der VirtueMart 2.0 umgehen kann, muss man diese Migration separat durchführen. Die dafür notwendigen Tools bringt die neue VirtueMart Version 2.0.x selbst mit. Zur Vorbereitung der Migration mit jupgrade müssen alle nicht kompatiblen Erweiterungen in Joomla 1.5.x deinstalliert werden. Das gilt leider auch für alle VirtueMart Tools. Dabei werden dann allerdings auch die Datenbanktabellen von VirtueMart 1.1.x gelöscht. Diese müssen vorher unbedingt gesichert werden. Dazu später mehr. Migration Variante 2 Bei der zweiten Möglichkeit überträgt man nur die VirtueMart Datentabellen aus dem VirtueMart 1.1.x. unter Joomla 1.5.x in ein jungfräuliches Joomla 2.5.x mit bereits installiertem VirtueMart 2.0.x. Die Übertragung erfolgt per SQL-Export/Import z.b. mit phpmyadmin. Diese Variante ist besonders dann zu empfehlen, wenn man in der Joomla Basis nur wenige Beiträge und Kategorien hat. Mit wenig meine ich nicht mehr als zum Beispiel Beiträge. Der Vorteil bei dieser Variante ist, dass man ein absolut sauberes Joomla 2.5 System ohne jegliche Altlasten bekommt, in das man dann die wichtigsten VirtueMart 1.1.x Daten übernimmt. Das ist eine schnelle und problemlose Lösung. Achtung: Bei dieser Variante werden keine Kundendaten aus der Joomla Basis übernommen. Die Variante eignet sich nur für die Übernahme von Artikel- Kategoriedaten. Migration Variante 3 Bei dieser dritten Variante installiert man zunächst eine komplett neue Joomla 2.5.x Copyright Karl-Heinz. Derhake 2012 Seite 5 Version 1.6

6 Website ohne Beispieldaten. Anschließend führt man eine Migration mit dem Tool SP Upgrade durch. Dabei werden alle Inhalte der Joomla 1.5 Website (auch die VirtueMart- Daten/ Tabellen) übernommen. Nun installiert man in der neuen Joomla 2.5.x Website die neue VirtueMart 2.0.x Komponente ohne Beispieldaten. In einem weiteren Schritt müssen alle Produktbilder aus der VirtueMart 1.1.x zur neuen Joomla 2.5 Website manuell übertragen werden. Im Anschluss daran erfolgt eine Migration der Daten für VirtueMart 2.0.x in der neuen Joomla 2.5 Website. Wir werden in diesem Handbuch auf jede der drei Möglichkeiten eingehen und Ihnen die Umsetzung jeder Variante Schritt für Schritt erklären und mit Beispielen näher bringen. Vorteile der Varianten 2 und 3: Diese beiden Varianten haben den Vorteil, dass man keinerlei Altlasten mitschleppt und alte Komponenten, Templates, Module und Plugins, die man vergessen hat zu deinstallieren, das System nicht instabil machen können. Hier kommt dann auch der Vorteil des Migrations- Tool SP Upgrade zum Tragen. Denn mit diesem kostenpflichtigen Tool können Sie nun, ohne großen Vorbereitungsaufwand, alle Core Inhalte und die VirtueMart Tapellen ihrer bisherigen Joomla 1.5 Website übernehmen. 4 Vorbereitende Arbeiten: Bevor man so richtig mit dem Upgraden loslegen kann, muss man erst mal ein paar vorbereitende Arbeiten für die Migration von Joomla tätigen. Die Vorbereitungen für Joomla sind abhängig von der jeweiligen Variante der Migration, die sie für die Umstellung von Joomla 1.5 nach Joomla 2.5 verwenden möchten. Dazu mehr im Kapitel vorbereitende Arbeiten für die Migration von Joomla. Copyright Karl-Heinz. Derhake 2012 Seite 6 Version 1.6

7 4.1 Vorbereitende Arbeiten für VirtueMart: Generell sollte eine Migration immer nur mit den neuesten/letzten Versionen erfolgen. Bei der zu übertragenden Website sollten in jedem Fall die Versionen Joomla und VirtueMart vorliegen. Ist das nicht der Fall, muss dieser Zustand zunächst hergestellt werden. Diese hier nachfolgend beschriebenen vorbereitenden Arbeiten müssen zunächst, für alle drei Varianten, durchgeführt werden Vorbehandlung der Bilder: Die Bilder für die Produkte, Kategorien, Hersteller etc. in der VirtueMart 1.1.x Version liegen in andern Ordnern als bei der neuen VirtueMart Version. Deshalb müssen diese Bilder verschoben werden, damit das neue VirtueMart 2.0.x diese nach der Migration finden kann. Die Order: /product/ unter /components/com_virtuemart/shop_image/, /category/ unter /components/com_virtuemart/shop_image/, /vendor/ unter /components/com_virtuemart/shop_image/, müssen rekursiv verschoben werden nach /images/stories/virtuemart/. Wir wechseln dazu in den Ordner /IhreWebseite/images/stories und legen hier einen neuen Ordner mit dem Namen virtuemart an Ordner der VirtueMart 1.1.x umbenennen oder alle VirtueMart Tools deinstallieren (nicht für Variante 3): Wenn Sie die Variante 1 mit jupgrade verwenden, müssen Sie entweder die Ordner der alten VirtueMart-1.1.x Version umbenennen oder alle VirtueMart Tools deinstallieren. Die Ordner umbenennen, z.b. in /com_virtuemart_alt, damit diese für das neue VirtueMart 2.0.x nicht mehr sichtbar sind und bei der Neuinstallation nicht, als schon existent, stören. Copyright Karl-Heinz. Derhake 2012 Seite 7 Version 1.6

8 Umbenannt werden müssen: der Ordner com_virtuemart im Komponenten-Ordner /components, der Ordner com_virtuemart im Admin-Ordner unter /administrator/components. Hinweis: Ich empfehle Ihnen, alle VirtueMart Tools zu deinstallieren, wir haben damit die besseren Erfahrungen gemacht. Hierbei müssen aber die Datenbanktabellen der VirtueMart 1.1.x Version vorher unbedingt ausgelagert werden. Alles Weitere dazu in der Variante Plugins und Module der VirtueMart 1.1.x deinstallieren nicht für Variante 3): Wenn Sie die VirtueMart Ordner nicht umbenannt haben (Variante 1), müssen sämtliche VirtueMart 1.1.x -Erweiterungen (Plugins und Module) deinstalliert werden, weil diese unter VirtueMart 2.0.x nicht mehr funktionieren. Nicht kompatible Plugins oder Module können beim Aufruf der Website, nach der Migration, Fehler verursachen und die Seitenanzeige dadurch komplett verhindern Die Frontendsprache in Joomla 2.5 angleichen: Die Standard-Frontendsprache von Joomla 2.5 muss genau auf die Sprache eingestellt werden, wie sie unter VirtueMart 2.0.x für die Originaltexte z.b. für die Produkt- und Kategorie- Beschreibungen abgelegt sind. Dieses muss unbedingt beachtet werden, da VirtueMart 2.0.x die Mehrsprachigkeit unterstützt und andernfalls falsche Zuordnung trifft, die dann sehr mühsam von Hand korrigiert werden müssen. 4.2 Vorbereitende Arbeiten für die Migration von Joomla: Seien Sie sich im Klaren darüber, dass Ihre Webseite nebst der Joomla Basis- Installation auch noch diverse Komponenten, Module und Plugins sowie ein Template enthält. Alle diese Elemente müssen ebenfalls unter Joomla 2.5 lauffähig sein oder bleiben. Falls Sie ein vorhandenes Joomla 1.5 Template übernehmen wollen, Copyright Karl-Heinz. Derhake 2012 Seite 8 Version 1.6

9 5.4 Datenbank Aktualisierungs-Werkzeug aktivieren: Starten der Migration in Virtuemart 2.0.x: Joomla 2.5 im Modulbereich anpassen: Probleme mit Plugins nach Upgrade von Joomla 1.5 zu Joomla 2.5: Beispiel zur Migrations-Variante 2: Datenbanktabellen Exportieren und Importieren: Admin Tools zum ändern des Joomla Prefix: VirtueMart Datenbanktabellen aus Joomla 1.5.x exportieren: Ausgelagerte Datenbanktabellen in der neuen Joomla 2.5 Installation einlesen: VirtueMart 2.0.x unter Joomla 2.5.x installieren: Standard-Shopsprache in Virtuemart 2.0.x einstellen: Datenbank Aktualisierungs-Werkzeug aktivieren: Starten der Migration in Virtuemart 2.0.x: Beispiel zur Migrations-Variante 3 mit SP Upgrade: Website mit SP Upgrade umstellen: SP Upgrade vorbereiten: Handhabung der IDs: Benutzerdaten zuweisen: Datenbanktabellen übernehmen z.b. von VirtueMart 1.1.9: VirtueMart 2.0.x unter Joomla 2.5.x installieren: Vorbehandlung der Bilder: Standard-Shopsprache in VirtueMart 2.0.x einstellen: Datenbank Aktualisierungs-Werkzeug aktivieren: Starten der Migration in Virtuemart 2.0.x: SEO Problematik Fehlerhafte Links führen zur neuen Website: Links auf die neue Joomla 2.5.x Website führen ins Leere: Copyright Karl-Heinz. Derhake 2012 Seite 71 Version 1.6

10 8.1.1 Die zu Joomla 2.5.x gehörendende Komponente Umleitungen: Fehlerhafte Links per Redirect umleiten: Qlue Custom installieren und konfigurieren: Auch bei den Links zu den VirtueMart Seiten muss nachgearbeitet werden: Probleme und deren Beseitigung: Probleme mit der MwSt.: Nicht übertragene Daten: Inhaltsverzeichnis: Copyright 2012, EasyBay-Web Ltd., Karl-Heinz Derhake. Alle Rechte vorbehalten. Dieses Buch darf - auch auszugsweise - nicht ohne die schriftliche Zustimmung des Autors kopiert werden. Alle Zuwiderhandlungen werden unnachgiebig verfolgt. Haftungsausschluss: Die Inhalte dieser Publikation wurden sorgfältig recherchiert, aber dennoch haftet der Autor nicht für die Folgen von Irrtümern, mit denen der vorliegende Text behaftet sein könnte. Copyright Karl-Heinz. Derhake 2012 Seite 72 Version 1.6