Make your ibm connections deployment your own, customize it!

Make Your IBM Connections
Deployment Your Own: Customize
It!
Wannes Rams

Wannes Rams - wannes@ramsit.com

Introduction
About Wannes Rams
wannes.rams.be
twitter.com/wannesrams
linkedin.com/in/wannesrams
http://slideshare.com/palmke

About this Presentation
http://www.slideshare.net/palmke/show301-make-your-ibm-connections-
deployment-your-owncustomize-
it-30628456

About my co-speaker

Agenda in Orlando
• Introduction
• User Interface
• Login Page
• Notifications
• Getting Started Page
• Communities
• Wikis
• Profiles
• Richtext Editor
• Media Gallery
Object Types
• Mobile App
• Reports
• Desktop Plugin
• IBM Connections
Content Manager

Todays agenda
• Introduction
• User Interface
• Login Page
• Notifications
• Getting Started Page
• Communities
• Wikis
• Profiles
• Richtext Editor
• Media Gallery Object Types
• Mobile App
• Reports
• Desktop Plugin
• IBM Connections Content
Manager
• Introduction
• Notifications
• Profile Types
• Profile widgets
• Login Page

So, who are you?

Introduction
Our environment
• Microsoft Windows Server 2008 R2
• IBM Connections 4.5 CR3 (IBM Domino LDAP, single
box installation)
• CONNECTIONS_CUSTOMIZATION_DEBUG enabled
• Next Generation Theme
• Profile templateReloading in profiles-config.xmlset to
15 secs
• Login credentials stored in soap.client.properties
-> Always disable debug & reloading settings in
production!

Introduction
Remarks
 We use following abbreviations:
–custom_dir: Customization directory, check the WebSphere variable
CONNECTIONS_CUSTOMIZATION_PATH
(here D:IBMConnectionsdatasharedcustomization
)
–provision_dir: Provision directory, check the WebSphere variable
CONNECTIONS_PROVISION_PATH
(here D:IBMConnectionsdatasharedprovision)
–profiles_dir: WebSphere profiles directory
(here D:IBMWebSphereAppServerprofiles)
–htdocs: HTTP Server htdocs directory
(here D:IBMHTTPServerhtdocs)

Notifications – Example
Custom colors, logoChanged
sender
Custom
text

Notifications – Example
Change default weekly
newsletters to daily

Notifications – How to
Change Text
 Open following folder:
profiles_dirDmgr01configcellsconnectionsCell01LotusConnections-
confignotifications
 Here you can find the source files for all the different notifications

Change Text
• Open notification(_en).properties in the resourcesnls folder

Change Text
• Change the text IBM Connections to IBM Connect 14
• Do the same for each language file which you want to use

Change Text
 Go back to the notifications folder and now open the notification(_en).properties
in newsresourcesnls
 Change every occurrence of IBM Connections to IBM Connect 14

Change Logo and Colors
 Go back to the notifications folder and now open the style.ftl in newsaggregated
 Change every occurrence of color #474747 to #025d9c

 Change the referenced footer image from ibmLogoWhite23.png to ibmconnect.png

 Go back to notification and copy ibmconnect.png to resourcesimages

 Open WAS Administrative Console and navigate to „Applications – WebSphere
enterprise applications“
 Stop an Start the
News App

Change Default Notifications Settings
 Start the wsadmin client and execute connectionsConfig.py
 Check out the notification-config.xml
LCConfigService.checkOutNotificationConfig('D:/temp','connectionsCell01’)

 Open notification-config.xml in D:temp
 Change properties for sender and mobile links

 Change all defaultFollowFrequency="WEEKLY” to defaultFollowFrequency=”DAILY"

 Close the file and check it in
LCConfigService.checkInNotificationConfig()
 Execute newsAdmin.py

 Run following command to refresh the default Email settings:
NewsEmailDigestService.refreshDefaultEmailPrefsFromConfig()

Notifications – Result
 Check the new settings in the browser by resetting to default notifications settings

 You can trigger the email digests by accessing the following URL to verify your settings
(admin will only receive digest)
http://connections.snt.com/news/web/testEmailDigestSendMail.action?type=daily
 Or for all users
http://connections.snt.com/news/web/testEmailDigestSendMail.action?type=daily&initNextTranche=t
rue

 Check Newsletters in your mail client (Desktop and Mobile)
Mail on Mobile

Notifications – Resources
 Customizing notifications
http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Customizing_notifications_ic45
 Including mobile links in notifications
http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Including_mobile_links_in_notifications_ic45
 Setting the default frequency of email digests
http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Setting_the_default_frequency_of_email_digests_ic45
 Verifying email digests
http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Verifying_email_digests_ic45

Profiles – Introduction
Add profile types
• In this part we will add a second profile type. This profile type will
contain only a subset of the profile attributes that the default
profile will have. We will also disable widgets based on the profile
• What are profile types
– Definition of different types of users
– Allows to change look and feel of the profiles application
– Example: customer, employee, contractor
• Why use profile types
– Show different data for different types of users
– Block certain features
– Block built in widgets
– Block custom widgets
– Limit information stream
– Phase a rollout

Profiles – Example
Add profile types

Profiles – How To
Add profile types
 First thing we need to decide is what field in LDAP will define the profile type.
In this example we will use an existing field that is not used for anything else
 Now we need to configure TDI to add the profile type to the Profiles database. Alter the
map_dbrepos_from_source.properties file in your TDI Solution directory and map
profileType to your field in LDAP

Profiles – How To
Add profile types
 Now run your TDI sync command
 This is what you will see in the Employee database

Profiles – How To
Add profile types
 Start the wsadmin client and execute profilesAdmin.py
 Check out the profiles-config.xml
ProfilesConfigService.checkOutConfig('D:/temp','connectionsCell01’)

Profiles – How To
Add profile types
 We need to define the profile types and the profile fields we want to show in the file
profiles-types.xml

Profiles – How To
Add profile types

Profiles – How To
Add profile types
 We can now disable profile features or widgets based on the profile type. We will start
with the profile features
 Open profiles-policy.xml and add the desired configuration

Profiles – How To
Add profile types
• Check in the profiles configuration
ProfilesConfigService.checkInConfig()

Profiles – How To
Add profile types
 Open WAS Administrative Console and navigate to “Applications – WebSphere
enterprise applications”
 Stop and Start
the Profiles App

Profiles – How To
Add profile types
• Login with the external user
Tagging
enabled
when
logged on
as
external
user
No Twitter Id

Profiles – Result
Logged in with internal user
Tagging disabled No invitation
button Disabled

Profiles – How To
Add profile types
 We will now disable widgets based on the profile type
 Check out the widget configuration.
 Disable the widgets you don’t want to show in widgets-config.xml

Profiles – How To
Add profile types
• Check in the widget configuration again and restart the profiles application

Profiles – Result
Add profile types
Tags and sand gone
Tabs gone All widgets gone
except links

Profiles – Resources
 Adding custom widgets to Profiles
http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Adding_custom_widgets_to_Profiles_ic45
 Customizing IBM Connections – Modifying the Report-To Chain iWidget to include
profile data retrieved via Ajax (Hunter Medney)
https://www.ibm.com/developerworks/community/blogs/hmedney/entry/customizing_co
nnections_modifying_the_report_to_chain_widget_using_profile_data
 Connections iWidget Development Guide
http://www-10.lotus.com/ldd/lcwiki.nsf/dx/development-guide
 Easy as a pie – Creating Widgets for IBM Connections (Mikkel Heisterberg)
http://www.slideshare.net/lekkim/bp207-easy-as-pie-creating-widgets-for-ibm-
connections
 Customizing IBM Connections 4.0 Profiles
http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Customizing_IBM_Connections_4.0_Profiles

Profiles – Resources
 Customizing Profiles
http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Customizing_Profiles_ic45
 Phasing an IBM Connections Rollout? Profile Types May Be the Answer
https://www-
304.ibm.com/connections/blogs/socialbusiness/entry/phasing_an_ibm_connections_roll
out_profile_types_may_be_the_answer4
 Profile types and locking profile features
http://www.slideshare.net/palmke/profile-types-and-locking-profile-features-15498931

Profiles – Introduction
Widget
 In this part we will add a custom google widget to profiles:
– Create widget
– Add widget

Profiles – Example
Widget
Office
address
displayed on
Google
Maps

Profiles – How to
Widget
 Create your widget called googleMap.xml in custom_dirprofiles

Profiles – How to
Widget

Profiles – How to
Widget
 Now we add the widget to our Connections profiles, start the wsadmin client and
execute profilesAdmin.py
 Check out the widgets-config.xml
ProfilesConfigService.checkOutWidgetConfig('D:/temp','connectionsCell01')

Profiles – How to
Widget
 Open widgets-config.xml in D:temp
 Add your new widget

Profiles – How to
Widget
 Check in widgets-config.xml
ProfilesConfigService.checkInWidgetConfig()

Profiles – How to
Widget
 Open WAS Administrative Console and navigate to “Applications – WebSphere
enterprise applications”
 Stop and Start
the Profiles App

Profiles – Result
Widget
 Open a profile and test your widget

Login Page – Introduction
 In this part we will:
– Add a disclaimer to the login page

Login Page – Example

Login Page – How to
Alter the login.jsp
 We need to change login.jsp. To do that copy
profiles_dir/AppSrv01/installedApps/connectionsCell01/Blogs.ear/blogs.war/
nav/templates/login.jsp
to
custom_dircommonnavtemplates
 Replace the following part

Alter the login.jsp
 With the following code to add the agreement text and agreement button

Alter the login.jsp
 Next thing is to change the loginbutton to make it disabled and assign an id for
reference in our javascript.
Change this code
 With this

Add Javascript
 Now we need to add a small piece of javascript to detect if the agreement was
accepted to change the login button to enabled
 To do this add following javascript to the script section of the file

Add property file(s)
 Last step is to add the property files that contain the actual text. To do so add a new file
to
custom_dirstrings
 Name the file
com.ibm.lconn.core.strings.templates.properties
 You can add files for other languages if you have a multi-language deployment

 Open WAS Administrative Console and navigate to „Applications – WebSphere
enterprise applications“
 Stop and Start the
Common and
Homepage App

Login Page – Result
 Refresh your browser

Login Page – Resources
 Customizing IBM Lotus Connections 3.0
http://public.dhe.ibm.com/software/dw/lotus/LC30CustomizeFinal.pdf

Further examples

Questions?

Thanks
wannes.rams.be
twitter.com/wannesrams
linkedin.com/in/wannesrams
http://slideshare.com/palmke
wannes@ramsit.com

Make your ibm connections deployment your own, customize it!

More Related Content

Similar to Make your ibm connections deployment your own, customize it! (20)

More from Wannes Rams (11)

Recently uploaded (20)

Make your ibm connections deployment your own, customize it!