Kontent.ai is a headless CMS providing the infrastructure to create and manage content. It is not coupled to any single presentation layer allowing the distribution of content to any platform or device.
All translatable fields are imported for localization unless flagged as in Kontent.ai.
Translatable content elements:
-
text
-
rich text
-
assets
-
linked items
Translatable media assets are also supported. To access assets, select Assets as the folder when setting up the connector or as a folder to be monitored in APC. Target files are uploaded to locations defined in APC or CJ.
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 specified workflow states is detected.
-
Selected content items are imported the very first time APC runs.
-
-
The connector API can be used to automate steps otherwise performed manually through the UI. Webhooks can be used to have 3rd party systems notified about certain events (for example, a job status change).
-
Log in to your Kontent.ai account and open the selected project.
The page opens.
-
Navigate to and click API Keys.
-
Copy the .
This key is required for the connector configuration. This connector will only be able to browse and monitor this Kontent.ai Project. If another Project needs to be monitored, create a new connector with a new Delivery API key (Project ID) for that project.
-
Copy the .
This key is required for the connector configuration. This key allows access to unpublished content items to be localized before publication.
-
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 .
-
Select how the connector should import linked content items.
Remote Kontent.ai workflow steps are respected for linked items. If the selected content item is set to , yet all linked items are in they will not be imported. Selected items and their linked items both require the initial workflow step to be imported by APC. This is ensure that only content that is explicitly intended to be localized by the content author is imported.
-
-
Content that is explicitly selected when adding from the repository is imported.
-
Changes detected by APC are imported for translation.
-
-
-
The connector traverses the entire hierarchy of linked content and imports all translatable fields for translation.
-
-
-
Enter obtained from the Kontent.ai site.
-
Enter obtained from the Kontent.ai site.
-
Provide .
Automated project creation will only create jobs for languages specified by codes in the given field that is specified by a unique ID (e.g. target_languages). Codes can be followed by language names as long as they are separated by a comma (e.g. de-DE German (Germany)).
Language codes are case insensitive and can use either _ or formatting - (e.g. de_de, de-de, de-DE).
Note
To select target languages on the content item level, create a new Taxonomy Group (Content Model > Taxonomies) within the selected Kontent.ai Project ID. The newly created group (e.g. Target Languages) should contain the language codes of all localization languages configured in the selected project. Add the configured taxonomy group to all or selected content models as a supporting element. Once added, the codename can be obtained.
-
Select .
This setting does not impact the default language in the Kentico project. The source language for the connector itself is language agnostic and any localization languages that are configured for a particular Kentico project can be used as the source language for the connector.
If using Kontent.ai with multiple source languages, set up multiple instances of the connector with different source languages configured in this field.
-
Click Test connection.
A checkmark will appear if the connection was successful. A red exclamation point will appear if it wasn't. Hover over the icon to see additional details.
-
Select Kontent.ai workflows.
By configuring workflows for a Kontent.ai Project, the workflow can be tuned to provide localization when needed. Kontent.ai workflows are configured for each project individually. By setting the Delivery API Key (Project ID) in the connector configuration, only the remote workflow steps for the specified project ID are displayed.
-
:
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 Kontent.ai:
-
The connector advances the workflow to the selected stage (e.g. Translation in Progress) when the source articles are downloaded.
Upon export to Kontent.ai:
-
The connector sets the workflow stage of the source articles to the selected stage (e.g. Translations Completed) when the translation is exported.
-
The connector sets the workflow step of the article translations to the selected stage (e.g. Translation ready for Review) when the translation is exported.
-
-
Click Save.
The connector is added to the list on the page.