Setup website translation

TODO: review these notes

Note: Translation works for the Adventist design. Hope design has currently not fully implemented translation.

Note!: 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.

Note!: If we don't have the language supported in the Adventist 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.

Entity

Note: Once the entity is set up, all websites for the entity will have access to the languages and the AI translation. If a new website requires a new language, then the entity needs to be updated.

• The entity, for the website, has to have the language(s) added to it, if the language(s) is/are not already there.
• Go to the entity switcher at the top left corner of the screen, expand it, 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

Configure AI translation

Verify AI translation is activated:

• Click on Manage your entity, under the entity switcher in the upper left corner
• The entity interface with the current entity displayed will appear
• Click on the Configuration tab, scroll to the "Automatic translations" section
• Enable automatic translations: Set a checkmark to activate
• Translations provider: choose your provider
• API key: provide your API key in the field
• Save your changes

Website

• First the website itself needs to be setup
• Web module > [website title] > Settings > Translations
• Add translation: select the language from the list. Click on +Add button
• Another window will open up automatically with the translation interface.
• Here the main fields of the website will be translated into the new language
  • Click on the small language icon to the right end of each field that needs to be translated. AI will translate the field for you.

  • Note: On the right side of each field there should be a language icon for using AI to translate the text on the left. If this is missing, AI translation has not been configured for this entity. (see Configure AI translation)

  • Some fields may not need translation. Copy over items by clicking on ">>" button on the right side of the source language.
  • Don't translate slugs or URLs, unless you are certain the website is setup to use alternate language paths.
  • Click on the "Save" button when done.
• Check Advanced & Authentication tabs for translation needs

Note: Flags only need to be translated if they appear in the frontend. In most cases they won't need to be translated. Need to verify if the flags are used for any URL mapping.

Language picker menu

Note: When a new translation language is added, it will be disabled. The languages added should be left disabled until ALL the work for translation is done. Otherwise, the language menu will appear on the website, but the website will not be ready with the newly added language content!

Menus

• Web > [website title] > Menus
• Click on the menu title
• Click on Translations tab once the menu interface has opened up
• Add translation: select the language from the list. Click on +Add button
• (may want to leave menu title in original language used in backend)
• Translate each label in the menu
• Click on Save button (upper right)
• Move to the next menu to translate

Appearance

• Web > [website title] > Appearance
• Go to Translations
• Click on the language to translate
• Translate the fields and save when all fields are translated or copied over
• Add translation(s) for additional languages

Pages

Note: Website pages will use the source language, and not translated languages. If there are links, buttons, etc. as page content on a page, those links should point to the source language of the website and not the translation of that page.

• Web > [website title] > (to open the page tree)
• Go through each page on the website, click on the page menu ("...") and then on "Translations"
• In the field "Add translation" select the desired language
• Click on "Add" button and the translation interface will open up

• Note: on the Content tab, click on the "Options" button and show hidden blocks and structure, this will display all page content

• On each tab (General, Content,) do the same steps as the website and translate or copy over content
• Save, after all the fields are properly filled out
• Continue down through all pages until the entire website is translated

Article translation

Note: the translation groups should have been setup as a part of the work for Articles Module Setup Guide

If an article needs to be translated into another entity language, open the article for editing and go to the "Translations" tab for the article.

Follow these steps on the Translation tab:

1. Click in the field "Add translation" and select the language the article should be translated into. You can select more than one language, if enabled.
2. Click on the "Add" button to the right of the language field.
3. The source language will appear on the left and the target language appears on the right.
4. Use the AI button next to the target language field or another source for translation to update the target language fields.

5. Note: If the AI translation button is not visible, then it could be the entity AI translation is not configured. If this is the case, see Configure AI translation

6. If the source field value should be copied over, without translation, click on the button ">>".
7. Once the translation is properly completed, click on the "Approve" button, else click on Save as draft (and seek approval)
8. Once the translation is approved it can appear on any page or website set to that target language.

Note: If there is not an approval workflow in place for the translations, then an admin/manager may need to approve the translation.

Translation Groups

The following group will be able to translate articles, website, menus, etc.

• Expand Admin Area in the bottom left corner of the screen
• Click on Groups
• Click on "Add group" button
• Name: XX Translation, where XX is the two character language code
• Click on "Create" button
• Click on Web module (under Permissions tab)
  • Site = Pick the website for this group
  • Sites: Basics = Read, Update, Translate
  • Pages: Read, Update, Translate
  • Menus: Read, Update, Translate
• Click on "Update" button
• Click on Articles module (under Permissions tab)
  • Basic: Read
  • Translations: Translate, set checkmark. Then search for and select language(s).
  • Click on "Update" button

When ready, the users can be assigned.

• Click on the "Users" tab
• Click on "Add user" button
• in the field, find the user and select them
• if a user does not appear in the select list, but they are a user in the Web Engine, you can paste their email into the email field under the add user popup. After the email is in the field, take the focus off the email address field, the user's email should be found by the system if they are in the system.

All done? And no language menu??

Note: Make sure all the translation work is done for a language before activating the language for the language picker menu. Otherwise, visitors may not see the content!

To activate language menu

• Web module > [website title] > 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