Contentstack Connector

Submit Content to Smartling from Contentstack with the Smartling App

The Smartling App for Contentstack allows you and your team to seamlessly submit entry content for translation. This allows your content writers to continue to create spectacular new content in Contentstack, and instantly submit it to Smartling for translation, without ever leaving Contentstack.

Content submitted for translation via the widget will sit in Awaiting Authorization in Smartling until an Account Owner or Project Manager user Authorizes it for translation.

The Smartling Widget also allows you to track each language's translation progress from within Contentstack. Completed translations can be easily viewed and published from the Contentstack languages switcher.

This article walks you through the following steps of using the Smartling App:

  1. Prerequisites
  2. Installation
  3. Connect the Smartling App to Smartling
  4. Submit Content for Translation
  5. Authorize the Job
  6. Monitor Translation Progress from Contentstack
  7. View & Publish Translations in Contentstack
  8. Unpublish Translations in Contentstack

Prerequisites

Installation

The following steps must be completed by a Contentstack Admin user:

  • The Smartling App can be found in the Contentstack Marketplace. Search Smartling in the Apps and click install.
  • Next, you need to choose the same stack that is already integrated with Smartling to install the widget, and accept the T&C's before clicking Install.

Screenshot_2022-05-19_at_14.58.15.png

Once installed, you must click Save (on the bottom-right side of the page). 

Screenshot_2022-05-17_at_15.36.59.png

A green notifier will appear once this has been successfully installed.

Screenshot_2022-05-19_at_14.58.52.png

 

Next, let's find the Smartling App in your widgets, and connect the Smartling App to your Contentstack Connector project in Smartling.

Connect the Smartling App to Smartling

The following steps must be completed by a Smartling Account Owner or Project Manager user:

  • Go to the stack you selected to install the Smartling App to
  • On the left navigation, click Entries 
  • Click on any entry you want to translate
  • On the right navigation, click Widgets
  • From your installed app list, select the Smartling App
  • If it's your first time using the Smartling App, you will need to connect to your Contentstack Connector project in Smartling, by clicking configuration page

Screenshot_2022-05-17_at_15.36.02.png

  • This will open a new tab in your browser where you can log into Smartling using your Smartling credentials. Once logged in, you will see the following page:

Screenshot_2022-05-17_at_15.30.10.png

  • Simply close this tab and return to Contentstack, where you must choose which Smartling project to submit content to.
  • Ensure this project is a live Contentstack Connector project, which correct language mapping
  • Once you have selected a project from the dropdown, click SaveScreenshot_2022-05-17_at_15.30.22.png

Now you're ready to translated entries from Contentstack!

Submit Content for Translation

The following steps can be completed by any Contentstack user who has access to the specific stack:

  • Go to the stack you selected to install the Smartling App to
  • On the left navigation, click Entries 
  • Click on any entry you want to translate
  • On the right navigation, click Widgets
  • From your installed app list, select the Smartling App
  • Click Request Translation to create a Job in SmartlingScreenshot_2022-05-17_at_15.38.01.png
  • The Request Translation two-step wizard will appear for you to enter the Job details. You can choose to create a New Job or add the asset to an Existing Job.
  • Insert the Job Name - the title for the translation task in Smartling.
  • Ensure the asset selection is correct. Click the X to remove any asset listed.
  • Choose to include Related Assets. For more information, see the links guide.
  • Insert a description for the linguists, if desired.
  • Select the Target Languages.
  • Click Save Job and Continue to create the Job in Smartling.

Screenshot_2022-05-17_at_15.38.38.png

The next step will display the Job Processing.

Screenshot_2022-05-19_at_15.00.40.png

  • Once the processing is complete, the Job details will appear. This means that the content has been successfully submitted to Smartling. Simply click Back to view the progress of each language in the Job

Screenshot_2022-05-19_at_15.00.58.png

Authorize the Job

The following steps must be completed by a Smartling Account Owner or Project Manager user:

Once your content has been submitted to Smartling, an Account Owner or Project Manager user can find the Job in Awaiting Authorization on the Jobs Dashboard. Once Authorized, you can monitor the translation progress for each language in the Job, directly from the Smartling App in Contentstack.

Screenshot_2022-05-19_at_18.19.07.png

Monitor Translation Progress from Contentstack

The following steps can be completed by any Contentstack user who has access to the specific stack:

  • If you want to add another language to the Job for that entry, simply click Request Translation and add the content to the existing Job.
  • Once translations are complete, the Smartling Status will indicate a green COMPLETED.

Screenshot_2022-05-19_at_18.15.02.png

View & Publish Translations in Contentstack

The following steps can be completed by any Contentstack user who has access to the specific stack:

  • To view the translated entry, click the language dropdown and select a language

Screenshot_2022-05-19_at_18.21.55.png

  • Choose to Publish this translated entry in Contentstack when it's ready

Screenshot_2022-05-19_at_18.23.03.png

Unpublish Translations in Contentstack

The following steps can be completed by any Contentstack user who has access to the specific stack:

Unlocalizing the entry will prevent the translations being applied to the entry, and revert the copy to the source language. To undo this action, simply click Save and the entry will localize in the target language. unpublish trans

Screenshot_2022-05-19_at_18.25.51.png

Was this article helpful?