Actions

Difference between revisions of "One click updates for language packs"

From Joomla! Documentation

(creation of the help doc)
 
(Updating for new versions)
Line 60: Line 60:
 
</source>
 
</source>
 
This can have more than one language pack (inside <updates> ... </updates> ) but you can only list one extension by file.
 
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
 +
 +
Users just need to check for updates on Joomla panel to get the new language pack installed!
  
 
[[Category:Joomla! 2.5]]
 
[[Category:Joomla! 2.5]]

Revision as of 14:01, 9 April 2012

Contents

Joomla has the ability to install language packs updates with just one click. This can be done for language core files Creating_language_packs_for_extensions_in_Joomla_2.5 but also for extensions languages files

Before proceeding:

You should read: 1- Extension Manager Update Help16:Extensions_Extension_Manager_Update 2- Creating language packs for extensions in Joomla 2.5 Creating_language_packs_for_extensions_in_Joomla_2.5

Update Server tag

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

Language pack XML

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 Creating_language_packs_for_extensions_in_Joomla_2.5


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="2.5.4.2" 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="3.4.7.1" 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="2.0.2.1" 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="3.0.3.1" 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 will be allways the same!
  • version number = the version number for the latest language pack as stated in version field at the XML pack file: <version>2.0.2.1</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 individual 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>2.0.2.1</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:

  1. Update the language files.
    1. Edit the language pack XML file for version number
  2. Publish the new zip pack
    1. Get URL for a direct download
  3. Edit the Update server files
    1. Update the version number at translationlist.xml
    2. Update the \details\zz-ZZ_details_jupiter.xml for new translation version number and URL for direct download

Users just need to check for updates on Joomla panel to get the new language pack installed!