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/webresourcesFor 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
- installedApps refers to the following directory path:
- 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
| 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
| 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/ If
you cannot find a string, check the Activities resource bundle in
installedApps/<cell_name>/Activities.ear/oawebui.war/WEB-INF/lib/oawebui.jar: 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
| 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.
| 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 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
| 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
| 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 |
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
| 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.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
| 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_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.