Episerver is now known as Optimizely. For the consistency, the documentation and Smartling interface refers to this software as Episerver.
Once you have installed the correct package for the branch you are working with, you can proceed to configure the connector before translating your content.
Important Prerequisite
Ensure Content is Localizable
Content for translation must be contained with a localizable property in Episerver. If a content type does not have the unique value per language setting enabled, the connector cannot ingest the content for translation. This results in missing components on translated sites. To ensure components are not missing, you can set up a fallback language for each language in Episerver. This will insert the component in the selected fallback language, so it is not missing in the translated site.
Language Configuration
- From within your Smartling Episerver Project, click on Project Settings > Episerver Settings.
- In the Language Configuration section, you will see the number of target languages in your Smartling project, along with the source language in your Smartling project. These details should match dropdown menus with your Episerver target languages.
- Choose the correct target language from the dropdown menu to map the language in your Episerver language configuration to your Smartling project target language.
- Click Save after mapping each of the target languages.
You cannot map a Smartling language to more than one Episerver language.
General
You can configure the behavior of the connector when updates are made to your previously translated content.
- From within your Smartling Episerver Project, click on Project Settings > Episerver Settings.
- Click the Automation of Prior Request for Translation dropdown to select your desired behavior.
- Click Save.
Automation of Prior Request for Translation
- Auto: The Episerver Connector will detect changes to source content every 3 hours. Any changes detected to the source content will be submitted to Smartling for translation, batched into a Job and sit in awaiting authorization. However, if auto-authorize is enabled under Smartling Settings, the updated content will be batched into a Job and automatically authorized for translation. Smartling will not detect net new content, only updates to content that have been submitted for translation in the past.
- Manual: The Episerver Connector will detect changes to source content every 3 hours, but will not submit new content for translation. Changed content will be indicated by a checkmark in the Outdated column in the Episerver Progress (New Experience).
- Disabled: The Episerver Connector will not detect changes to source content or automatically submit new changes.
3 hours is the recommended shortest time duration between checks. Talk to your Solutions Architect about changing the frequency to longer wave periods using cron.
Configure Episerver Content Parsing
When Smartling captures content from Episerver it may process the fields of an entry based on your configuration settings and may break down the individual fields into even smaller strings for translation. This process makes it easier to produce higher quality translations faster.
Follow the steps below to configure how Smartling should handle fields based on how your content editors are allowed to format them in Episerver. Of course, if a field is not "localizable" in Episerver, then it won't even appear in the list of fields for that content type in the Smartling settings.
Parsing Option |
Description |
Copy value |
Copies the source content to the target field. |
Do not translate |
Use this if the field shouldn't be translated using Smartling. |
Plain text | All text and characters treated as plain text. Use this for fields that you expect to only have plain text with no markup or formatting. |
HTML | Parses the field's HTML tags for the best experience by translators and maximum Translation Memory leverage. Use this when your field is likely to have HTML markup in it |
- Under Content Parsing, select your Episerver space. A list of the localizable fields appears.
- For each field, decide whether it requires translation, and if so, which parser should be used for that field.
- Click Save.
Smartling Settings
Talk to your Customer Success Manager or Solutions Architect about options on auto-authorization and translation retrieval.
What next?
Now you're ready to translate content with the Episerver Connector.