Locale: Configuring the Directus Connector

Owned by Bartosz Lewandowski
Last updated: Sept 18, 2024 by Damian Rozmiarkowski
4 min read

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 is 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 will need to get started

  1. The login link for Locale.

  2. The login link for your Directus instance.

    1. 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.

  3. User login information for both your Locale instance, and your Directus instance.

    1. 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

  1. Start by accessing Locale, and choosing to login (instructions can be found here: Locale: Accessing your Locale instance) with your username and password.

  2. Once logged into Locale, we are greeted with our Dashboard, which looks something like this image below.

General Login 001.png

  1. 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.

Directus Config 001.png

  1. Next, the connector configuration process will require 3 pieces of information: the Domain URL, Admin API token, and Collections list.

    1. The Domain URL is the Domain URL which is used to log into your Directus instance.

    2. To find the Admin API token:

      1. Access your Directus instance with the admin username and password.

      2. Select the User Directory menu on the left.

      3. Select the Administrator user.

      4. Choose the user, and scroll down to the Admin Options.

      5. From here, you can copy the Token API information.

c. To find the Collections list.

i. Access your Directus instance with the admin username and password.

ii. Select the Content menu on the left.

iii. Make note of the content types which require content for translation, and paste these into the Locale instance, separated by a comma (without spaces).

a) In our example, and in video here: Locale: Directus Demos and Recordings, we have highlighted content in our Articles and Pages sections.

  1. 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 are ready to create a project in Locale.

  1. Start by selecting the source and target languages for your project, and select Add Project.

    1. Note: the target languages must also be enabled in your Directus instance for the translations to be properly inserted in your required projects.

  1. Locale will automatically connect to your Directus instance, and perform an analysis on the content that needs to be translated.

  1. Once the content has been analyzed, Locale will display the number of words and segments which require translation.

  1. 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.