pigletto / fusionauth-localization

FusionAuth translations

FusionAuth Localization

If you're using FusionAuth and your first language is not English, we can use your help! We are shipping support for localized login pages and while our users can localize themselves, we would like to provide a base of languages to use when building out your theme or localization strategy.

If you'd like to contribute, feel free to submit a PR or open an issue so we can discuss how you can help!

Credits

• @markschmid Initial support for German. Danke!
• @pawpro Initial support for Polish. Dzięki!
  • @pigletto for the additions and fixes!
• @jerryhopper Initial support for Dutch. Bedankt!
  • @flangfeldt for the review and assist!
• @Fahrenholz Initial support for French. Merci!
• @Loketony Initial support for Swedish. Tack!
• @veturi Initial support for Finnish. Kiitos!
• @wijse Initial support for Danish. Tak!
• @Loketony Initial support for Russion. Благодарность!
• @Loketony Initial support for Ukrainian. Спасибі!
• @lamuertepeluda Initial support for Italian. Grazie!
• @lluisgener Initial support for Spanish. Gracias!
  • @einar-lanfranco for the edits and fixes!
• @rapcal Initial support for Portuguese (Brazilian). Obrigado!
• @kevinadhiguna Initial support for Indonesian (Indonesia). Terima kasih!
• @kevinadhiguna Initial support for Japanese. ありがとうございました！
• @zahertalab Initial support for Arabic. اشكرك
• The FusionAuth team - couldn't have done it without you!

How to translate

For languages listed in the wanted section, start with the theme/message.properties as a base, and rename it by adding a country code suffix. The wanted section outlines the country code and filename per language. If the language you are translating is not listed there simply find your two character country code and append it to follow the pattern below.

If there is already a theme/message_xx.properties file for your language you will find a missing-translations/message_xx.properties file that lists only those messages that are missing from the base theme. Use this file to find the missing messages and add them to the base theme file for you language. You don't have to add new messages in any particular place, you can add them to the bottom and once finished you can run the update.rb ruby script (or we can run it for you) to reorganize the base /theme file and update the /missing-translations file.

It is not required that you translate every message, when a message is not translated FusionAuth will fall back to the default message in the theme. This is generally English unless you have modified the default messages in your theme.

As FusionAuth adds new messages they will not (currently) be automatically added to any of these translated files. This means these messages will only be displayed in English until translated. As mentioned you can find missing translations in the /missing-translations files.

Wanted

This is just a suggested list, please contribute whatever you can! We're happy to pay you for your efforts, if you can contribute a new quality translation we can send you $50 as a token of our appreciation, join the forum and let us know so we can send a gift your way.

• Czech - theme/message_cz.properties
• Chinese (Taiwan) - theme/message_zh_TW.properties
• Chinese (China) - theme/message_zh_CN.properties
• Greek - theme/message_el.properties
• Hindi - theme/message_hi.properties
• Indonesian - theme/message_id.properties
• Korean - theme/message_ko.properties
• Norwegian - theme/message_no.properties
• Portuguese - theme/message_pt.properties
• Portuguese (Portugal) - theme/message_pt_PT.properties
• Punjabi - theme/message_pa.properties

Project Layout

The theme folder contains translations that can be used in a FusionAuth theme. The missing translations folder contains a list of messages that are in the message.properties file (English) that are missing from the language indicated by the country code suffix (e.g. _it for Italian).

theme
├── message.properties       English
├── message_ar.properties    Arabic
├── message_da.properties    Danish
├── message_de.properties    German
├── message_es.properties    Spanish
├── message_fi.properties    Finnish
├── message_fr.properties    French
├── message_id_ID.properties Indonesian (Indonesia)
├── message_it.properties    Italian
├── message_ja.properties    Japanese
├── message_nl.properties    Dutch
├── message_pl.properties    Polish
├── message_pt_BR.properties Portuguese (Brazilian)
├── message_ru.properties    Russian
├── message_sv.properties    Swedish
├── message_ua.properties    Ukrainian
missing-translations
├── message_ar.properties    Arabic
├── message_da.properties    Danish
├── message_de.properties    German
├── message_es.properties    Spanish
├── message_fi.properties    Finnish
├── message_fr.properties    French
├── message_id_ID.properties Indonesian (Indonesia)
├── message_it.properties    Italian
├── message_ja.properties    Japanese
├── message_nl.properties    Dutch
├── message_pl.properties    Polish
├── message_pt_BR.properties Portuguese (Brazilian)
├── message_ru.properties    Russian
├── message_sv.properties    Swedish
├── message_ua.properties    Ukrainian

How to use a translation

First, find the language translation you want.

• Clone this project.
• Copy the contents of one of the message properties files.

Next, update your theme.

• Log in to the FusionAuth administrative user interface.
• If you only have the default theme, make a copy. The default theme is immutable.
• Edit your theme.
• Navigate to the "Messages" tab.
• Select "Add localization"
• Set the "Locale" to the language.
• Paste in the contents of the messages properties file.
• Click "Submit"
• Click the blue save icon to save the theme.
• Update your tenant to use the new theme.

Test it out:

• Navigate to your FusionAuth instance and provide a locale in one of the supported manners.

Not all translations are up to date. Where there are missing messages, the default English text will be displayed. Please contribute any fixes or additional translations for missing messages.