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 mappings in the following format:
   
   key=value
   
   For example, anchor_back_to_top=Back to top.

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

In the top of the panel, expand the "Select website" drop-down list to select the channel for which you want to configure the languages/language labels.

Language Properties

For each supported language, the following properties are shown:

In This Topic

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 for each channel. The default content language determines the following:

• The language drop-down in a sidebar header (or the Language Widget in XperienCentral versions R31 and lower) 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 can be seen at the top of the Language Labels panel in the list of available languages. The current default content language is assigned the number "1" ranking. For example:

In the example above, Dutch is ranked number "1" in the list which means it's the default content language. The ordering thereafter is the order the available languages appear in the Language Widget.

To change the default content language in XperienCentral, follow these steps:

1. In the list of supported languages, change the ranking of the language that you want to make the default by assigning it the number "1".
2. Modify the ranking of the other languages as needed in order to ensure that no numbers are skipped or doubled. In the example below, the list has been modified to make English the default content language, therefore "2" was changed to "1" for it and the ranking for Dutch was changed from "1" to "2":
   
   
   
   
   
3. Click [Apply]. The sort order is automatically refreshed back to ascending. For example:
   
   
   In the example above, English is now set as the default content language.
   
   

Back to top

Modifying a Language Label

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. Expand the section containing the label(s) by clicking the plus [+] sign next to it.
   
   
   
   
   
   The language labels appear. On the left side of the list is the internal identifier for the language label and in the text field next to it is the current label being used for it in the current language. To modify a label, click in the field and change the text. In the example below, the string for the "Author" line in the Downloads content element is changed to "Publisher":
   
   
   
   
   
   
   
   
3. Click [Apply]. After clicking [Apply], the label is modified. In the Editor, the label in the Download content element now appears as "Publisher":
   
   
   
   
4. Repeat these steps for all labels that you want to modify for the selected language.
5. Click [Apply] to submit your modifications.

Back to top

Deleting a Language Label

To delete a language label, follow these steps:

1. Expand the section containing the language label you want to delete.
2. Select the checkbox to the right of the language label in the "Delete" column.
3. Click [Delete]. A confirmation dialog box will appear.
4. Click [OK]. The language label is deleted.

Back to top

Anchor
copying_a_language copying_a_language

Copying a Language

The best way to add a new language to XperienCentral is to copy all of the labels for an existing language and then modify the labels in the copied language to the new one you want to support. To copy a language, click [Copy] next to the language. For example:

 

XperienCentral will then prompt you to provide a code for the new language. For example:

Click [Apply]. The new language will appear in the list. Enter the translation of the language's name in Dutch and English. For example:

Modify the labels for the new language. Once copied, the new language is available in the Language Widget. For example:

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

Back to top

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. Select the checkbox for the language in the "Delete" column in the list of languages.
2. Click [OK] to confirm the operation:
   
   
   
   
   
   The labels for the language are deleted.

Back to top