Menu configuration

Navigation menu > Menu configuration

The Menu configuration is a system form, used by application administrators to customize the navigation menu shown to users.

To open, click the Menu configuration entry displayed by the arrow next to the application name, or directly on the Administration folder.

The configuration layout

The first section displays the current structure of the menu tree, containing top-level folders and subfolders, forms, labels and links, originally indicated by folder, form, capture12 and capture13 icons respectively; however, in the navigation menu, the user will see the top-level folders as vertical accordion menus, and subfolders as indented labels.

Folders can be opened by clicking the (lightTriangle) icon at the left of the folder icon. This action displays the nested list of subfolders and/or forms contained in the opened folder.

Below the menu tree section, there is a drop-down box that controls the section of available items. Depending on the option selected, this section will show:

  • Forms: A list of available forms (both system and application forms) that can be dragged into the menu structure.

  • Details: Used to edit the URL associated with link items and decide whether or not the application folders and forms will Show in menu and/or Show in mobile menu.

  • Icon Selector: Displays a list of icons that are used to customize the appearance of menu items.

The Menu configuration is dismissed by clicking the grayCross icon at the top bar.

There is no Save button (except for when selecting Details), so be aware that all changes to the menu are immediately effective and visible to all users who are currently online.

Add a form

Select the form in the bottom section, and drag and drop it onto the desired position of the menu tree. Note that the forms that are already present in the navigation menu are colored.

Add a folder

Select an item in the menu tree, under which you want to add a folder. Then, right-click to display a context menu and select the Add folder option. Type a name to replace the "New folder" default name. To change its position, click-and-drag it to the desired location.

Note that this is an empty folder at the selected location, and it is not displayed in the actual navigation menu, until one or more forms are placed inside it. Note also that the menu-level decides if the new folder will be an accordion folder or a subfolder.

Add a label

Select an item in the menu tree, under which you want to add a label. Then, right-click to display a context menu and select the Add label option. Type a name to replace the "New label" default name. To change its position, click-and-drag it to the desired location.

Menu labels are simply used as headings on the navigation menu.

Select an item in the menu tree, under which you want to add a link. Then, right-click to display a context menu and select the Add link option. Type a name to replace the "New link" default name. To change its position, click-and-drag it to the desired location.

Note that the new links are originally empty. To add a URL to your link, select Details in the drop-down, enter the target in the section displayed below, and Save.

Rename a menu item

Select the item you want to rename in the menu tree. Then, right-click to display a context menu and select the Rename option. This operation can also be done by double-clicking the menu item. Type a name to replace the original one.

If this operation is done on a form item, note that it will only change the entry label on the navigation menu, but not the title of the form.

In the same manner, if the application form is renamed in the Form designer, it might be the case that a form in the menu has a different name than the title of the actual form, causing confusion to the users.

That is why it’s a recommended practice to keep forms named exactly the same as their corresponding menu items, resulting in a more consistent application structure. Otherwise, you can always find which actual form the menu item will open by selecting such an item in the Menu configuration, then select Details in the drop-down box, and read the original title of the form in Extra information.

Delete a menu item

Select the item you want to delete in the menu tree. Then, right-click to display a context menu and select the Delete option.

Deleting a form item in the menu does not delete the actual form, which remains available for editing in the Form designer, and can be manually restored in the navigation menu at a later time.

Deleting a folder or subfolder deletes all the menu items it contains, so care should be applied when deleting this type of menu items.

It is possible to hide a form from application users without actually deleting the form item. This can be done by removing all access rights to the form for the users' roles with the Form rights administrative form.

See also