Application menu

GoERP UI library contains a standard component named “Unified menu”. Applications must use this component for navigation within the app.

The menu bar can appear at the top of the page — or the left side of the screen. Menu position can be set in HTML by toggling a class name:

class="menu--topnav"
vs
class="menu--sidebar"

The position should be set according to user preference, so that when the user navigates from app to app, the menu always appears in the same position.

Read the preference from a CAFA setting, using the call GET /configuration. Parameters:

application=GOERP
name=goerp-menu-position
level=User
level_id=<current user ID>

NB! Set the following header to the request:

Look-Deeper: true

If there is no preference set for this particular user, CAFA will return the accountwide setting as the fallback.

Possible values:

top
side

If the setting does not exist or the value is empty, assume side as the default.

(If you want to create a settings page where the user can change the preference, use the same “application” and “name” to update the setting in CAFA.)

Tailoring the menu to your app

When integrating the component, make sure that the following elements display information appropriate to your app:

  • App name
  • App icon
  • Version number
  • Link to app store (the “Upgrade” button)

Standard elements

The component also contains several standard navigation elements, to let the user navigate between apps, tell them where they are right now and give them a set of base features on every screen:

  • Account number
  • Company name
  • Username
  • Language switcher
  • Account switcher
  • Link to dashboard: “Switch application”
  • Logout link
  • Wiki link