One click updates for language packs
From Joomla! Documentation
Revision as of 13:19, 9 April 2012 by Horus 68
Joomla has the ability to install language packs updates with just one click. This can be done for language core files but also for extensions languages files
You should read:
Language pack XML
by including the "update server" tag on XML language packs you can have oneclick updates for extension languages. This needs to be included in the XML language pack and it links to an update server. Joomla extension update panel checks the installed XML language packs for the version number and update server. If the update server has more recent version number it alerts for an updated available
Update Server tag
Language pack XML file needs to include (zz-ZZ stands for your language code):
<updateservers> <server type="collection" priority="1" name="zz-ZZ Language Updates">http://update.zzZZ.com/translationlist.xml</server> </updateservers>
See full example here: Creating language packs for extensions in Joomla 2.5
A tiny web space its required to state the latest version and URL for downloadable packs. You can post the zip packs in a different domain but all files need to be directly linked! Good practice: to keep it clean you can use a subdomain just for updates as in http://update.zzZZ.com/
Update server packs list
The update server will include one translationlist.xml with all the latest language release versions. This is done with a tag for each extension/language available.
If you wanto to create an update server list for Joomla + tinyMCE + 2 different components (using the names Jupiter and Pluto as component names) for the zz-ZZ language, the translationlist.xml contents would be:
<?xml version="1.0" encoding="utf-8"?> <extensionset name="zz-ZZ Language Updates" description="zz-ZZ Joomla core and extensions languages updates"> <extension name="zz-ZZ language for Joomla" element="pkg_zz-ZZ" type="package" version="126.96.36.199" detailsurl="http://update.zzZZ.com/details/zz-ZZ_details.xml"/> <extension name="zz-ZZ language for TinyMCE" element="file_tinymce_zz-ZZ" type="file" version="188.8.131.52" detailsurl="http://update.zzZZ.com/details/zz-ZZ_details_tinymce.xml"/> <extension name="zz-ZZ language for Jupiter" element="file_jupiter_zz-ZZ" type="file" version="184.108.40.206" detailsurl="http://update.zzZZ.com/details/zz-ZZ_details_jupiter.xml"/> <extension name="zz-ZZ language for Pluto" element="file_pluto_zz-ZZ" type="file" version="220.127.116.11" detailsurl="http://update.zzZZ.com/details/pt-PT_details_pluto.xml"/> </extensionset>
- element info = same as the XML file name on the language pack file_jupiter_pt-PT.xml. This name will never change!
- version number = the version number for the latest language pack as stated in version field at the updated XML pack file: <version>18.104.22.168</version>
Good practice: the translation language version should use the same version number as the extension itself (as in 2.0.2.x) and one more number for each translation version (as in x.x.x.1) so you can easily remember what extension version is that translation good for!
Details update packs
Listed in the translationlist.xml are the different languages packs available to update. Each pack URL and version its stated in an single details xml file for each extension. A details XML file would include the details for that language pack as in: \details\zz-ZZ_details_jupiter.xml
<?xml version="1.0" encoding="utf-8"?> <updates> <update> <name>zz-ZZ language for Jupiter</name> <description>zz-ZZ language for Jupiter 2.0.2</description> <element>file_jupiter_zz-ZZ</element> <type>file</type> <version>22.214.171.124</version> <downloads> <downloadurl type="full" format="zip">http://joomlacode.org/gf/download/frsrelease/3238/72703/jupiter_202_lang_zz-ZZ_v2021.zip</downloadurl> </downloads> <targetplatform name="joomla" version="2.5"/> </update> </updates>
This can have more than one language pack (inside <updates> ... </updates> ) but you can only list one extension by file.
Updating language files
A translations its a work in progress and require frequent updates. To deliver your new language files you need:
- Update the language files.
- Edit the language pack XML file for version number
- Publish the new zip pack
- Get URL for a direct download
- Edit the Update server files
- Update the version number at translationlist.xml
- Update the \details\zz-ZZ_details_jupiter.xml for new translation version number and URL for direct download pack
Users just need to check for updates on Joomla panel to get the new language pack installed!