Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 that 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.

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 Save.

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

    You should the new navbar section on the navbar. If you don’t see the new section, try clearing the browser cache.

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

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 of the page, 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, let's update the values for the NavBarSection10Verb and NavBarSection10Noun settings to the appropriate UINouns and UIVerbs in the system that represent what do users can do in the new section. For example, if you want users to be able to reset their passwords, you could change the Noun to Password and the verb to ChangePassword.

Easy html macro
theme{"label":"solarized_dark","value":"solarized_dark"}
contentByMode{"html":"<!doctype html>\r\n<link href=\"https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css\" rel=\"stylesheet\" integrity=\"sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC\" crossorigin=\"anonymous\">\r\n<link href=\"https://docs.empowerid.com/new_docs.css\" rel=\"stylesheet\">\r\n<script src=\"https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js\" integrity=\"sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM\" crossorigin=\"anonymous\"></script>\r\n<div class = \"bd-callout bd-callout-success\">\r\n <p>You can view the default UINouns and UIVerbs by expanding <b>Admin > Miscellaneous</b> and clicking <B>Noun Verb Action Navigation</B> on the navbar. \r\n If desired, you can create new UINouns and UIVerbs and then associate them with the \r\n NavBarSection10Verb and NavBarSection10Noun settings. For the purpose of this topic, \r\n we will use existing UINouns and UIVerbs.</p>\r\n <p><img src=\"https://docs.empowerID.com/assets/img/confluence/UINounDetails.png\" style=\"padding: 10px;max-height: 500px\"/></p>\r\n \r\n </div>\r\n ","javascript":"","css":""}

Update NavBarSection10 Noun and Verb

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

  2. Search for NavBarSection10.

  3. Click the Edit button for NavBarSection10Noun.

  4. Replace the Value with the desired UINoun, which in this example is Password.

  5. Click Save.

  6. Click the Edit button for NavBarSection10Verb.

  7. Replace the Value with the desired UIVerb, which in this example is ChangePassword.

  8. Click Save.


Next, lets create a custom UIAction named ChangeMyPassword and configure the UIAction with the as neededrelevant UINoun and UIVerb.

Easy html macro
theme{"label":"solarized_dark","value":"solarized_dark"}
contentByMode{"html":"<!doctype html>\r\n<link href=\"https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css\" rel=\"stylesheet\" integrity=\"sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC\" crossorigin=\"anonymous\">\r\n<link href=\"https://docs.empowerid.com/new_docs.css\" rel=\"stylesheet\">\r\n<script src=\"https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js\" integrity=\"sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM\" crossorigin=\"anonymous\"></script>\r\n<div class = \"bd-callout bd-callout-success\">\r\n <p>You can view the default UINouns and UIVerbs by expanding <b>Admin > Miscellaneous</b> and clicking <B>Noun Verb Action Navigation</B> on the navbar. \r\n If desired, you can create new UINouns and UIVerbs and then associate them with the \r\n NavBarSection10Verb and NavBarSection10Noun settings. For the purpose of this topic, \r\n we will use existing UINouns and UIVerbs.</p>\r\n <p><img src=\"https://docs.empowerID.com/assets/img/confluence/UINounDetails.png\" style=\"padding: 10px;max-height: 500px\"/></p>\r\n \r\n </div>\r\n ","javascript":"","css":""}

Create a custom 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 (blue star) button.

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

    • Action Name (no spaces) – ChangeMyPassword

    • Display Name – Change My Password

    • Description – Change My Password

    • Locale Key (Unique Name) – Optional

    • Locale Key for Description – Optional

    • Verb – Change Password

    • Noun – Password

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

    • Select Workflow and then select Change Password

  4. Click Save.

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

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


    Insert excerpt
    IL:External Stylesheet
    IL:External Stylesheet
    nopaneltrue

Div
stylefloat:left; position:fixed;
idarticleNav

IN THIS ARTICLE

Table of Contents
maxLevel4
minLevel2
stylenone
printablefalse