Help Center

Menu

Configure translation support for content pages

This article describes the end-to-end process of configuring a secondary language in the Component Services  Language page and then linking this language as a Context available to content page assets.

The workflow is described in the following sections:

  1. Activate the Languages menu

  2. Pre-requisites

  3. Set up supported languages in the Component Service.

  4. Pair a language to a context in Squiz Content Management.

Activate the Languages menu

For languages to be available for a content page to use, the Languages menu must first be made available in your Squiz DXP Organization.

Availability of this menu is controlled by a back-end feature flag.

To activate this flag, contact your customer success manager. They will organise to have the flag activated.

Pre-requisites

To configure translation support, the following end-user pre-requisites must be met.

  • Your Squiz DXP user account has site builder, system administrator, system owner or developer permissions.

  • You have access to a Squiz Content Management instance within your DXP organization with system administrator or root user permissions

  • You are familiar with the concepts described in Content Management Contexts.

Set up supported languages in the Component Service

The translations feature relies on a set of approved languages to be configured in the DXP.

At least two languages must be set for the Component Service to offer Translations on Content Page components.

Steps

  1. Sign in to your Squiz DXP Organization

  2. Select Component Services  Language to load the Languages configuration page.

    languages configuration page

  3. Click Create language to load the Create language dialog box.

    create language dialog
    Name

    Specify a name for this language that content editors would understand.

    Language code

    Select the language from the list of supported ISO language codes.

  4. Click Save to add the language as an available translation target.

Be careful when choosing your language code for languages. In order to ensure data integrity, after a language is created, it cannot be deleted, and it cannot have its language code updated.

  1. Repeat the above process until your language list represents the list of languages you want to be made available to your editors.

Pair a language to a context in Squiz Content Management

Now that the target language is added at the Component Service level, you need to allow Squiz Content Management to access this language through the Alternative contexts feature.

If content page translations are being used, Squiz highly recommends that all contexts are mapped to a DXP language as described in this process.

Steps

  1. Sign in to your Squiz Content Management instance.

  2. Click system configuration and then select Contexts to load the Contexts screen.

  3. Click Edit.

  4. Create a context:

    1. Select the checkbox.

    2. Give the context a name that matches the name of the language you set in Component Service.

    3. Click Save to add the context into the Alternative contexts section.

  5. Use the Edit button to load the Edit selected context screen.

    edit selected context
    Name

    Use the same name as the language you set in the Component Service configuration as a best practice recommendation.

    DXP Language

    Select the language you created in [dxp-language].

  6. Configure the Minimum matches and Conditions sections as per the instructions at Content Management Contexts.

  7. Click Save on the Contexts screen to make the edited context available to all content page assets.

  8. Follow steps 5-7 for the Default context, to pair the Default DXP language and appropriately rename the this context to reflect the default language it now represents.