Migratie van Joomla 1.5 naar Joomla 1.6

Inmiddels is Joomla 1.6 officieel vrijgegeven, en gelijk zijn er veel vragen ontstaan hoe men een Joomla 1.5 site kan migreren naar Joomla 1.6. Op deze pagina zult u stap voor stap door de algemene procedure worden geleid.

Inmiddels is Joomla 1.7.0 verschenen. Alhoewel deze handleiding is gemaakt voor het migreren van 1.5.x naar 1.6 kunt U deze nog steeds gebruiken om rechtstreeks van 1.5.x naar 1.7 te migreren. Zorg dat u de laatste versie download van de component jUpgrade en volg verder deze handleiding. U hoeft dus niet eerst naar 1.6 te migreren.
Lees voor het updaten van 1.6.x naar 1.7.0 deze handleiding

Voordat u begint met de upgrade

Het realiseren van Joomla 1.6 kostte drie jaar om te ontwikkelen. Ontelbare uren zijn besteed door vele vrijwilligers uit de hele wereld. Hoewel veel van de code hetzelfde is als in Joomla 1.5, zijn er toch nog wat extra opties toegevoegd. De veranderingen zijn te vergelijken met de veranderingen van Joomla 1.0 naar 1.5.

Omdat de veranderingen van Joomla 1.5 naar 1.6 zo groot zijn, is het niet mogelijk om een simpele update te doen, maar is een migratie noodzakelijk.

Met het bekende jUpgrade (een 3e partij extensie), is het mogelijk om te migreren van Joomla 1.5 naar Joomla 1.6. Deze extensie zorgt ervoor dat er een nieuwe 1.6 installatie op uw site komt te staan. Deze site vindt u na migratie terug in de map jupgrade op uw server. Als uw site bijvoorbeeld eerst stond op www.uwsite.nl, dan is de 1.6 site na migratie te vinden op www.uwsite.nl/jupgrade.

Voordat u definitief begint

Voordat u echt aan de slag gaat, zijn er een paar dingen die erg belangrijk zijn om te controleren of over na te denken.

1. Is uw Joomla 1.5 versie wel up-to-date? Op het moment van schrijven van deze documentatie is de laatste versie van de 1.5 serie, Joomla 1.5.22. Een groot deel van het testen van de migratie is gedaan met Joomla 1.5.22. Het is verstandig om voordat u begint met migreren een upgrade uit te voeren naar Joomla 1.5.22 (vooral als u nog werkt met Joomla 1.5.11 of lager).

2. Zijn alle extensies die u gebruikt al voor Joomla 1.6 beschikbaar? Op het moment van schrijven van deze documentatie zijn er net iets meer dan honderd extensies voor Joomla 1.6 beschikbaar op de JED. Let wel op dat jUpgrade momenteel niet in staat is om de Joomla 3e partij extensies te upgraden.

3. Heeft u dingen gewijzigd in de core bestanden? Alle wijzigingen die u in de Joomla core- bestanden heeft gemaakt, zullen verdwijnen. Wees gewaarschuwd!

4. Is er een Joomla 1.6 template beschikbaar welke u wilt gebruiken voor uw nieuwe site?  Eventueel kunt u uw eigen template ook aanpassen zodat deze ook werkt met Joomla 1.6. Daarbij zijn een paar goede hulpmiddelen:
   - Chad Windnagle's Joomla Community blog
   - Chris Davenport's "Template Changes for Joomla 1.6" presentation
   - Joomla's Docs Template Tutorial
   

5. Is uw taalpakket beschikbaar voor Joomla 1.6? Het Nederlandse taalbestand, vindt u hier, en is vertaald door het vertaalteam van JoomlaCommunity.eu.

6. Heeft u de juiste permissies ingericht in uw Joomla 1.5 installatie? Vindt hier een Engelstalige handleiding.

7. Is het echt noodzakelijk om te gaan migreren naar Joomla 1.6? Kijk bijvoorbeeld eens in deze top 10 met verbeteringen in 1.6. Joomla 1.5 is nog steeds krachtig. Voor veel mensen is er geen reden om overhaast over te stappen naar Joomla 1.6. Joomla blijft de 1.5- serie voor nog minstens 1 jaar en drie maanden ondersteunen, door het vrijgeven van beveiligingsupdates en bug updates wanneer dat nodig is.
   

8. Heeft u de MooTools plugin aangezet in uw Joomla! 1.5 installatie? Dit kunt u doen bij Extensies->Pluginbeheer.
   

Maak altijd een back-up!

Het overslaan van dit onderdeel is misschien wel de grootste fout die u kunt maken. Als u een goede back-up (of meerdere) maakt, kunt u deze altijd gemakkelijk terugzetten indien er iets misgaat. Echter, als u geen goede back-up hebt, kost het veel tijd om uw gegevens terug te zetten.

Upgraden van Joomla! 1.5 naar Joomla! 1.6 met jUpgrade

Wat zijn de vereisten

- De server moet geschikt zijn voor Joomla! 1.6.
- de Curl module van PHP moet zijn ingeschakeld (vraag eventueel uw hoster als u dit niet weet)
- Een bestaande Joomla 1.5 installatie
- Een browser die Javascript/jQuery ondersteunt (dus bijvoorbeeld Windows Internet Explorer niet, maar Firefox wel)

Downloaden

De jUpgrade component is als zip-bestand te downloaden via http://www.matware.com.ar/downloads/joomla/jupgrade.html.

Installatie

Log-in als administrator op uw 1.5 site en ga naar Extensies->Installeer/Deïnstalleer en installeer op de gebruikelijke manier het gedownloade jUpgrade pakket (het gedownloade zip-bestand).

Het 'upgraden'

1. In het administratie venster moet nu bij het menu Componenten jUpgrade staan als de installatie daarnet is geslaagd.

   
   

2. Klik op jUpgrade en een nieuw venster verschijnt: Start Upgrade

   
   

3. Bekijk bij 'Voorkeuren' ('Preferences' ) of de configuratie juist is en pas zo nodig aan. Waarschijnlijk is dit niet nodig.
   

   
   

4. Klik op het plaatje 'Start Upgrade'

5. U kunt de voortgang van het upgrade proces nu volgen:

   - Checking..: check DONE
   - Downloading Joomla 1.6…: 8480345 bytes/8480345 bytes
   - Decompressing package…
   - Installing Joomla 1.6 …
   - Upgrading progress…: Migrating … weblinks
   - Upgrading templates…
   - Upgrading 3rd extensions… COMING SOON
   - Joomla 1.6 Upgrade Finished!
   

   
   

6. Onder aan de pagina staan nu 2 links: naar de website en het administratiegedeelte. Klik op 1 van beiden om het resultaat te zien.

7. Eerst (ter herinnering) de oorspronkelijke Joomla 1.5 site met alle voorbeelddata.

   
   

   En daaronder zoals de site er na de migratie uitziet

   
   

8. Bekijk nu het oorspronkelijke 1.5 administratievenster

   
   

   En het nieuwe 1.6 administratievenster

   
   

9. Nu gaat het eigenlijke werk beginnen: de ‘finetuning’ om de site naar uw eigen wensen in te richten en nieuwe extensies toe te voegen.

   Tenslotte: de volledige gemigreerde site staat in een nieuwe map ‘jupgrade’. De oude site is gewoon intact gebleven, dus als er ergens niet goed gegaan is of het resultaat u niet zint, is er niets verloren: u kunt gewoon opnieuw beginnen. Als u de site wilt verplaatsen naar de hoofdmap, lees dan dit artikel.
   

Eventuele problemen

Als het downloaden van het Joomla 1.6 pakket om de een of andere reden tijdens het migratieproces niet lukt kunt u het zelf downloaden via http://anonymous:@joomlacode.org/svn/joomla/development/branches/jupgrade/pack/joomla16.zip en met behulp van uw ftp software in de Joomla 1.5 tmp directory plaatsen.

Bij de voorkeuren (preferences) (zie hierboven onder 3) moet 'Skip Download' op 'Yes' gezet worden. Daarna kan het proces opnieuw opgestart worden.

Met dank aan forumleden Ad Louter en Rick Kupers die dit artikel hebben vertaald en samengesteld