To access the Language Labels panel, navigate to Configuration > Language Labels:

In This Topic

Labels

On the "Labels" tab you manage the default and custom language labels for XperienCentral.

Adding a Custom Language Label

To add a custom language label, follow these steps:

1. Select the language to which you want to add a custom label from the "Select language" drop-down list.
2. Click [New label].
3. Enter the internal name for the new label in the "Label name" field. The name should be lowercase and multiple words joined by the underscore character ( _ ) — "download_version" for example. See the format of the default labels for other examples.
4. Enter the string that appears in the XperienCentral GUI in the "Value" field.

5. Click the checkmark icon to save the new label.
   
   
   

   
   
   
   
   

   Info
   Because the list is sorted alphabetically in ascending order, the new label may disappear from view after you save it. If the label is used in more than one language, be sure to switch the language using the "Select language" drop-down and then modify the value of the label for the other language(s) in which it will be used.

   
   

Modifying a Language Label

You can modify both the default XperienCentral language labels as well as all custom language labels. To modify a language label, follow these steps:

1. Select the language for which you want to modify the label(s) from the Select Language drop-down list.
2. Click the pencil icon next to the label you want to modify:
   
   
   
   
   
3. Modify the language label "Value" string.
4. Click the checkmark icon to apply the change.
5. Repeat these steps for all labels that you want to modify for the selected language.
6. Click [Apply] to submit your modifications.

Deleting a Modified Language Label

English (EN) and Dutch (NL)

The default language labels in English and Dutch XperienCentral cannot be deleted. However, if you have modified a language label, you can delete the modification. To do so, click the "trash" icon to the right of a modified language label. The modification will be deleted and the default value of the label will be restored. If a default language label has not been modified, the "trash" icon is grayed out and unavailable.

Other Languages

For every language that you add to XperienCentral in addition to English (EN) and Dutch (NL), all language labels can be deleted. Be careful when deleting default XperienCentral language labels because it could affect the usability of configuration panels and the Workspace.

Language

The "Language" tab shows the languages that are available for content in XperienCentral. The default languages are "Dutch" and "English". Here you can also add more languages or delete any language(s) that you have added.

Language Properties

For each supported language, the following properties are shown:

Adding a Language

To add a new language to XperienCentral, follow these steps:

1. Click [+New Language].
2. In the "Dutch name" field, enter the name of the language as it appears in XperienCentral when the editing language is set to "Dutch".
3. In the "English name" field, enter the name of the language as it appears in XperienCentral when the editing language is set to "English".
4. In the "Meta tag value" field, enter the ISO 639-1 code for the language in the format xx_XX. For example, for German the Meta tag value would be "de_DE".
5. Select the "Fallback language".
6. Define the labels for the new language.
7. Make the new language active.

The new language is now available in the language drop-down lists in the left and right Sidebars. For example:

The new language is now also available in the default language drop-down list for a page. For example:

Anchor
setting_the_default_language_for_xperiencentral setting_the_default_language_for_xperiencentral

Setting the Default Content Language for XperienCentral

In XperienCentral, you can set any of the available languages as the default content language of the edit environment. The default content language determines the following:

• The language drop-down in a sidebar header is set to the default content language each time you start a new XperienCentral session.
• All content items you create are in the default content language if you do not switch languages.
• Content created by a developer using the Java API is in the default content language if one is not explicitly specified in the code.
  
  

The default content language is the one with "Yes" in the "Default language" column. To change the default language, follow these steps:

1. Click the pencil icon next to the language you want to make the default.
2. Click the checkbox in the "Default" language column to select it:
   
   
3. Click the checkbox to the right of the language to save its settings. The language is now the default.

Deleting a Language

To delete a language, follow the steps below. You can only delete a language that you have added. Because Dutch and English are the default supported languages in XperienCentral, neither of them can be deleted.

To delete a language:

1. Click the "trash" icon next to the language you want to delete.
2. Click [Delete] to confirm the operation:
   
   
   
   
   
   
   All the labels for the language and all content items containing the language are deleted.

Back to top

Exporting Custom Language Labels

You can export custom language labels as well as default language labels that have been modified to a file and then import them in another XperienCentral web initiative.

To export custom language labels, follow these steps:

1. Click the "Export" tab.
2. Select the language from which you want to export the labels from the "Select language" drop-down list. Select "All languages" to export all custom/modified labels from all languages in your XperienCentral web initiative.
3. The custom/modified language labels present in the language(s) you selected are saved in the Downloads folder of your browser in a .zip file. Within the export file there is a .properties file for each exported language containing a mapping between the name of the custom label and its value.

Back to top

Importing Custom Language Labels

You can import custom language labels and default languages that have been modified from another XperienCentral web initiative into the current web initiative.

To import custom/modified language labels from one or more languages, follow these steps.

1. Click the "Import" tab.
2. Navigate to the folder containing the .zip language label export file.
3. Select the file.
4. Click [Import]. The language labels present in the export file are imported into the present web initiative.

Back to top

Inheritance

If a language label is empty it is possible to have it inherit the value from a related language label. This can be turned on in the General tab of the Setup Tool by enabling the property use_languagelabels_inheritance. When enabled, an empty label with name search.button.find will use the value from button.find if available. Abstractly the inheritance structure works like this: a.b.c > b.c > c

Back to top

Providing Default Language Labels in a Plugin

You can provide default values for language labels that are contained in a plugin.

To do so, follow these steps:

1. Add or update a service in your plugin that implements the LanguageLabelProvider interface.
2. Add language label property files to your plugin for the languages in your website. These files should be added to the src/main/resources/languagelabels folder of your plugin. The file should be named using the following convention:
   
   languagelabels_<metatag of language>.properties
   
   for example, languagelabels_en_US.properties.
   
   These files should contain language label

1. mappings in the following format:
   
   key=value
   
   For example, anchor_back_to_top=Back to top.