Drupal

Drupal is an open-source CMS used by millions of websites. You can find more information about Drupal at this link.

Installation

In order to use Smartcat with Drupal, you need to install the Smartcat Translation Manager module. You can download it from this link

You can find information on installing modules in Drupal at this link.

You now need to link the Drupal account to your Smartcat account. If you don't have one, please go to smartcat.ai to create a new account. Next, go to Settings>API on the left-hand menu to generate an API key.

mceclip0.png

Click on Create New Key which opens the following dialog:

mceclip1.png

Choose a unique name, preferably something that will identify the Drupal account since you can have more than one account linked to your Smartcat account, copy the key using the button on the right of the key and click on confirm. You cannot view and copy that key later on so make sure to use it right away in WordPress or paste it in a document that you can refer to later. 

Back in Drupal, select Smartcat Translation Manager in the Manage top menu and select the Configuration tab and enter your API credentials - your server location, your account ID and the API key you just created. Your account ID can be found on the Settings>API page of your Smartcat account and if you don't know your server location, please contact our support team. Click on Save configuration.

mceclip0.png

Setting up

The first step needed once you have completed the installation process is to set up languages for the site. In the Drupal top menu, select Manage and then Configuration. In the Regional and Language section, select the Languages option.

mceclip0.png

The list will display languages available in the current configuration and specify the default language. To add a language, click on +Add language and pick the appropriate language in the drop-down list in the next page. Click on Add language.

mceclip1.png

mceclip2.png

Drupal will look for any available interface translation for the site (if any) and will also indicate the status of that interface translation. The order of the languages in the list will be reflected in the Language Switcher that can be added to the site where users can pick a language to view the articles (see below in Displaying the translation). 

Once you have selected your languages, you can set up translation profiles. Smartcat lets you define how your documents will be processed - from language choices and workflow. 

To set up profiles, select Smartcat Translation Manager in the Manage top menu and select the Profiles tab.

mceclip3.png

This will take you to a page that displays existing profiles (if any) or allows you to create new ones.

mceclip4.png

To create a new profile, click on +Add Profile. You will be presented the following options:

mceclip5.png

First, select a name for the profile that you are creating. If you don't, a name will be generated automatically. With the next two options, you can select your source and target languages. More than one target language can be associated with a profile. The language list will be limited to the languages you have implemented in your Drupal account. The Vendor option lets you decide if jobs created using this profile will be managed from your Smartcat account (for example, task assignment) or if they will be delegated to a vendor associated with your account. This can be helpful if you are working with an LSC for certain languages. Selecting workflow stages will then let you control the translation process - you can customize this based on the level of quality needed. Note that it is possible to create different profiles to translate into the same languages as quality requirements might vary for different content. Click on Save configuration to save the profile. Existing profiles can be edited from the profile list using the options listed on the right.

Translating

Using the Smartcat Translation Connector, you can translate articles, basic pages, and custom content. Basic pages are generally more static content like the About Us or Contact sections. Articles are more dynamic information on the site. Custom content will vary between sites. 

To start a translation project, go to Manage > Content from the top menu:

mceclip6.png 

You can filter the listing to display only the type of content you want to process. From the listing, select the content to be translated by checking the box to the left of the name (or select all from the top of the list). Then from the Action drop-down menu, select Submit for translation. Then click on Apply to selected items.

mceclip7.png

The next page will ask you to confirm the settings for this project. You can verify that the content listed is what you need translated and choose from the pre-defined profiles. Then click on Confirm to start the process. Or Cancel if you need to make changes.

mceclip8.png

Once documents have been submitted for translation, they will appear in the localization dashboard that is accessed by clicking on Smartcat Translation Manager > Dashboard in the top menu and their status will be updated using the information received from the connected Smartcat account.

mceclip9.png

Smartcat and Drupal synchronize on a regular basis so a project might not be created immediately in the Smartcat account. It could take a couple of minutes.

The dashboard displays the document name, the source and target language for the project, the status of the project and a link to the document in the Smartcat editor. The status will change from Sent to Smartcat to Translating in Smartcat to Completed. Once a document is marked completed in Smartcat, it will also be marked as completed in the dashboard and a draft version of the translation will be added to the Drupal account. The document must still be published after review.

Projects created in Smartcat using the connector can be processed like any other project but before proceeding with translation, resources such as translation memories, glossaries, and machine translation engines should be specified, pre-translation rules should be defined and statistics refreshed to reflect the additional linguistic assets. The project manager can then assign tasks as needed. 

Displaying the Translation

The Language Switcher can be activated by selecting Manage > Structure in the top menu and then Block layout. This page will display the different page regions where the information can be displayed. If Language Switcher is not present in any of the existing regions, click on Place block and pick Language Switcher from the list. You can change the location later on if you decide that it's not ideal for your users. The pre-header region is generally a good spot for this menu.

mceclip10.png