Table of Contents
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’ll be receiving consistent and accurate localization content for every page or article in your system, right when you need it.
What you’ll need to get started
The Login link for Locale (https://app.locale.to/en/)
The login link for your Joomla! instance.
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.
User login information for both your Locale instance, and your Joomla! 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 Joomla! Connector
Start by accessing and logging into Locale with your username and password.
Once logged into Locale (instructions on that can be found here) 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 Joomla!
Next, the connector will require 2 pieces of information: API Key Information and the Domain URL for your instance.
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:
Access your Joomla! instance with a super admin username and password
Using the menu on the left, select Users > Manage > and the User Name of the Super Admin which you’ve used to log into Joomla!
In the user profile, select the Joomla API Token tab, and then copy the API token information, and paste it into Locale.
Note: If you don’t 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 Technical pre-requisites for Joomla!
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:
www.example.joomla.com = acceptable
www.example.joomla.com/ = not acceptable
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’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 Joomla! instance for the translations to be properly inserted in your required projects. If you haven’t done this already and need some help, see our article on the Technical prerequisites for configuring the Joomla! Connector
Locale will automatically connect to your Joomla! 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.
Choose the Push Content button in the top right corner of the page to choose the translation resource you’d like to use: TMS, Contact Person, or MT engine. (Our example shows translation with MT) and push the content for translation.
Locale will automatically begin the translation process according to the selected resource, and show the In Progress status.
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.
