If you are new to Joomla, you can check out our detail guide on extension installation
After installing the component successfully, access the configuration of the component. Login to your Joomla site (administrator), select Components >> JA Multilingual.
When you first install the component, it is required to add your BING API Client ID and and secret key. If you do not have a Bing account you can always register for a free account.
Supported Translation Languages
JA Multilingual Component supports translating 41 languages.View Full List
Select translation services
JA Multilingual component supports 2 of the popular translation services: BING and Google.
In the admin panel of the component, click on the Option button
When select a translation service, you need to add key for that service. We will show you steps to get the key in the 2 sections below.
Get BING API for Free
Follow the steps below to get BING API for free.
Step 1: signup a Mircosoft account
Access the link https://signup.live.com/ and sign up a Microsoft account.
Step 2: login Azure marketplace
Access the link https://datamarket.azure.com/ with the registered Microsoft account at./p>
Step 3: get your key
Now access the link https://datamarket.azure.com/account/keys to get your account key.
Step 4: register a new application with your key
To register a new application with your key, access this link https://datamarket.azure.com/developer/applications. Add the client ID and name. For Client secret, it will be auto added, you can change it if you want.
You can create unlimited applications.
Now, click on Edit button to get your Client ID and Client Secret.
Step 5: Register Bing translation service
Now open this link: https://datamarket.azure.com/dataset/bing/microsofttranslator, register a Bing translation service package. It provide free package that allows you to translate 2.000.000 characters per month. If your site db is too large, you can select a premium package.
You can see your translation quota any time by access the link: https://datamarket.azure.com/account/datasets. Before translate, you should check the quota to make sure it's enough for your translation.
Get Google API
Step 1: Create a new project
Create a new project in Google Cloud Console
Login with your google account, follow this link https://cloud.google.com/console#/project, to create new project.
Then you have to verify by phone. Once done, new project is created.
Step 2: Enable Translate API
Go to project, on the left column APIs & auth >> APIs >> Translate API then enable it.
Step 3: Register App and new API key
Go to project, on the left column APIs & auth >> Credentials
Create new Client ID
Click New client ID to create new client ID, select Web Application flatform
Create new API key
After register App, go ahead to create new API key, click on Create new key button.
Add url then click on Create.
Now copy the created API key.
Step 4: Billing
Google Translate API v2 requires billing information for all accounts before you can start using the service. See instructions below to enable billing.
1. Usage Fees:
- Translation: $20 per 1 M characters of text, where the charges are adjusted in proportion to the number of characters actually provided. For example, if you were to translate 500K characters, you would be billed $10.
- Language Detection: $20 per 1 M characters of text, where the charges are adjusted in proportion to the number of characters actually provided.
2. Usage limits:
- Google Translate API has a default limit of 2 M chars/day. You can increase this limit up to 50 M chars/day in the Cloud Console by following the instructions below.
- If you need to translate more than 50 M chars/day, please request at Google Translate API v2 Feedback
To enable billing for your project, go to project, on the left column Settings >> Enable Billing >> Fill the info and complete your transaction.
Step 5: View/change user limits
To view or change usage limits for your project, or to request an increase to your total limit, on Google Cloud Console, select a project >> APIs & auth >> Translate API.
On the API's info page, select the Quota link near the API name.
These are how-to steps to translate a language.
1. Install languages to be translated to
If the language you want to translate to is already installed in your site then you can skip the installation, and go ahead with the translating.
In case the language is not installed in your site, you can select to install from the JA Multilingual component admin panel by clicking on the Install More?
Now, select the language you wish to install then click on theInstall button..
2. Change default language (if necessary)
The language to translate from is your site default language. Please make sure you have the correct default language before you translate. You will have to undo all translation if you plan to change the default language later on. You can also change the language to translate from by changing your site default language.
Click on the Change button.
Now set the new default language for your site.
3. Translate languages
So now we already get all the initial set-up done, let's start translating the languages. Click on the Translate All button and let the magic works.
You can see the progress of the translation in the translation progress window, you can also keep track of whether or not the translation is successful.
If there are some elements in your site which somehow cannot be translated. You would see the failed message and that is pretty normal. Don't worry about it!
If an error occurs with a request, the API returns an HTTP status code and reason in the response based on the type of error.
Enable "language switcher" module
1. Enable Plugin: System - Language Filter
Navigate to: Extensions >> Plugin Manager then find plugin named: System - Language Filter
Then configure the plugin as our suggestion in the screenshot below.
2. Add module: Language Switcher
Navigate to: Extensions >> Module Manager then click on New button to create new module. In the appeared popup, select module: Language Switcher
Set the position for the module
We keep the default settings for other fields, you can configure as you wish but for default settings, the module works fine.
Please assign the module to All languages so that when you switch to any language, the module is enabled.
Manage Content (Manual translation)
Step 1 Open Association Manager
After auto translation, you may want to update translation manually, we have made it pretty easy in this extension, from the back-end of the JA Multilingual Component, select Association Manager then select content type.
Step 2 Edit associated content
Now check the content box that include the title and its associated items of translated languages, click on Edit to fix the content in the language.
Now open the item to customize its content.
If you want to change association of the item, open the Association of the item the change
This is new feature in version 1.0.4. So if you want to use this feature, you have to upgrade to the version. View changelog of version 1.0.4: http://pm.joomlart.com/browse/JAECLANG.
This features comes handy in case you want to remove the translations or want to start over. Please note, this results in loss of translated content. Please take backup before removing content.
When translations for one language is removed, the translated content will be removed from the default Joomla extensions as well as from any other supported 3rd party extensions.
- Content - Categories
- Web Links
- Content - Articles
- News Feeds
- Menu Types
Steps to remove translation of one language. We will remove translation of Arabic as a live sample. It's the same for any other language.
Step 1: take backup
Once you remove translation, content will be gone forever so it requires you to take backup before you remove translation.
Step 2: remove translation
Now hit the Delete button of language you want to remove its translation.
Translation of Arabic language has been removed successfully.
Step 3: uninstall language
This step is to uninstall language. If you don't want to uninstall language, just remove translation, you can ignore the step.
To uninstall a language, we need to delete content language and uninstall language package. In the Remove translation panel, you will see a note, it includes links to the Language Manager: Content languages and Extension Manager: Manage panel.
Remove language content
Access Language Manager: Content Languages panel by go to Extensions >> Language Manager >> Content.
Or add the following link just after your site administrator url.
Remove language package
To access "Extension Manager: Manage" panel, go to Extensions >> Extension Manager >> Manage. Search for language package then uninstall.
Or add the following link just after your site administrator url.
This is how-to video tutorial that shows you all steps to install, configure the component and translate.
If you still have trouble, feel free to ask us in discussion forum.