RO CSVI

RO CSVI comes with a set of migration templates that can be used to migrate your Joomla 3 data to a Joomla 4 site, not only that, this can also be used to move data from a Joomla 4 to another Joomla 4 site. The aim of the migration templates is that you can move your data with a few clicks.

With Joomla 4 getting stable and popular in the Joomla market, users are looking at migrating their Joomla data from a Joomla 3 site to a Joomla 4 site with ease. In RO CSVI we have made standard migration templates to make this process as easy as possible. This document explains on how to use these migration templates to move data from a Joomla 3 site to a Joomla 4 site. The same migration templates can be used to move data from a Joomla version to another and not just a Joomla 3 version to a Joomla 4 version.

Migration templates are available for the following Joomla extensions

• Joomla Categories
• Joomla Contact
• Joomla Content
• Joomla Custom Fields
• Joomla Menus
• Joomla Modules
• Joomla Tags
• Joomla Users

Keeping the database ID

The migration templates have been made with the idea that you want to keep your database IDs the same. This is a big help in maintaining the relations between different parts of your website. Think about the menu items linking to articles or categories, they are connected by the database ID of the given category or article. Modules are linked to menu items by their ID, users are linked to articles by their ID. The list goes on and on. To prevent that you have to manually change all these settings, which would defeat the purpose of the migration, we have added the option to keep the existing IDs, this option is enabled on all migration templates.

One thing you really need to be aware of is that the website where you import the data does not have any of the existing IDs from the old site. If you do have them, they will be overwritten and things can look quite unexpected. So check if you do not have any overlapping IDs between your source site, where the data is exported from, and your target site, where the date is imported into. If you have any overlapping IDs, you have to decide whether you run the migration into a clean site or cleanup the site so there are no overlapping IDs anymore.

Multilingual sites

If you have a multilingual site, make sure all languages that are going to be used are installed prior to running your migrations. The language are required to be available during import.

Associations

The migration supports associations as used in multilingual sites as well. All migration templates have the associations enabled by default, so no changes are needed. If you do not use associations in your site, you can just ignore them. The export will be empty and so the import will not import anything.

Installation of Migration Templates

First step is to install the migration templates in RO CSVI. This process has to be done in both Joomla 3 and in Joomla 4. So make sure RO CSVI package is installed in both of the Joomla versions.

To Install migration templates follow the steps

1. Go to RO CSVI maintenance page
2. Select RO CSVI in the first dropdown list
3. Select Install example templates in second drop down list.
4. Select the needed Joomla extensions, for example to migrate articles select Joomla Content in the list of extensions. Set Enable debug log option to Yes.
5. Click on Continue button
6. Example and migration templates for selected Joomla extensions are now installed.

Kindly note that steps for installing migration templates are same in both Joomla 3 and Joomla 4 versions.

Video showing the process of the installation of the migration templates

This page explains on how to move Joomla Categories from Joomla 3 to Joomla 4 using RO CSVI Joomla categories migration templates.

Run Export in Joomla 3 version

Steps to be followed to run the export

1. Go to RO CSVI templates list page
2. Look for Example Joomla Categories Export Migrate template in the list.
3. Click on Run button.
4. The migration template has all the needed fields added as template fields. You can add or remove fields from RO CSVI template fields page if you want to customize the export.
5. Save the export file.

Video showing the process of the Joomla Categories Export

Run Import in Joomla 4

On the Joomla 4 site, run the import using the export file from the Joomla 3 site that was exported in the previous step.

1. Go to the RO CSVI templates list page
2. Look for Example Joomla Categories Import Migrate template in the list
3. Click on Run button
4. Select the export file in Choose file option
5. Check the import preview page if the data displayed is correct. This page is to review the data before running the import. The first five records from the import file is displayed on the page.
6. If everything looks good, click on Start Import button.
7. Check the Import log details page on errors and information on the import.

Video showing the process of the Joomla Categories Import

 

This page explains on how to move Joomla Contacts from a Joomla 3 to a Joomla 4 site using RO CSVI Joomla contact migration templates. 

Run Export in Joomla 3 version

 Steps to be followed to run the export

1. Go to RO CSVI templates list page
2. Look for Example Joomla Contacts Export Migrate template in the list.
3. Click on Run button.
4. The migration template has all the needed fields added as template fields. You can add or remove fields from RO CSVI template fields page if you want to customize the export.
5. Save the export file.

Video showing the process of the Joomla Contacts Export

Run Import in Joomla 4 version

On the Joomla 4 site, run the import using the export file from the Joomla 3 site that was exported in the previous step.

1. Go to RO CSVI templates list page
2. Look for Example Joomla Contacts Import Migrate template in the list
3. Click on Run button
4. Select the export file in Choose file option
5. Check the import preview page if the data displayed is correct. This page is to review the data before running the import. The first five records from the import file is displayed on the page.
6. If everything looks good, click on Start Import button.
7. Check the Import log details page on errors and information on the import.

Video showing the process of the Joomla Contacts Import

This page explains on how to move Joomla articles from Joomla 3 to Joomla 4 version using RO CSVI Joomla content migration templates. 

Run Export in Joomla 3 version

 Steps to be followed to run the export

1. Go to RO CSVI templates list page
2. Look for Example Joomla Content Export Migrate template in the list.
3. Click on Run button.
4. The migration template has all the needed fields added as template fields. You can add or remove fields from RO CSVI template fields page if you want to customize the export.
5. Save the export file.

Video showing the process of the Joomla Content Export

Run Import in Joomla 4 version

On Joomla 4 site, run the import using the export file from Joomla 3 version.

1. Go to RO CSVI templates list page
2. Look for Example Joomla Content Import Migrate template in the list
3. Click on Run button
4. Select the export file in Choose file option
5. Check the import preview page if the data displayed is correct. This page is to review the data before running the import. The first five records from the import file is displayed on the page.
6. If everything looks good, click on Start Import button.
7. Check the Import log details page on errors and information on the import.

Video showing the process of the Joomla Content Import

This page explains on how to move Joomla custom fields related data from Joomla 3 to Joomla 4 version using RO CSVI Joomla custom fields migration templates. The migration templates are available for two operations for Joomla custom fields import and export.

1. Joomla Fields Group
2. Joomla Fields

To be able to migrate all data we must perform the migration in 2 steps:

1. Joomla Fields Groups
   This step is needed first so we can assign fields to their respective groups
2. Joomla Fields
   In this second step we actually import the fields and assign them to the correct groups

Run Fields Group Export in Joomla 3

 Steps to be followed to run the export

1. Go to RO CSVI templates list page
2. Look for the Example Joomla Custom Field Groups Export Migrate template in the list.
3. Click on Run button.
4. The migration template has all the needed fields added as template fields. You can add or remove fields from RO CSVI template fields page if you want to customize the export.
5. Save the export file.

Video showing the process Joomla Custom Field Groups Export

Run Fields Export in Joomla 3

Steps to be followed to run the export

1. Go to RO CSVI templates list page
2. Look for the Example Joomla Custom Fields Export Migrate template in the list.
3. Click on Run button.
4. The migration template has all the needed fields added as template fields. You can add or remove fields from RO CSVI template fields page if you want to customize the export.
5. Save the export file.

Video showing the process Joomla Custom Fields Export

Run Joomla Custom Field Groups Import in Joomla 4 version

On the Joomla 4 site, run the import using the export file from the Joomla 3 site that was exported in the previous step.

1. Go to RO CSVI templates list page
2. Look for Example Joomla Custom Field Groups Import Migrate template in the list
3. Click on Run button
4. Select the export file in Choose file option
5. Check the import preview page if the data displayed is correct. This page is to review the data before running the import. The first five records from the import file is displayed on the page.
6. If everything looks good, click on Start Import button.
7. Check the Import log details page on errors and information on the import.

Video showing the process Joomla Custom Field Groups Import

Run Joomla Custom Fields Import in Joomla 4 version

On the Joomla 4 site, run the import using the export file from the Joomla 3 site that was exported in the previous step.

1. Go to RO CSVI templates list page
2. Look for the Example Joomla Custom Fields Import Migrate template in the list
3. Click on Run button
4. Select the export file in Choose file option
5. Check the import preview page if the data displayed is correct. This page is to review the data before running the import. The first five records from the import file is displayed on the page.
6. If everything looks good, click on Start Import button.
7. Check the Import log details page on errors and information on the import.

Video showing the process Joomla Custom Fields Import

This page explains on how to move Joomla Menus from Joomla 3 to Joomla 4 version using RO CSVI Joomla Menu migration templates. 

Run Export in Joomla 3 version

 Steps to be followed to run the export

1. Go to RO CSVI templates list page
2. Look for Example Joomla Menus Export Migrate template in the list.
3. Click on Run button.
4. The migration template has all the needed fields added as template fields. You can add or remove fields from RO CSVI template fields page if you want to customize the export.
5. Save the export file.

Video showing the process of the Joomla Menus Export

 Run Import in Joomla 4 version

On the Joomla 4 site, run the import using the export file from the Joomla 3 site that was exported in the previous step.

1. Go to RO CSVI templates list page
2. Look for Example Joomla Menus Import Migrate template in the list
3. Click on Run button
4. Select the export file in Choose file option
5. Check the import preview page if the data displayed is correct. This page is to review the data before running the import. The first five records from the import file is displayed on the page.
6. If everything looks good, click on Start Import button.
7. Check the Import log details page on errors and information on the import.

Video showing the process of the Joomla Menus Import

 

This page explains on how to move Joomla Modules from Joomla 3 to Joomla 4 version using RO CSVI Joomla modules migration templates. 

Run Export in Joomla 3 version

 Steps to be followed to run the export

1. Go to RO CSVI templates list page
2. Look for Example Joomla Modules Export Migrate template in the list.
3. Click on Run button.
4. The migration template has all the needed fields added as template fields. You can add or remove fields from RO CSVI template fields page if you want to customize the export.
5. Save the export file.

Video showing the process of the Joomla Modules Export

Run Import in Joomla 4 version

On Joomla 4 site, run the import using the export file from Joomla 3 version.

1. Go to RO CSVI templates list page
2. Look for Example Joomla Modules Import Migrate template in the list
3. Click on Run button
4. Select the export file in Choose file option
5. Check the import preview page if the data displayed is correct. This page is to review the data before running the import. The first five records from the import file is displayed on the page.
6. If everything looks good, click on Start Import button.
7. Check the Import log details page on errors and information on the import.

Video showing the process of the Joomla Modules Import

This page explains on how to move Joomla tags from Joomla 3 to Joomla 4 version using Migration Joomla tags export template in Joomla 3 version. 

Run Export in Joomla 3 version

 Steps to be followed to run the export

1. Go to RO CSVI templates list page
2. Look for Example Joomla Tags Export Migrate template in the list.
3. Click on Run button.
4. The migration template has all the needed fields added as template fields. You can add or remove fields from RO CSVI template fields page if you want to customize the export.
5. Save the export file.

Video showing the process of the Joomla Tags Export

Run Import in Joomla 4 version

On the Joomla 4 site, run the import using the export file from the Joomla 3 site that was exported in the previous step.

1. Go to RO CSVI templates list page
2. Look for Example Joomla Tags Import Migrate template in the list
3. Click on Run button
4. Select the export file in Choose file option
5. Check the import preview page if the data displayed is correct. This page is to review the data before running the import. The first five records from the import file is displayed on the page.
6. If everything looks good, click on Start Import button.
7. Check the Import log details page on errors and information on the import.

Video showing the process of Joomla Tags Import

 

This page explains on how to move Joomla users from a Joomla 3 to a Joomla 4 site using RO CSVI migration templates in three steps. Migration templates are available for three operations. 

1. Joomla User Access Levels
2. Joomla User Groups
3. Joomla Users

To be able to migrate all data we must perform the migration in 3 steps:

1. Joomla User Groups
   This step is needed first so we can assign users to their respective groups
2. Joomla Users
   In this second step we actually import the users and assign them to the correct groups
3. Joomla User Access Levels
   The final step is to create the access levels to allow users to access the different parts of the system

Run Joomla User Groups Export in Joomla 3

 Steps to be followed to run the export

1. Go to RO CSVI templates list page
2. Look for Example Joomla Usergroup Export Migrate template in the list.
3. Click on Run button.
4. The migration template has all the needed fields added as template fields. You can add or remove fields from RO CSVI template fields page if you want to customize the export.
5. Save the export file.

Video showing the process of User Groups Export

 

Run Joomla Users Export in Joomla 3

 Steps to be followed to run the export

1. Go to RO CSVI templates list page
2. Look for the Example Joomla Users Export Migrate template in the list.
3. Click on Run button.
4. The migration template has all the needed fields added as template fields. You can add or remove fields from RO CSVI template fields page if you want to customize the export.
5. Save the export file.

Video showing the process of Users Export

 

Run Joomla Users Access Level Export in Joomla 3

 Steps to be followed to run the export

1. Go to RO CSVI templates list page
2. Look for the Example Joomla Users Access Levels Export Migrate template in the list.
3. Click on Run button.
4. The migration template has all the needed fields added as template fields. You can add or remove fields from RO CSVI template fields page if you want to customize the export.
5. Save the export file.

Video showing the process of User Access Level Export

 

Run Joomla Usergroup Import in Joomla 4 version

On the Joomla 4 site, run the import using the export file from Joomla 3.

1.  Go to RO CSVI templates list page
2. Look for Example Joomla Usergroup Import Migrate  or Example Joomla Users Access Levels Import Migrate or Example Joomla Users Import Migrate  templates in the list based on import operation.
3. Click on Run button
4. Select the export file in Choose file option
5. Check the import preview page if the data displayed is correct. This page is to review the data before running the import. The first five records from the import file is displayed on the page.
6. If everything looks good, click on Start Import button.
7. Check the Import log details page on errors and information on the import.

Video showing the process of User Groups Import

 

Run Joomla Users Import in Joomla 4 version

On the Joomla 4 site, run the import using the export file from Joomla 3.

1.  Go to RO CSVI templates list page
2. Look for the Example Joomla Users Import Migrate template in the list.
3. Click on Run button
4. Select the export file in Choose file option
5. Check the import preview page if the data displayed is correct. This page is to review the data before running the import. The first five records from the import file is displayed on the page.
6. If everything looks good, click on Start Import button.
7. Check the Import log details page on errors and information on the import.

Video showing the process of Users Import

 

Run Joomla Users Access Levels Import in Joomla 4 version

On the Joomla 4 site, run the import using the export file from Joomla 3.

1.  Go to RO CSVI templates list page
2. Look for the Example Joomla Users Access Levels Import Migrate template in the list.
3. Click on Run button
4. Select the export file in Choose file option
5. Check the import preview page if the data displayed is correct. This page is to review the data before running the import. The first five records from the import file is displayed on the page.
6. If everything looks good, click on Start Import button.
7. Check the Import log details page on errors and information on the import.

Video showing the process of User Access Level Import