search
  1. Home

Categories Widget

Overview

This widget enables users to display selected categories and their immediate subcategories on the home page. Users can associate an image with each category to create a visual and intuitive navigation path in place of the traditional tree structure.

Configuring the Widget

  1. Login to Portal Administration.
  2. Click Edit in a portal's row in the Available Portals list.
  3. Click Configuration.
  4. Scroll to the lines:
    <home> 
    <categoriesWidget>
  5. Make changes to the Attributes Widget as described in the table.
  6. Click Save.

XML Section

Description

Example

<home>

.

.

.

<categoriesWidget >

 

Only one instance of this widget can be defined.

A maximum of 20 categories can be defined.

Enable the widget by setting "enabled=true".

Disable the widget by setting "enabled=false"

Specify:

  • A numeric value for category displayOrder to indicate the order in which the attributes should be displayed. This is mandatory.
  • The numeric value of the top-level parent category id for "id". This is mandatory.
  •  An appropriate category name for "name". This is mandatory. The name of the category given in the KB Admin control panel will not be used
  •  The filename of a graphic that gives a visual identity for the category. This is an optional entry. If you wish to use it, provide the file name only, you need not specify the path.
  • Ensure that the size (height and width) of the images for each category are of the same dimensions to maintain a uniform and neat display on the portal.

<categoriesWidget enabled="true">

<category displayOrder="2">

<id>1026</id>

<name>BILLING</name>

<image>icon3.png</image>

</category>

<category displayOrder="1" 

<id>1027</id>

<name>Bus Prod</name>

<image>icon4.png</image>  

</category>

</categoriesWidget>

 

 

 

 Table : Configure Widget - Categories

To determine the ID of a category from the Administration control panel, mouse-over the desired category and observe the ID.  

See the box-highlight in Figure "Category ID".


Figure: Category ID

Important: The title of the widget is defined in the Language option in "Portal Administration".