Actions

J2.5

Making non-core language packs

From Joomla! Documentation

Revision as of 11:32, 9 May 2012 by Mahagr (Talk | contribs)

To make a non-core language pack in 2.5 is quite different from making a Core pack.

http://docs.joomla.org/Making_a_Language_Pack_for_Joomla_1.6

The type of package is a "file" type.

Here is a typical xml including installing ini files into the administrator and site CORE default language folders for one language and one extension only. Many languages and many extensions can be included.


<?xml version="1.0" encoding="utf-8"?>
<extension type="file" version="2.5" method="upgrade">
 
        <!-- Please use a unique name to make uninstall to work. Should be identical to your manifest filename. -->
        <name>lang_extensionname_fr-FR</name>
        <author>French Translation Team</author>
        <creationDate>24 Janvier 2012</creationDate>
        <copyright>(C) 2005-2012 Whoever</copyright>
        <license>http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL</license>
        <authorEmail>info@whoever</authorEmail>
        <authorUrl>http://www.myextension.org</authorUrl>
        <version>1.0.0</version>
        <description>This fr-FR lang pack for myextension has been installed successfully</description>
 
        <!-- Fileset definition -->
        <fileset>
 
                <!-- back-end -->
                <files folder="admin/fr-FR" target="administrator/language/fr-FR">
                        <filename>fr-FR.com_myextension.ini</filename>
                        <filename>fr-FR.com_myextension.sys.ini</filename>
                        <filename>fr-FR.plg_system_myextension.ini</filename>
                        <filename>fr-FR.plg_system_myextension.sys.ini</filename>
                </files>
 
                <!-- front-end -->
                <files folder="site/fr-FR" target="language/fr-FR">
                        <filename>fr-FR.com_myextension.ini</filename>
                        <filename>fr-FR.com_myextension.sys.ini</filename>
                        <filename>fr-FR.mod_myextension.ini</filename>
                        <filename>fr-FR.mod_myextension.sys.ini</filename>
                </files>
        </fileset>
</extension>

The .zip in this case is composed of the xml above and 2 folders: site and admin, each of them containing a fr-FR folder with the ini files.

lang_extensionname_fr-FR.xml

site/fr-FR/ + all ini files

admin/fr-FR/ + all ini files

You can name your language extension and xml file as you wish, but please make sure that the name is unique as

The result is the installation of the ini files in an existing fr-FR folder or creating one if does not exist.

It has no impact on existing files. Uninstalling the "File" pack (Extensions Manager=>Manage=>Filter by "file") will only uninstall the ini files listed.

NOTE: In 2.5, except if one uses a specific script, the language xx-XX folders will always be created if they do not already exist.