Locale: Configuring the Joomla! Connector

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

Introduction

Our connector with Joomla! aims to bring speed and agility to the future of localization. This innovative connector redefines automation, effortlessly orchestrating translation workflows between all the languages in your system. Connect your Joomla! instance to Locale and in no time you will be receiving consistent and accurate localization content for every page or article in your system, right when you need it.

What you will need to get started

  1. The Login link for Locale.

  2. The login link for your Joomla! instance.

    1. Note: This is provided to you by your Joomla! account manager, support team, or contact person. If you are unsure of this information, please contact your system administrator or your Joomla! representative.

  3. User login information for both your Locale instance, and your Joomla! 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 Joomla! Connector

  1. Start by accessing and logging into Locale with your username and password.

  2. Once logged into Locale (instructions on that can be found here: Locale: Accessing your Locale instance), 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 Joomla!

Joomla - Locale App Store.png

  1. Next, the connector will require 2 pieces of information: API Key Information and the Domain URL for your instance.

  1. To find the API Key, it must originate from the user account of a Super Admin user, this way the appropriate read and write functionality will be possible. To find this information, follow these steps:

    1. Access your Joomla! instance with a super admin username and password

    2. Using the menu on the left, select Users → Manage → and the User Name of the Super Admin which you have used to log into Joomla!

c. In the user profile, select the Joomla API Token tab, and then copy the API token information, and paste it into Locale.

d. Note: If you do not see the API Token tab, you likely did not enable the User – Token plugin, go back to the Plugin Manager page and make sure the plugin is enabled. For more information on how to do this, see our article on Locale: Technical prerequisites for configuring the Joomla! connector.

e. To find the URL link, simply copy and past the URL of the Joomla! instance which requires translated content, making sure to remove any trailing slash marks, otherwise this will cause an error in project creation. Example:

  1. Select next to continue with the process of Creating a Joomla! project in Locale.

Creating a Joomla! project in Locale

After configuring the Joomla! 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.

Note: the target languages must also be enabled in your Joomla! instance for the translations to be properly inserted in your required projects. If you have not done this already and need some help, see our article on the Locale: Technical prerequisites for configuring the Joomla! connector.

  1. Locale will automatically connect to your Joomla! 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. Choose the Push Content button in the top right corner of the page to choose the translation resource you would like to use: TMS, Contact Person, or MT engine. (Our example shows translation with MT) and push the content for translation.

  1. Locale will automatically begin the translation process according to the selected resource, and show the In Progress status.

  1. When the translations are complete, Locale will update the status with the Complete status indicator, and place all of the translated content back into your Joomla! instance.