Manual method.
Prev Creating a language translation. Next

Manual method.

Those unwilling or unable to make use of Transifex, we here describe a manual mechanism for creating an installable extension pack. For translating extensions for Joomla! 1.6, 1.7, 2.5 see this article: Creating language packs for extensions in Joomla 1.6/1.7: http://docs.joomla.org/Creating_language_packs_for_extensions_in_Joomla_1.6/1.7

The following example illustrates the build of the Portuguese Brazilian language for the Macrotone IP Mapping component.

1) We will prepare folder structure for the new created translation. Create the following folders on your disc:

        lang/admin
        lang/modules

Open text editor and paste the following content:

        <html><body bgcolor="#FFFFFF"></body></html>

Save it as index.html in all folders (as lang/admin/index.html, lang/modules/index.html and lang/index.html).

2) Unzip the Macrotone IP Mapping component ZIP file somewhere on your disc.

Go to:

    admin/language/en-GB/ folder (which is included in the unzipped Macrotone IP Mapping structure)

and open both files in your text editor:

        en-GB.com_ipmapping.ini
        en-GB.com_ipmapping.sys.ini

Translate the strings to your language and save them as (in our example we use Portuguese Brazilian prefixes):

        lang/admin/pt-BR.com_ipmapping.ini
        lang/admin/pt-BR.com_ipmapping.sys.ini

Go to:

    modules/mod_ipmapping_mapper/language/en-GB/ folder (which is included in the unzipped Macrotone IP Mapping structure)

and open the files in your text editor:

        en-GB.mod_ipmapping_mapper.ini
        en-GB.mod_ipmapping_mapper.sys.ini

Translate the strings to your language and save them as (in our example we use Portuguese Brazilian prefixes):

        lang/modules/pt-BR.mod_ipmapping_mapper.ini
        lang/modules/pt-BR.mod_ipmapping_mapper.sys.ini

Files should be saved as UTF-8 without BOM encoding.

Go to:

    modules/mod_ipmapping_visitoragent/language/en-GB/ folder (which is included in the unzipped Macrotone IP Mapping structure)

and open the files in your text editor:

        en-GB.mod_ipmapping_visitorogent.ini
        en-GB.mod_ipmapping_visitoragent.sys.ini

Translate the strings to your language and save them as (in our example we use Portuguese Brazilian prefixes):

        lang/modules/pt-BR.mod_ipmapping_visitoragent.ini
        lang/modules/pt-BR.mod_ipmapping_visitoragent.sys.ini

Files should be saved as UTF-8 without BOM encoding.

3) Open text editor and paste there the following content:

<?xml version="1.0" encoding="UTF-8"?>
<extension type="file" version="2.5" method="upgrade">
  <name>pt-BR.com_ipmapping</name>
  <tag>pt-BR</tag>
  <version>1.0.0</version>
  <creationDate>08/01/2013</creationDate>
  <author>Macrotone Consulting Ltd</author>
  <authorEmail>This email address is being protected from spambots. You need JavaScript enabled to view it.</authorEmail>
  <authorUrl>www.macrotoneconsulting.co.uk/authorUrl>
  <copyright>(C) 2012-2013 Macrotone Consulting Ltd</copyright>
  <license>http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL</license>
  <description>Brazilian-Portuguese language pack for IP Mapping</description>
  <fileset>
    <files folder="admin" target="administrator/language/pt-BR">
      <filename>pt-BR.com_ipmapping.ini</filename>
      <filename>pt-BR.com_ipmapping.sys.ini</filename>
      <filename>index.html</filename>
    </files>
      <files folder="modules" target="language/pt-BR">
      <filename>pt-BR.mod_ipmapping_mapper.ini</filename>
      <filename>pt-BR.mod_ipmapping_visitoragent.ini</filename>
      <filename>pt-BR.mod_ipmapping_mapper.sys.ini</filename>
      <filename>pt-BR.mod_ipmapping_visitoragent.sys.ini</filename>
      <filename>index.html</filename>
    </files>
  </fileset>
</extension>

Edit it, changing the language specifics and the author as required and save it as:

    lang/install.xml file.

So now you should have the following folder structure in the folder lang:

    install.xml
    index.html
    admin/index.html
    admin/pt-BR.com_ipmapping.ini
    admin/pt-BR.com_ipmapping.sys.ini
    modules/index.html
    modules/pt-BR.mod_ipmapping_mapper.sys.ini
    modules/pt-BR.mod_ipmapping_mapper.ini
    modules/pt-BR.mod_ipmapping_visitoragent.sys.ini
    modules/pt-BR.mod_ipmapping_visitoragent.ini

Select all files included in lang folder and add them into ZIP file called lang-prefix-LANG-PREFIX.com_ipmapping.zip (in our example the file will have the following name: pt-BR.com_ipmapping.zip).

Now the translation is ready and can be installed via standard Joomla! installation procedure.

Remember that the Joomla Language core pa k for your desired language must be installed otherwise the language installation will fail.

Prev Up Next
Creating a language translation. Home Joomla 3.x support