alfresco-content-app/docs/i18n.md

Internationalization (i18n)

The Content Application provides support for the following languages:

• German (de)
• English (en)
• Spanish (es)
• French (fr)
• Italian (it)
• Japanese (ja)
• Norwegian (nb)
• Dutch (nl)
• Brazilian Portuguese (pt-BR)
• Russian (ru)
• Simplified Chinese (zh-CN)

The fallback locale is the English one, however current browser language is taken as the default one automatically when the application starts.

User-defined language

You can allow users to set custom language that gets saved to user preferences. The main application menu already has the ADF Language Menu component integrated and pre-filled with the supported items.

To change the default language set edit the app.config.json file and add or remove items:

{
    ...,
    "languages": [
        {
            "key": "de",
            "label": "German"
        },
        {
            "key": "en",
            "label": "English"
        },
        {
            "key": "es",
            "label": "Spanish"
        },
        ...
    ]
}

The file is located at the following path: /src/app.config.json.

Custom languages

To add a custom language, add a new "JSON" file to the "/src/assets/i18n" folder with the name of the target locale, for instance, a "de.json" for the "German".

Translate the resource strings based on the default "en.json" file. You can copy the content over to your newly created file and replace English values with translated text.

{
  "APP": {
    "SIGN_IN": "Anmelden",
    "SIGN_OUT": "Abmelden",
    "NEW_MENU": {
      "LABEL": "Neu",
      "MENU_ITEMS": {
        "CREATE_FOLDER": "Ordner erstellen",
        "UPLOAD_FILE": "Datei hochladen",
        "UPLOAD_FOLDER": "Ordner hochladen"
      },
      ...
    }
  },
  ...
}

The Content Application automatically bundles your file upon project build. You can test your locale by changing the browser language settings and reloading the page.

Optionally, you can extend the ADF Language Menu component with the newly added language by updating the app.config.json file.

Customizing ADF translations

In addition to creating a custom language file for the Content Application, you can also provide translations for the ADF resources.

Your /src/assets/i18n/<lang>.json file can reflect the structure of one of the ADF language files:

• ADF Core (en.json)
• ADF Content Services (en.json)
• ADF Process Services (en.json)
• ADF Insights (en.json)

At runtime, the application-level strings have the highest priority. That means you can replace the value of any ADF resource string if needed.

For example, let's change the title of the "Create Folder" dialogue shipped with the ADF. Modify the /src/assets/i18n/en.json file and append the "CORE" section like in the example below:

{
    "APP": {
        ...
    },
    "CORE": {
        "FOLDER_DIALOG": {
            "CREATE_FOLDER_TITLE": "Custom title"
        }
    }
}

Now, if you run the application and click the "New → Create Folder" menu, the title of the dialogue should look similar to the following:

Language picker

You can enable internal language picker in the app.config.json file:

{
    ...,

    "languagePicker": true,

    ...
}