Skip to content

Customizing property file strings

Use the information in the tables to locate the customizable strings that are contained in property files and to determine where to save the customized files.

The following tables list the application properties files that contain strings you can customize.

Notes:

  • To customize the source properties files, you must first extract the contents of the JAR file files by using a compression program.
  • In the paths that are listed as follows:

    • installedApps refers to the following directory path: WAS_HOME/profiles/profile_name/installedAppswhere:

      • WAS_HOME is the directory to which you installed IBM® WebSphere®® Application Server.
      • profile_name is the profile to which you installed one of the applications. For example: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/standaloneCell01/
    • webresources refers to the web resources provisioning directory for created during installation. By default, it is created in: CONNECTIONS_HOME/data/shared/provision/webresources

      For example: /opt/IBM/Connections/Data/shared/provision/webresources/

    • customizationDir refers to the base customization directory where you need to save your customized files. This base directory is defined during the installation of , when it is saved as a WebSphere Application Server variable named CONNECTIONS_CUSTOMIZATION_PATH. This variable is set to [shared\_data\_directory\_root](../plan/i_ovr_r_directory_conventions.md)/customization by default.

      For example: local/opt/IBM/Connections/Data/shared/provision/customization/

    • _version refers to the file version and time stamp, for example, _3.0.0.20120307-0100 in the following file name: com.ibm.lconn.activities.web.resources_3.0.0.20120307-0100.jar

    • The customized files are saved in the customizationDir/strings/customized_properties_file_name directory, where any slashes in the source file name location are replaced by dots.

    For example, when you customize the ui.properties source file for Blogs from the Blogs.ear/blogs.war/WEB-INF/classes/com/ibm/lconn/blogs/strings/ui.properties source location, you must save the customized properties file in the following location: customizationDir/strings/com.ibm.lconn.blogs.strings.ui.properties.

  • To customize a locale-specific version of a source file, look in the same source directory for a file of the same name but with the relevant language code appended before the .properties file extension. When you save the customized version of the file, ensure that you append the language code to the file name before the file extension.

    For example, to customize German strings for Blogs, look for the ui_de.properties file in the Blogs.ear/blogs.war/WEB-INF/classes/com/ibm/lconn/blogs/strings/ui.properties source location and save the customized strings in the following location: customizationDir/strings/com.ibm.lconn.blogs.strings.ui_de.properties

    Important: For non-European languages that use Unicode instead of the actual characters, you must update them by using the Unicode for the custom characters, not the actual characters.

  • The following features do not have any properties files that are associated with them:

    • Blog widget (Communities)
    • Enterprise Content Manager document picker (Communities)
    • Ideation Blog widget (Communities)

Common areas

Description Source location Save customizations in
Common widget strings Typically, in installedApps/<cell_name>/application_name.ear/lc.util.web-3.0.jar: com.ibm.lconn.core.strings.templates.propertiesFor example for the home page: ./Homepage.ear/lc.util.web-3.0.jar customizationDir/strings/com.ibm.lconn.core.strings.templates.properties
Core activity stream strings that are used in the home page, Profiles, Communities, HCL Notes®, and other consumers of the activity stream gadget In installedApps/<cell_name>/Common.ear/connections.web.resources.war/WEB-NF/eclipse/plugins/com.ibm.social.as.web.resources_version.jar: properties/activitystream_resources.properties customizationDir/strings/activitystream_resources.properties
Core activity stream strings that are used in the Home page, Profiles, Communities, HCL Notes, and other consumers of the activity stream gadget In installedApps/<cell_name>/Common.ear/connections.web.resources.war/WEB-INF/eclipse/plugins/com.ibm.social.as.lconn.web.resources_version.jar: properties/activitystream_lconn.properties customizationDir/strings/activitystream_lconn.properties
Strings that are used by the Application Access and Access Request interfaces that prompt users to grant, deny, and revoke access to their data for third-party applications that are protected by OAuth. In webresources/com.ibm.lconn.oauth.web.resources_version.jar:_properties/com/ibm/lconn/oauth/strings/ui.properties. webresources refers to the web resources provisioning directory for IBM Connections created during installation. By default, it is created in the following directory: CONNECTIONS_HOME/data/shared/provision/webresources. com.ibm.lconn.oauth.strings.ui.properties.

Activities

Description Source location Save customizations in
Activities user interface strings Most user interface strings are in strings.js. This file is in the Activities resource jar file in the PROVISION folder sample: <CONNECTIONS_PROVISION_PATH>/webresources/com.ibm.lconn.activities.web.resources_version.jar

If you cannot find a string, check the Activities resource bundle in installedApps/<cell_name>/Activities.ear/oawebui.war/WEB-INF/lib/oawebui.jar: com/ibm/openactivities/web/coreui/resources/resources.properties

|customizationDir/strings/com.ibm.openactivities.web.coreui.resources.resources.properties| |Activities notification strings|Notification strings and some user interface strings are in  LotusConnections-config/notifications/activities/resources/nls/notification.properties where locale is the language code, for example notification _en.properties. If no locale is specified, use notification.properties.|Edit and save the customized file in the source location.|

Blogs

Description Source location Save customizations in
User interface strings Blogs.ear/blogs.war/WEB-INF/classes/com/ibm/lconn/blogs/strings/ui.properties customizationDir/strings/com.ibm.lconn.blogs.strings.ui.properties
Log strings Blogs.ear/blogs.war/WEB-INF/classes/com/ibm/lconn/blogs/strings/log.properties customizationDir/strings/com.ibm.lconn.blogs.strings.log.properties

Bookmarklet

Note: The bookmarklet is the window that displays when you add a bookmark. It is in the Common.ear file. The bookmarklet allows users to add bookmarks to different applications, such as Communities or Activities. Users can add a button to their browser that allows them to access the bookmarklet window. Every page in has a Bookmarking Tools link in the page footer that allows users to install this toolbar button.

Description Source location Save customizations in
Bookmarklet user interface strings (JSP files) In installedApps/<cell_name>/Common.ear/lc-bookmarklet.war/WEB-INF/lib/lc-bookmarklet.jar: com/ibm/lconn/bookmarklet/strings/ui.properties customizationDir/strings/com.ibm.lconn.bookmarklet.strings.ui.properties
Bookmarklet user interface strings (Java™ files) In installedApps/<cell_name>/common.ear/lc-bookmarklet.war/WEB-INF/lib/lc-bookmarklet.jar: com/ibm/lconn/bookmarklet/resources/jspresources.properties customizationDir/strings/com.ibm.lconn.bookmarklet.resources.jspresources.properties

Bookmarks

Description Source location Save customizations in
Bookmarks user interface strings (JSP files) In installedApps/<cell_name>/Dogear.ear/dogear.webui.war/WEB-INF/lib/dogear.svc.jar: com/ibm/lconn/dogear/strings/uilabels.properties customizationDir/strings/com.ibm.lconn.dogear.strings.uilabels.properties
Bookmarks user interface strings (Java files) In installedApps/<cell_name>/Dogear.ear/dogear.webui.war/WEB-INF/lib/dogear.svc.jar: com/ibm/lconn/dogear/strings/ui.properties customizationDir/strings/com.ibm.lconn.dogear.strings.ui.properties

Communities

Description Source location Save customizations in
Main Communities application user interface In installedApps/<cell_name>/Communities.ear/comm.web.war/WEB-INF/lib/comm.web.jar: com/ibm/lconn/communities/strings/ui.properties customizationDir/strings/com.ibm.lconn.communities.strings.ui.properties
Communities email text In installedApps/<cell_name>/Communities.ear/comm.web.war/WEB-INF/lib/comm.web.jar: com/ibm/lconn/communities/strings/uiemail.properties customizationDir/strings/com.ibm.lconn.communities.strings.uiemail.properties
Communities business card (used by the applications) In installedApps/<cell_name>/Common.ear/connections.web.resources.war/WEB-INF/eclipse/plugins/com.ibm.lconn.core.web.resources_version.jar: _properties/com/ibm/lconn/core/web/resources/commbizcard.properties customizationDir/strings/com.ibm.lconn.core.web.resources.commbizcard.properties
Communities widget titles installedApps/<cell_name>/Common.ear/connections.web.resources.war/WEB-INF/eclipse/plugins/com.ibm.lconn.core.web.resources_version.jar: _properties/com/ibm/lconn/widgets/resources/ui_widgets.properties customizationDir/strings/com.ibm.lconn.widgets.resources.ui_widgets.properties
Linked Library widget In webresources/com.ibm.lconn.librarywidget.config_version.jar: _properties/com/ibm/quickr/lw/nls/LibraryWidgetMessages.properties customizationDir/strings/com.ibm.quickr.lw.nls.LibraryWidgetMessages.properties
Related Communities widget In installedApps/<cell_name>/Communities.ear/recomm.web.war/WEB-INF/classes/com/ibm/lconn/recomm/strings/ui.properties customizationDir/strings/com.ibm.lconn.recomm.strings.ui.properties

Files

Description Source location Save customizations in
Main Files application user interface and the Files widget in Communities In webresources/com.ibm.lconn.files.web.resources_version.jar: _properties/com/ibm/lconn/files/strings/ui.properties customizationDir/strings/com.ibm.lconn.files.strings.ui.properties
Help pop-up windows In webresources/com.ibm.lconn.files.web.resources_version.jar: _properties/com/ibm/lconn/files/strings/uihelp.properties customizationDir/strings/com.ibm.lconn.files.strings.uihelp.properties
About and Metrics pages In webresources/com.ibm.lconn.files.web.resources_version.jar: _properties/com/ibm/lconn/files/strings/uitemplates.properties customizationDir/strings/com.ibm.lconn.files.strings.uitemplates.properties

Forums

Description Source location Save customizations in
User interface strings installedApps/<cell_name>Forums.ear/forum.web.war/WEB-INF/lib/forum.web.jar:com/ibm/forum/web/resources/resources.properties customizationDir/strings/com.ibm.forum.web.resources.resources.properties
Log strings installedApps/<cell_name>/Forums.ear/forum.web.war/WEB-INF/lib/forum.svc.jar:com/ibm/lconn/forum/internal/resources/resources.properties customizationDir/strings/com.ibm.lconn.forum.internal.resources.resources.properties
Log strings installedApps/<cell_name>/Forums.ear/forum.web.war/WEB-INF/lib/forum.svc.jar:com/ibm/lconn/forum/internal/service/core/core.properties customizationDir/strings/com.ibm.lconn.forum.internal.service.core.core.properties

Home page

Description Source location Save customizations in
Most strings that appear in the user interface, except for the stories in the river of news In installedApps/<cell_name>/Homepage.ear/homepage.war/WEB-INF/lib/homepage.utils.jar: com/ibm/lconn/homepage/resources/nls/jsp/jsp_resources.properties customizationDir/strings/com.ibm.lconn.homepage.resources.nls.jsp.jsp_resources.properties
Activity Stream strings In installedApps/<cell_name>/Homepage.ear/homepage.war/WEB-INF/lib/homepage.utils.jar: com/ibm/lconn/homepage/resources/nls/activitystream/activitystream_resources.properties customizationDir/strings/com.ibm.lconn.homepage.resources.nls.activitystream.activitystream_resources.properties
Activity Stream filters In installedApps/<cell_name>/Homepage.ear/homepage.war/WEB-INF/lib/homepage.utils.jar: com/ibm/lconn/homepage/resources/nls/activitystream/config/activitystreamconfig_resources.properties customizationDir/strings/com.ibm.lconn.homepage.resources.nls.activitystream.config.activitystreamconfig_resources.properties
Notification strings In installedApps/<cell_name>/Homepage.ear/homepage.war/WEB-INF/lib/homepage.utils.jar: com/ibm/lconn/homepage/resources/nls/ui/ui_resources.properties customizationDir/strings/com.ibm.lconn.homepage.resources.nls.ui.ui_resources.properties
Widget resources In installedApps/<cell_name>/Homepage.ear/homepage.war/WEB-INF/lib/homepage.utils.jar: /com/ibm/lconn/homepage/resources/nls/widgets/widgets_resources.properties customizationDir/strings/com.ibm.lconn.homepage.resources.nls.widgets.widgets_resources.properties
Core activity stream filter resources In installedApps/<cell_name>/Homepage.ear/homepage.war/WEB-INF/lib/lc.services.gadgets.osapiclient.jar: com/ibm/lconn/services/gadgets/osapiclient/activitystream/config/activitystreamconfig.properties customizationDir/strings/com.ibm.lconn.services.gadgets.osapiclient.activitystream.config.activitystreamconfig.properties

Moderation

Description Source location Save customizations in
Main Moderation application In installedApps/<cell_name>/Moderation.ear/sn.moderation.ui.jar: com/ibm/lconn/moderation/ui/strings/ui.properties customizationDir/strings/com.ibm.lconn.moderation.ui.strings.ui.properties
Online help In installedApps/<cell_name>/Moderation.ear/sn.moderation.ui.jar: com/ibm/lconn/moderation/ui/strings/uihelp.properties customizationDir/strings/com.ibm.lconn.moderation.ui.strings.uihelp.properties
About page In installedApps/<cell_name>/Moderation.ear/sn.moderation.ui.jar: com/ibm/lconn/moderation/ui/strings/uitemplates.properties customizationDir/strings/com.ibm.lconn.moderation.ui.strings.uitemplates.properties

News

Description Source location Save customizations in
Template resource strings for use in activity stream event titles Important: Customized strings must have the same placeholders (string of characters that are delimited by curly braces) as the placeholders in the source string.

|In installedApps/<cell_name>/News.ear/news.common.jar: com/ibm/lconn/news/nls/templatePlaceholders.properties|customizationDir/strings/com.ibm.lconn.news.nls.templatePlaceholders.properties| |JSP resources for email digest settings page|In installedApps/<cell_name>/News.ear/news.common.jar: com/ibm/lconn/news/nls/jsp_resources.properties|customizationDir/strings/com.ibm.lconn.news.nls.jsp_resources.properties| |Notification strings that are displayed in the Homepage|In installedApps/<cell_name>/News.ear/news.common.jar: com/ibm/lconn/news/nls/ui_resources.properties|customizationDir/strings/com.ibm.lconn.news.nls.ui_resources.properties| |Strings that are related to Homepage widgets, such as widget titles and the strings that are displayed in the customization palette|In installedApps/<cell_name>/News.ear/news.common.jar:com/ibm/lconn/news/nls/catalog/service/ui/CatalogServiceUIMessages.propertiess|customizationDir/strings/com.ibm.lconn.news.nls.catalog.service.ui.CatalogServiceUIMessages.properties|

Profiles

Description Source location Save customizations in
Used in the Atom APIs for informational use only, not for the user In installedApps/<cell_name>/Profiles.ear/lc.profiles.app.war/WEB-INF/lib/lc.profiles.web.app.jar: com/ibm/lconn/profiles/api/actions/resources.properties customizationDir/strings/com.ibm.lconn.profiles.api.actions.resources.properties
Main resource string file for user interface display in Profiles In installedApps/<cell_name>/Profiles.ear/lc.profiles.app.war/WEB-INF/lib/lc.profiles.web.app.jar: com/ibm/lconn/profiles/strings/ui.propertiesNote: To update the Profiles user interface, you must change the appropriate template file. For example, profileDetails.ftl defines the custom section that is rendered when you view someone's profile. The business card template renders the same profile when you start someone's business card.

The key to define a custom section to view a profile in profileDetails.ftl is as follows:

<nlsKey="label.displayName"/>. Template files are in: <dmgr profilehome>/config/cells/<cellname>/LotusConnections-config/profiles/templates.

Note: The Profiles advanced search page does not have a customization template. Update the advanced search page by using the strings folder customization directory. Create the following file: com.ibm.lconn.profiles.strings.uilabels.properties. Add, for example, the following property/string: label.advanced.searchForm.attribute.telephoneNumber=Telephone:.

|customizationDir/strings/com.ibm.lconn.profiles.strings.ui.properties| |Strings for profile field labels|In <dmgr profilehome>: /config/cells/<cellname>/LotusConnections-config/profiles/templates/template.properties|customizationDir/strings/com.ibm.lconn.profiles.strings.uilabels.properties|

Note: To customize the Profile field labels take, the following steps:

  • Stop Connections and shut down the Dmgr.
  • Browse to C:\IBM\WebSphere\AppServer\profiles\Dmgr01\config\cells\Your_Cell01\LotusConnections-config\profiles\templates\resources\nls.
  • Edit the language file that you want to change. In French for example, change the key/value pairs in template_fr.properties.
  • Restart Dmgr, and the Connections clusters as normal.
  • If necessary, synchronize the nodes.
Description Source location Save customizations in
Search application user interface strings In installedApps/<cell_name>/Search.ear/search.common.jar: com/ibm/lconn/search/strings/ui.properties customizationDir/strings/com.ibm.lconn.search.strings.ui.properties

Social analytics

Description Source location Save customizations in
Strings for the Who Connects Us, Things in Common, and Do You Know widgets In installedApps/<cell_name>/Common.ear/connections.web.resources.war/WEB-INF/eclipse/plugins/com.ibm.lconn.sand.web.resources_version.jar: _properties/com/ibm/lconn/sand/resources/sand.properties customizationDir/strings/com.ibm.lconn.sand.resources.sand.properties

Wikis

Description Source location Save customizations in
Main Wikis application user interface In installedApps/<cell_name>/Wikis.ear/wikis.web.jar: com/ibm/lconn/wikis/strings/ui.properties customizationDir/strings/com.ibm.lconn.wikis.strings.ui.properties
Welcome page content In installedApps/<cell_name>/Wikis.ear/share.services.jar:com/ibm/lconn/share/services/handlers/wiki/nls/WikiWelcomeMessages.properties customizationDir/strings/com.ibm.lconn.share.services.handlers.wiki.nls.WikiWelcomeMessages.properties
Help tooltips In installedApps/<cell_name>/Wikis.ear/wikis.web.jar: com/ibm/lconn/wikis/strings/uihelp.properties customizationDir/strings/com.ibm.lconn.wikis.strings.uihelp.properties
About page and Server Metrics page In installedApps/<cell_name>/Wikis.ear/wikis.web.jar: com/ibm/lconn/wikis/strings/uitemplates.properties customizationDir/strings/com.ibm.lconn.wikis.strings.uitemplates.properties