JU Translation - Create and Share Extension Translations
Introduction
JU Translation is a translation tool integrated in our extensions that gives the possibility to translate, get and share translations.
What can I do with it?
- Install a translation file to translate the extension in your language
- Override an existing translation
- Update original translation file and share it
- Re-install a language file
- Use a user friendly translation interface
I. INSTALL AN EXISTING TRANSLATION
The main interface of the translation tool is accessible through the settings of the extension, in a tab named "Translations". In the main interface you'll find all your website language listed.
By default all our extensions are distributed with English language file only, If your website is in French for example, just hit the button Install
A resume of the translation strings will be displayed and validate the step, you're done, your extension is now in french!
You also have the possibility to re-install a language file, it's helpful in the following cases:
- You want to update the language to a recent version
- You've made some errors in the language file
II. ADD A NEW LANGUAGE TRANSLATION
Here is the process to add a new language translation to an extension.
1. Make sure your website is in Danish language for example if you want to add the Danish translation.
WordPress language can be chosen from the Global settings or in case of a multilingual website added in WPML or Polylang. In Joomla, use the default language manager to add a language.
2. Now, your new language should then be listed under Settings > [Your Extension] > Translations
If there's no translation available in your langue, a message will be displayed "No translation found". Click on "Edit original file" then start the translation.
During the translation process you can check your current translation in your extension of course. And once you're done, please share your translation using the green button "Share with JoomUnited".
III. OVERRIDE A LANGUAGE FILE
3.1 Add an override
The override process is about create a language that will be used in priority over the original one. The main advantage is that this overrided file will remain untouched on plugin update.
From this file you can override only few strings, that's OK. Just hit the Override button.
In the translation interface you'll find listed the constant (for Joomla) the reference in English, the language you want to override then you can add you own translation.
3.2 Translation interface use
The translation interface is pretty user friendly, like our extensions :) Some filters are available on the top part to quickly find what you're searching for or display only empty translations.
There's some arrows in your between the fields, you can copy the original translation to save time or create your own translation
Then hit the save button and your override is done!
IV. EDIT ORIGINAL TRANSLATION AND SHARE IT!
This part is for translators only. From the main translation dashboard, you got an orange button named Edit original translation
This button will lead you to a warning message to avoid editing an original file that will be erased on update. The idea of editing the original file is to share your translation with us and then we'll validate it as the reference for your language.
On the next step you can start the translation.
Finally, after your translation, just confirm it and then you can share your translation with us.
You can also drop us a custom message.