RO CSVI

Joomla Menus import

This tutorial explains how to create a Joomla menus import template, add the fields and how to run the import. Step by step we show you how to perform each task. A video will show you the steps in action so you can follow that as well.

Creating the template

A template can be created by following these steps:

  1. Go to Components -> RO CSVI -> Templates
  2. Click New
  3. Give the template a name
  4. Set Action to Import
  5. Set Component to Joomla Menus
  6. Set Operation to Menu
  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 -> RO CSVI -> 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

  • type
  • path
  • menutype

Criteria

These fields make up the criteria to determine if the record is going to be updated or added. If all the criteria fields match an existing record, the record will be updated. If not all the criteria fields match, the record will be added. 
  • type
  • path
  • menutype

 

Run the import

The import can be run by following these steps:

  1. Go to Components -> RO CSVI -> 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 RO 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

Video showing the process

 

Examples

"alias","component","language","level","link","menutype","menu_image","menu_text","path","title","type"
"home","com_content","*","1","index.php?option=com_content&view=featured","mainmenu","","Y","home","Home","component"
"test-article","com_content","*","1","index.php?option=com_content&view=article&id=1","mainmenu","","Y","test-article","Test article","component"

Example file

Joomla_menu.csv

Delete a menu

With RO CSVI Menu import it is also possible to delete the existing menu items. Use field menu_delete with value Y in import to delete a menu item.

Example for menu delete

"alias","menutype","path","title","type","menu_delete"
"home","mainmenu","home","Home","component","Y" 
"test-article","mainmenu","test-article","Test article","component","Y"

Please note that Joomla saves alias as path when saving the menu. So even if you have a path set in import file, when storing the menu Joomla builts the path using alias field. To update existing Joomla menu, use the path as stored by Joomla.

Related Articles