# Languge Files

### Overview

Our Extensions uses native Joomla language procedures.

### Translate example - JomDirectory

We have created an installation package that can be translated and adapted to any language.

[com\_jomdirectory\_en-GB.zip](https://wiki.comdev.eu/attachments/2)

<p class="callout warning">Please notice that file version is **6.1**. While you are reading there can be the newest version.</p>

#### Here is a procedure to translate the extension and create a language pack:

#### Unpack the files

To translate extension into any language file jomdirectory\_en\_GB.zip needs to be downloaded (link above) and unpacked to some temporary directory. Structure of the folders will looks like this:

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/rQmobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/rQmobraz.png)

These are the folders containing translations for the extensions and modules. The last file is the installation file.

#### Changes files names to new language

If we would like to translate e.g. into German we would need change all the names from en\_GB to de\_DE accordingly:

#### Translate all phrases inside files

We need to translate all the phrases in the files, these are in double quotes e.g:

COM\_JOMCOMDEV\_HOME\_CATEGORIES="**Kategorien**"

#### Edit installation file

After translation is done, edit jomdirectory\_de\_de\_language\_pack xml and change all names accordingly:

```
<?xml version="1.0" encoding="utf-8"?>
 <extension type="file" version="2.5" method="upgrade">
 <name>JomDirectory Sprachpaket Deutsch</name>
 <version>2.5.0</version>
 <creationDate></creationDate>
 <author>AUTHOR</author>
 <authorEmail>YOUR EMAIL</authorEmail>
 <authorUrl></authorUrl>
 <copyright>Copyright (C) 2011 Comdev. Alle Rechte vorbehalten.</copyright>
 <license>http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL</license>
 <description>JomDirectory Sprachpaket Deutsch</description>
 <fileset>
 <!-- Admin jomdirectory component language folder -->
 <files folder="com_jomdirectory/admin" target="administrator/language/de-DE">
 <filename>index.html</filename>
 <filename>de-DE.com_jomdirectory.ini</filename>
 <filename>de-DE.com_jomdirectory.sys.ini</filename>
 </files>
 <!-- Admin jomcomdev component language folder -->
 <files folder="com_jomcomdev/admin" target="administrator/language/de-DE">
 <filename>index.html</filename>
 <filename>de-DE.com_jomcomdev.ini</filename>
 <filename>de-DE.com_jomcomdev.sys.ini</filename>
 </files>
 <!-- Site jomdirectory language folder -->
 <files folder="com_jomdirectory/site" target="components/com_jomdirectory/language/de-DE">
 <filename>index.html</filename>
 <filename>de-DE.com_jomdirectory.ini</filename>
 </files>
 <!-- Site jomcomdev language folder -->
 <files folder="com_jomcomdev/site" target="components/com_jomcomdev/language/de-DE">
 <filename>index.html</filename>
 <filename>de-DE.com_jomcomdev.ini</filename>
 </files>
 <!-- modules language files -->
 <files folder="mod_jomdirectory_items" target="language/de-DE">
 <filename>index.html</filename>
 <filename>de-DE.mod_jomdirectory_items.ini</filename>
 <filename>de-DE.mod_jomdirectory_items.sys.ini</filename>
 </files>
 <files folder="mod_jomdirectory_search" target="language/de-DE">
 <filename>index.html</filename>
 <filename>de-DE.mod_jomdirectory_search.ini</filename>
 </files>
 </fileset>
 </extension>
```

Please make sure to insert your email:

```
 <authorEmail>YOUR EMAIL</authorEmail>
```

for further updates. As seen above all en\_GB has been changed to de\_DE.

#### Zip package

The last step is to zip all files and create a new file: jomdirectory\_de\_DE.zip

#### Test package

Now go to your Joomla and install package, if everything goes right component will be translated, upload it on the Forum in [Localizations ](http://comdev.eu/forum/12-localization)

#### If any errors?

<div data-hasbody="true" data-macro-name="note" id="bkmrk-it-is-worth-to-turn-"><div>It is worth to turn on language debug under Joomla to check if any language errors occur and need to be corrected. These will be visible under the page flashing on red, also, lines will be provided in which error occurs.</div></div>The most common error is enclosed double quotes e.g: COM\_JOMCOMDEV\_HOME\_CATEGORIES="**Kategorien**

##### Unicode UTF8 Compatibility

<div data-hasbody="true" data-macro-name="note" id="bkmrk--2">  
</div><p class="callout info">Language files have to be saved with the encoding **UTF8 NO BOM**.</p>

Please see the Joomla documentation on the link below for more information on Joomla language files.

[http://docs.joomla.org/Creating\_a\_language\_definition\_file](http://docs.joomla.org/Creating_a_language_definition_file)

For technical information about this topic see:

2.6 Encoding Schemes

[http://www.unicode.org/versions/Unicode5.0.0/ch02.pdf](http://www.unicode.org/versions/Unicode5.0.0/ch02.pdf)

and

[http://stackoverflow.com/questions/2223882/whats-different-between-utf-8-and-utf-8-without-bom](http://stackoverflow.com/questions/2223882/whats-different-between-utf-8-and-utf-8-without-bom)