Joomla 2.5 a 3.x Migració Pas a Pas

This page is a translated version of the page Joomla 2.5 to 3.x Step by Step Migration and the translation is 54% 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

Joomla! 2.5.28 can only be migrated in 2-steps at the moment. First migrate to 3.5.1 . You then need to upgrade from 3.5.1 to the latest 3.x through the one click installer

The following are step by step instructions to migrate your 2.5.x site to Joomla! 3.x. While there are hundreds of different scenarios, this will give you the basic procedure to follow. Very complex migrations will likely be a result of installed third-party extensions. You are encouraged to contact the developers of third-party extensions installed on your Joomla! site for their suggested path to migrate their extensions.


The migration from Joomla! 2.5 to 3.x is considered a mini-migration. This is because the Joomla! core extensions will upgrade with a “one-click” upgrade via the Joomla! Update component in the backend administrator side of Joomla. Many third-party extensions are a one-click upgrade too. Some are not. You need to look at each one and determine what path the extension needs to follow to get from 2.5 to 3.x. If you haven't already, you might be interested in reading the Self Assessment and Planning for 2.5 to 3.x Migration prior to following the steps below.

Joomla! Core Extensions:

  • Categories
  • Articles
  • Menús
  • Mòduls (els mòduls bàsics - no tercers)
  • Banners
  • Contactes
  • Missatgeria
  • Newsfeeds
  • Redirecció
  • Cerca
  • Cerca Intel·ligent
  • Enllaços

Per migracions molt grans o complexes de 2.5 a 3.x

The one-click update will be fine and work well for many. For some larger, more complex sites, the one-click update may not be the best route. For large or very complex sites, you may want to follow instructions for a regular migration and bypass the one-click update functionality. To do this, follow the same instructions for planning 1.5 to 3.x and migrating from Joomla 1.5 to 3.x, simply substitute 2.5 for 1.5 while reading.

Pas a pas

Establir una ubicació de desenvolupament

  1. Take a backup of your live 2.5 site. You can use a suggested tool (see bottom of page) or you can do this manually.
  2. Make sure your environment meets the technical requirements for Joomla 3 before proceeding.
  3. Create a new database and new user to restore your 2.5 site to.
  4. Create a testing site or build area to work in and restore the back up copy of your 2.5 site in one of the following places:
  5. In your test location, update your Joomla! 2.5 instance to the latest maintenance release. (Currently 2.5.28).
  6. Make sure you have the latest database schema updated to the latest version 2.5.28 by going to: Extension Manager → Database tab. If your schema is not up to date as in the following image, click the Fix button:
  7. Prova.
  8. Còpia de seguretat de nou.

Avaluar cada extensió

  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.
    Es recomana seleccionar primer el paquet, perquè si hi ha alguna cosa que es necessita desinstal·lar, en un paquet, es farà automàticament, mòduls, complements i qualsevol altra cosa associada al paquet, alhora.
  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. Prengui nota de les versions de paquets i components actualment instal·lats que mantindrà al seu lloc web. Feu servir el Full de treball d'inventari d'extensions de tercers o simplement copiar-les i enganxar-les en un document de referència.
  8. Actualitzi totes les extensions a les darreres versions.
  9. Abans de l'actualització i durant la mateixa, prengui comprovi si les extensions tenen dues versions, 2.5 i 3.x, en el mateix paquet. Si és així, podrà actualitzar-les "en un sol clic". En cas contrari, i la 2.5 i la 3.x tenen paquets diferents, necessitarà examinar cas per cas. Normalment estaran dins d'algun dels escenaris següents:
  10. * L'extensió té paquets separats però al actualitzar a Joomla 3.x, detectarà això automàticament i seguirà funcionant. Assegureu-vos que el desenvolupador de l'extensió li confirma això.
  11. * L'extensió té paquets separats que necessiten ser desinstal·lats de la 2.5 primer i reinstal·lats en la versió 3.x del lloc un cop aquest ha estat migrat. Un exemple d'això pot ser un plugin de contingut. És molt fàcil de desinstal·lar a la 2.5 i després instal·lar-lo de nou a la 3.x.
  12. * Vegi les Consideracions sobre la plantilla durant la Migration per a informació més específica sobre aquest tipus d'extensions.
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

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. Aneu a Extensions  Gestor de Complements, introdueixi Recordi'm en el filtre i premeu Retorn.
  3. Desactiveu el complement Remember Me (Recordi'm) fent clic a la marca verda i convertint-la en un cercle vermell.
  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. Feu clic a Desa i Tanca
  9. Veureu llavors la versió de Joomla que té instal·lada, la darrera versió de Joomla! i l'URL del paquet d'actualització.
  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.

Obrir al públic el lloc web amb Joomla! 3.x

  1. When you’re ready to go live, back up your 2.5 site for the last time. Restore it in a subdirectory or subdomain if you would like to.
  2. Back up your Joomla! 3.x site and move or restore your Joomla! 3.x site to the root (or change nameservers if you were building on a temporary domain at a new hosting account root).
  3. Test again.
  4. Remove the Joomla! 2.5 site from the server within a couple of days unless you have edited your robots.txt file to block the search engine spiders.
  5. Remove all development sites you may have been working with or keep them up-to-date if they are running a current version in order to ward off hack attempts on your server.

If you had data change on the 2.5 site while you were migrating to 3.x, you will want to get that data moved over to the 3.x site before going live. You can do this manually (make sure you keep the same user IDs - go in order) or by using a transfer tool/third-party extension.

Eines suggerides