Community Widget File Download with Connections Customizer¶
Note: These instructions are for HCL Connections On-Premise
If you want to learn more about using Connections Customizer, have a read of the developer documentation on GitHub.
Prerequisites¶
- Connections Customizer is setup as per documentation
- Download boards-iframe-download-customizer.zip
Configure Reverse Proxy¶
As part of the Connections Customizer set up, you configured a reverse proxy.
Our Customizer app has integration points in Communities. The rule in your reverse proxy conf that directs requests to mw-proxy
(customizer) should include all Community paths. You might already be directing all traffic through Customizer, which will also work.
location ~ ^/(files/customizer|files/app|communities/service/html|forums/html|search/web|homepage/web|social/home|mycontacts|wikis/home|blogs|news|activities/service/html|profiles/html|viewer) {
proxy_pass http://MW_PROXY_SERVICE:30301;
}
Copy Files to Customizer Server¶
The script file that is injected by Customizer needs to be copied into a directory on the mw-proxy
server.
-
Extract files from
boards-iframe-download-customiser.zip
-
You will need to change the variable
boardsFrameSrc
to the URL (or part there of) of Boards in your environment -
Copy
iframe-download.js
into/pv-connections/customizations/huddo-boards-iframe-download
-
Update
iframe-download.js
and replace the variable boardsFrameSrc with the Boards URL in your environment
Register Boards iFrame Download in Customizer¶
- Go to the Connections Customizer App Registry, e.g
https://connections.example.com/appreg
Note: To access App Registry, you need to have the
admin
Security Role for the Common application. This is configured in the WebSphere console
-
Add a new app.
-
Open Code Editor.
-
Import or copy the entire contents of
appreg-manifest.json
fromboards-iframe-download-customiser.zip
into the code editor and clickSave
.
This saves you from completing all of the form fields for creating the app. You can edit the app now to customize names or directories if necessary.