Determining where to save your customizations
When you are customizing , save your customized files to the appropriate directory to ensure that your customizations override the default settings.
The base directory where you must store your customizations is defined during installation, when it is saved as an IBM® WebSphere® Application Server variable named CONNECTIONS_CUSTOMIZATION_PATH. By default, this variable is set to *installDir*/data/customization
. This customization base directory is referenced as *customizationDir*
throughout the documentation
To determine the location of your customization directory, check the value of the CONNECTIONS_CUSTOMIZATION_PATH variable for your deployment. After you determine the base directory location, you can then identify the subdirectory where you must save your customizations.
-
Log in to the IBM WebSphere Application Server Integrated Solutions Console.
-
Expand Environment and select WebSphere variables.
-
Look for CONNECTIONS_CUSTOMIZATION_PATH in the list of variable names and make a note of the value.
For example:
/local/IBM/Connections/data/shared/customization
-
Save your customized files in the appropriate subdirectory of the customization directory:
-
To save customizations that apply to all the applications, copy the file into the common subdirectory:
*customizationDir*/common
-
To save customizations that apply to a single application only, copy the file into the subdirectory for that application:
Directory path Description *customizationDir*/common
Stores files to be applied to all of the applications. You most often copy edited files to this directory. *customizationDir*/activities
Stores files to be applied to the Activities user interface only. *customizationDir*/blogs
Stores files to be applied to the Blogs user interface only. *customizationDir*/bookmarks
Stores files to be applied to the Bookmarks user interface only. *customizationDir*/communities
Stores files to be applied to the Communities user interface only. *customizationDir*/files
Stores files to be applied to the Files user interface only. *customizationDir*/forums
Stores files to be applied to the Forums user interface only. *customizationDir*/homepage
Stores files to be applied to the Home page user interface only. *customizationDir*/metrics
Stores files to be applied to the Metrics page user interface only. *customizationDir*/moderation
Stores files to be applied to the Moderation page user interface only. *customizationDir*/news
Stores files to be applied to the News user interface only. *customizationDir*/profiles
Stores files to be applied to the Profiles user interface only. *customizationDir*/search
Stores files to be applied to the Advanced Search user interface only. *customizationDir*/wikis
Stores files to be applied to the Wikis user interface only. Note
Footers for Community widgets are controlled within the Communities subdirectory. With the exception of Blogs and Wikis which are controlled from their respective application subdirectories.
The following table identifies where to store customized versions of files when the customizations apply to all the applications.
Directory path Description *customizationDir*/themes/<theme_name>Theme/custom.css
Customized styles *customizationDir*/themes/<theme_name>Theme/defaultTheme.css
Customized themes *customizationDir*/common/nav/templates/login.jsp
Customized login page *customizationDir*/common/nav/templates/footer.jsp
Customized footer file *customizationDir*/common/nav/templates/error.jsp
Customized error page *customizationDir*/themes/images
Customized images The following table identifies where to store application-specific versions of customized CSS files:
File name and file path Description *customizationDir*/themes/*theme*/applications/activities.css
Customized styles for Activities. *customizationDir*/themes/*theme*/applications/blogs.css
Customized styles for Blogs. *customizationDir*/themes/*theme*/applications/dogear.css
Customized styles for Bookmarks. *customizationDir*/themes/*theme*/applications/bookmarklet.css
Customized styles for the Bookmarklet. *customizationDir*/themes/*theme*/applications/communities.css
Customized styles for Communities. *customizationDir*/themes/*theme*/applications/files.css
Customized styles for Files. *customizationDir*/themes/*theme*/applications/forums.css
Customized styles for Forums. *customizationDir*/themes/*theme*/applications/homepage.css
Customized styles for the Home page. *customizationDir*/themes/*theme*/applications/metrics.css
Customized styles for Metrics. *customizationDir*/themes/*theme*/applications/moderation.css
Customized styles for Moderation. *customizationDir*/themes/*theme*/applications/news.css
Customized styles for News. *customizationDir*/themes/*theme*/applications/profiles.css
Customized styles for Profiles. *customizationDir*/themes/*theme*/applications/wikis.css
Customized styles for Wikis.
Note
- Where theme is the name of the themes that are available for each application. For example: redTheme, goldTheme, and so on.
- When you select the Coffee theme in the UI, the goldTheme is invoked. There is no coffeeTheme in the CSS files.
- Right-to-left themes are specified in the
*application*RTL.css
files, where application represents one of the HCL Connections applications. For example:activitiesRTL.css
- For information about where to save customized application properties files, see the Property file strings topic.
-