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 here:
    • installedApps refers to the following directory path:
      WAS_HOME/profiles/profile_name/installedApps
      where:
      • 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 IBM Connections applications.

      For example: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/standaloneCell01/

    • 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

      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 IBM Connections, when it is saved as a WebSphere® Application Server variable named CONNECTIONS_CUSTOMIZATION_PATH. This variable is set to shared_data_directory_root/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.

  • When you want to customize a locale-specific version of one of the source files, 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

  • The following features do not have any properties files that are associated with them:
    • Blog widget (Communities)
    • ECM document picker (Communities)
    • Ideation Blog widget (Communities)

    For a list of the JavaScript files that are associated with these features, see JavaScript resource strings.

Common areas

Table 1. Common string locations
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, IBM Lotus 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, IBM Lotus 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 IBM Connections 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

com.ibm.lconn.oauth.strings.ui.properties

Activities

Table 2. 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 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

Note: For more information, see Customizing strings sourced in JavaScript.
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_locale.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

Table 3. 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 IBM Connections has a Bookmarking Tools link in the page footer that allows users to install this toolbar button.
Table 4. Bookmarklet
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

Table 5. 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

Table 6. 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 IBM Connections 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 and Media Gallery 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

Table 7. 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-ups 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

Table 8. 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

Table 9. 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

Metrics

Table 10. Metrics
Description Source location Save customizations in
Main Metrics application user interface, not including metrics reports provided by Cognos® In webresources/com.ibm.lconn.metrics.web.resources
_version.jar
:
_properties/com/ibm/connections/metrics/ui/strings/ui.properties
customizationDir/strings/com.ibm.connections.metrics.ui.strings.ui.properties
About page In webresources/com.ibm.lconn.metrics.web.resources
_version.jar
:
_properties/com/ibm/connections/metrics/ui/strings/uitemplates.properties
customizationDir/strings/com.ibm.connections.metrics.ui.strings.uitemplates
.properties

Moderation

Table 11. 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

Table 12. 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

Table 13. 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.properties
Note: 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 performs the same rendering when you launch someone's business card.

The following is the key to define a custom section to view a profile in profileDetails.ftl:

<nlsKey="label.displayName"/>. Template files are located 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, this 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, perform a node synchronization.

Search

Table 14. Search
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

Table 15. 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

Table 16. 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_locale.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
Note: These resource bundles contain most of the Wikis user interface strings, but the strings for the Communities widget are provided in JavaScript. See Customizing strings sourced in JavaScript for more information.