Role required: admin.
In SimpleOne, navigation is based on these entities:
- Categories – physically stored in the Menu Category (sys_menu_category) table.
- Child categories – physically stored in the Menu Category (sys_menu_category) table.
- Menu items – physically stored in the Menu Item (sys_menu_item) table.
- Dynamic categories – physically stored in the Dynamic Menu Category (sys_menu_dynamic_category) table.
A category can have one or more child categories. Child categories never have other child categories.
The hierarchy of a category containing child categories and items is shown below:
A category can also be a dynamic one that is an entry point to a separate submenu. The order of a dynamic category containing child categories, subcategories and its items, and its own items is shown below:
Categories
To create a new category, follow these steps:
- Navigate to System Settings → Menu Categories.
- Click New and fill in the fields. See an example below.
- Click Save or Save and exit to apply the changes.
Portal Structure category form fields
The Edit button is marked with a pencil icon 
.
It allows you to modify the properties of a specific category or category item. Click it to open the property editing form.
Menu Category form fields
| Field | Mandatory | Description |
|---|---|---|
| Title | Y | Specify the displayed category title. |
| Active | N | Select the checkbox to activate the category. |
| Dynamic | N | Select the checkbox if you need the category to be dynamic. |
| Dynamic category | Y | Specify the dynamic category to extend the category you are creating. |
| Order | Y | Specify the category order in the interface (categories are arranged in ascending order). |
| Description | N | Enter a short description for the category. |
| User roles | N | Specify user roles that have access to the category. If the field is left blank, the category will be available to all users. |
| Parent | N | Specify the category which is the parent to the current one. This allows you to change the level of the category. A category cannot be a parent to itself. Child categories cannot have their child categories. The maximum level hierarchy is shown below:
1.1. Service Option Service Option item Service Item |
If the newly created category contains no items, it will not appear in the navigation panel. To display it, create one or more menu items for this category. To learn how to create a menu item, refer to Menu Items section of this article.
Child categories
Child category is an optional level for a category that allows you to implement hierarchy in the Navigator.
To create a child category, follow these steps:
- Navigate to System Settings → Menu Categories.
- Open a category record you need to create a child category for.
- Open the Child Categories tab in the Related Lists area.
- Click New and fill in the fields.
- Click Save or Save and exit to apply the changes.
You can also create a child category this way:
- Navigate to System Settings → Menu Categories.
- Click New and fill in the fields.
- Click Save or Save and exit to apply the changes.
Note that in this case, you need to fill in the Parent field manually.
If the newly created child category contains no items, it will not appear in the navigation panel. To display it, create at least one menu item for this child category.
Menu items
SimpleOne administrators can use menu items as links to content pages (for example, lists or forms of table records). Menu items can be related to a category or a child category.
To make a menu item point to an external source, on the Link Type tab, fill in the URL field with a link to the source.
To create a new category item, follow these steps:
- Navigate to System Settings → Menu Categories.
- Оpen a category record you need to create a menu item for.
- In the Related Lists area, select the Menu Item tab.
- Click New and fill in the fields.
- Click Save or Save and exit to apply the changes.
Menu Item form fields
| Field | Mandatory | Description |
|---|---|---|
| Title | Y | Specify the displayed menu item title. |
| Category | Y | Specify the category of the item. Move it from one category to another by clicking the magnifier icon |
| User roles | N | Specify user roles that should have access to the menu item. If the list is left empty, the category will be available to all users. |
| Visibility tab | ||
| Active | N | Select the checkbox to display the element in the navigator. |
| Order | Y | Specify the element order in the interface. Elements are sorted in ascending order. |
| Link Type tab | ||
| Table | Y | Specify the table to which the menu item refers to. |
| Link type | Y | Specify the link type in this Choice field. Available options:
|
| Filter | N | The condition builder field that allows you to tune up a filter that will be applied to a list view. |
| URL | N | Enter a URL if a navigation item should point to an internal or external source. If you enter a URL, values of the Table and Link type fields will be ignored. |
Dynamic categories
Dynamic menu is a special navigator element that is the entry point to a separate submenu. Categories and items of such a menu are formed based on table data. There are two options for forming a dynamic menu structure while creating it:
- Specify one table, so its records will be both categories and category items. To do so, specify the field in the Category parent column that defines the parent-child relationship.
- Specify two tables, one for the category and the other for the items included in the category. To do so, specify the field that defines the parent-child relationship in the Category parent column for the category and subcategories table. And also specify the field in Item parent column that defines the item-to-category relationship for the table with items.
Dynamic Category form fields
| Field | Mandatory | Description |
|---|---|---|
| Title | Y | Specify the category title. |
| Use categories | N | Select the checkbox if you need to create a hierarchy using two tables. |
| Category table | Y | Define the table that will be used as a category for items. The field appears when the Use categories checkbox is selected. |
| Category parent column | Y | Specify the column to define parent-child relationship of elements. The field appears when the Use categories checkbox is selected. |
| Category icon source | N | Specify the vector image for the category. The field appears when the Use categories checkbox is selected. |
| Category UI list | N | Specify the List Layout for the category. The field appears when the Use categories checkbox is selected. |
| Category conditions | N | Specify the conditions that must be met to filter categories. The field appears when the Use categories checkbox is selected. |
| Item table | Y | Define the table which records will be used as items. |
| Item parent column | Y | Specify the column that will define parent-child relationship between items and categories. |
| Item icon source | N | Specify the vector image for items. |
| Item UI form | N | Specify the form layout for items. |
| Item conditions | N | Specify the conditions that must be met to filter items. |
Navigator search
You can use the search bar at the top of the navigator to reduce the number of items displayed. It may be helpful if there are many items displayed, and it is hard to find the preferred one.
For this, enter some characters or keywords in the search bar at the top of the navigator:
The initial filtration is performed by the category name.
- When you enter some characters of a keyword, the navigator displays categories whose titles contain characters, and all their items.
- When a full keyword is entered, items with the keyword and their categories will be shown.
