Hoe migreer of upgrade je Joomla 3 naar Joomla 4 - stap voor stap handleiding
Joomla 4 is de nieuwste versie van Joomla die enorm veel nieuwe functies krijgt en daarbij echt snel is. In dit artikel laat ik zien hoe je Joomla 3 kunt upgraden naar Joomla 4.
Joomla 4 verhoogt de minimaal ondersteunde PHP-versie naar PHP 7, daarnaast zijn eerder afgeschreven functionaliteiten verwijderd. Joomla 4.0 is gebaseerd op Joomla Framework 2.0 en nieuwe Core User Interface die de moeite waard is om naar uit te kijken!
Joomla 3.10 bevat backward compatibiliteit met API veranderingen en het zal vooral een brugversie zijn tussen Joomla 3.x en Joomla 4. Je dient je website bij te werken naar Joomla 3.10, echter alleen als jij je website wil bijwerken naar Joomla 4. Belangrijk is om de upgrade goed te testen in een testomgeving voordat jij je productiewebsite daadwerkelijk upgrade, volg daarbij onderstaande stappen.
In 6 stappen Joomla 3 migreren naar Joomla 4
- Maak een back-up van je website
- Controleer de technische vereisten
- Update Joomla 3.9.x site naar Joomla 3.10
- Joomla 4 pre-update controle
- Update Joomla 3.10 site naar Joomla 4
- Testen gemigreerde Joomla 4 website
Maak een back-up van je website
Het maken van een backup is een essentiële taak voor jou als beheerder. Met een backup kan jij je website herstellen indien er iets mis gaat. Je kunt de website eenvoudig herstellen door een back-up te terug te zetten, ook wel restoren genaamd. Maak altijd voor alle update en upgrade acties een backup van je Joomla installatie voordat je begint. Je moet een goede back-up extensie te gebruiken om de meest effectieve back-up te krijgen, Akeeba is een van de meest populaire back-up extensies voor Joomla en ook al geschikt voor Joomla 4.
Lees ook mijn artikel: Installatie van en een backup maken met Akeeba Backup in Joomla 4
Controleer de technische vereisten
De technische- of systeemvereisten van Joomla 4 zijn aangepast. Je kunt de technische vereisten in je huidige Joomla website controleren via de back-end. Log in op je backend en klik in het menu op Systeem gevolgd door Systeem informatie.
Vereisten voor Joomla 3.x:
Software | Recommended | Minimum | More Information |
PHP | 7.3 + | 5.3.10 | https://www.php.net |
Supported Databases | |||
MySQL | 5.5.3 + | 5.1 | https://www.mysql.com |
SQL Server | 10.50.1600.1 + | 10.50.1600.1 | https://www.microsoft.com/sql |
PostgreSQL | 9.1 + | 8.3.18 | https://www.postgresql.org/ |
Supported Web Servers | |||
Apache | 2.4 + | 2.0 | https://www.apache.org |
Nginx | 1.8 + | 1.0 | https://www.nginx.com/resources/wiki/ |
Microsoft IIS | 7 | 7 | https://www.iis.net |
Vereisten voor Joomla 4.x:
Software | Recommended | Minimum | More Information |
PHP | 7.4 + | 7.2.50 | https://www.php.net |
Supported Databases | |||
MySQL | 5.6 + | 5.6 | https://www.mysql.com |
PostgreSQL | 11.0 + | 11.0 | https://www.postgresql.org/ |
Supported Web Servers | |||
Apache | 2.4 + | 2.4 | https://www.apache.org |
Nginx | 1.18 + | 1.10 | https://www.nginx.com/resources/wiki/ |
Microsoft IIS | 10 + | 10 | https://www.iis.net |
Update Joomla 3.9.x site naar Joomla 3.10
De Joomla 3.10 en Joomla 4 stabiele versies zijn uitgebracht op 17 augustus 2021. Mijn advies is om je live of productiewebsite nog niet direct te updaten naar Joomla 3.10 of Joomla 4, zonder een grondige test gedaan te hebben! Maak een testomgeving aan en restore daar een backup van je live versie. Volg dan onderstaande stappen.
- Log in op de back-end van je Joomla 4 omgeving, ga hiervoor naar de url: https://<jedomein.nl>/administrator, mocht je uitgelogd zijn.
- Als je gebruik maakt van Joomla versie 3.9.x, dan komt na 17 augustus 2021, de 3.10 versie automatisch in beeld.
Je kunt deze probleemloos updaten, ook als je nog NIET wil upgraden naar Joomla 4!
Er wordt minimaal 2 jaar ondersteuning gegeven op Joomla 3.x. Je kunt op je gemak upgraden.
Zie onderstaande afbeelding, klik op de afbeelding voor een vergroting (geld voor alle onderstaande print screens). - Klik op de knop Update nu om je huidige Joomla versie (in dit voorbeeld 3.9.28) te upgraden naar Joomla 3.10.
- Er komt een waarschuwing in beeld, lees deze en zorg dat je een back-up hebt.
- Klik op de knop Installeer de update, zie bovenstaande print screen.
- Als de upgrade van Joomla 3.9.x naar 3.10 succesvol afgerond is, komt onderstaande melding in beeld.
- Ga nu naar de volgende stap.
Joomla 4 pre-update controle
De brugversie Joomla 3.10 introduceert een ingebouwde optie namelijk de Pre-Update Checker. Je controleert met de Pre-Update Checker of alle extensies en templates geschikt zijn voor Joomla 4. Ik raad aan om deze checkup altijd te doen voordat jij je website update naar Joomla versie 4. In Joomla Pre-Update Checker wordt een checklist getoond, met daarin de extensie(s) of template(s), die nog niet klaar zijn voor Joomla 4, of die je moet bijwerken om compatibel te zijn. Indien er geen update beschikbaar is, dan dien je de extensie(s) of template(s) te verwijderen. Houd er rekening mee dat er dan functionaliteit verloren gaat! Deze kun je na de upgrade herstellen door ze te vervangen met extensies of templates die wel geschikt zijn voor Joomla 4.
Extra tip is: verwijder alle overbodig geworden extensies voordat je gaat upgraden, ook eventuele ongebruikte modules, plugins etc. Dit is een mooie aangelegenheid om zaken op te schonen in Joomla 3.
Database Schema check
- Klik in het menu op Extensies gevolgd door Beheren en dan op het Database tab.
- Als de databaseschema niet up to date is, klik dan op de Repareren knop.
De database wordt dan alsnog bijgewerkt. Hieronder een print screen die aangeeft data de databasetabellen structuur in orde is. Links de knop Repareren, mocht jouw database niet in orde zijn.
Update check
- Klik in het menu op Componenten gevolgd door Joomla! update
- Klik dan op Controleer op updates, de Pre Update Checker (Voor-update controle voor Joomla 3.10.0) geeft dan bijvoorbeeld onderstaande informatie weer.
Je kunt op [Meer detail] klikken voor meer informatie.
Groen betekend -> geen problemen.
Oranje betekend -> waarschuwing
Rood betekend -> dat er geen update informatie beschikbaar is, dus de betreffende extensie of template is NIET geschikt voor Joomla 4.
Hieronder een voorbeeld van OSMap versie 4.3.1. Hieruit blijk dat deze extensie (nog) geen compatibele versie biedt voor Joomla 4, of dat er geen informatie over compatibiliteit beschikbaar is.
Uit voorzorg heb ik OSMap versie 4.3.1 inclusief de Joomlashack extensies verwijderd!
Dan kan via het menu Extensies, gevolgd door Beheren en nogmaals beheren.
Vervolgens heb ik gezocht op OSMap en dan heb ik de bijbehorende onderdelen geselecteerd en op de knop Deinstalleren geklikt.
Update Joomla 3.10 site naar Joomla 4
- Om nu de volgende release versie te installeren moeten we een aanpassing doen, hiervoor klik je op de knop Opties.
- Pas nu het Updatekanaal aan van Standaard naar Volgende Joomla zoals hieronder te zien is
- Klik dan op de knop Opslaan en Sluiten (zie pijl vorige print screen van stap 2) er komt een melding in beeld dat de instelingen succesvol opgeslagen zijn.
- Ga dan naar het Tabblad Live update, plaats een vinkje bbij de opmerking "Wilt u de waarschuwingen over mogelijk niet compatibele plugins negeren en doorgaan met de upgrade?
Er komt een extra waarschuwing in beeld via een pop-up. Klik op de knop OK. - Klik dan op de knop Installeer de update.
- Er komt dan een melding in beeld over de Joomla! versie update status
Gefeliciteerd je hebt succesvol Joomla 4 geinstalleerd.
Je zult vast nog even moeten wennen aan de compleet vernieuwde back-end van Joomla.
Testen gemigreerde Joomla 4 website
Nadat je website geupgrade is, test dan de gehele website op de werking, werken:
- Alle menu-items
- Alle extensies, bijvoorbeeld contactformulieren, gastenboeken, foto-albums etc.
- Fomulieren, worden de e-mails verzonden zoals verwacht?
- Kun je een nieuwe back-up maken?
- Kun je inloggen op de front-end pagina?
- De 404 pagina en bedankt pagina's?
- Etc.
Tot slot
Persoonlijk verwacht ik dat veel problemen zullen ontstaan met het update naar Joomla 4 van hun template(s) en oudere extensies. De kans is vooral groot als het gaat om gratis extensies of templates.
Niet alle templates zijn geschikt voor Joomla 4, tenzij je de standaard templates van Joomla gebruikt zoals bijvoorbeeld Protostar. Ruim op voorhand oude extensies op, zeker als je ze niet meer gebruikt.
Handige aanvullende links
- Lees meer over de pre-update checker:
https://docs.joomla.org/Pre-Update_Check - Lees meer over de planning voor een mini-migratie:
Planning voor mini-migratie - Joomla 3.10.x naar 4.x - Joomla! Documentation - Lees meer over de template overwegingen tijdens een migratie:
Template-overwegingen tijdens een migratie - Joomla! Documentation
Lees ook mijn artikel: Joomla 4 update wordt niet getoond? Hier is de oplossing
Terug naar het overzicht Terug naar categorie Installatie