Quelltext der Seite Upgrade Joomla Version 3 auf Version 4

==Lokale Joomla Instanz aktualisieren==
Falls eine lokale Joomla Instanz existiert, so kann man zunächst einmal das Upgrade lokal durchführen.
*Download der Joomla Projektdaten auf den lokalen Rechner
*Export der Datenbank mit <nowiki><tt>phpMyAdmin und Import am lokalen Rechner</nowiki>
==Joomla 3==
*Im Joomla Verzeichnis den Ordner <code>tmp</code> leeren - außer index.php
===Papierkorb leeren===
Beiträge, Kategorien, Menüs
 Suchwerkzeuge | Status Papierkorb
Alle Einträge auswählen
 Papierkorb leeren
*Überprüfen, ob die aktuelle Joomla 3 Version installiert ist
 Komponenten | Joomla Update
===Update-Quelle ändern===
 Komponenten | Joomla Update
 Optionen | Update-Server | Joomla! Next
Nun wird angezeigt, für welche Erweiterungen Eingriffe nötig sind bzw. es keine Joomla 4 Version gibt.
===Kompatibilitätsprüfung===
Erweiterungen, für die es keine Joomla 4 Version gibt, der Reihe nach deinstallieren.
 Erweiterungen | Verwalten
Die zu löschenden Erweiterungen über die Suchfunktion ausfindig machen.
===Phoca Komponenten===
Folgender Schritt scheint nicht mehr nötig zu sein.
:Mit <code>phpMyAdmin</code> alle <code>phocagallery</code> Tabellen exportieren außer <code>phocagallery_styles</code>
Man kann gleich unter Joomla 3 die Phaca Gallery für Joomla 4 installieren. Dies gilt anscheinend auch für Phoca Email.
===Update auf Joomla 4 ===
Nun kann man das Update auf Joomla 4 starten.
 Live-Update
 Update installieren
==Joomla 4==
===Child Templates erstellen===
Für das '''Frontend''' und für das '''Backend''' ein Child Template erstellen
 System | Site Templates
 System | Administrator Templates
Folgende Schritte für das Site Template und das Administrator Template durchführen.
 Template Cassiopeia auswählen
 Child Template erstellen
Dem Template einfach den Namen <code>child</code> geben.

Nun auf <code>Styles</code> klicken und das Child Template als Standard setzen.
===Custom CSS===
Man kann für das Site Template eine <code>user.css</code> erstellen oder eine vorbereitete Datei kopieren nach
 media/templates/site/cassiopeia_child/css
und für das Backend
 media/templates/administrator/atum_child/css
===Template bearbeiten===
 Templates | Styles | Cassiopeia - child | Erweitert
 Brand: nein
=== Header Modul erstellen===
 Content | Site Modules | Neu | Eigenes Modul
*Dem Modul den Namen <code>Header Modul</code> geben.
* Ein Hintergrudbild auswählen
 Optionen | Hintergrundbild auswählen
 header.jpg
*Titel der Website als Text <code>H1</code>
*Dem Modul die Position <code>banner</code> zuweisen
*Titel verbergen
*Modul Stil:
 Erweitert | Modul Stil: card
===Modul Navigation - Top===
Das vorhandene Modul '''Top Menue''' bearbeiten
 Position <code>topbar</code>
 Titel verbergen
 Layout: Collapsible Dropdown
 Module Style: card
===Weitere Navigationsmodule===
Erstellen von weiteren Navigationsmodulen falls notwendig
*Position: <code>sidebar_right</code> oder <code>sidebar_left</code>
===Phoca Gallery===
*Neueste Version installieren (Version für Joomla 5)
 Komponenten | Phocagallery | Styles
Alle deaktivieren außer
 theme_standard.css
==Server Instanz aktualisieren==
Hier beschreibe ich, wie man das neu erstellte und getestete Joomla_4 Projekt vom lokalen Rechner auf den Remote-Server übertragen kann.
===Datenbank Backup am Remote Server ===
Mit <code>phpMyAdmin</code> bei allen Tabellen der Joomla Datenbank das Prefix ändern
 : Beispiel: <code>joo_</code> ändern auf <code>joo3_</code>
Im Joomla_3 Projekt am Server das Prefix in die Konfiguration eintragen.
 # configuration.php
 $dbprefix = "joo3_" 
Somit kann die alte Version weiterverwendet werden, falls nötig.
===Joomla 3 - Backup der Serverdaten===
Die Daten des Joomla_3 Projekts werden gesichert.
 cd /srv/www/htdocs
 cp -a joomla_proj joomla_proj_3
===Daten Upload ===
Die Daten der Joomla Instanz am lokalen Rechner werden nun mit einem geeigneten Programm zum Server übertragen.

Ich verwende dafür ein eigenes Script <code>upload.sh</code>, das diesen Job mit Hilfe von <code>rsync</code> erledigt und nicht mehr benötigte Dateien am Server entfernt.
 # localhost
 cd /srv/www/htdocs/joomla_proj
 upload.sh --delete
===Datenbank übertragen===
Am lokalen Rechner die Joomla_4 Datenbank mit <code>phpMyAdmin</code> in eine SQL Datei exportieren
 joomla_proj.sql
Am Server im Internet die Datei mit <code>phpMyAdmin</code> in die Joomla Datenbank importieren