Skip to content

HCL Connections Widget Setup

Add Huddo Boards Hybrid widgets into HCL Connections on-premise environments


Community Widget

  1. SSH to the WAS Deployment Manager

  2. Start wsadmin

    cd /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/bin
    ./wsadmin.sh -lang jython -user wasadmin -password <password-here>
    
  3. Check out the widgets-config.xml file.

    execfile("profilesAdmin.py")
    ProfilesConfigService.checkOutWidgetConfig("/LCCheckedOut", AdminControl.getCell())
    
  4. Edit the widgets-config.xml file.

    Find the resource element with the type of community, e.g. <resource ... type="community" ... >, then under <widgets>, then within <definitions> add the following:

    <!-- Huddo Boards -->
    <widgetDef defId="HuddoBoards" modes="view fullpage" url="{webresourcesSvcRef}/web/com.ibm.social.urliWidget.web.resources/widget/urlWidget.xml" themes="wpthemeNarrow wpthemeWide wpthemeBanner" uniqueInstance="true">
        <itemSet>
            <item name="resourceId" value="{resourceId}"/>
            <item name="width" value="100%"/>
            <item name="height" value="500px"/>
            <item name="url" value="https://boards.huddo.com/community/connections"/>
        </itemSet>
    </widgetDef>
    <!-- END Huddo Boards -->
    
  5. Check in the widgets-config.xml file.

    ProfilesConfigService.checkInWidgetConfig()
    
  6. Restart the Communities application via the ISC

  7. Optional. Install the extensions for Connections Customizer. This includes a fix for the Community Widget that enables attachments to be downloaded as well as multiple new integrations for Connections.


Activity Stream widget

  1. Open Homepage => Administration

    Click Add another app

    Example

  2. Select the following:

    • OpenSocial Gadget
    • Trusted and Use SSO
    • Show for Activity Stream events
    • All servers

    Click the Add Mapping button.

    Example

  3. Enter values:

    • OAuth Client: conn-ee
    • Service name: connections_service

    Click Ok

  4. Enter the following:

    Field Value
    App Title Huddo Boards Stream
    URL Address https://boards.huddo.com/widgets/connections/url-gadget.xml
    Icon URL https://boards.huddo.com/favicon.ico
  5. Scroll down and click Save

  6. Select the newly defined app and click Enable

    Example


CEC (Community Highlights)

Huddo Boards integrates with Connections Engagement Center

Example

  1. Download the Boards Hybrid widget definition file

  2. Open the CEC (XCC) main admin page

    i.e. https://connections.company.com/xcc/main

  3. Click Customize, Engagement Center Settings, expand Customization Files & click Upload File

    Example

    Note: you must have the admin role for the Customize button to appear

  4. Select the custom.js downloaded previously

    Note: the file must have this name. If you already have a custom.js file you must manually merge the contents. Copy the HuddoBoards() function and make sure to call it in init()

  5. To validate:

    1. Open the Highlights application in a Community
    2. Click Customize, Widgets and Huddo Boards

      Example

    3. The Boards Highlights widget should now appear at the end of the page

      Example