In this tutorial you will customize the Share header menu. In the previous two tutorials you saw how to add menu items and customize them. You will now learn how to remove menu items. This will be demonstrated using two different techniques: using a built-in helper function,widgetUtils.deleteObjectFromArray, and through configuration exposed by the SkyVault/header/AlfSitesMenu widget.
In the first part of this tutorial you will use the helper function widgetUtils.deleteObjectFromArray to remove menu items. This function takes three arguments:
- The object to remove the widget definition from (you can typically just use model.jsonModel)
- The attribute to search for (you should use id)
- The value to match against the target attribute (the id attribute of the widget definition to remove)
For example, to remove the My Files link from the menu bar you would need to include the following code in the file share-header.get.js (see the two previous tutorials):
widgetUtils.deleteObjectFromArray(model.jsonModel, "id", "HEADER_MY_FILES");
You will now try this out by removing the My Files menu item.
- In Eclipse load up the file share-header.get.js that you created in the previous tutorials.
-
At the end of the file add the following code:
widgetUtils.deleteObjectFromArray(model.jsonModel, "id", "HEADER_MY_FILES");Save the file.
-
In the Package Explorer right-click on the build.xml file
and select .
This builds a new JAR file that was already deployed in the previous tutorial.
- Restart the application server (for example, Tomcat).
-
Log in to Share, you will see that the My Files menu
item is no longer present on the main menu.
In this part of the tutorial you have seen how to use the helper function to remove a menu item. Note your code could have been more complex. For example, to hide MyFiles for users who are not admins you could use the following code:
if (!user.isAdmin) { widgetUtils.deleteObjectFromArray(model.jsonModel, "id", "HEADER_MY_FILES"); }
In this next section of the tutorial you will see how to remove items from the Sites drop-down menu. Although you saw how to customize the Sites menu in the previous tutorial, there is now (from 4.2.2 and onwards) configuration attributes that allow the easy removal of Site menu items.
These boolean attributes are as follows:
| Attribute | Description |
|---|---|
| showCreateSite | Controls whether the Create Site menu item is displayed. |
| showSiteFinder | Controls whether the Site Finder menu item is displayed. |
| showUsefulGroup | Controls whether the Useful menu group is displayed. Will override showCreateSite, showSiteFinder and showFavourites. |
| showRecentSites | Controls whether the Recent Sites menu group is displayed. |
| showFavourites | Controls whether the Facvourites menu item and favourite controls (such as add/remove) are displayed. |
For example, to hide the Site Finder, you would include the following code in share-header.get.js:
// Find the "Sites" menu...
var sitesMenu =
widgetUtils.findObject(model.jsonModel, "id", "HEADER_SITES_MENU");
if (sitesMenu != null)
{
// Hide the site finder...
sitesMenu.config.showSiteFinder = false;
}
- In Eclipse load up the file share-header.get.js that you created in the previous tutorials.
-
At the end of the file add the following code:
// Find the "Sites" menu... var sitesMenu = widgetUtils.findObject(model.jsonModel, "id", "HEADER_SITES_MENU"); if (sitesMenu != null) { // Hide the site finder... sitesMenu.config.showSiteFinder = false; }Save the file.
-
In the Package Explorer right-click on the build.xml file
and select .
This builds a new JAR file that was already deployed in the previous tutorial.
- Restart the application server (for example, Tomcat).
- Log in to Share. Select the Sites menu item from the main menu bar, you will see that the Site Finder is no longer present on the drop-down menu.