21. How to add a new language to Vehicle manager

#

This article will describe how Vehicle Manager handles languages and how to add a new language file to the to our car softwaret. Vehicle manager and language behavior

The Vehicle Manager component for Joomla comes with full language support. And with Arabic, Brazilian, Portuguese, Danish, Dutch, English, French, German, Hungarian, Italian, Lithuanian, Norwegian, Portuguese, Romanian, Russian, Spanish, Turkish. language files included. What does this mean?

  1. All Vehicle Manager language variables are stored in one file.
  2. That file can be translated to add other languages.
  3. Once you have put a language file for a language into Vehicle Manager, then the language chosen as default in Joomla will automatically be picked up by Vehicle Manager.
  4. On multilingual sites with JoomFish, Vehicle Manager will automatically pick up the language chosen in the frontend.

Remark:
Yes, we know... the current language files in Vehicle Manager are done the "old fashioned" way, as it used to be in Joomla 1.0.x. Joomla 3.0.x uses translations through .ini files, split between admin area and frontend area.

The reason we kept the old way for now is because it gives us less headaches maintaining different translation methods for the two Joomla versions. Perhaps we will look at transforming the translations to the new Joomla 1.5.x way for a future version. Important thing is: the translations work, and they work fine!

Obtaining or creating language files
Many Language files for the Vehicle Manager component can be obtained from the website. But if your language isn't there yet, you can translate Vehicle Manager yourself and add your language. Once you have it, please share it on the website to help others!

If you need add new language:
First, find the file called english.php, either in your installation or in the zip archive of the component. Or download the latest English language file for Vehicle Manager from the Vehicle Manager languages section of the website.

In the Vehicle Manager installation it is located in the directory /components/com_vehiclemanager/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.

WARNING:
All Joomla 1.5.x files need to be saved as UTF-8.
WordPad or Notepad can NOT handle UTF-8, so they are NOT FIT to create or edit these files with!

Try PSPad instead (http://www.pspad.com/), and set it under [Format] to UTF-8 before you edit and save your files. A partial example of what you will see:

< ?php
/**
*
* @package Vehicle Manager
* @copyright 2008 Andrey Kvasnevskiy-OrdaSoft
* Homepage: http://www.ordasoft.com/
* @version: 1.5.2 Shop $
* English Language File (EN) - UTF-8

**/
// components/com_Vehiclemanager
DEFINE('_VehicleManager_TITLE','VehicleManager');
DEFINE('_VehicleManager_DESC','Our library with suggestions for vehicle for
you to enjoy.');
DEFINE('_VehicleManager_SEARCH_DESC1', 'Search Vehicle');
DEFINE('_VehicleManager_SEARCH_DESC2', 'Search Vehicle'); DEFINE('_VehicleManager_SUBMIT_Vehicle','Submit a Vehicle');
etc.

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

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

< ?php
/**
*
* @package Vehicle Manager
* @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_ VehicleManager
DEFINE('_VehicleManager_TITLE','VehicleManager');
DEFINE('_Vehicle Manager_DESC','Onze bibliotheek met suggesties voor boeken die je misschien leuk en nuttig vindt.');
DEFINE('_VehicleManager_SEARCH_DESC1', 'Boek zoeken');
DEFINE('_VehicleManager_SEARCH_DESC2', 'Boek zoeken');
DEFINE('_VehicleManager_SUBMIT_vehicle','Boek inbrengen');
etc.


Continue to translate all language variables in your language.

REMARK:
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 Vehicle manager 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.

  1. Place your language file inside the directory
    /components/com_Vehicle Manager/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).
  2. In the file Vehicle Manager.xml in the directory /components/com_Vehicle Manager/ add the language entry for your language. This goes right after the entry language/english.php.
    So if you use for example Dutch and Spanish on your site you would add those, like this:
    lang/english.php
    lang/dutch.php
    lang/spanish.php
  3. To ensure the languages you use are visible inside the dropdown boxes in the administration part for selecting, you will need to add the language entries to every language file in use in your installation. In each language file, find the part marked //Languages and add your language there. Example:
    //Languages
    DEFINE('_VehicleManager_LANGUAGE_NOT_USED', 'Not specified');
    DEFINE('_VehicleManager_LANGUAGE_ENG', 'English');
    DEFINE('_VehicleManager_LANGUAGE_DUT', 'Dutch');
    DEFINE('_VehicleManager_LANGUAGE_GER', 'German');
    DEFINE('_VehicleManager_LANGUAGE_FRE', 'French');
    DEFINE('_VehicleManager_LANGUAGE_ITA', 'Italian');
    DEFINE('_VehicleManager_LANGUAGE_SPA', 'Spanish');
    etc.

Save each file. Remember to translate the entries according to the language file you are editing. That's it, you're done!

Sharing your created language files with the community.

Once you have a working translation for Vehicle Manager ready, please share it on the website to help others!

You will receive full credits for your work in the Vehicle Manager Languages Section, as well as a link to your website.

    Submitting language files for Vehicle Manager can be done in two ways by registered users:
  1. You can upload your language file from User Menu > Upload file
  2. Or you can attach the file in a forum post
    When submitting your language file, please mention:
  1. version of Vehicle Manager the language translation is for your name as you want it mentioned in the credits the website you want mentioned in the credits


How to change constant in Language Manager of Vehicle Manager?

#

You can update any constant with help of Language Manager (the option is available only for Vehicle Manage PRO).
1. Go to admin area Components -> Vehicle Manager -> Language Manager.
2. In the Search by value constant field enter needed value.

Language Manager in Vehicle manager, joomla Joomla automotive extension
3. Then write your value in the editing field and you will see new value on frontend.

For example you want to change constant "Fuel type"

Language Manager in Vehicle manager, joomla automotive extension

Constant value before change

Language Manager in Vehicle manager, joomla automotive extension

Constant value after

Language Manager in Vehicle manager, joomla automotive extension

View constant value on frontend before

Language Manager in Vehicle manager, joomla automotive extension

View constant value on frontend after

Language Manager in Vehicle manager, joomla automotive extension


How to translate Email in Language Manager?

#

You can translate any Email with help of Language Manager (the option is available only for Vehicle Manager PRO).
1. Go to admin area Components -> Vehicle Manager -> Settings -> Email Notification.

Settings in Vehicle manager, joomla automotive extension
2. Then find section "Buy Request options" and select the needed text (or a part of text)

Settings in Vehicle manager, joomla automotive extension

WARNING:
You can change Email text fot any text, but {username} must be constantly. There in {username} will be output the name of your clients.

3. After that go to Components -> Vehicle Manager -> Language Manager and in the Search by value constant field enter selected text. Press Enter. Vehicle Manager output the needed constant (_VEHICLE_MANAGER_EMAIL_NOTIFICATION_BUYING_REQUEST).

Language Manager in Vehicle manager, joomla automotive extension
4. Finally select the checkbox _VEHICLE_MANAGER_EMAIL_NOTIFICATION_BUYING_REQUEST and select needed language in the select list

Language Manager in Vehicle manager, joomla automotive extension

Thank you in advance for sharing your efforts with the rest of the Vehicle Manager users!


What are you looking for?
Anti-spam question: How many eyes has a typical person?