Adding the Chat Rooms widget to the widget definition file

Add the Chat Rooms widget definition to the widget definition file, widgets-config.xml.

About this task

For information about modifying the widgets-config.xml file see Using the widgets-config.xml file for Communities.

Procedure

Add the Chat Rooms widget definition to the widget definition file by completing these steps:
  1. On the computer hosting the IBM® Connections server, add a definition for the Chat Rooms widget into the widgets-config.xml file. Use the definition shown here, but customize the values as needed. See the table of customizable widgets-config.xml file values at the end of this definition for a list of values that require customizing. Be sure to use your own url value to reflect your own configuration.
    {code:} <widgetDef defId="Chat Rooms" primaryWidget="false" modes="view" 
url="/communities/nav/common/ChatRoomsWidget.xml" uniqueInstance="true" 
iconUrl="/communities/nav/common/chat-icon.png">

<itemSet>
   item name="sametimeAdvancedUrl" value="http://sametimeadvanced.ibm.com:9080" />
  <item name="globalFolderId" value="20130329-1212-5521-8958-000000000000" />
  <item name="globalFolderName" value="Community Chat Rooms" />
  <item name="sortChatRoomsBy" value="unreadLineCount" />
  <item name="widgetFilePath" value="/communities/nav/common/" />
</itemSet>

</widgetDef>  {code}
    Table 1. Customizable widgets-config.xml file values
    Value Description
    url The ChatRoomsWidget.xml file, including the path.
    iconUrl The chat-icon.png file, including the path.
    sametimeAdvancedUrl The protocol, address and port number to your Sametime® Advanced Server.
    globalFolderId The ID of the folder which stores all Community folders.
    globalFolderName The name of the folder which stores all Community folders.
    sortChatRoomsBy The sort order of the chat rooms when displayed in Communities. Options are unreadLineCount or activeUserCount.
    widgetFilePath The path to the widget files.
  2. Save and close the file.