Customize the new Hikari theme in IBM Connections 5.5

With IBM Connections version 5.5 a new default theme was introduced, the
Hikari theme. In order to customize this new theme new directory paths are
required. You can find the source sprite files ( images ) and the CSS files of this
theme in the following location.

D:\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\ACMECORPCell01\Common.ear\connections.web.resources.war\WEB-INF\eclipse\plugins

Now open the following JAR file. ( Running IC55 CR1 )

com.ibm.social.hikari.theme_1.0.0.20160515-0614.jar

Under \resources\sprite you can find the images used within this theme.

com.ibm.social.hikari.theme_1.0.0.20160515-0614.jar\resources\sprite
WinrarSpriteFolderHikariTheme

 

Place customized versions of these images under the CONNECTION_CUSTOMIZATION_PATH. Find the current customization path in the WAS console under Environment -> WebSphere variables.

For example, CONNECTIONS_CUSTOMIZATION_PATH  =
\\\\fs01.ACMECORP.net\\connections55\\customization

Additions and customization’s for the Hikari theme style-sheet needs to be placed under
the following path in a file with the name custom.css.

\\fs01.acmecorp.net\\connections55\customization\themes\HikariTheme

Custom sprites used by the Hikari theme need to be placed in the below mentioned directory. You can just create a copy of an existing sprite file and make adjustments to it, use other colors or create complete new icons.

\\fs01.acmecorp.net\connections55\customization\javascript\com\ibm\social\hikari\theme\sprite

This way you can easily re-style the images used for the Apps menu or the Mail & Calendar icons as used by Connections Mail.

HikariThemeCustomizedMailIcons

IC55 Hikari theme custom mail icons

HikariThemeCustomizedAppsIcons

IC55 Hikari theme custom Apps icons

 

 

 

The caching mechanism of Connections can be very persistent. When activating new
theme changes for Connections I always go for removing all the temp files of the
WAS IC nodes. So stopping all JVM’s, removing everything under AppSrv01/temp and
starting all JVM’s again. Then in the browser go for a CTRL + F5 to see the theme changes.

A strange phenomenon in the combination of Connections 5.5, Connections Mail 1.7 and Windows servers is that temp files are created in directory paths which are longer than the supported length of Windows. ( running Windows 2012R2 )

Whenever you try to remove the Common temp folder you will get this prompt.

WindowsConnectionsMailtempfiles

 

 

 

 

 
Whenever you try to browse to certain directories you will notice that the path
gets so long that you will not be able to open the underlying directories anymore.

For example:

D:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp\NLDELCONN98Node01\InfraCluster_server1\Common\connections.web.resources.war\eclipse\workspace\.metadata\.plugins\com.ibm.servlets.amd.dojo.1.9.resources\__build-version__\domjs\dojo_trunk\131.20160119-0324

In order to delete these temp files you will need to make the full path length smaller.
So in case of the path as mentioned  above rename some of the directories to a
single character.

AppSrv01\temp\NLDELCONN98Node01\1\2\2\eclipse\

 

 

This entry was posted in ibm connections and tagged , , , , , . Bookmark the permalink.

Leave a Reply

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

Please leave these two fields as-is:

Protected by Invisible Defender. Showed 403 to 807,336 bad guys.