Overview
With Web Engine it is possible to translate the website into any available language. This feature enables partners the opportunity to present the website in the languages of the people in their context. Which also allows the website to reach many other people who have that language in common.
The steps below outline how to implement a multi-language website using Web Engine. Depending on the rights of your account, you may need to speak with your administrator in order to do some of the configuration.
Notes:
- Translation works for the Adventist design. The Hope design has not currently fully implemented translation.
- All pages, menus, etc. need to be translated from the source to the target language. If elements are not translated, then not even the source language will be displayed. This prevents pages with mixed languages.
- If we don't have the language supported in the Adventist Web Engine frontend, there will be an issue when trying to translate a website into the language. A 404 error will be thrown when trying to visit the home page using the foreign language.
How to
Configure the Entity
Add the language to the entity (if the language not setup already):
- Expand the entity at the top left corner of the screen and select Manage your entity.
- The entity interface with the current entity displayed will appear.
- On the General tab, scroll down to the Language section.
- Add the language(s) and then click on Save button.
Enable AI translation:
- Expand the entity, at top left corner of the screen and select Manage your entity.
- The entity interface with the current entity displayed will appear.
- On the Configuration tab, scroll down to the Artificial Intelligence section.
- Set a checkmark in the box of Enable AI.
- Expand the AI service you are using.
- Click on the Edit button to open the API key field.
- Enter your API key into the field.
- Click on the Save button.
- Next scroll down to the Automatic translations section.
- Set a checkmark in the box Enable automatic translations.
- Choose the Translations provider from the select list.
- Choose the Model from the select list.
- Click on the Save button.
- (The Translations provider and Model are only examples. Please use the correct settings for your entity.)
Configure the Website
- Navigate to the website and expand the menu below it.
- Open the Website settings interface by clicking on Settings.
- Click on the Translations tab.
- Use the field Search for a language to locate the language to add.
- Find the language in the list and click on it.
- Click on the green Add button to add the language to the website.
- The translation interface for the website will open.
AI translation icon:
- If AI translation is being used, the first thing to do, is verify the AI translation is activated.
- On the fields (Title & Description) if there is no language icon on the right end of the field, the automated translation is not activated or properly configured.
- You will need to troubleshoot the problem, if needed open a ticket with the support team.
- If manual translation is being used, or if the translation is enabled, the fields in all tabs can then translated.
- Guidelines for translation of fields:
- Use the AI translation or manual translation to place the proper text in the fields on the right side of the interface. Check for proper context, spelling, etc.
- Some fields may not need to be translated. Copy over items by clicking on the >> icon.
- Don't translate slugs or portions of URLs, unless you are certain the system is setup for those language paths.
- Flags only need to be translated if appearing in the frontend. Most times you will not translate the flags.
- After all translation is done, or if you need to switch tasks, click on the Save button to keep your work!
- Repeat this process of adding any additional languages to the website.
Notes:
- Pages, Menus, Articles and Website Settings will need to be translated as well. See the links in Additional Information below.
- After all the translation work is done, then enable the language, under website Settings, Translations tab. Otherwise the incompletely translated language will appear in the language picker menu!
- If a new language is being added to an existing website, leave the language disabled until all the translation work is completed.
To activate language menu
When all the translation work for the website is done (configuration, pages, menus, appearance, articles, etc.), follow these steps to activate the language menu in the frontend of the website. Note! If you are adding a new language, do all of the translation first, then add the new language; otherwise, the visitors could become frustrated.
- Expand the Web module, then expand the website.
- Go to Settings > Translations.
- Activate the language you want in the menu.
- Click on the "Actions" icon.
- Go to the Danger Zone tab.
- Under Enable site translation, click on the Enable button.