Writing Internationalized XWiki Applications

Version 11.5 by Clemens Robbenhaar on 2013/11/07


Using properties located in XWiki pages

  • Create a page that will host your key/value pairs
  • Enter all the key/value pairs in that page (use the wiki editor). For example:
    withparams=I can {0} pass {1} {2} params too using the Java MessageFormat syntax
  • Do the same for all the translations you want.

    To enable multiple languages you'll need to go to the Administration page and set MultiLingual to true and list the different languages you wish to use in the Languages field.

  • Tell XWiki that your page is a Document Bundle by going to the Administration page, selecting the "Localization" section and entering it in the "Internationalization Document Bundles" field. You can specify several pages, separated by commas.

    When creating "Internationalization Document Bundles", you should avoid naming the pages with names that include spaces. For example, a document name of Main.My Messages could cause issues, instead, use Main.MyMessages

  • Alternatively you can also specify the list of Internationalization Document Bundles in xwiki.cfg under the key xwiki.documentBundles.
  • On the page where you want to use the internationalized message, use:
    $services.localization.render("key", ["param1", "param2", ...])

    where key is the key for the message to retrieve. Parameters can also be passed as is shown in the second syntax above.

I18n of XWiki Objects

This is currently not implemented (see our logged issue: XWIKI-69). There are 2 workarounds you can use:

  • Have several objects, one for each language, with a language field, and then decide which object to use (for example in a Class Sheet, based on the current language):
    $doc.getObject('Your.Class', 'lang', $context.language')
    ## Will select the object whose 'lang' property is set to the current language
  • Use Velocity scripting to do an IF in your object. For example, you could have:
    #if ($context.language == "fr")
      French texts
      Default texts

Using the static Resource Bundles

  • Stop your XWiki instance
  • Extract the ApplicationResources*.properties file for your language from the WEB-INF/lib/xwiki-*oldcore-*.jar file and put them in your WEB-INF/classes directory
  • Edit this file and add/modify the key/value pairs you need for your application
  • In your document, use the following to get the value associated with a key: $services.localization.render("key")

This will get the value from the Resource Bundle corresponding to the current language you are using in XWiki.

Get Connected