Joomla 2.5 til 3.x skridt for skridt migrering

From Joomla! Documentation

This page is a translated version of the page Joomla 2.5 to 3.x Step by Step Migration and the translation is 28% complete.

Outdated translations are marked like this.
Other languages:
български • ‎català • ‎dansk • ‎Deutsch • ‎English • ‎español • ‎فارسی • ‎français • ‎Bahasa Indonesia • ‎Nederlands • ‎português do Brasil • ‎русский • ‎Türkçe • ‎中文(台灣)‎
Stop hand nuvola.svg.png

Det følgende er en skridt for skridt vejledning i migrering af dit 2.5.x websted til 3.x. Selvom der er hundredvis af forskellige scenarier, så vil dette give dig den basale procedure som du skal følge. Meget komplekse migreringer vil oftest være et resultat af installerede tredje-parts udvidelser. Du opfordres til at kontakte udviklerne af tredje-parts udvidelserne der er installeret i dit Joomla system, for at få deres vejledning til hvordan udvidelsen migreres.


Migreringen fra Joomla 2.5 til 3.x betragtes som en mini-migrering. Det er fordi Joomla kerne udvidelserne opgraderes med en "en-kliks" opgradering via Joomla! opdateringskomponenten i backend administrator delen af Joomla. Mange tredje-parts udvidelser er også en-kliks opgraderbare. Nogen er ikke. Du er nødt til at kigge på hver enkelt og bestemme hvilke skridt der skal tages for at komme fra 2.5 til 3.x. Hvis du ikke allerede har gjort det, så kan du måske være interesseret i at læse Selv evaluering og Planlægning af 2.5 to 3.x migrering inden du følger skridtene nedenunder.

Joomla kerne udvidelser:

  • Kategorier
  • Artikler
  • Menuer
  • Moduler (kerne moduler - ikke tredje-parts)
  • Bannere
  • Kontakter
  • Beskeder
  • Nyhedsfeed
  • Omdiriger
  • Søg
  • Smart søg
  • Weblink

For meget store eller komplekse 2.5 til 3.x migreringer

En-kliks opdateringen vil fungere fint for mange. For nogle større og mere komplekse websteder, vil en-kliks opdateringen måske ikke være den bedste metode. For store og meget komplekse websteder, vil det måske være bedre at følge vejledingen for en regulær migrering og tilsidesætte en-kliks opdateringsfunktionaliteten. For at gøre dette, følg de samme vejledninger som for Planlægning af migrering 1.5 til 3.x og Migrering fra Joomla 1.5 til 3.x, skift blot 1.5 ud med 2.5 mens du læser.

Skridt for skridt

Opsæt en udviklingsplacering

  1. Tag en backup af dit live 2.5 websted. Du kan anvende et foreslået værktøj (se bunden af siden) eller du kan gøre dette manuelt
  2. Vær sikker på at dit miljø opfylder de tekniske krav for Joomla 3 inden du fortsætter
  3. Opret en ny database og ny bruger for at genskabe dit 2.5 websted hertil.
  4. Opret et testwebsted eller arbejdsområde til at arbejde i og genskab backup kopien af dit 2.5 websted på et af følgende steder:
  5. På din testplacering, opdater din Joomla 2.5 installation til den seneste vedligeholdelsesudgivelse (aktuelt 2.5.28).
  6. Vær sikker på at du har det seneste database skema opdateret til den seneste version 2.5.28 ved at gå til: Udvidelser → Database fanen. Hvis dit skema ikke er opdateret som på det følgende billede, så klik på knappen Reparer: J25-admin-extension-database-fix-en.png
  7. Test.
  8. Tag backup igen.


  1. Empty trash: Do you have any articles in the trash? If so, delete them (and any applicable media that may be associated with them if not in use elsewhere on the site). Articles (categories and menu items too) left in the trash can cause issues in having a migration to complete without errors.
  2. Test.
  3. Backup again.

Assess Each Extension

  1. You are going to be looking at every single extension installed on your site. You will be determining if they need to be updated to the latest version or uninstalled. In Joomla! 2.5.28 you can go to Extension Manager  Update tab and click Find Updates which will add a tooltip in the Version column, under the Manage tab, giving some compatibility information from the backend. This functionality only supports extensions that update via the Extension Manager Update tab. If you have extensions installed that do not use the Joomla extension update then they need to be assessed manually as detailed below. The same goes for those extensions that have a tooltip. You will still need to check the type of package and migration path with the extension developer to verify how to upgrade/migrate.
  2. Go to Extension Manager  Manage tab
  3. Click the drop-down for Type.
  4. Select Package from the drop-down.
    Selecting Package first is recommended because if there is something you need to uninstall in a package, it will automatically uninstall the associated Modules, Plugins, or anything else in the package at one time.
  5. Uninstall any Packages that are no longer needed or will not be migrating to Joomla 3.
  6. Repeat this process of going through the Manage tab for all Types in the drop-down: Component, File, Language, Library, Module, Plugin and Template. If the Author states Joomla! Project, then leave those extensions alone. Smart Search is a Joomla core supported extension even though the Author fields are blank. For all others, make sure that you uninstall those not in use or not compatible with Joomla! 3.x.
    NOTE! You will not be able to uninstall any Template that is set as default. You will need to select a Core supported template like Beez or Atomic and then uninstall the template if you need to do so.
  7. Make a note of any versions of Packages and Components currently running that you will be keeping on your site. You can use the Third-Party Extension Inventory Worksheet or just copy/paste them into a document for reference.
  8. Update all extensions to the latest versions.
  9. Before and as you update, note if the extensions have both 2.5 & 3.x versions in the same package. If so, they will be fine to "one-click update." If not, and 2.5 and 3.x have different packages, you need to look at them case by case. They will normally fall into one of the following scenarios:
    • The extension has separate packages but upon upgrading to 3.x, they automatically detect this and still work. Make sure the developer confirms this.
    • The extension has separate packages that need to be uninstalled in 2.5 and then installed with the Joomla 3.x version once the site is migrated. An example of this might be a content plugin. It is very simple to uninstall it in 2.5 and then install it again in 3.x.
    • See Template Considerations for more specific information on templates.
Note on Core Supported Extensions: If you are using a Core Supported Extension (Banners, Contacts, Messaging, Newsfeeds, Redirect, Search, Smart Search, or Weblinks) in Joomla! 2.5 and it has been decoupled in Joomla! 3.4+, Joomla will detect their use during the upgrade and install those Core Supported Extensions automatically.

Going to Joomla! 3.x

Joomla! 2.5.28 can only be migrated to the latest Joomla 3.x in two steps. First migrate to version 3.5.1.

Download the Joomla! 3.5.1 Upgrade Package (.zip) package at the Joomla! 3.5.1 download page. You'll find the package in the Update Existing Joomla! Installations section. Scroll about half-way down the page. The description reads, "This package is for performing updates from Joomla! 2.5 and previous 3.x releases to 3.5.1."

Once you have either updated or uninstalled your third-party extensions so that only those compatible with Joomla! 3 remain in your installation, continue with the following steps:

  1. Go to Site  Global Configuration  Server tab and turn Error Reporting from System Default to Maximum. Make sure to Save & Close.
  2. Go to Extensions  Plugin Manager and enter Remember Me into the Filter and press enter.
  3. Disable the Remember Me plugin by clicking the green check mark and making it a red circle.
  4. Take another backup.
  5. Recommended but not required: Fix assets. (Fixing the assets table). See below for a tool to do this in just a few clicks.
  6. Go to Components  Joomla Update. (It should say no updates found. If it doesn’t, update Joomla to the latest version and test. Then do another backup.) Click on the Options button at the top right corner.
  7. Select Short Term Support (This is the current text - it may be different in the future) from the drop-down for Update server.
  8. Klik på Gem & luk.
  9. Du vil så se din installerede Joomla version, den seneste Joomla! version og URLen til opdaterings pakken.
  10. If the update is not showing up, go to Extension manager  Update and press Purge Cache from the toolbar. Now the update to Joomla! 3 should show up.
  11. Cross your fingers, make sure you turned off Remember Me and that you have a backup from just before this point.
  12. Click the Install the Update button.
  13. Watch the spinning circle go round and round and feel the anxiety building. No, just kidding. The amount of time the wheel spins is dependent on your site, Internet connection and server speed.
  14. If all goes well, you will get to a totally new look to the backend administrator panel.
  15. Click the Clear Cache button.
  16. Go to Extensions  Manage  Database and click Fix.
  17. In the Extension Manager, go to Discover and see if there are any extensions to install.
  18. Recommended but not required: Fix assets. (Fixing the assets table). See below for a tool to do this in just a few clicks.
  19. Enable Remember Me from the Plugin Manager.
  20. Go to the frontend of your site and see if it shows up even if it’s not the right template. If so, continue. If not, see common errors during migration.
  21. Take a backup.
  22. At this point, it would be prudent to clear your browser's cache. Some browsers, notably Firefox, will retain old version 2.5 files. That caching might prevent the operation of the Save and Save & Close buttons in the Administrator.
  23. Go to Content  Article Manager  Options button  Editing Layout tab and set the Enable Versions to Yes.
  24. Install your new template or other extensions if you have them to install. Back up often.
  25. Configure them. Back up often.
  26. Test everything. Back up often.
  27. If everything works as expected, turn Error Reporting back to System Default (System  Global Configuration  Server tab). Make sure to Save & Close.

Gå live med dit Joomla! 3.x websted

  1. Når du er klar til at gå live, tag backup af dit 2.5 websted for sidste gang. Genskab det i en undermappe eller et subdomæne, hvis du ønsker dette.
  2. Tag backup af dit Joomla! 3.x websted og flyt eller genskab dit Joomla! 3.x websted i roden (eller skift navneservere hvis du har opbygget webstedet på et midlertidigt domæne på en ny hosting konto).
  3. Test igen.
  4. Fjern Joomla! 2.5 webstedet fra serveren inden for få dage med mindre du har redigeret din robots.txt fil for at blokere søgemaskine robotter.
  5. Fjernudviklingswebsteder som du har arbejdet på eller hold dem opdaterede, hvis de kører en opdateret version for at holde hacker på afstand fra din server.

Hvis du har haft dataændringer på 2.5 webstedet mens du migrerede til 3.x, så vil du formodentlig ønske at flytte dataene over til 3.x webstedet inden det går live. Du kan gøre dette manuelt (vær sikker på at du beholder de samme bruger ID'er - gå i rækkefølge) eller ved at anvende en overførselsværktøj/tredjeparts udvidelse.

Foreslåede værktøjer