Joomla Translate (Sef Translate) is Joomla extension for automatically translation Joomla websites with help of Google, Bing (Microsoft Translator on Azure), Yandex translation API. This article show you How to configure Joomla Translate Pro version. At first glance the configuration of Joomla Translate may seem difficult, but all steps are described in details, so follow them and make your Joomla website multilingual. If you have free version of Joomla Translate, please read this tutorial How to configure Joomla Translate, Free version
3.1. Choose layout for module Joomla Translate.
There are 5 module positions: default (to use standard Joomla position), top, bottom, left and right.
In order to place Joomla Translate module in one of these positions you have to set any standard Joomla position and choose one of predesigned positions of Joomla Translate module.
3.2. Set translation method for your site
In Pro version of Joomla translate you may select Instant, jQuery, Redirect.
If you select Instant then your site will be translated without redirect when the user clicks on language flag or chooses language from the drop-down list.
If you select jQuery translation work will look like method before, but trsnslation will usejQuery JavaScript library and as install Translate API from Google or Bing. And if Instant will not ask money from you. jQuery will eat your translate quota
If you select Redirect then your website will be redirected and page will be opened on selected language.
If you use Redirect translation method and cache pages, when user is logged in Joomla, his page won't be saved in cache and translation method will be switched to jQuery. This option is necessary for security of user's data.
The redirect method - is best method for site SEO. You may create your site Map on every language which you need.
3.3. "Remember Language" you may set will need your site clients press "Translate" for every your site page. Or translation will do automatically.
3.4. Select whether or not show the message that page is not translated
3.5. Enter message that page is not translated
3.6. Use SEF URLs (only for Redirect method). This option is used for correct definition of URLs for translation. If you use search engine friendly URLs on your site, set Yes, if you don't use SEF URLs on your site, set No.
3.7. Hide module. Set to Yes in order to hide module from logged in users. Set to No in order to show module to logged in users. This is necessary to save translation quota.
3.8. Enter languages which you want to display in the form of flags on frontend.
3.9. Images from this module. If you want to merge flags from our Translate module and Joomla language Switcher, choose what flags will be displayed. Set to Yes if you want to display flag images from our Translate module (recommended).
3.10. Choose the size of flags. Available sizes: 16px, 24px, 36px, 48px, 64px
3.11. Choose style of flags (flat or shiny)
3.12. Choose style"how you want see languages for translate", You may select: Dropdown list, Dropdown list with flag, Plain text list, Text list with flag
3.13. Enter languages which you want to display in drop-down list on frontend. If you choose no language, drop-down list won't be shown on frontend. This option is available only if you choose default module position.
4.1. On tab "General" field "Main site language" . Select main language of your website.
4.2. Translation algorithm (By default 1). You need to check what algorithm works the best for your website.
4.3. On tab "General" field "No translate phrases" insert phrase or worlds which you want not translate.
4.4. If you don't want to translate some pages, enter their URLs in Untranslatable pages. Each URL should be written from new line.
4.5. Place to save cache.. This is option for set where to you will save cache - to files or to database. In case save cache to DataBase - you will save inode quota for some hosting, also you will have possibility manual correct page what was translated. "Base url" use as main page for translate for this URL and this language - without check cookies and post values. Depending on the option what you selected where to save cache - you will see pages in "Page manager"(only commerce version) from files or from DataBase
4.6. You may select with what Translate API need use for translate. For now we support Bing translate Api (Microsoft, Axure), Google Translate API and Yandex Translate API. Bing selected as default, because it is free (up to 2,000,000 Characters/month) , but google support more languages. Bing translate support so languages. Google translate support so languages. Yandex translate support so languages. Yandex most best for countries where Cirilc main language.
4.7. Google API Key. For work with service google translate. You need add "API key" on tab "General" field "Google API key". get started here.
4.8. Bing Translate API. Insert your Bing (Azure) Translate API here. Read How to get Azure Translate API?
4.9. For work with Yandex Translator API. Subscribe to the Yandex and create billing account. After you will need create Api Key and add this key to Translate component ->General settings->"Yandex security api key"
4.10 On tab "General" field "Remember Language" this important if you no wish every time press Flag in Translate module from website translate
4.11.Joomla multi languages. You need set this option if your site support native translation from Joomla for some languages, set this option to YES. Not use this option together with Joomla FaLang multi languages
4.12. Falang multi languages. You need set this option if your site support FaLang translation from Joomla for some languages. Not use this option together with "Joomla multi languages".
4.13. Translate iFrames. Set to YES if you want to translate iFrames with help of Ordasoft Translate. You no need set this option if no need iFrame translate or have some errors with iFrame translation
4.14. Translate URLs. If you want URLs to be translated, set option to YES. Any translated url - you may manual correct or translate in Url manager(only commerce version)
4.15. User IP. Set to Yes if you want to supply the IP address of the end-user on whose behalf the request is being made. This option is used if there are some problems with Google translation. Goggle limits the translation quota without specifying user IP.
4.16 "Detect language". If on your site original text is multilangual, set this to "Yes"
4.17. Debug. Option for error checking. If some page after translation turns to blank page, set this option to Yes in order to check the problem.
5.1. Caching. Select Yes to use caching for translated page. This will help you to speed up your website.
5.2. Cache time. Set time (in minutes) after which cache will be refreshed.
5.3. For identification pages of the website (while creating cache) we use POST+COOKIE+URL. If you have pages which after reload have different value for some keys in POST or in COOKIE (for example Google analytics), please set these keys to be removed from cache page name definition.
In order to ensure website security OrdaSoft Joomla Translate turns off Cache and switches to AJAX automatically when using Redirect while User is logged on the site.
5.4. Clear Cache. Option gives ability to clear cache.
6.1. "SiteMap Component. Select component that is used to generate a sitemap.
If you set Not use or choose component that is not installed you will get site map generated only for main menu.
If you choose installed on your site Sitemap component and select some of SiteMap languages, SEF Translate will translate the Sitemap on all selected languages.
6.2. Sitemap Languages. You need to choose languages on which your website will be translated. This option is required.
6.3. XML Sitemap URL. It is link on XML Sitemap for registration on Search Engines like Google or Yahoo.
6.4. HTML Sitemap URL. It is link for HTML Sitemap for displaying to users.
6.5. Use cache for Sitemap. Select use cache for Sitemap or not.
6.6. If you have very long Sitemap or while creating translation of Sitemap you have error you can Add languages on you cached Sitemap.
6.7. Clear cache Sitemap. Click on button to clear cache Sitemap.
IMPORTANT!!! For see "map site" on different languages, you need add Bing, Yandex or Google Translate API keys.