Profiles widget attributes

The following tables list the widget elements that you can configure when enabling, disabling, editing, or moving widgets in the Profiles application. These elements are configured in the widgets-config.xml file.

Profiles widget elements

Table 1. The widget definition element
AttributeDescription Required
defIdThe widget name, which must be unique. The defId attribute is also used as a title or a resource bundle key.

This attribute takes a string value.

Yes
primaryWidgetSpecifies that the widget displays in the center column of the page. The default value is true.No
description Description of the widget that displays in the widget palette. This attribute uses the custom string framework. For more information about adding widget strings, see Adding custom strings for widgets and other specified scenarios.No
category The category in which the widget is placed in the widget palette. This attribute uses the custom string framework. For more information about adding widget strings, see Adding custom strings for widgets and other specified scenarios. No
requires Specifies which HCL Connections applications are required for the widget to function. The XML attribute values must match the serviceReference values in the LotusConnections-config.xml file. No
url Specifies the location of the widget descriptor. This XML attribute can be parameterized with substitution variables.

This attribute takes a string value.

Yes
modesSpecifies the modes that are supported by the custom widget. Possible modes include:
  • view. This mode enables the widget to display on the profile overview page.
  • search. This mode integrates the widget into a community's search results page. Each widget displays as a separate tab on the page.
  • fullpage. This mode integrates the widget into the navigation bar. When users click the widget link in the navigation bar, the widget displays in a full page view in the community.
  • edit. This mode enables the Edit menu option in the widget's action menu, allowing community owners to edit the preferences of the widget inline, directly from the community's Overview page. The widget is also integrated in to the Edit Community page as a separate tab.
No
uniqueInstanceSpecifies whether the widget supports multiple instances on the same page. The default value is true.No
navBarLink Specifies the URL to an external application. A link to this URL is added to the navigation bar when the widget is part of the community. The URL can contain substitution variables. No
helpLink Specifies the URL to an HTML file containing help documentation for the widget. The help opens in a pop-up window. This parameter can contain subvariables. It can also be parameterized with substitution variables.No
showInPaletteSpecifies if the widget should be displayed in the content palette.No
loginRequiredSpecifies that the widget displays only when users are logged in.No
bundleRefIdThe resource bundle reference ID that is defined in the LotusConnections-config.xml file. This ID is used to determine the bundle strings for the widget category, widget description, and widget title. For more information about adding widget strings, see Adding custom strings for widgets and other specified scenarios.No
Note: The url, navBarLink, and item or @value XML attributes can be parameterized using substitution variables. For more information about the substitution variables that you can use, see Profiles widget configuration variables.
Table 2. The layout element
AttributeDescription
resourceSubType Contains the name of the profile type that is used to render the widget layout. Multiple profile type layout configuration is allowed in Profiles. For more information, see Adding profile types.

This attribute takes a string value.

Table 3. The page element
Attribute Description
pageIdContains the page ID for the page that Profiles uses to render the widget layout. This attribute takes a string value.
Possible values include:
  • profilesView
  • searchView
  • searchResultView
  • networkView
  • editProfileView
Table 4. The widget instance element
AttributeDescription
uiLocation Specifies which column on the page contains the widget. This attribute takes a string value.
Possible values include:
  • col1
  • col2
  • col3. Note that this option is not available for the networkView page.
defIdRef Defines the widget definition to which the instance is bound.

This attribute takes a string value.