Confluence Plugins

Language Plugin

With the Language plugin you can have the same content in different languages on the same Confluence page. The user sees content only in the language which is set in the user settings. If no macro exists for the preferred language of the user, the plugin checks if there is a macro for the confluence default language to display. Additionally, the page title can be set according to the users language settings using the {pagetitle} macro.

Table of Contents



Download History
Issues


Macros


{english}, {german}, {french}

 Use the language macros to write content in the languages supported by Confluence:
  • {english}
  • {german}
  • {french}

The following macros can be used as well if the corresponding language packs are installed in Confluence:

  • {belarusian}
  • {bulgarian}
  • {catalan}
  • {chinese}
  • {czech}
  • {danish}
  • {dutch}
  • {estonian}
  • {finnish}
  • {greek}
  • {hindi}
  • {hungarian}
  • {icelandic}
  • {indonesian}
  • {italian}
  • {japanese}
  • {korean}
  • {latvian}
  • {lithuanian}
  • {norwegian}
  • {polish}
  • {portuguese}
  • {romanian}
  • {russian}
  • {serbian}
  • {slovak}
  • {spanish}
  • {swedish}
  • {thai}
  • {turkish}
  • {ukrainian}
  • {vietnamese}


Parametersno parameters

Examples
Show content according to the language a user has set in the user settings:
{english}
This text is only displayed
if the user has set english
in the user settings.
{english}
 
{german}
Dieser Text erscheint nur,
wenn der User Deutsch gewählt hat.
{german}
 
{french}
Ce text est seulement montré
si français etait choisi comme langue.
{french}


Screenshot




{pagetitle}

Using the {pagetitle} macro you can also set the title of the page according to the users preferred language.


Parameters

no parameters


Examples

Include the {pagetitle} macro inside the language macros to set the title of the page:

{english}

{pagetitle:My english title}
This text is only displayed
if the user has set english
in the user settings.
{english}
 
{german}
{pagetitle:Mein deutscher Titel}
Dieser Text erscheint nur,
wenn der User Deutsch gewählt hat.
{german}
 
{french}
{pagetitle:Mon titre français}
Ce text est seulement montré
si français etait choisi comme langue.
{french}


FAQ



  • Is the "Automatically detect browser setting" supported?
    Yes, if the user didn't set a preferred language, the plugin tries to use the browsers language or otherwise uses the Confluence default language. (Confluence 3.5 or higher)

  • The {pagetitle} macro changes only the title next to the page title logo. The title is not changed in the bread crumbs, the browser window title bar, in the {pagetree} macro and the {children} macro. Is this a bug? And are you going to fix this?
    The {pagetitle} macro replaces the page title only on the actual page when that page is loaded. While it should be possible to change the title in the bread crumbs and the browser window title bar (see feature requests[LANGUAGE-1] and [LANGUAGE-4]), it will not be possible to change the title of a page in the page tree or a list of child pages using the {pagetitle} macro (see [LANGUAGE-2] and [LANGUAGE-5]).


Comments