Gedrag - Achterwaartse compatibiliteit

Joomla staat bekend om zijn flexibiliteit, maar bij grote upgrades – zoals de stap van Joomla 5 naar Joomla 6 – kun je tegen verouderde extensies of aangepaste functionaliteiten aanlopen. Gelukkig biedt de Achterwaartse compatibiliteit / Backward Compatibility Plugin (BC Plugin) tijdelijk een oplossing. Maar hoe lang kun je daarop vertrouwen? En wat betekent dit voor jouw upgradeplanning?

Wat is de Backward Compatibility Plugin (BC Plugin)?

De Backward Compatibility Plugin is een gedragsplugin in Joomla 5 die het mogelijk maakt om oudere extensies en aangepaste code te blijven gebruiken, zelfs als ze gebaseerd zijn op verouderde functies (deprecated code).

In feite overbrugt de plugin het gat tussen oudere extensies en de moderne, veilige aanpak in Joomla 5. Veel ontwikkelaars hebben tijd nodig om hun extensies aan te passen aan de nieuwste standaarden. De BC Plugin geeft hen – en jou – de kans om over te stappen op Joomla 5, zonder dat alles meteen stukloopt.

Wat verandert er in Joomla 6?

Vanaf Joomla 6 wordt de Joomla 5 versie van de BC Plugin volledig verwijderd. Dit betekent:

• Verouderde API’s worden definitief niet meer ondersteund
• Extensies die afhankelijk zijn van de BC Plugin, zullen niet meer functioneren
• Custom code die deprecated functies gebruikt, kan fouten veroorzaken

Wil je dus upgraden naar Joomla 6? Dan moet je zorgen dat je website volledig zonder deze plugin kan draaien.

Voordat je deze plugin uitschakeld!

Let op: door het uitschakelen van deze plugin is het mogelijk dat jouw website niet meer werkt en niet meer bereikbaar is. (soms ook niet meer via de administrator) dus zorg er altijd voor dat je:

• Een werkende (dus een geteste) backup hebt van de website.
• Toegang hebt tot de database (via bijv. phpMyAdmin).
• Alle geinstalleerde extensies hebt bijgewerkt naar de meest recente versie. (let op: soms geeft een extensie, bijv. JCE Editor, niet de juiste updatemelding dus controleer deze zorgvuldig.)
• Test op een aparte testomgeving.

Schakel de Backward Compatibility plugin uit

Via System > Plugins zoek je naar de Achterwaartse compatibiliteit plugin en je schakelt deze uit door op het status icoon te klikken. Daarna controleer je of jouw website nog werkt zoals voorheen. Zorg ervoor dat je alle pagina's controleert, zoals specifieke pagina's waar een extensie actief is. bijvoorbeeld de sitemap of contactformulier)

Zorg ervoor dat je jouw website nu goed test of alles nog werkt zoals voorheen.

Jouw Joomla website werkt niet meer nadat je de Backward Compatibility hebt uitgeschakeld

Zoals hierboven uitgelegd is het mogelijk dat jouw website niet meer werkt nadat je de Achterwaartse compatibiliteitplugin hebt uitgeschakeld. Er is dus een extensie actief die verouderde code gebruikt.

Wat kun je doen om dit probleem op te lossen:

1. Schakel, indien mogelijk, de plugin weer in via de System > Plugins

2. Wanneer je geen toegang meer tot de pluginpagina hebt door een foutmelding, moet je de plugin inschakelen via de database. Hiervoor ga je naar jouw database via phpMyAdmin.
- Ga naar de tabel #__extensions (vervang #__ door jouw eigen prefix)
- Zoek naar Name Like %...% compat

Bij de zoekresultaten zie je nu de regel voor de compatibiliteitsplugin.
- Verander Enabled 0 naar 1

Bekijk jouw website en hij zal weer werken.

3. Werkt ook deze manier niet, zet dan een complete backup terug van jouw website.

Met het opnieuw aanzetten van deze plugin weet je dat je website nog afhankelijk is van verouderde code. Dit betekent dat je actie moet ondernemen vóór de release van Joomla 6.

Welke plugin dit precies veroorzaakt, is soms lastig te achterhalen. Je kunt dit doen door de verouderde code uit de foutmelding (bijv. JPlugin of JFactory) op te zoeken in de bestanden. Een programma wat ik gebruik is Fileseek. Je moet dan wel eerst alle bestanden downloaden om ze te scannen. 
Een andere manier is om plugins 1 voor 1 uit te zetten en te onderzoeken wanneer het fout gaat.

Je kunt dan:

• Contact opnemen met de ontwikkelaar van de betreffende extensie
• Zoeken naar alternatieve extensies die Joomla 6 native ondersteunen
• Custom code herschrijven of laten herschrijven op basis van de nieuwe API

Gebruik de BC Plugin dus alleen als tijdelijke oplossing. Hoe eerder je je website optimaliseert voor Joomla 6, hoe minder risico je loopt op bugs, downtime of beveiligingsproblemen.

Hulp nodig bij het uitschakelen van de BC plugin of het upgraden van jouw website? Neem contact met mij op via het contactformulier of info@joomill.nl