Menus

Context

The menu is accessible on the left-hand side of the app. It is used to navigate between the pages set up for the user.

On mobile, you first need to click on the burger button at the top of the screen. When the menu is hidden, it shows a counter if there are actions to be taken by the store.

On the top section, the user name and the current store are displayed. The user name is clickable and directs to the user page, in which the language can be changed.

 

The menu is highly configurable to match your needs. The configuration is available in the Backoffice configuration page Configuration > Store App > Menu. This allows, for example:

  • Manage the menu view according to the user's role

  • Manage the menu view according to store type

  • Display "store as a warehouse" management

  • Reorganize/modify menu groups.

  • Add custom pages

Several menus can be configured, and can be differentiated according to user or stock location conditions, such as:

  • Stock location - id, manual tag, enabled module, workflow

  • User - role

How it’s work

To create a menu for the Store app, click on the add menu button or duplicate an existing menu.

In order to always fall into a menu, it is highly recommended to always have a menu with ‘no conditions’ in the last position.

You can then edit it by clicking on it. From here you can choose between four actions:

  • Add a condition to the menu (custom menu depending on user or stock location conditions)

  • Add a section to the menu (page group)

  • Add a page to a section (drag and drop)

  • Delete the menu (top right)

Once the section has been created, standard pages can be added simply by dragging and dropping them from the side section.

Then, the display of each page or each section can be conditioned. Simply click on the element and add the condition. It will then be visible in the main view.

The most frequently used condition concerns activated modules. Each section of type "sfs", "ckc" etc. must be displayed only if the module is activated in the stock location.

Tips & tricks

Override OIS catalog home page

The OIS catalog home page can be configured. To do this, you need to:

  • create a custom page by clicking on the Create custom page button

  • select the Existing page tab

  • choose the Catalog page

  • fill in the necessary parameters.

Create a custom external page

There is a component for loading an external script. To add one custom page to the given menu you can click on the “Create custom page“ button.

Then you can choose the extension tab and fill the name and the path. Once you've created this page, you'll find it in the list on the right, and you can drag and drop it into the section of your choice.

The "script" field is configured in another section of the configuration. You'll need to go to Configuration > Store App > Pages > my_custom_page (with my_custom_page = Name given at the creation of the custom page).

By filling all these parameters your custom page will be up and running:

  • API URL → https://custom.onestock-retail.io

  • Query path → /path/new

If you create a new page, don't forget to do all the translations associated with that page.