Details
Access: Public
Opened by Allon Moritz (laoneo)
Parent Category: Documentation
Category: GAnalytics
Last Updated by Allon Moritz (laoneo): Thursday, 04 August 2016 14:46 (Thursday, 04 August 2016)
Created: Saturday, 21 January 2012 21:20 (Saturday, 21 January 2012)
Hits: 4661

Introduction

The GAnalytics Joomla extension uses Transifex to maintain all available language translations. Transifex provides easy to use online tools, which can be used to update translations easily and without any in-depth or technical knowledge. Alternatively, Transifex allows you to download the current translation and update it with your favorite tool. It also allows anyone to download the most current version of any translated file.

Having your language in Transifex is the only way to get it into GAnalytics.

transifex

Translation status

Here is a list of the translations of the GAnalytics project (please add your translation as well!!):

100%
100%
100%
100%
99%
67%
66%
53%
39%
11%
10%
9%
8%

Language files

Every extension shipped with the GAnalytics package has a language folder where the translations/language files are located. For example, if you want to translate the GAnalytics frontend into your language, copy the file /components/com_ganalytics/language/en-GB/en-GB.com_ganalytics.ini to /components/com_ganalytics/language/it-IT/it-IT.com_dpcalendar.ini and translate the English strings inside the double quotes.

 

Language overrides

The strings in GAnalytics are loaded through the Joomla language manager. Joomla offers to overwrite these strings in the language manager of Joomla itself. More information can be found here https://docs.joomla.org/J3.x:Language_Overrides_in_Joomla.

joomla language override

Join Transifex

Please follow the following steps to add your translation to GAnalytics.

  1. Register
    You can register at www.transifex.com. Please use your username you are using on joomla.digital-peak.com!
  2. GAnalytics on transifex
    You can find GAnalytics under this URL: www.transifex.com/digital-peak/GAnalytics
  3. Create the language
    Please create your language if there is no one yet. Please use the five digit xx_XX language code instead of the two digit language code. Or start translating a specific language right now.
  4. Doing the translation
    Go back to the mainpage of the GAnalytics project page: www.transifex.com/projects/p/GAnalytics/. There you can see a list of the language files. To translate one of those just click on it. On the next side you can see some additional info and below is a list of the available languages. If your language is not listed, just click on add Translation and choose your language. If your language is available, you can click on it. Now you get a popup with some options. You can upload your local .ini file and transifex will find the translations automatically or you can click on Translate now. When you press on Translate now you get a new view with all strings which are translated or should be translated. Just fill your translations into the text fields and press save. Your done with this file, go to the next ;)
For further information visit docs.transifex.com/
 

Warnings

Please test that your language works in Joomla! before uploading the file into Transifex. Otherwise your translations may break during import!

There are some bugs in Transifex Joomla support, so please check these:

  • NEVER use double quotes (") in your translation; use single quotes instead (also in HTML tags)
  • If you edit files by hand, make sure that it uses Unix encoding (\n), not Windows (\r\n) or Mac (\r) before uploading the files back to Transifex
  • If you edit files by hand, make sure that you don't split the translations into more than one line (part of the translation disappears)
 

Comments (0)