Drupal 8/9/10 TMGMT Request Translations

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

The connector supports the translation of content, configs, and user interface strings (this support comes from TMGMT).

Request Translations

Once you have installed and configured the Drupal 8/9/10 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.
   • 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. Select the languages you wish to translate your content into.
5. Click the Request Translation button to submit for translation.

Add Content to a New or Existing Smartling Job

Drupal 8/9/10 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.
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.

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). 

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.
   

Exclude Content From Translation

In Drupal

You can configure fields to be excluded from translation entirely for each content type within your Drupal instance. The following steps are recommended for content that you never intend to translate, as the connector will not send the field to Smartling for translation.

1. In Drupal, go to Structure > Content types
2. On the content type that contains fields you want to exclude, click Manage fields
3. On the field you would like to exclude from translation, click Edit
4. Check the Exclude from translations checkbox
5. Click Save Settings

In Smartling

You can exclude content from translation on a string-level. Follow steps outlined in Exclude Content from Translation and Restore Excluded Strings to exclude content from translation within Smartling. The steps outlined in the document are recommended if you want to exclude some content from translation for some locales or in some scenarios (and not entirely).  

Asynchronous Mode

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

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 it works 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.

This option is controlled by the setting "Track changes of the translatable entities" within /admin/tmgmt/extension-settings page. You can also select which languages content needs to be re-submitted for. 

Include Visual Context with your Translation Request

A visual context capture tool is built into the Drupal 8/9/10 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

TMGMT module 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.

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 cron 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.