Contentful provides a headless content management infrastructure to create, manage and distribute content to any platform or device.
Note
The connector does not support the translation of JSON objects.
Supported Localization Methods
Contentful supports multiple localization methods. See Contentful documentation for their detailed description.
Entry-Level Localization
Use Contentful (Entry-Level) connector.
The entry-level connector only works with content types that have localized reference fields (e.g., a reference field called Localized that is enabled for localization).
Field-Level Localization
Use Contentful connector.
The field-level connector only works with content types that have a translatable field (e.g., either Text or Rich Text field with enabled localization) and Media Assets. If the connector is configured to import referenced entries, it traverses the entire hierarchy of nested content and imports all translatable fields for translation. If the reference field is enabled for localization, it imports the reference that match the project's source language.
There are a number of use cases for the connector:
-
Project managers can add files directly to projects from an online repository. Content is searchable by Entity ID.
-
Set up the submitter portal so Submitters can add files to requests directly from the online repository. Content is searchable by Entity ID.
-
Use automated project creation (APC) to have new projects automatically created when a change in the content size is detected for monitored documents or a folder.
-
Selected files are imported the very first time APC runs.
-
Set up the Connector
-
The Source language of the project must match the Default locale of the Contentful space that is configured in Contentful's locales settings.
-
Target languages of the project must be a subset of Contentful target locales. The languages must match exactly; for example, English and English (United States) are considered different languages.
Contentful Settings
No changes are required unless using workflow support with the Contentful Launch application.
If using workflow support, follow these steps:
-
Install Contentful's Launch application to one or more spaces.
Note
Only one workflow can be created per space. If different approaches for content types is required within one Contentful space, contact the dedicated Customer Success Manager.
-
Set up a the required localization workflow.
-
Select content type or types that follow the described workflow.
If workflows in a connector are set the Automated Project Creation (APC) will automatically create new projects when a change in the workflow steps is detected for monitored articles or content types.
Important
If accessing from a custom domain (ex. mydomain.phrase.jp
), open an incognito browser window and log in via cloud.phrase.com
or us.cloud.phrase.com
to apply the authentication required for the creation or saving of the connector. After saving, the connector can be accessed via the custom domain.
-
From the Settings
page, scroll down to the section.
-
Click on Connectors.
The
page opens. -
Click New.
The
page opens. -
Provide a name for the connection and change the Type to either Contentful (Entry-Level) or Contentful (Field-Level) .
-
Select how to process nested content. Content can use a reference field to reference other content allowing the creating a hierarchy of entities.
-
Contentful (Entry-Level)
The entry-level connector automatically traverses the entire hierarchy of nested content.
-
Contentful (Field-Level)
Select how the field-level connector should import nested content.
-
-
Content that is explicitly selected when adding from the repository is imported.
-
Changes detected by APC are imported for translation.
-
-
Import referenced entries
-
The connector traverses the entire hierarchy of nested content and imports all translatable fields for translation.
-
-
-
-
Select
if data is missing for a particular field in the source language.Select a
from the dropdown list if required. This language locale will be used in the case of missing data.Note
There is no relationship between the Contentful fallback language and this setting.
-
If logging of debug information is requested by technical support team, select
. -
Click Connect to Contentful.
A checkmark will appear in the connector setup if the connection was successful. A red exclamation point will appear if it wasn't. Mouse over the icon to see additional details.
-
Contentful (Entry-Level) only:
Set the Source language.
Note
This language should match the Default locale of the Contentful space that's configured in Contentful's Locales settings.
-
Click Save.
The connector is added to the list on the
page. -
Edit the connector to select
.-
:
The connector monitors articles in the selected stage (e.g. Translate). The author can apply this label to articles when ready for translation.
Upon import from Contentful:
-
The connector advances the workflow to the selected stage (e.g. Translation in Progress) when the source articles are downloaded.
Upon export to Contentful:
-
The connector sets the workflow stage of the source articles to the selected stage (e.g. Translations Completed) when the translation is exported.
-