Home OrdaSoft News Media Library Documentation how to translate / add languages to components

how to translate / add languages to components

How to translate components

For example we take MediaLibrary:

First, find the file called english.php, either in your installation or in the zip archive of the component. In the MediaLibrary installation it is located in the directory /components/com_medialibrary/language/.

Next, make a copy of english.php and rename it to your own language, for example dutch.php.

Now open dutch.php with a text editor which is capable of handling UTF-8. We recommend PSPad if you are on a Windows operating system. Try PSPad instead, and set it under [Format] to UTF-8 before you edit and save your files.

A partial example of what you will see:



* @package MediaLibrary

* @copyright 2008 Andrey Kvasnevskiy-OrdaSoft

* Homepage: http://www.ordasoft.com/

* @version: 1.5.2 Shop $

* English Language File (EN) - UTF-8


// components/com_MediaLibrary


DEFINE('_MediaLibrary_DESC','Our library with suggestions for Media for

you to enjoy.');

DEFINE('_MediaLibrary_SEARCH_DESC1', 'Search Media');

DEFINE('_MediaLibrary_SEARCH_DESC2', 'Search Media');

DEFINE('_MediaLibrary_SUBMIT_Media','Submit a Media');

DEFINE('_Media_EXIST','There is already a Media with that ISBN/ASIN.');


You translate the text portions only, so ONLY the parts between the single quotes.

Example translation for Dutch (NL) would look like this:



* @package MediaLibrary

* @copyright 2008 Andrey Kvasnevskiy-OrdaSoft, Rob de Cleen

* Homepage: http://www.ordasoft.com/

* @version: 1.5.2 Shop $

* Dutch Language File (NL) - UTF8

* Dutch translation by Rob de Cleen


// components/com_MediaLibrary


DEFINE('_MediaLibrary_DESC','Onze bibliotheek met suggesties voor boeken

die je misschien leuk en nuttig vindt.');

DEFINE('_MediaLibrary_SEARCH_DESC1', 'Boek zoeken');

DEFINE('_MediaLibrary_SEARCH_DESC2', 'Boek zoeken');

DEFINE('_MediaLibrary_SUBMIT_Media','Boek inbrengen');

DEFINE('_Media_EXIST','Er is al een boek met dat ISBN/ASIN.');


Continue to translate all language variables in your language.

That very important, at start every language file you see row:
$LangLocal = array('lang_code'=>'nl-NL', 'title'=>'Dutch');
so lang_code - must be exactly as use joomla for your lang, in this case for Dutch language and for dutch.php file !!!


You can use accented letters and special characters like é, ô, ü, ç, ñ, ¿. ©, ß etc.

inside the files, with ONE exception:

You cannot use single quotes inside the language variables.

Please replace all single quotes ( ' ) with back-accents ( ` )

So for example French "l'emprunt" inside a language variable needs to be

written "l`imprunt".

This is because single quotes are part of the PHP code normally. The ` or back-

accent will be ignored by PHP and interpreted as normal text.

Adding your language file to the component installation

You can either do the operations on the component archive and then rezip and install, or edit the necessary files in place inside an existing installation.

Place your language file inside the directory

/components/com_MediaLibrary/language/ using an FTP client or similar

(if you are on a shared hosting account, please use internal Joomla FTP or

QuiXplorer or similar to preserve the file ownership).

Save each file. Remember to translate the entries according to the language file

you are editing. That's it, you're done!

Languages for VehicleManager

Languages for BookLibrary

Languages for RealEstateManager

Languages for MediaLibrary