Skip to main content

XTM Connect – Sitecore Administrator Guide

  • XTM Connect – Sitecore Administrator Guide
  • Configuration
  • Configuring XTM Visual mode for Sitecore content in XTM Workbench

Configuring XTM Visual mode for Sitecore content in XTM Workbench

You can configure Sitecore and XTM Connect – Sitecore to enable translators to access and translate unpublished Sitecore website contents, and others, in XTM Cloud. To do so, you must configure the options for enabling XTM Visual mode on the server on which the Sitecore application is installed. Once it has been configured there, and enabled in a project in XTM Workbench, a Linguist who is working in XTM Workbench can display a preview of the source and target file content. They can then select the text in the preview and enter a translation for it in the target segment. The target preview is immediately updated with the translated text, so the translator will see the full context for their translation as they are working on it.

Note

For more details about how to use XTM Visual mode in XTM Workbench, go to the XTM Cloud documentation page, select the version of XTM Cloud that you use and then search for the Visual mode in XTM Workbench topic.

To configure XTM Visual mode for Sitecore content in XTM Workbench, perform these four actions, in sequence:

  1. Register the server for use as a Translation site in the relevant Sitecore configuration file.

  2. Enable XTM Visual mode in the Sitecore settings.

  3. Update the hosts file in the server's MS Windows configuration.

  4. Configure the bindings for this Sitecore instance, in Microsoft IIS Manager.

To register the server for use as a Translation site in the relevant Sitecore configuration file:

  1. On the server on which the Sitecore instance is located, use Windows Explorer to find the Sitecore configuration files.

  2. Find the Xtm.Connector.Sitecore.TranslationSiteDefinition.config file. Default path: .\Sitecore\Website\App_Config\Include\Xtm.

  3. Open this file in an editor and set a new site name, if required, or use the default name. Example of new name: Sitecore_2.

    Xtm.Connector.Sitecore.TranslationSiteDefinition.config file example listing:

    <configuration xmlns:patch="http://www.sitecore.net/xmlconfig/">;
<sitecore>
<sites>
<site name="XtmTranslationSite" patch:before="site[@name='website']";
hostName="XtmTranslationSite"
virtualFolder="/"
physicalFolder="/"
rootPath="/sitecore/content"
startItem="/home"
database="master"
domain="extranet"
allowDebug="false"
cacheHtml="true"
htmlCacheSize="50MB"
enablePreview="false"
enableWebEdit="false"
enableDebugger="false"
disableClientData="false" />
</sites>
</sitecore>
</configuration>

  4. Note down the new site name (if defined) or default site name. You will enter it in the Sitecore settings.

  5. Close the Xtm.Connector.Sitecore.TranslationSiteDefinition.config file. Save your changes at the prompt, if required.

  6. Close the editor, if it is still open.

To enable XTM Visual mode in the Sitecore settings:

  1. Log in to Sitecore.

  2. In the main Sitecore screen, select the Content Editor icon. You see the Content Editor screen.

  3. Select the arrow to the left of the XTM Translation folder.

  4. Select the arrow to the left of the XTM Connect folder, to open it.

  5. Select the Settings cog icon. The Sitecore settings for XTM Connect are listed on the right. These settings are grouped in sections.

  6. In the Sitecore Settings section, find the Translation site URL field.

  7. In this field, enter the site name that you noted down in step 4. above, when you registered the server for use as a Translation site in the relevant Sitecore configuration file. When you do so, insert "http://" before the name and a forward slash ("/") after the name. "Example: "http://Sitecore02/".

  8. Select the Use Translation site URL checkbox to apply the new site name. If you do not, the Base Sitecore URL shown above the Translation site URL field is used for HTML generation for XTM Visual mode.

  9. Select the Save icon at the top of the screen, on the left, to save your translation site setting.

To update the hosts file in the server's MS Windows configuration:

  1. On the server on which the Sitecore instance is located, find the MS Windows hosts configuration file. Default location: C:\Windows\System32\drivers\etc\hosts.

  2. Open the hosts file in an editor.

  3. In it, find the line with the Sitecore page that you are using. Example: URL "127.0.0.1 Sitecore01".

    Then change the site URL into the site name that you used in the first step. Example: 127.0.0.1 Sitecore02.

  4. Copy that line and paste it into a new line below, in the hosts file.

  5. In that line, change the site name, in the site URL, to match the site name that you noted down in step 4. above, when you registered the server for use as a Translation site in the relevant Sitecore configuration file. Example: "127.0.0.1 Sitecore02". In other words, the IP address (in this case, "127.0.0.1") remains unchanged, but the hostname is changed (in this case, to "Sitecore02").

  6. Save the hosts file and close it.

  7. Close the editor, if it is still open.

To configure the bindings for this Sitecore instance, in Microsoft IIS Manager:

  1. On the server on which the Sitecore instance is located, run the MS IIS Manager application.

  2. In it, find the Sitecore instance you use.

  3. Edit the Bindings for your Sitecore instance: add a new Binding with the same name as before. Do not change the default settings for any other parameters.

    For more information, refer to the online help provided for Microsoft IIS Manager by Microsoft Corp.

  4. Save your settings.

  5. Close Microsoft IIS Manager.

In this section: