Table of Contents
Introduction
The Directus connector from Locale aims to harness the power of automation and apply it to your translation workflows. Our connector can seamlessly integrate your Directus instance and it’s translatable fields to Locale for fast, easy, automated localization and internationalization workflows. Easily send your content to your trusted TMS, contact person, or LSP of choice for quick and easy processing.
What you’ll need to get started
The login link for Locale (https://app.locale.to/en/)
The login link for your Directus instance.
Note: This is provided to you by your Directus account manager, support team, or contact person. If you are unsure of this information, please contact your system administrator or your Directus representative.
User login information for both your Locale instance, and your Directus instance
A trial account of Locale can also be taken for free by going to locale.to and selecting the “Get Started” button
Configuring the Directus Connector
Start by accessing Locale, and choosing to login (instructions can be found here) with your username and password.
Once logged into Locale we’re greeted with our Dashboard, which looks something like this image below.
Next, select the Add Project button from the dashboard. This will populate a list of connectors which can be used for our project. From this list, start by selecting the CMS filter on the left side, and choosing Create Project under Directus
Next, the connector configuration process will require 3 pieces of information: the Domain URL, Admin API token, and Collections list
The Domain URL is the Domain URL which is used to log into your Directus instance
To find the Admin API token:
Access your Directus instance with the admin username and password
Select the User Directory menu on the left
Select the Administrator user
Choose the user, and scroll down to the Admin Options
From here, you can copy the Token API information
To find the Collections list
Access your Directus instance with the admin username and password
Select the Content menu on the left
Make note of the content types which require content for translation, and paste these into the Locale instance, separated by a comma (without spaces).
In our example, and in our Demo Video, we’ve highlighted content in our Articles and Pages sections
Select next to continue with the process of Creating a Directus project in Locale
Creating a Directus project in Locale
After configuring the Directus connector to your Locale instance with the steps above, you’re ready to create a project in Locale.
Start by selecting the source and target languages for your project, and select Add Project.
Note: the target languages must also be enabled in your Directus instance for the translations to be properly inserted in your required projects.
Locale will automatically connect to your Directus instance, and perform an analysis on the content that needs to be translated.
Once the content has been analyzed, Locale will display the number of words and segments which require translation.
Select the green “Push Content” button in the top right corner to choose from your options of sending content to your LSP of choice, TMS system, or an MT engine for processing.