This document explains on how to migrate K2 items from a Joomla 3 installation to Joomla content on a Joomla 4/5 installation. First we explain on how to set up export in Joomla 3 site and then we explain on how to set up import using exported K2 items file.
Setting up K2 items export in Joomla3 site
- Make sure to install RO CSVI - K2 plugin from Our downloads page.
- Update available fields in RO CSVI
- Create RO CSVI K2 Items export template.
- Add template fields. Now there are two ways to map K2 item fields with Joomla content fields.
- By adding Joomla content fields as column headers in K2 item export template.
- By adding template fields in Joomla content import template and set Use file for configuration to No in import template settings and on Options tab.
We will explain in this document on the first method of setting column headers in K2 items export template.
Below is the list of equivalent fields from k2 to Joomla articles. In this document we are going to show on migrating these fields.
|
K2 item fields |
Joomla article fields |
| title |
title |
|
alias |
alias |
|
introtext |
introtext |
|
fulltext |
fulltext |
|
category_path |
category_path |
|
published |
state |
|
created |
created |
|
created_by |
created_by |
|
modified |
modified |
|
modified_by |
modified_by |
|
publish_up |
publish_up |
|
publish_down |
publish_down |
|
access |
access |
|
ordering |
ordering |
|
featured |
featured |
|
hits |
hits |
|
language |
language |
Import Category
Before we import K2 Items, it is important we migrate categories from K2 to Joomla. If the categories does not exists in Joomla then articles are created under default Uncategorized category with ID 2. To move the categories use K2 category export template with category_path field. Check the document Migrate K2 categories to Joomla categories using RO CSVI to migrate categories.
Video showing K2 item export process
Run Joomla content import in Joomla 4/5 site
Now that we have export file ready. We need to create Joomla content import template in Joomla4 site and run the import. To create content import template
- Go to RO CSVI template page and click on New
- Give a name for template and select Action as Import, Component as Joomla content and Operation to Content. Follow the steps and save the template.
- Click on Run button and select the K2 Item export file. Check Import preview page and see if all fields are shown correct.
- Run the import.
Video showing Joomla content import process
Processing Images in content
It is possible that K2 item has images stored in introtext or fulltext fields and that needs to be moved into Joomla content. RO CSVI cannot download images inside the content. So to move the images
- Copy images to folder on Joomla4 site before import.
- Check the path of the images in Joomla3 site and Joomla4 site. If they are not same use RO CSVI Multi replace rule and with Find and Replace operation replace path of image in K2 Item export.
- Apply the rule on both introtext and fulltext field from RO CSVI template fields page on Joomla3 site.
- With rule applied K2 Item export will get content with new path for images.