Last updated Apr 2, 2024

Internationalising Confluence plugins

Text in Confluence plugins can be internationalised to cater for a variety of locales or languages. To do this, you will need to create a translated copy of the properties file(s) for each plugin and bundle these inside your language pack plugin. Having a properties file in each plugin allows plugin authors to provide internationalised plugins without having to add their i18n keys to Confluence's core source.

Confluence comes bundled with a few plugins that are stored in a file called atlassian-bundled-plugins.zip. The basic process for translating a plugin is:

  1. Extract this zip to a directory
  2. Extract the plugin JAR
  3. Locate the properties file which contains i18n keys (examples are below)
  4. Copy this file to the same location in your plugin. For example, if it is in path/to/file.properties, it needs to be in the same place in your language pack JAR with a locale extension: path/to/file_jp_JP.properties
  5. Repeat this for all plugins that can be internationalised

Below is a list of bundled plugins that can be internationalised and the properties file you will need to translate (correct as of Confluence 2.7):

Plugin Name

Filename

Usage Statistics Plugin

usage-tracking-plugin-<version>.jar

I18N Resources:

resources/stats/usage.properties

Atlassian Plugin Repository

atlassian-plugin-repository-confluence-plugin-<version>.jar

I18N Resources:

resources/i18n/repository-templates.properties

 

I18N Resources:

resources/i18n/repository-macros.properties

Clickr Theme

clickr-theme-plugin-<version>.jar

I18N Resources:

clickr.properties

Mail Page Plugin

mail-page-plugin-<version>.jar

I18N Resources:

resources/mailpage.properties

Social Bookmarking Plugin

socialbookmarking-<version>.jar

I18N Resources:

com/atlassian/confluence/plugins/socialbookmarking/i18n.properties

WebDAV Plugin

webdav-plugin-<version>.jar

I18N Resources:

com/atlassian/confluence/extra/webdav/text.properties

Charting Plugin

chart-plugin-<version>.jar

I18N Resources:

chart.properties

TinyMCE (Rich Text) Editor

atlassian-tinymce-plugin-<version>.jar

I18N Resources:

com/atlassian/confluence/extra/tinymceplugin/tinymce.properties

Advanced Macros

confluence-advanced-macros-<version>.jar

I18N Resources:

resources/com/atlassian/confluence/plugins/macros/advanced/i18n.properties

Dashboard Macros

confluence-dashboard-macros-<version>.jar

I18N Resources:

resources/com/atlassian/confluence/plugins/macros/dashboard/i18n.properties

Below are the system plugins (found in confluence/WEB-INF/lib/) that can be internationalised and the properties file you will need to translate:

Plugin Name

Filename

Information Plugin

confluence-information-plugin-<version>.jar

I18N Resources: information.properties

Layout Plugin

confluence-layout-plugin-<version>.jar

I18N Resources: layout.properties

Livesearch Plugin

confluence-livesearch-plugin-<version>.jar

I18N Resources: livesearch.properties

Dynamic Tasklist Plugin

confluence-dynamictasklist-plugin-<version>.jar

I18N Resources: dynamictasklist.properties

Rate this page: