Skip to content

Apps Menu / Navigation

Note

This guide is very similar to the on-premise version but with a different URL: https://boards.huddo.com/auth/connections/[CONNECTIONS_HOSTNAME_BASE64]

HCL Connections 8.0

There are a few ways to achieve this in HCL Connections 8.0 with the new theme.

Top Level More Popout
top level navigation more popout

Customizer

Please see the full customizer extensions documentation for our package of default customisations. The HCL documentation also highlights how to add customEntries to the side navigation.

Customise nav json file

Tip

This is the recommended approach for environments that do not have Customizer installed.

The side navigation is customisable as per the official documentation.

  1. Download the default react-nav.json file.

  2. Rename this file to react-nav-entries.json

  3. Edit this file to add Boards

    Huddo Boards can be added in any place in the navigation. Typically this would either be at the top level in the navbarmenus.main_menus array between Communities and People. Alternatively under the More popout section. Simply add the following JSON object in the corresponding section of the file:

    {
      "id": "boards",
      "name": "Boards",
      "link": "https://boards.huddo.com/auth/connections/[CONNECTIONS_HOSTNAME_BASE64]",
      "icon": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgeG1sOnNwYWNlPSJwcmVzZXJ2ZSI+PHBhdGggZD0iTTQuNSAzaDcuM3Y0LjZINC41em03LjkgMGg3LjN2NC42aC03LjN6bS0uNiAxMS40SDQuNFY4LjloNy40djUuNXpNNC45IDE0aDYuNVY5LjNINC45VjE0em0xNC44LjRoLTcuMlY4LjloNy4ydjUuNXptLTYuOC0uNGg2LjNWOS4zaC02LjNWMTR6bTYuOCA3LjFoLTcuMnYtNS41aDcuMnY1LjV6bS02LjgtLjRoNi4zdi00LjZoLTYuM3Y0LjZ6IiBmaWxsPSIjZmZmZmZmIi8+PC9zdmc+",
      "order": 2500,
      "submenu": []
    },
    

    Where [CONNECTIONS_HOSTNAME_BASE64]is

    • your Connections hostname base64 encoded. E.g.
      connections.example.com => Y29ubmVjdGlvbnMuZXhhbXBsZS5jb20=

    For example:

    Top Level More
    top level navigation more popout
  4. (Optional) Remove Activities menu item

    Once Huddo Boards (Activities Plus) is installed you may choose to remove the Activities menu item. This can be done by removing the following Activities section from the more.submenu array in the json file.

    activities menu item

  5. Place this customised file on your Shared Drive at this location:

    <SHARED_DRIVE>/customization/common/ui/cnx8-react/react-nav-entries.json
    

    For example:

    /nfs/data/shared/customization/common/ui/cnx8-react/react-nav-entries.json
    
  6. Restart the Common application via the ISC to apply the changes

    restart common


HCL Connections 7.0 and earlier

The following steps are for Connections 7 and earlier (6.5, 6.0, 5.5, 5.0 etc) and use the apps.jsp file to add the Huddo Boards app links to the Apps Menu.

Outcome

  1. If you have not customised the apps.jsp file for your connections environment, please make a copy of the file.

    • You can access the file from:

        <WAS_home>/profiles/<profile_name>/installedApps/<cell_name>/Homepage.ear/homepage.war/nav/templates/menu
      
    • Paste the copy into the common\nav\templates subdirectory in the customization directory:

        <installdir>\data\shared\customization\common\nav\templates\menu\apps.jsp
      
  2. To add the Huddo Boards App Link add the following lines towards the bottom of the apps.jsp file before the </table> element

    --%><tr><%--
      --%><th scope="row" class="lotusNowrap"><%--
        --%><img width="16" src="https://boards.huddo.com/img/logo-small.png" /><%--
        --%><a href="https://boards.huddo.com/auth/connections/[CONNECTIONS_HOSTNAME_BASE64]"><%--
          --%><strong><fmt:message key="connections.component.name.kudos.boards" /></strong><%--
        --%></a><%--
      --%></th><%--
      --%><td class="lotusNowrap lotusLastCell"><%--
        --%><a href="https://boards.huddo.com/auth/connections/[CONNECTIONS_HOSTNAME_BASE64]?redirect_to=/todos/assigned"><%--
          --%><fmt:message key="label.menu.kudos.boards.todos" /><%--
        --%></a><%--
      --%></td><%--
      --%><td class="lotusNowrap lotusLastCell"><%--
        --%><a href="https://boards.huddo.com/auth/connections/[CONNECTIONS_HOSTNAME_BASE64]?redirect_to=/templates/public"><%--
          --%><fmt:message key="label.menu.kudos.boards.templates" /><%--
        --%></a><%--
      --%></td><%--
    --%></tr><%--
    

    Where [CONNECTIONS_HOSTNAME_BASE64]is

    • your Connections hostname base64 encoded. E.g.
      connections.example.com => Y29ubmVjdGlvbnMuZXhhbXBsZS5jb20=
      There are many free online services to do this, ie here

  3. Save and close the file

  4. Add the Huddo Boards Strings for the Apps Menu

    • Download the strings files and extract the files to the Connections strings customisation directory:

        <CONNECTIONS_CUSTOMIZATION_PATH>/strings
      
    • Note: Please append the lines to the files if they already exist. Extra languages can also be added

  5. The changes will take effect when the cluster(s) are restarted