Connect Contentful with Smartcat

Contentful integration with Smartcat | Smartcat Help Center Contentful allows you to create, update, and distribute content for your website, a mobile app, or any other content-displaying medium. When using the integration between Contentful and Smartcat, you can send content from the former to the latter, translate it, and then request that the translation be returned upon completion. The integration currently supports all Contentful fields enabled for localization, which are all fields with Enable localization checked in Settings. Setup 1. Install the app via this link: https://www.contentful.com/marketplace/app/smartcat/ 2. Select Contentful Space and Environment to connect Smartcat to. 2. Click Install and Authorize access on the screens that follow. 3. On the final screen, click Install and Connect to your Smartcat account. Select your Smartcat Workspace. 4. Now everything is ready to configure Smartcat App as a sidebar widget for certain content types that you want to translate via Smartcat. But before that, familiarize yourself with the possible approaches to content localization in Contentful and how to prepare your content models for localization. Creating content 1. Go to the Content tab, click Add Entry and add a new entry. Alternatively, you can open an already existing content piece and skip the content creation step. As an example, we'll be creating an entry of Product Description (Multilingual) type. 2. Wait until the Smartcat Translator in the sidebar loads. You will receive a notification that your content model was updated. 3. Reload the page to see the Languages field. What happened here is that Smartcat detected a missing Languages field, and added it to the content model, populating it with the list of languages in your Contentful Space. You will use this field to determine which languages this particular piece of content needs to be translated to through Smartcat. Note that the Translation section that is provided by Contentful and shown in the sidebar doesn’t control the list of languages in the object in any way — it just allows you to show or hide some languages in the content editor. 4. Create the content. Add the title for the multilingual content entry, and the content for the product description itself. 5. Go back to the main content object. You will see that the English version references the newly created content of Product Description (Single Language) type. Translation process 1. Enable one or more languages for translation. Make sure that your changes were saved (check the Last saved… status under the Publish button in the sidebar). 2. Pick an existing project or choose to create a new one automatically. 3. Choose a translation workflow. You can choose to either translate the content fully automatically (AI translation), automatically with human editing on top of it (AI translation + Human review option) or manually (Human translation). 4. Click Send to Smartcat button in the sidebar. 5. After synchronization is complete, Smartcat App will show links to the project and specific language files. 6. Follow the links displayed in the sidebar to open the project in Smartcat or open individual files directly in the editor for the selected language. 7. When editing is done, go back to Contentful and request the translations by clicking Get translations from Smartcat. Translation progress information will be updated automatically. Smartcat will notify you when translations have been received. 8. Now you have the translated versions of your object. Smartcat has created a new content of Product Description (Single Language) type and referenced it from the main object: Click on this object to see its properties. Every field that was marked as localizable now has translations.

Translate your website content

Website content translation | Smartcat Help Center With Smartcat Website Translator you can automatically translate your website into any language on the fly and then, if necessary, adjust the translation, polish it, and bring it to perfection with manual edits. Let's delve into details and see how it's done. Automatic translation To translate your website into any language, proceed as follows: In your browser, open https://www.smartcat.com/website-translator/ an procceed to log in/sign. Skip this step if you are already in your Smartcat account. Select to translate website on your account homepage.  3. Enter the URL of your site to the form above and specify the source ( from ) and target ( into ) languages. You can translate the site to multiple languages, therefore the into field accepts multiple values. 4. Smartcat will create a translation project which you'll be able to find on your Projects page. All the translation options including editing and professional review are available for this project. 5. You can adjust the preview settings using the gear icon at the upright corner of the screen. The available options are:Translation mode. Here you can choose how the translation will be rendered for your website visitors. Language selector. Here you can choose how to locate the language selector to best fit your website design. Preview settings. Here you can select to start the translation of a page as soon as you enter it. Publish settings. Here you can decide which languages to publish. This option comes in handy when your website is being translated to multiple languages and not all of the translations are ready at the same time.  5. When you switch to a new language, the site is rendered in the original language and the Start translation button appears in the toolbar. Click it to have the site translated to another language. Note that your Smartwords balance appears in the toolbar and is instantly updated to keep you aware of any changes. In addition to automatically translating your website, Smartcat allows you to edit the resulting translation and tailor it to a particular vocabulary or cultural and social preferences of the specific target audience. Editing Click the Edit button in the toolbar to open the translation you've just previewed in the Smartcat Editor. After you've made all the required changes in the Smartcat editor, click x in the Editor toolbar above. It redirects you to the website preview that reflects all the recent edits.  Note that the percentage of automatically and manually translated content is shown respectively in the buttons beside the Language field. To publish the translation hit the respective button at the top of your website page. Publishing To publish the translation hit the respective button at the top of your website page. A message will appear informing you that in order to publish the translated version of your website the following script must be added to the website header. Click Copy code to save the code in the buffer. Paste the code to a text file and send the file to your Web designer. Refer to this article for the detailed instructions for a Web designer. As soon as the code has been added, click Validate and continue. Smartcat verifies that the JavaScript snippet appears on each relevant page and publishes all the existing automatic and manual translations. Publishing means that snapshots of each translated page from your website are gathered and stored in a cloud. The embedded script retrieves and displays them. Whenever a visitor accesses your web page and switches to another language, they will not be hitting Smartcat to dynamically download the translations, but they will be getting static snapshots. The Smartcat script injected to your website code not only retrieves and displays all the available translations, but also renders a selector that your site visitors will use to switch to the required language.

Connect Drupal with Smartcat

Drupal integration with Smartcat | Smartcat Help Center With Smartcat and the TMGMT connector, you can send content from Drupal to Smartcat for translation, manage the translations in your Smartcat account, and then send them back to Drupal. What you need TMGMT moduleSmartcat pluginCron manager module To install the TMGMT module: 1. Download the ZIP-archive or copy the tar.gz download link from the official website. 2. Enable the Update Manager Module in the Admin panel of your Drupal website by ticking the relevant box. 3. Select Add a new module and paste the link into the archive/upload the archive into the window that opens. 4. Choose Enable recently added modules from the Next Steps list and select the modules used by TMGMT in the Translation Management section. Click Proceed . Select the languages you want to work with in the Language and Region settings of your website. In case of success, you will see new “Translation” tab in the Drupal interface. To install the Smartcat module: 1. Download the ZIP-archive or copy the tar.gz download link from the official website.2. Add it to your website as a new module as described above.3. Enable the Smartcat Translator by ticking the relevant box in the Translation Management section. To install Cron manager module: Download the ZIP-archive or copy the tar.gz download link from the official website.Add it to your website as a new module as described above.Enable the Ultimate Cron by ticking the relevant box in the Other section. Setting up the integration In your Smartcat account:1. Navigate to Settings- >API on the left-hand side menu to generate an API key.2. Click Create New Key to open the following dialog:3. Copy the API key as well as your account ID. On your Drupal website:1. Navigate to the Providers tab in the Translations section of your Drupal website and select Smartcat.2. Paste your API key and the account ID into the corresponding sections, and select your preferred server.3. Click Save. In case of success you might see confirmation message: The translation process There are 2 ways to set up the translation workflow: On Demand Translation – to manually send required articles for translations.Continuous Translation – automatically send each newly created or updated article (of the specified type/s) as a new job item  to the preconfigured translator. On Demand Translation setup 1. Navigate to Structure -> Content Types and select Operations -> Edit for each content type you want to translate. 2. Navigate to the Language settings tab and select Enable translation and Show language selector for these content types. 3. The selected sources will be available in the Sources section of your Providers tab. 4. Tick the ones you want to translate right away, select the source and target languages and click Request translation. 5. Select Smartcat as your translation provider and submit the job*. *Please note that a job is created for each target language. To translate one text into several languages at once, tick the relevant box. 6. Smartcat will create a project for each job you submit. These are also available in the Jobs section of your Drupal website. You can monitor the progress of translations in the Translation Job Messages. 7. To complete the job, approve all the selected segments in Smartcat. 8. To push the translations back, enter the relevant job on your Drupal website and click Download translations. 9. Enter the job, approve the translations and click Publish . The target language version of your article will be generated and published. Translating custom fields 1. Navigate to the Content types section of your website’s Structure, and add a new field for the material you want to edit. 2. Select the type of field, e.g. plain text, list or image. 3. Fill in the rest of the data, e.g. Alt-text, category, or tags, and click Save. 4. Return to the Configuration section and tick the fields you want to translate, e.g. title, tags, etc.* and click Save. If you tick no fields, only the title will be translated. *Please make sure the fields you select can be translated. 5. Submit the material for translation as described above. Review the translations in the Editor* and push them back to Drupal. *The only field that can’t be translated for now is the Category field as it’s uploaded from Drupal as a numeric value. Continuous Translation setup Go to the main translation page by clicking "Translation" from the toolbar Make sure there is a configured continuous translator on the "Providers" page. In this case, it is the Smartcat provider. Open "Jobs" menu tab and click on "Add continuous job" The page provides several configuration options including translator selection, label, source and target language. By default, the continuous settings block displays a list of content types available for translation. Click "Save job" to complete the process. Each newly created article (of the selected type/s for continuous translation) will be automatically created as a new job item and sent to the preconfigured translator. The continuous translation process is provided via a scheduler thanks to Cron. TMGMT and Smartcat provide special scheduler tasks that will automatically send and receive translation from Smartcat. These tasks will be automatically launched thanks to Cron, which will automate the localization process. Continuous Translation setup First, you need to make sure that the Ultimate Cron module is installed. Ultimate Cron extends Drupal’s native cron features and expands control over repeating jobs. The following manual will explain how to enable translation jobs to run repeatedly. Go to the TMGMT settings page, “Translation” > “Settings”. Enable “Submit continuous job items on cron” option placed under “Performance settings” block. We recommend specifying the value 5 in the "Number of job items to process on cron" field. This is the number of jobs that will be processed in one iteration of continuous translation. In other words, this is the number of documents that will be uploaded to Smartcat at one time. Make sure Ultimate Cron is enabled. “Extend” > “Install new module” enables site administrators to install new modules. Go to “Configuration” > “Cron” > “Cron Jobs”. It provides an overview of available cron runs. Look for “Default cron handler” provided by “Translation Management Core” and “Smartcat translator” and click the “Edit” button. a. Translation Management Core: Responsible for submitting and updating translations in the Smartcat project. b. Smartcat translator: Responsible for receiving translations from Smartcat, as well as importing into Drupal. The Cron edit page provides several settings related to the TMGMT cron job. Using the “Run cron every” option, it is possible to set an interval for the cron job to run on. Make sure the cron job is enabled and finish the process with “Save”. If you have added a continuous job and configured Cron, the continuous localization process will start working. The Cron tasks that were described above will run automatically depending on the interval that you specified. For testing purposes, you don't have to wait for Cron to run the necessary tasks, so you can use the "Run" button that each task has separately. Automatic run of cron tasks In order for tasks to automatically run every minute or every 15 minutes (depending on the settings), you need to ensure that the Cron trigger is always running. Go to Configuration → System → Cron → Run cron. Here you will find a special link that you can follow to run Cron. We recommend setting up this link to be called automatically every minute so that tasks run consistently. To do this, you need to go to your server settings. If you are using Linux, then run the command: Save your changes. Now the cron scheduler will automatically send a request every minute to the link you specify, which will ensure stable running of tasks. How to check if everything works Let's imagine that you have 10 articles that are in your continuous job. When you run a cron task from Translation Management Core, the first 5 articles will be sent to Smartcat. There is currently no option to select an existing project in Smartcat. Therefore, if this is the first content submission, the project will be automatically created and linked to the continuous job. In the future, all content will go into this project. In the "Translation -> Jobs items" tab you can find articles sent to Smartcat; they will have the status "In progress". Job items with the status "Inactive" are those that are waiting to be sent to Smarcat. Don't forget to filter items by the "states" parameter. If you run the cron job from Translation Management Core again, the following 5 articles (which are in Inactive status) will be sent to Smartcat. Sending in batches is necessary in order to avoid "timeout" problems during task execution. This way you can run the cron job until all documents are sent to Smartcat. As a reminder, this will happen automatically if Cron is configured. Now let's translate one of the articles into Smartcat and try to get the translation back into Drupal. Now, in order to get translations back into Drupal, you need to run a cron task from Smartcat translator. This task will automatically receive all job items that are in the "In progress" status and try to get translations from Smartcat. Articles that have been translated and successfully imported into Drupal will receive an "Accepted" status. Did this article help you find the answer you were looking for? If not or if you have further questions, please contact our support team.

Connect Zendesk with Smartcat

Zendesk integration with Smartcat | Smartcat Help Center Learn how to connect, configure and use Zendesk within a Smartcat project. Zendesk is a cloud-based help desk management solution for building customer service portals, knowledge bases and online communities. The Smartcat Zendesk integration allows you to manage the translation of your Zendesk help center content. The source and, optionally, translation data is automatically or manually pulled to Smartcat, and translated content is then sent to Zendesk. 1. Pre-requisites Prior to setting up the Smartcat Zendesk integration collect the following parameters:Zendesk URLZendesk email addressZendesk API key To collect this information, proceed as described below. 1.1. Zendesk URL This is the URL of your Zendesk domain as displayed in the address field of your Zendesk instance homepage, for example, http://smartcat.zendesk.com/. 1.2. Zendesk email address The primary email address associated with your Zendesk profile and specified in your Zendesk account. Note that in Zendesk content access permissions depend on the account. Therefore, the integration will have access only to the content available to the account whose primary email address you provide. To find your Zendesk email address:Log in to Zendesk.Click your profile icon in the upper-right corner of the page header, then select View profile.On the left sidebar of your profile, you can view the information related to your account. Copy the address in the Primary email address field and save it. 1.3. Zendesk API Key The API token used to as part of two-factor authentication for the integration. To generate an API token, complete the following steps:Log in as an administrator.Click the gear icon in the sidebar, then select Channels > API.Click the Settings tab, and make sure Token Access is enabled.Click Add API Token.Enter a name for the token, and click Create. The token is generated, and displayed in a pop-up window.Copy the token and paste it somewhere secure. Once you close this window, the token will never be displayed again. Configuring the integration To configure the Zendesk integration, log in to Smartcat and complete the following steps.Create a new integration project as described here.In the Integrations tab, click Connect in the Zendesk integration tile.Paste the Zendesk URL, Email address and API key that you collected as pre-requisites.Click Create Integration.The Import Translations page is displayed. If Smartcat finds pre-existing translations of source articles, you can review them by clicking Import Report.- To import a translation, check the respective checkbox and click Import.- To pull the source content only, uncheck all checkboxes and click Import. 1.4. Using the integration If the integration is created successfully, the content of your Zendesk help center is synchronized with the current Smartcat project and all the documents stored in the folder appear as Smartcat project documents. If the landing page of your help center has buttons or tiles with section names, those names will appear in a separate file called headlines.json_en. After an article translation is completed, return to the integration settings, open the Settings tab, enable the option Push translations back and click Sync Now. The target segments will be pushed to Zendesk. If new source segments were added to the integrated space since the previous sync, the Smartcat documents will be updated accordingly. By default, a sync disregards incomplete translations. You can, however, instruct the integration to include them in every sync by enabling the option Publish incomplete documents. Instead of explicitly performing sync by clicking Sync Now, you can schedule a sync at the required intervals. To do this, click on Do not repeat and select the appropriate option from the drop-down menu.

Install Smartcat Translator for Chrome

Smartcat Translator installation for Chrome | Smartcat Help Center Smartcat Translator is an extension for the Google Chrome browser that can translate website pages in a flash. With Smartcat Translator you can not only view website content in various languages, but also translate incoming emails and your replies, or social media posts. As a prerequisite to using Smartcat Translator, make sure that you have a corporate Smartcat account and know your username and password, because you will be prompted to authenticate prior to using the extension. If these requirements are fulfilled, open this link and proceed as follows: Click Add to Chrome.When prompted to confirm that you want to proceed, click Add extension. Smartcat Translator now appears in your list of extensions: Open any Web page.Click on the Extension icon in the top right and open Smartcat Translator. You can always pin it for quick access.Click Let's get started to log in to your existing corporate Smartcat account.  6. If you have successfully authenticated and logged in, you will be redirected back to the page where the Smartcat Translator was opened. 7. In the plugin, specify the required Source text and Target text languages. In the example below, Autodetect is enabled for the source language and German is selected for the target language. 8. Select any text on the page or type free text in the Source text field, and click Translate. The translation to the selected target language will immediately appear in the Target text field. 9. To use the translation in another document or edit it in an editing tool, click Copy translation icon. The translation will be copied to the buffer. Frequently asked questions Is there a character limit for the content to be instantly processed through the extension? No, the character count is unlimited. Is there a link between the extension and the Smartwords balance on our corporate account? Yes, the link exists as this extension consumes Smartwords. Is the data processed through the extension secured and not used by MT vendors? The data that passes through the extension is not exposed to any third party and remains completely secure at all times. What is the maximum number of simultaneous users? The number of simultaneous users is unlimited.