Skip to main content

XTM Connect – Kontent.ai 1.4/Administrator Guide

Adding Kontent.ai projects

Note

The Client name (your company name) is set automatically by XTM Cloud and cannot be modified.

Each project is assigned its own specific API key so the Administrator user must configure the connection between the connector and the specific Kontent.ai projects.

To add a new Kontent.ai project:
  1. Log in to the XTM Connect – Kontent.ai administrator panel.

  2. Go to Kontent.ai Projects and click Add project.

  3. Select the required Client assigned from the dropdown. The clients list is set by the XTM Cloud system administrators.

  4. Select the Active checkbox – inactive users cannot use the connector.

  5. Provide the required Project name.

  6. Expand the down arrow angle-down-solid.png next to Connect to Kontent.ai to configure the Kontent.ai connection by filling in the required fields with information about the XTM Cloud account:

    • Project ID - the value copied from the Kontent.ai Delivery API setting in the CMS project Environment settings > API keys section

    • Management API Key - token copied from the Kontent.ai Management API setting in the CMS project Environment settings > API keys section

      Note

      Make sure it is switched to Active.

    • Preview API Key - token copied from the Kontent.ai Preview API in CMS project settings of API keys

  7. Click the Connect to Kontent.ai button.

    Once the connection has been established, the Connected status is displayedin the dropdown.

  8. Fill in the optional details for a new project from the dropdowns:

    Fill in the optional details for a new project from the dropdowns or checkboxes:

    • Content types that define the structure of your content, such as an Article or Landing page

    • Content elements within a specific content type:

      • Text

      • Rich text

        Note

        Once you select the Rich text content element checkbox, the Remember context for Rich text fields checkbox is activated.

        Also, once you select the Remember context for Rich text fields checkbox, the Propagate repeat translations checkbox is activated.

      • Number

      • Date & time

      • Linked items

      • Custom element

    • Kontent.ai workflow steps:

      • Draft

      • Translate

      • Review

      • Scheduled

      • Published

      • Archived

    • Remember context for Rich text fields - use it to specify how the translation of rich text fields with referenced objects is handled:

      Note

      This checkbox is activated once the Rich text content element has been selected in the Content elements dropdown.

      • To keep the context of rich text field references in generated source files that are sent for translation, select the Remember context for Rich text fields checkbox.

        Note

        Once you select the Remember context for Rich text fields checkbox, the Propagate repeat translations checkbox is activated.

      • If you do not want to keep the context of rich text field references in generated source files that are sent for translation, clear the Remember context for Rich text fields checkbox.

    • Propagate repeat translations - determines how the translation of multiple references of the same object is handled:

      Note

      This checkbox is activated once you select the Remember context for Rich text fields checkbox.

      • If you want the translation of the first occurrence of the referenced entry content to be applied to repetitions in the source file, select this checkbox.

      • If you want multiple translations of the same referenced entry content to be applied to repetitions in the source file, clear this checkbox.

  9. Select the optional Kontent.ai workflow step for translated content from the dropdown:

    • Draft

    • Translate

    • Review

    • Scheduled

    • Published

    • Archived

  10. Select the optional Webhooks from the dropdown for your Kontent.ai project. The webhooks will notify certain users of specific changes made to your project.

  11. Select the optional Users for webhooks from the dropdown for your Kontent.ai project. These users will receive notifications about specific events resulting from specific user actions in the CMS UI.

  12. Select optional Users assigned to your Kontent.ai project.

    Tip

    Administrator users can either assign users to projects at project level that are defined in XTM or can assign projects at user level.

  13. Using the Language mapping dropdown, set the language mappings for your Kontent.ai project as required.

    • Kontent.ai language

    • XTM language

  14. Click Save.