Drupal 8 TMGMT Connector

Drupal 8 TMGMT Request Translations

This article is for Account Owners and Project Managers.

The Smartling Drupal 8 connector allows you to translate Drupal 8 content with context. Translations are requested from within Drupal 8, and translated content is automatically sent back to your Drupal 8 instance.

The connector supports translation of Content (Articles and Basic Pages).

Request Translations

Once you have installed and configured the Drupal 8 connector, you can begin submitting content to Smartling for translation.

If enabled, the Translate tab will appear for any content that is enabled for translation.

Translate Individual Content

To submit individual Content:

  1. From within Drupal, edit any content you would like to translate.
  2. Click the Translate tab.
  3. Select the languages you wish to translate to.
  4. Click the Request Translation button.
  5. Complete the check out process by:
    • Labeling your job (leaving this field blank will use a default job name).
    • Select your translation provider.
    • Clone job to other languages (if applicable).
    • Click Submit to Provider.

Translate Content in Bulk

To submit multiple pieces of content at once:

  1. From within Drupal, open the Translation menu item via the admin toolbar.
  2. Click Sources.
  3. Select the content you wish to translate.
  4. Click the Request Translation in Batch button.
  5. Select the languages you wish to translate your content in to.
  6. Click the Request Translation button to submit for translation.

Add Content to a New or Existing Smartling Job

As of the 8.x-3.0 release, the Drupal 8 TMGMT Smartling connector allows you to bucket your content into a new or existing Smartling Job. The Jobs feature helps you group and prioritize content for translation, and monitor the progress throughout completion.

You will first need to create and save your content before being able to add it to a new or existing  job. To add content to a new or existing job:

  1. Go to Translation > Sources, select the content for translation and click Request translation.
  2. You will have the option to Create new job or Add to job.
  3. Enter a job name, description, and due date. (If you are adding content to an existing job, you can update the description and due date.) The job name needs to be unique, and the due date cannot be in the past. Otherwise, you will get a validation error that looks something like this: "Job with name 'demo test job 1' already exists. Please choose another job name. Due date cannot be in the past."
  4. The Authorize checkbox will already be checked provided that your settings are configured to allow authorization. (To find your settings, go to Translation > Providers > Smartling translator > Edit, and make sure that "Automatically authorize content for translation in Smartling" is checked if you want to allow authorization.)
  5. Select the local(s) for which you would like your content translated.
  6. Click Submit to provider (if it's a new job) or Save job (if it's an existing job).

Additional information about a selected job, such as its state and a list of files associated with the job, can be found in the Smartling dashboard.

Add Content for Multiple Locales to a Job

If you want to add content (for multiple locales) to a job, you can achieve this from the /admin/tmgmt/sources page (Content > Sources). 

content_overview.png

  1. Set the Target language to "Multiple". This will display all available languages from which you can select the ones you need.
  2. Click Request Translation. You will then be redirected to the TMGMT job edit page, like the example below, where you are able to either create a job or add content to an existing one.
    jobs_pending.png

Asynchronous Mode

All of the described actions above behave synchronously. Content will be sent and attached to the created/existing node once you click Request translation. However, if you need, there is an option to postpone file uploads.

xml.png

Enable “Asynchronous mode” from Translation > Providers > Smartling translator > Edit. The connector will put all necessary files into an upload queue, and will be uploaded by the next cron, instead of an immediate upload.

Track Changes

The TMGMT Smartling connector continues to handle changes with previously submitted content (with help from the TMGMT Extension Suite module). Since version 8.x-3.0 works with Smartling Jobs, we package all updated strings into one special job - the daily bucket job (one job per day). This means that if you submitted a node to a Smartling Job, and then, for example, updated the title, the connector creates a new one (or picks up the existing daily bucket job) and sends the updated content to it. The bucket job name looks something like this: “Daily Bucket Job mm/dd/yyyy” or “Daily Bucket Job mm/dd/yyyy hh:mm:ss” if there is a closed/completed bucket job on this day.

Include Visual Context with your Translation Request

A visual context capture tool is built into the Drupal 8 connector, helping linguists get your translations right the first time - reducing translation cost and time to market. Context will automatically be captured when content is submitted to Smartling.

If you are not seeing visual context in Smartling, refer to the Set Up TMGMT_Smartling_Context_Debug Module article for troubleshooting.

Check Status

The Smartling connector displays translation progress on any content in Drupal.

To monitor translation progress on all translation requests:

  1. From within Drupal, open the Translation menu item via the admin toolbar.
  2. Click Jobs.
  3. Use the filter at the top of the screen to find your translation requests.

Translation progress is displayed in the Progress column. The overall status of the translation request is also listed in the Progress column.

If your translation request shows a failed status, you can resubmit the request from the Jobs page. Use the Smartling Bulk Submit tab to resend translation requests if multiple submissions fail.

Download Translations

Automatic

The Smartling Connector can be configured to download translated content once it is complete on a schedule defined in your Drupal configuration. Check with your technical team to verify your current download schedule.

Manual

You can download translations manually from the Jobs tab for any Content by clicking the Download translation button.

You can download translations manually in bulk from the Jobs tab:

  1. From within Drupal, open the Translation menu item via the admin toolbar.
  2. Click Jobs.
  3. Select the content you wish to download.
  4. Click the With Selection dropdown menu.
  5. Click Download Translation.

Publishing Translated Posts

Automatic

The Smartling Connector can be configured to automatically publish translated content once it is returned to your Drupal instance.

If Auto accept finished translations option is disabled, you will need to manually publish your content:

  1. From within Drupal, open the Translation menu item via the admin toolbar.
  2. Click Jobs Items.
  3. Find the Content you wish to publish and click Review.
  4. Click Save as completed to publish the translation.

 

Was this article helpful?