Tweak HCL Connections Newsletter v2

by Christoph Stoettner
Read in about 2 min · (words)

Postboxes for newsletter

Photo by Yannik Mika | Unsplash

The newsletter in version 2 format has one big disadvantage, we or our users lost the easy links to the topic, author profile or application.

Newsletter version 1

When we look at the same information in Newsletter version 2, we can’t open the profile or the main blog/application, just the post is linked on the “Open” link.

Newsletter version 2 with default settings

The links are stored in the homepage database and are stripped away during the generation of the newsletter/notification message.

/opt/IBM/WebSphere/AppServer/profiles/Dmgr01/config/cells/CellName/LotusConnections-config/notifications_v2/resources/commonUtil.ftl

391
392
393
394
395
396
397
398
399
400
401
402
<#-- Convert html fragment structures to text
 #              Strip all tags but preserve html entities
 #              Structural tags converted to white space to maintain word separation
 #              Link URL's are discarded
 # -->
<#function convertHtmlStructuresToText html>
        <#if html??>
                <#return __convertHtmlStructuresToText(html?string) />
        <#else>
                <#return html />
        </#if>
</#function>

This function is called to prepare the headings in the notifications. So we can remove the call, or just return the html after the call:

391
392
393
394
395
396
397
398
399
400
401
402
<#-- Convert html fragment structures to text
 #              Strip all tags but preserve html entities
 #              Structural tags converted to white space to maintain word separation
 #              Link URL's are discarded
 # -->
<#function convertHtmlStructuresToText html>
        <#if html??>
                <#return html /> # <.>
        <#else>
                <#return html />
        </#if>
</#function>

Replace the original line here with the highlighted code.

Now synchronize the nodes and test it again:

Newsletter version 2 with customized header

Author
Add a comment
Error
There was an error sending your comment, please try again.
Thank you!
Your comment has been submitted and will be published once it has been approved.

Your email address will not be published. Required fields are marked with *

Suggested Reading
Card image cap

Since IBM Connections 6.0CR4 we can use a new newsletter format which needs still (now with HCL Connections 7) be activated separately in LotusConnections-config/notification-config.xml.

Today some users asked how they can add other users to their private communities (visible in Community catalog) without manually adding them. As we investigated the question I had a look at the old notification format.

Read in about 3 min
Aaron Burden: Fountain pen and a notebook
I had an issue with daily newsletters in Connections 3.x, where newsletters were sent every 25 and not 24 hours. This is fixed in Connections 4, now newsletters are arriving every 24 hours.
Read in about 1 min
Card image cap

I wrote about font loading from external CDN in the post Hiding The Create Community Button 2nd last year and hoped this is finally fixed for all Connections applications. A good summary on the reasons to not allow external font loading is Blocking Web Fonts for Speed and Privacy .

So I checked with a Connections 7 deployment with the latest CFix (CFix.70.2112) deployed, if this is still an issue with Connections.

In former Connections' versions we found external fonts loaded in Orient Me (/social), Communities Catalog (/communities) and the Admin panel (/cnxadmin/).

Read in about 5 min