Sitecore (TMS)

Available for

Enterprise plan

Get in touch with Sales for licensing questions.

Sitecore is a web content management service that helps users build and manage websites.

url and other non-translatable attributes in General Links and non-translatable attributes in Image stay unchanged in Sitecore after updating existing translation

Sitecore connector allows the downloading of source content and uploading of translations to/from Sitecore for the following field types:

Single-Line Text (and Limited)
Rich Text
Multi-Line Text (and Limited)
HTML
Text
Name Value List
General Link
Image
Checklist (Referenced items are included in the job if not translated.)
Multilist (Referenced items are included in the job if not translated.)
Treelist (Referenced items are included in the job if not translated.)

Supported Versions

Sitecore - XP (Experience Platform): 8.2 and higher

Use Cases

There are a number of use cases for the connector:

Project managers can add files directly to projects from an online repository.
Set up the submitter portal to allow Submitters to add files to requests directly from the online repository.
Use automated project creation (APC) to have new projects automatically created when a change in the last modified date is detected for monitored files or a folder.
- Selected files are imported the very first time APC runs. All files are imported when a folder is monitored.
- If using automatic project creation and the main page to be translated contains sub-items, changes made to those sub-items do not automatically create a new project. These sub-items will need to be translated manually.

Restrictions

The Default Language set in the Sitecore server must be the same language as the source language in the Phrase account.

Configure In-Context Preview

The In-context preview feature offers a real-time preview of original or translated text in both the CAT web editor and CAT desktop editor.

Phrase requirements:

Pass through the enterprise firewall to access the on-premise installation.
Authenticate into the authoring environment.

Firewall configuration for on-premise installation:

Installation must be accessible from the following IP addresses:

34.243.87.13, 34.248.197.209, 108.129.22.31, 3.248.158.93
Domain name must be able to be resolved externally.

Note

Some HTML tags present a risk and the CAT editor removes them from this HTML when displaying the preview. This is to ensure user's data privacy and security.

Examples of removed tags include FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT or background-image CSS properties.

Sitecore Settings

In order to set up the connector, the Sitecore Administrator must enable SSL and the Rest API.

To enable the Rest API, follow these steps:

In the file {SITECORE_ROOT}Website\App_Config\Include\Sitecore.ItemWebApi.config set itemwebapi.mode and itemwebapi.access:

<site name="website">
    <patch:attribute name="itemwebapi.mode">StandardSecurity</patch:attribute>
    <patch:attribute name="itemwebapi.access">ReadWrite</patch:attribute>
</site>

Set the security policies:

In the file {SITECORE_ROOT}Website\App_Config\Include\Sitecore.Services.Client.config set the value Sitecore.Services.SecurityPolicy to Sitecore.Services.Infrastructure.Web.Http.Security.ServicesOnPolicy, Sitecore.Services.Infrastructure.
Restart the server/service.
Open/sitecore/admin/showconfig.aspx and validate that the configuration was correctly applied:
- Item REST API enabled: <site name="website" itemwebapi.mode="StandardSecurity" itemwebapi.access="ReadWrite" patch:source="Sitecore.ItemWebApi.config"/>
- Security policy applied: <setting name="Sitecore.Services.SecurityPolicy" value="Sitecore.Services.Infrastructure.Web.Http.Security.ServicesOnPolicy, Sitecore.Services.Infrastructure" patch:source="Sitecore.Services.Client.config"/>

Access Roles and Permissions

The Sitecore connector does not require specific roles.

Apply these settings:

Add Read and Write access rights to items that to be translated.

For more information, see Sitecore access rights.
Add Read access right to items that are parents of items to be translated.
Add Read access right to languages items using /System/Languages/**
Add Read access right to workflow items using /System/Workflows/**

Phrase TMS Settings

From the Settings page, scroll down to the Integrations section.
Click on Connectors.

The Connectors page opens.
Click New.

The Create page opens.
Provide a name for the connection and change the Type to Sitecore .
Enter the Sitecore URL, including the protocol.
Enter the Username and Password.
Select the Source Language.

Source language must match the default language in Sitecore.
Select the Sitecore Database to connect to. If not using the default database, provide the Custom Database Name.
Click Test connection.

A checkmark will appear if the connection was successful. A red exclamation point will appear if it wasn't. Mouse over the icon to see additional details.
Click Save.

The connector is added to the list on the Connectors page.