Customizing the Navbar

As an administrator, you can completely customize the navbar to present users with navigation that is appropriate for your environment. Setting up custom navigation in EmpowerID is an easy process that you can perform without needing to write any custom code or create overrides files. You simply enable the navbar sections you want to customize, edit the localized text entry for those navbar section you are adding to the navbar, and add the appropriate UIActions to the UINoun and UIVerb you want to associate with those customized sections.

To enable custom navbar sections

  1. On the navbar, expand Infrastructure Admin > EmpowerID Servers and Settings and click EmpowerID System Settings.

    This takes you to the EmpowerID System Settings page, where you can configure certain aspects of the application.




  2. Search for navbar.

    You should see settings for NavBarSection*Enabled, NavBarSection*Noun, NavBarSection*Verb, where * represents a whole number such as 10.




  3. Filter the search to NavBarSection10 to reduce the number of objects returned to just those settings for that custom section.

  4. Click the Edit button for NavBarSection10Enabled.




  5. Change the Value from false to true and then click SAVE.




  6. Recycle the EmpowerID IIS app pools and then refresh the browser.

    You should the new navbar section at the top of the navbar.




  7. Next, let’s edit the localized text entry so that the section displays something other than NavBarSection10Title.

To edit the localized text entry for NavBarSection10

  1. On the navbar, expand Admin > Miscellaneous and click Localized Text.

    This takes you to the LocaleKeyEntry page, where you can create new localized strings and well as edit exiting ones.




  2. From the Localized Strings tab, search for NavBarSection10Title and then click the Local Key (Unique Name) link.




  3. On the Locale Key Details page that appears, click the Edit icon to put the Locale Key in edit mode.




  4. Change the Default Value from NavBarSection10Title to something more meaningful. In our example, we are changing the value to I want to.




  5. Save your changes and recycle the EmpowerID IIS app pools.

  6. Refresh your browser.

    You should the title text for new navbar section update to reflect your change.


     

     

Next, lets create a new UIAction named ChangeMyPassword that we will then add to the new section.

To create a new UIAction

  1. On the navbar, expand Admin > Miscellaneous and click Noun Verb Action Navigation.

    This takes you to the NounVerbsAction page, which where you create new UINouns, UIVerbs and UIActions, as well as view and edit existing ones.




  2. Go to the UIAction tab, and then click the Create New UIAction button.




  3. Fill in the Actions Details form with the following information:

    • Action Name (no spaces) — ChangeMyPassword

    • Display Name — Change My Password

    • Description — Change your password

    • Locale Key (Unique Name) — ChangeMyPassword

    • Locale Key for Description — Change my password

    • Verb — NavbarSection10Verb

    • Noun — NavbarSection10Noun

    • Toggle Is a Contextual Action Only so that it is not selected.

    • Select Workflow and then select Change Password




  4. Save the new UIAction.

  5. Recycle the EmpowerID IIS app pools and then refresh your browser.

    You should see the new UIAction underneath the custom navbar section.




After enabling the navbar section and adding UIActions to it, you need to configure access to the section and any workflows or pages grouped under the section before users will be able those navbar items. By controlling access in this way, you can completely customize which navbar items appear to which users as shown below.