Joomla 4.4.x to 5.x Planning and Upgrade Step by Step/nl

Waarschuwing

Introductie

Goed nieuws voor Joomla 4.4.x naar 5.x, het is een upgrade, geen migratie. Waarom? Twee belangrijke redenen:

1. Joomla 4 (J4) extensies die alle verouderde code hebben verwijderd en up-to-date Joomla code gebruiken, werken in Joomla 5 (J5)
2. De meeste andere werken met de nieuwe Gedrag - Achterwaartse compatibiliteit plugin geactiveerd

Deze documentatie weerspiegelt het eenvoudige proces door het combineren van het plannen en stap voor stap in een document. Je hebt toch wat vaardigheden nodig. Bekijk de Zelfbeoordeling om te ontdekken of je zelf wel of niet de upgrade uitvoert.

Behulpzame links voor third-party extensie ontwikkelaars

Plannen 4.4.x naar 5.x

Hosting/Technische specificatie

1. Bepaal of de hosting-omgeving voldoet aan de vereisten.

Je kunt niet naar Joomla 5 upgraden als de server omgeving niet voldoet aan de minimum technische vereisten. De optie om te upgraden verschijnt niet in de Joomla Update component.

• PHP 8.1
• MySQL 8.0.13
• MariaDB 10.4.x (testen tonen aan dat J3, J4, en J5, compatibel zijn met MariaDB 10.4.x)
• PostgreSQL 12.0

Je kunt je systeeminformatie in de Joomla 4 site controleren door te klikken op Systeem -> Systeeminformatie. Neem contact op met je hosting provider als de server niet voldoet aan de vereisten.

Het volgende is een voorbeeld van een omgeving dat voldoet aan de technische vereisten. Het toont MySQL 8.0.31, PHP 8.2.0 en Joomla 4.4.3.

2. Controleer alle extensies op comptabiliteit met Joomla 5

Er zijn een aantal third-party extensie scenario's voor deze upgrade.

1. De extensie kan compatibel zijn met zowel J4 en J5 zonder gebruik te maken van de Achterwaartse compatibiliteit plugin.
2. De extensie kan compatibel zijn met zowel J4 en J5 MET gebruik van de Achterwaartse compatibiliteit plugin.
3. De extensie lijkt te werken in J5, maar als je hem probeert te gebruiken gaat hij stuk.
4. De extensie breekt de hele site.

Maak je geen zorgen! Het is niet zo erg als het klinkt! Laten we het eerst hebben over de Achterwaartse compatibiliteit plugin.

De Achterwaartse compatibiliteit Plugin

De Gedrag - Achterwaartse compatibiliteit Plugin is een poging om third-party extensies toe te staan classes te gebruiken die niet meer in Joomla 5 zitten.

Als een upgrade van J4.4.x naar J5 wordt uitgevoerd, wordt de Achterwaartse compatibiliteit plugin automatisch geaciveerd. Bij nieuwe installaties van J5 wordt de Achterwaartse compatibiliteit plugin standaard geactiveerd.

De Achterwaartse compatibiliteit plugin ondersteund extensies die werken in J4 ook te werken in J5. In J6, zullen de J4 extensies niet achterwaartse compatibel zijn met de plugin ingeschakeld. Dit geeft extensie ontwikkelaars twee extra jaar om hun extensies compatibel met J5 te maken zonder de Achterwaartse compatibiliteit plugin. De bedoeling is dat met iedere hoofdrelease een Achterwaartse compatibiliteit plugin komt die de voorgaande hoofdrelease tot de hoofdrelease erna ondersteund.

Kun je de de Achterwaartse compatibiliteit plugin op enig moment deactiveren in J5? Goed vraag. Na vaststellen dat iedere third-party extensie compatibel is en volledig functioneel zonder dat de Achterwaartse compatibiliteit plugin geactiveerd is, kan de Achterwaartse compatibiliteit plugin gedeactiveerd worden. Dat zeggende bevelen we voorzichtigheid aan. Voor de Achterwaartse compatibiliteit plugin te deactiveren wordt aanbevolen een van de volgende dingen te doen:

1. Doe het op een dev/test site. Op deze manier, als je per ongeluk een extensie hebt gemist die het beheergedeelte ontoegankelijk maakt, dan brengt het je productie website niet in gevaar.
2. Zorg dat je toegang hebt tot de database. Op die manier kun je, indien noodzakelijk, de plugin snel opnieuw activeren. Meer hierover verderop.

Voor-update controle t.o.v. Systeem -> Beheren - Extensies

Theoretisch, zou de Voor-update controle je moeten vertellen of je third-party extensies compatibel zijn met J5. Echter, de Voor-update controle is alleen behulpzaam als alle extensie ontwikkelaars van hun extensie de comptabiliteit van de extensie laat weten. In een perfecte wereld zou het Extensie deel van de Voor-update controle je moeten vertellen of een extensie of:

• Ge-upgraded kan worden zonder de Achterwaartse compatibiliteit plugin geactiveerd
• Ge-upgraded kan worden met de Achterwaartse compatibiliteit plugin geactiveerd
• Of een update van de extensie noodzakelijk is voor te upgraden van J4 naar J5
• Of een extensie volledig niet-compatibel is

Testen hebben verschillen getoond tussen extensies die compatibel zijn en die dat niet zijn. Dit is geen probleem met de voor-update controle component. Extensie ontwikkelaars sturen liever informatie via hun extensie die de voor-update controle juist vullen. Als hun extensies niet gecodeerd zijn om de voor-update controle de juiste informatie te vertellen, dan is er heel weinig (niets) dat de voor-update controle nog het Joomla! project hieraan kan doen. Een goede bron voor informatie zou de website van de third-party extensie ontwikkelaar zijn om te controleren hoe de bepaalde extensie behandeld moet worden tijdens de upgrade van J4 naar J5.

De afbeelding hieronder toont een voorbeeld van de voor-update controle component in Joomla 4.4.x in de Extensie sectie.

De bovenste sectie toont de extensies die een update nodig hebben. Ga naar Systeem -> Update -> Extensies en update je extensies.

De middelste sectie toont extensies waarvan de update-informatie van de extensie-ontwikkelaar ontbreekt. Je weet niet of deze wel of niet compatibel zijn zonder ze te testen of contact op te nemen met de ontwikkelaar.

De onderste sectie toont de extensies welke geen update nodig hebben. Dit betekent dat deze extensies Joomla vertellen dat ze compatibel zijn met Joomla 5. Er is niet aangegeven of ze de Achterwaartse comptabiliteit plugin al dan niet nodig hebben.

Weet dat deze extensies niet aanbevolen worden door het Joomla Project. Deze extensies worden alleen als voorbeeld getoond. Ze zijn willekeurig gekozen uit de JED als test.

Aanbevolen wordt om alleen het Extensies gedeelte van de Voor-update controle component te gebruiken als extreem hoog niveau overzicht, maar niet een 100% bron van de waarheid. Om het anders te verwoorden je kunt de Voor-update controle component niet vertrouwen met de extensies die je gebruikt.

Wat is de bron van de waarheid dan? Systeem -> Beheren Extensies

Vanuit Extensies: Beheren scherm, ben je in staat alle third-party extensies die je gebruikt op de site te zien. In de schermafbeelding hieronder zie je het hoofdscherm. In de Auteur kolom, kun je de naam van een populaire extensie ontwikkelaar in een paar regels vinden. Je ziet de auteur van het Joomla Project ook in een aantal regels.

Controleer je third party extensies. Je zult vervolgens ontdekken of ze compatibel met J5 zijn (met of zonder de achterwaartse comptabiliteit plugin) of niet. Als dat niet zo is, dan zal de update niet succesvol zijn.

Drie manieren om je third-party extensies te controleren op J5 compatibiliteit

1. Controleer op de website van de ontwikkelaar.
2. Maak een backup/kopie van je J4 site, restore het op een sub-domein, zet debug aan, volg onderstaande stappen om te upgraden naar J5. Kijk of er iets stuk loopt. Als het kapot loopt, deactiveer elke extensie die een fout veroorzaakt en noteer de extensie. Je moet contact op nemen met de ontwikkelaar aangezien hij niet compatibel met J5 is.
3. Installeer een nieuw J5 pakket op een subdomein, activeer de Gedrag - Achterwaartse compatibiliteit Plugin, installeer alle extensies die je gebruikt en kijk of het werkt.

Let op: De Joomla! Extensions Directory JED toont Joomla 5 compatibele badges van extensies die compatibel zijn met of zonder gebruik van de Achterwaartse compatibiliteit plugin.

Je zou een combinatie van bovenstaande kunnen doen. Begin met een schone installatie en test je extensies. Als je weet welke wel of niet werken, dan kun je met de ontwikkelaars bepalen waar ze zijn met de ontwikkelingen voor J5. DAN, als al je extensies werken op een schone site, weet je of je een volledige upgrade van J4.4.x naar 5.x kunt testen.

Je wilt misschien weten of een extensie werkt zonder de Achterwaartse comptabiliteit plugin geactiveerd. In dat geval wil je toegang tot de database. Plan dit. Wees er zeker van dat je toegang tot de database hebt.

Na het installeren van J5, is de Achterwaartse comptabiliteit plugin geactiveerd. Je moet hem uitschakelen. Ga naar 'Plugins', filter op type 'Gedrag' en deactiveer 'Gedrag- Achterwaartse comptabiliteit'. Installeer elke extensie een voor een. Als het je site om zeep brengt activeer je de Achterwaartse comptabiliteit plugin via de database.

De Achterwaartse comptabiliteit Plugin kan in de database gevonden worden in de database in de _extensions tabel. Het heet plg_behaviour_compat. Zet het Enabled veld op 0 om de plugin te deactiveren. 1 om de plugin te activeren. Door de Achterwaartse comptabiliteit plugin opnieuw te activeren, krijg je weer toegang tot Joomla (zolang de extensie werkt met de Achterwaartse comptabiliteit plugin).

OF

Je kunt de extensie in de database uitschakelen zodat je verder kunt testen met je andere extensies om te zien of ze functioneren zonder de compatibiliteit plugin geactiveerd. Deze entries staan in de #_extensions tabel. Je verandert het Enabled veld in 0 om de extensie uit te schakelen.

In sommige gevallen, als je een extensie in J5 installeert die niet compatibel is met of zonder de Achterwaartse comptabiliteit plugin geactiveerd, moet je de entries in de database vinden voor die extensie (er kunnen er een paar of veel zijn) en ze uitschakelen tot je weer toegang krijgt tot het beheergedeelte. Deze entries staan in de #_extensions tabel. Je verandert het Enabled veld in 0 om de extensie uit te schakelen. Als je het beheergedeelte weer kunt bereiken, kun je hem deïnstalleren via Systeem -> Beheren -> Extensies en informatie inwinnen bij de ontwikkelaar.

Cassiopeia, Recaptcha, Weblinks, Schema.org, en Search (com_search niet Smart Search)

Cassiopeia

Cassiopeia blijft het frontend template voor Joomla 5. Je aanpassingen zouden nog steeds goed moeten zijn, we adviseren het testen op een ontwikkelsite aan om daarvan zeker te zijn. Bootstrap zal bijgewerkt zijn naar Bootstrap 5.3 in Joomla 4.4.0. Als er Bootstrap inconsistenties in je template zitten, dan zijn ze al zichtbaar in 4.4.0. Dus zouden de meeste, zo niet alle, problemen gevonden moeten worden voor de upgrade naar J5.

Google reCAPTCHA

Als je Google reCAPTCHA gebruikt in J4, zou je dit moeten vervangen door Invisible reCAPTCHA voor het upgraden naar Joomla 5 (of een third-party oplossing). J5 bevat Google Recaptcha niet meer. De Recaptcha plugin zal gedeïnstalleerd worden bij de upgrade naar J5. De Invisible reCAPTCHA plugin bestaat nog als je upgrade vanaf 4.4.x. Je kunt hem activeren en instellen met nieuwe sleutels, zodat je Invisible reCAPTCHA gebruikt. Of je kunt een andere third-party oplossing gebruiken. Schone installaties van Joomla 5.x bevatten geen reCAPTCHA plugins in de core. Schone installaties van Joomla 5.x moeten gebruik maken van een third-party plugin/soplossing.

com_weblinks

De Weblinks extensie werkt in J5 zonder de Achterwaartse compatibiliteit plugin geactiveerd in versie 4.3.0+. 4.3.0 op Github. Weblinks in de JED.

Schema.org Plugin

Met Joomla! 5 is een nieuwe en meer dynamische manier voor het afhandelen van rich snippets (gebaseerd op https://schema.org/) data geïmplementeerd. Standaard is het opgezet op een manier dat de informatie voor zoekmachines hetzelfde is als in Joomla 4, maar om de uitvoer aan te passen, ga je naar Systeem => Beheren => Plugins en zoek je naar de systeem plugin “Syteem - Schema.org”. Bewerk de plugin om je site informatie toe te voegen voor een juist gebruik van de functinaliteit. Lees meer over Rich Snippets in dit magazine artikel.

com_search

com_search is niet beschikbaar in Joomla 5. Deïnstalleer hem voor het upgraden naar Joomla 5. Je moet nu Slim zoeken (com_finder) gebruiken.

Oefenrondje

Als onderdeel van je planning wordt aanbevolen je upgrade te testen op een sub-domein of lokaal om uit te vinden of het perfect werkt. Zorg ervoor dat je alle stappen bijhoudt die je moet maken zodat je upgrade perfect plaats vindt.

Als je je upgrade op een subdomein of localhost hebt getest, en het perfect werkt, kun je een back-up van je productie site nemen en hier een upgrade uitvoeren. Stap voor stap instructies staan hieronder.

Stap voor stap upgrade

De site die je aan het upgraden bent moet voldoen aan de technische vereisten en op Joomla 4.4.x draaien om te kunnen upgraden. Als je site nog niet op Joomla 4.4.x draait moet je upgraden naar 4.4.x voor te upgraden naar J5.

1. Volg alle instructies in de Plannen sectie (boven) voor het upgraden.

2. Back-up je website.

3. Update alle extensies die bijgewerkt moeten worden.

4. Deactiveer of deïnstalleer alle extensies die niet compatibel zijn met J5.

5. Als je de oude zoek component (com_search) gebruikt een andere verwante modules, deïnstalleer deze voor het upgraden.

6. Als je Google reCAPTCHA gebruikt deactiveer deze dan en begin in plaats daarvan met het gebruik van Invisible reCAPTCHA.

7. Zet Debug aan (Algemene instellingen -> Systeem tabblad -> Foutopsporing systeem op Ja).

8. Back-up je website opnieuw.

9. Test je back-up zodat je weet dat hij werkt. (Ja, doe dit. Je voelt je beter.)

10. Ga naar Systeem -> Update -> Joomla

11. Klik op Opties in de bovenste Werkbalk rechts.

12. Wijzig het Updatekanaal in Volgende Joomla

13. Klik op Opslaan & sluiten in de bovenste werkbalk.

14. Als je server voldoet aan de technische vereisten zie je het volgende scherm met links in de linker zijbalk met Vereiste instellingen, Aanbevolen instellingen en Extensies.

15. De kans is groot dat je Vereiste instellingen en Aanbevolen instellingen goed zijn, aangezien het scherm niet zichtbaar wordt als de omgeving niet voldoet aan de technische vereisten. Extensies zouden niet juist kunnen zijn. Kijk bij sectie Planning (boven) over de Voor-update controle en waarom het geen groen vinkje kan hebben maar nog steeds allemaal compatibele extensies kan hebben. Je hebt je testen al uitgevoerd (juist?), je weet dus al of ze al dan niet compatibel zijn.

16. De Achterwaartse compatibiliteit plugin zal geactiveerd worden tijdens de upgrade van Joomla 4.4.x naar 5.x.

17. Als je de instructies niet gevolgd hebt in de Planning (boven) voor het Oefenrondje, stop nu en ga terug naar de planning sectie en volg de instructies. Planning is het belangrijkste deel van deze upgrade.

18. Als je zeker bent dat al je extensies compatibel zijn met J5 en je de upgrade hebt getest en het resultaat perfect was, kun je het vinkje aanklikken om de waarschuwingen te erkennen over de potentieel niet compatibele extensies en doorgaan met met de update, klik OK in het pop-up scherm en klik daarna op de update knop.

19. Daarna vraagt je site opnieuw te bevestigen dat je een back-up hebt gemaakt (wat je hebt gedaan en waarvan je het installeren hebt getest).

20. Je site voert de upgrade naar J5 uit.

21. Een succesvolle upgrade toont dit scherm

22. Je ziet dat je site Joomla 5 is in de rechter bovenhoek van het scherm.

23. Test de front-end van je site.

24. Test het beheergedeelte van je site.

25. Schakel foutopsporing uit in Systeem -> Algemene instellingen -> Server tabblad.

26. Verbeter indien nodig je nieuwe Slim zoeken.

27. Stel je schema plugin in, zoals beschreven in het planning gedeelte van dit document.

28. Geniet van een lekker drankje en verwonder je over hoe geweldig je bent.

Wat als het mis gaat?

Als je alles van tevoren hebt getest zou dat niet moeten. Maar het is mogelijk dat er iets in de omgeving is veranderd of dat er code is veranderd in een extensie tussen het testen en de upgrade.

Because you enabled Debug before you started, you should be able to see the extension that causes the issue and disable it (this may need to happen from the database if you can no longer access the backend to disable it). That way your site will be up and running whilst you figure out what went wrong, and fix it.

In het ergste geval kun je je back-up restoren zodat je tijd hebt om uit te vinden wat er fout ging in de testomgeving.

Database Repareren zou enkele van je problemen kunnen oplossen. Navigeer naar het Systeem - Controlepaneel en klik op Database.

Op de Onderhoud: Database pagina, worden de database structuur problemen getoond die de site mogelijk heeft. Vink het gewenste vakje aan en daarna klik je op de Structuur bijwerken knop in de bovenste werkbalk.

Andere plekken om hulp te krijgen

Joomla Forum: Migration & Upgrade Board 5.x

Joomla Community op Mattermost