RO CSVI

Requirements

Creating the template

A template can be created by following these steps:

1. Go to Components -> CSVI Pro -> Templates
2. Click New
3. Give the template a name
4. Set Action to Import
5. Set Component to Joomla Categories
6. Set Operation to Category
7. Click Next: Select Source
8. Source is set default to Load from your computer. No need for change.
9. Click Next: Select options
10. The default values are OK, change if needed.
11. Click Next: Select fields
12. Nothing needed here as we set to Use column headers as configuration in step 10.
13. Click Next: Finalize
14. All done here
15. Click Close to return to the list of templates or Edit if you want to fine-tune the template further.

Adding the template fields

Template fields can be added by following these steps:

1. Go to Components -> CSVI Pro -> Templates
2. Click on Template fields
3. In the Search Tools select your template
4. Click on New to add a single field or click on Quick Add to add multiple fields.

Quick Add

The Quick Add Option allows you to quickly add multiple fields to a template. It is not possible to set any settings per field here but that can be done after the fields have been added to the template.

Required fields

• category_path
• extension

Criteria

Creating the import file

As in the example file, the fields we are trying to import are listed below, more fields can be added according to the requirement. Check the available fields page in CSVI to find out which fields are available for the Joomla! categories import.

Run the import

The import can be run by following these steps:

1. Go to Components -> CSVI Pro -> Import
2. Select the template created earlier
3. Click Select file
4. Select the file to import
5. Click Preview
6. You now see a preview of the file as to how CSVI sees the file
7. Click Start import
8. The import is run
9. The Log details page will be shown with information regarding the import if the Enable logging is enabled in the template

Examples

Create a 2 level category for Joomla content

"category_path";"extension"
"Parent/Child";"com_content"

Create a 2 level category for Joomla content assigned to the British language

"category_path";"extension";"language"
"Parent/Child";"com_content";"en-GB"

Create a 3 level category for Joomla content

"category_path";"extension"
"Parent/Child/Grandchild";"com_content"

Create a 2 level category for Joomla banners

"category_path";"extension"
"Parent/Child";"com_banners"

Example file

joomla_categories_import.csv

Further reading

Along with Joomla category fields CSVI also supports import of Joomla custom fields for a category. If there is a custom field added for a category it will be available as a import available field. Please note that alias of the custom field will be available as import field as it is the unique value.

For example, here in this document we are explaining on how to add a custom field Extra title to Joomla custom fields for a category and importing its value along with other Joomla category fields. 

1. Add an custom field from Joomla administrator menu > Articles > Fields, Select category from the filter options and click on New button. Add custom field with Title Extra title
2. Save the custom field
3. Go to Components -> CSVI Pro -> Available fields
4. Update the available fields
5. Go to Components -> CSVI Pro -> Template fields
6. Select your Joomla category import template
7. Click on New button, search for the new custom field added. Save as a template field
8. Run the import.