We've launched a new support center at help.smartling.com. This site will continue to be maintained into January 2017. Please update your bookmarks.

Smartling TMGMT Module for Drupal 8

Drupal 8 users can use Drupal’s TMGMT Module to manage their translations in Drupal. By installing the smartling_tmgmt module, you can use Smartling as a translation provider in TMGMT.

Install the Smartling Module

To use the Smartling TMGMT Module, you first need to install the TMGMT Module and all of it’s dependencies. Follow the TMGMT documentation to set up your languages for translation.

Download the Smartling TMGMT module and from the Extend tab, click + Install new module.

Upload the module file and click Install.


Set up Smartling Module

1) From the TMGMT Providers tab (/admin/tmgmt/translators), find click Add Provider.

2) Label the provider Smartling translator and, from the Provider plugin dropdown, select Smartling translator.

3) Check Auto accept finished translations if you want to automatically publish translations returned from Smartling. If you do not check this box, you will need to review translations in Drupal before they are published on your translated sites.

4) Add the following information to the Smartling Translator Plugin Settings:

  • API URL - ‘https://api.smartling.com/v1
  • Project ID - The project ID for the Smartling project you are using for your Drupal translations.
  • Key - The API key for your Smartling Account.
  • orgID - This identifier is used to match context with translatable strings. You can find your Smartling Org ID in your Smartling project at Project Settings > API.

  • Username for context retrieval - To get context for your translations, the Connector impersonates a Drupal user. Different users may have different permissions that enable them to see different components of a page. Keep this in mind when you choose a user for context.
  • The desired format for download - select the type of translations you want returned. You can either return only translations that are published or pre-published in Smartling, or return any saved translation even if they are not published (for example if the translation is currently in an editing step). For testing, you can choose to return a modified version of the original text with extra characters, so you can check that your layout can handle a translation that takes up more space than the original text.
  • Automatically authorize content for translation in Smartling - if checked, when you submit translations, content will automatically be authorized instead of being added to your Awaiting Authorization queue.
  • Use Smartling callback - You can have Smartling send a callback to your Drupal instance to download translated items as soon as they become available, rather than waiting for the scheduled download process to pick them up. For this to work, your instance must be publicly addressable.
  • Remote Language Mappings - Once you have set up your languages in the TMGMT Module, you will see an entry for each language here. Enter the corresponding Smartling locale code set up in your project. For example, de-DE for German (Germany). The language must be set up in your Smartling Project.

5) Drag the Smartling translator entry to the top of the list, to make it your default provider, and click Save.


Translating your Drupal nodes with Smartling

1) From the Translation tab, click Sources.

2) Select a language, select the nodes you want translated, and click Request translations. This will create a Drupal translation job.

3) A window will open for the translation job. If you wish, provide a label for the job, then, click Submit to Provider.

If you checked Auto accept finished translations in the Provider settings, translations will be published on your translated sites as soon as they are complete. If not, you will need to review and accept completed translations from this page.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request
Powered by Zendesk