XTM App Installation Guide

XTM is a cloud-based translation management application that offers language localization to simplify the process of content distribution across systems. It is a simple, robust, and cost-effective solution that helps to broaden your reach to multiple customers with multiple languages and colossal content.

Contentstack Marketplace allows you to easily integrate the XTM application and use it within your stack to create localized versions of your entries.

Prerequisites

Let's go through the steps required to install and configure the XTM app within Contentstack Marketplace.

Steps for Execution

  1. Fetch the credentials from your XTM account
  2. Define workflow in Contentstack
  3. Install the XTM application
  4. Translate your Content
  1. Fetch the credentials from your XTM account

    To configure the application, you need to create an account in XTM. To do so, follow the below steps:

    1. Go to https://xtm.cloud and create a new account based on your requirement.
    2. Fetch the XTM details such as baseURL, user identifier, customer ID, UserCompany and password required to set up the app configuration page.

    Note: In the XTM dashboard, you must define the languages and create a template for the translation process. Make sure these languages are present in Contentstack as well.

  2. Define Workflow in Contentstack

    To use the XTM application, you must define the Workflow to initiate the translation process.

    Firstly, you need to create a content type and an entry. To do so, follow the below steps:

    1. Log in to your Contentstack account.
    2. Click the + New Stack button and then click the Create New button.
      Create-Task.png
    3. Go to your stack, click the Content Models icon on the left navigation panel, and click the + New Content Type button.
    4. Create a content type by entering relevant details as given below:
      Create-Content-Type.png
    5. On the left navigation panel, select Entries. On the Entries list page, click the + New Entry button, select the content type and click the Proceed button.
    6. Add content in your entry that you want to translate.

      Note: If you already have a stack, skip the above steps.

    Follow the steps below to define the Workflow for your stack:

    1. Navigate to your stack and click the Settings icon on the left navigation panel.
      Stack-Settings.png
    2. Under Settings, click Workflows
      Select-Workflow-tab.png
    3. Define the workflow stages.
      Workflow-Stage.png
    4. Once done, click Enable Workflow and click the Save button.
  3. Install the XTM application

    Follow the steps to install the application in Contentstack.

    1. Log in to your Contentstack account.
    2. On the left navigation panel, you will find the icon for Marketplace. Click the icon to navigate to Marketplace.
      Marketplace-Icon-1.png
    3. Select XTM from the list of apps.
    4. On the right-hand side, click the Install App button.
    5. In the Authorization window, select the stack where you want to install the app and then click the Authorize & Install button.
      XTM-App-Authorization.png

    You have successfully installed the XTM app to your stack in Contentstack.

  4. Translate your content

    XTM lets you translate your content in two different ways:

    1. Machine Translate
    2. Human Translate

    Machine Translate

    The machine translation process can translate multiple languages in just one go.

    On the XTM Configuration screen, enter the following details:

    1. XTM Fields

      You can fetch the below details from your XTM account.

      1. XTM Base URL : The URL of the application.
      2. XTM User Identifier : Unique identification given to a user.
      3. User Company Name : The company name of the user.
      4. XTM Password : Company credentials for integration
      5. XTM Customer ID : Unique customer ID given to users.
      6. Select Translation Type : XTM provides two translation types
        • Machine Translate : Machine Translate helps to translate your entry data automatically once you update the workflow. It helps to process and translate data quickly.

          Note: The default translation type is Machine Translate

      7. XTM Template Fields: This field can help to define the languages in which you want to translate your content. Click Get XTM Template, a dropdown menu with a list of templates will appear.
    2. Click the Next button.
    3. Configure the Contentstack Fields settings:
      1. Workflow: Set of instructions used to define a plan for a process.
      2. Workflow Stage: Define the workflow stage in which your translation will initiate.
      3. Next Workflow Stage: After translation, the workflow stage will be changed to the stage you have defined in this field.
      4. Enable Additional Settings: If you enable mapping, you can define the scope of your fields for translation.
      5. Contentstack-Field.png
    4. Click the Next button.
    5. Configure the Additional Settings:
      1. Content Type Field Mapper: Define the fields of a particular content type you want to exclude from translation.
      2. Field(s) to Exclude from All Content Type(s): Define specific fields of all the content types you want to exclude from the translation.
      3. Additional-Settings.png
    6. Once done, click the Save button.
    7. To reset the configuration:
      1. If you want to reset the configuration with other values, click the Reset Configuration button. 

      2. A pop-up will appear. Click the Reset Config button to reset the entire configuration.

    Initiate the translation process

    Once you define the configuration for your XTM application, initiate the translation process by following the below steps:

    1. Navigate to the Entry page that you created in Step 2.
    2. Enter the content in the entry field.
    3. Click the Save button.
    4. On the right navigation panel, click Workflow Details.
      WORKFLOW-DETAILS-NEW.png
    5. Click Change. To start the translation process, you need to change the workflow stage, as defined in the XTM configuration page.
      WORKFLOW-DETAILS-CHANGE.png
    6. Select the Workflow stage from the dropdown and click the Update button.
      WORKFLOW-DETAILS-CHANGE.png

    Note: In the Sidebar Widget, you can check the translation status of the latest 10 projects created in the XTM dashboard based on the creation date. Contentstack Sidebar Widget gives insight about the XTM dashboard such as number of projects, the status of the translation (whether completed/ In-Progress) and the number of languages in which the content is translated.

    Project-List-Sidebar-Widget.png

    Human Translate

    In the Human translation process, an individual user manually translates the content. This process is slower than machine translation.

    On the XTM Configuration screen, enter the following details for human translation:

    1. XTM Fields
      • Select Translation Type
        • Human Translate

    Note: The rest of the configuration will be similar to the machine translation process.

    The process for human translation will be as follows:

    1. Navigate to the entry page. Click on the Widget icon in the right navigation panel.
    2. Under Apps, select XTM App.
    3. Select the project ID from the dropdown. You need to select the ProjectID from the sidebar widget.

      Note: Project ID is a unique identifier given to the entry which needs to be translated. With the help of project ID, users can easily search for the entry in the XTM dashboard and translate the content manually.

    4. Navigate to the XTM dashboard to view the list of all the projects.
    5. Select the project based on your project ID. 
      XTM-Dashboard-Projects-List.png
    6. In the left navigation panel, click Workflow. Assign different languages to different users so they can manually translate the content.
      XTM-Dashboard-Assign-Language-To-Users.png
    7. Click the Start button.

      Note: Users need to log in via individual credentials in the XTM dashboard. Credentials are different for human and machine translation in XTM.

    8. Select the project based on project ID. Translate the content manually.
    9. Click the Finish button.
      Finish-Human-Translate.png

    You will be able to see the translated content in Contentstack.

    After-Translation.png

Was this article helpful?

Thanks for your feedbackSmile-icon

More articles in "Language Translation"

On This Page

^