Customize the landing pages

You can specify how many information objects appear in the Dashboard, Services, and Support pages, and their order of appearance. The order is defined in rows that appear left-to-right, and top-to-bottom. For example, you might want to hide the object that lists popular bundles or popular items. There are seven information objects (widgets) that can appear on any landing page. The following list describes the name and configuration ID of these widgets.:

  • Pending Approvals (APPROVAL_STATUS)

  • Request Status (REQUEST_STATUS)

  • Popular Items (POPULAR_ITEMS)

  • Request On Behalf (REQUEST_ON_BEHALF)

  • Assistance (ASSISTANCE)

  • Your Subscriptions (SUBSCRIPTION)

  • Support (SUPPORT)

To customize the order of appearance of these widgets, follow these steps:

  1. In the manifest.xml file, locate the <widgetsGroup></widgetsGroup> section. Within this section, you can configure the number of widgets for each landing page and the display order (left to right and top to bottom).

    - <widgetsGroup>
      + <widgets displayOn="DASHBOARD">
      + <widgets displayOn="SERVICE">
      + <widgets displayOn="SUPPORT">
      </widgetsGroup>
    

    There are sub-parameters for each available object.

  2. Locate the <widgets></widgets> parameter. There are sub-parameters for each available object. For example, your manifest.xml may resemble the following:

    <widgets displayOn="pagename">
    	<widget displayOrder="1" 
    	type="APPROVAL_STATUS" visible="true"/>
    	<widget displayOrder="2" 
    	type="REQUEST_STATUS" visible="true"/>
    	<widget displayOrder="3"
    	type="POPULAR_ITEMS" visible="true"/>
    	<widget displayOrder="4"
    	type="ASSISTANCE" visible="true"/>
    </widgets>
  3. You cannot change the name of the object, but you can change the order that they appear in by changing the number assigned to the object. For example, to make the REQUEST_STATUS object appear first, change the value of its displayOrder attribute from 2 to 1.

    • Make sure to change the order value assigned to APPROVAL_STATUS.
    • Make sure each object has a unique displayOrder value.
  4. To hide a widget, change its visible attribute from true to false.

  5. Save your changes, but do not close the file until you are done.