Locales tab

The Locales feature allows you to configure language translations for your customizer templates, enabling the same template to be displayed in multiple languages for different global business regions

Instead of creating separate templates for each language (e.g., one for English and one for French), you can use a single template that dynamically updates its language based on the user's selection. The way this works is that a translated file containing all the necessary text is created, and the template is tagged with the language codes it needs to read from. When a user toggles to a different language, the text within the customizer is updated dynamically.

How to Configure Locales for a New Template

The process involves two main stages: first, setting up the locales at a system-wide level, and second, applying a specific locale file to your template.

Stage 1: Configure Locales in the VU Admin Settings (Prerequisite)

Before you can apply a language to a template, the locale must first be created in the main VU Admin platform settings. This action can only be performed by users with administrator permissions.

1. Navigate to Locale Settings: From the Dashboard, click Settings > Locale.

2. Add a New Locale: Click Add New.

3. Enter Locale Details:

   • In the Name field, enter the name for the locale (e.g., English).

   • In the Code field, enter the corresponding language code (e.g., en-US).

4. Save the Locale: The locale will be successfully created and available for use throughout the platform. You can repeat this for all the languages you need to support.

Stage 2: Apply the Locale File to Your Template

Once the locales have been defined globally, you can associate a locale file with your new or existing template.

1. Access the Template Editor: From the Dashboard, navigate to Customizer > Templates. Find the template you wish to configure and click Edit to open the detailed template editor.

2. Locate the Locales tab: On the main template editor page, you will find a tab for locales configuration.

3. Choose the Locale File: Click Choose file and Select the applicable locale file for your template. This file contains the translated text and effectively "tags" the template with the language information it needs.

4. Save Your Template: Once the file is selected, click Save to apply the changes to your template.

By following these steps, your template will be configured to support multiple languages, dynamically updating the text based on the locale file you have associated with it