Translation

CM Gift Card uses English by default, but you can always translate it into other languages, just like Joomla! itself or any other Joomla! extension.

Before translating CM Gift Card into another language, you need to install that language.

In the left menu, go to System -> Languages (in the Manage card).

You see the list of languages installed on your site. Click the Install Languages button on the toolbar to install a new one.

The next page lists all of the available languages. You can use the search field to find the language you want, select it in the list, and click the Install button.

If the language is installed successfully, you see a success message from Joomla!.

After installing the new language, go back to the list of installed languages, where you can see your new language.

You need to note the language tag of your new language. The language tag is shown next to the language name, in the Language Tag column. In the screenshot above, the French language package is installed, and fr-FR is the language tag of French.

You can use your favorite FTP client or the file manager available in your hosting control panel to navigate to the <Joomla! root folder>/components/com_cmgiftcard/language/ folder. In this folder you see the en-GB folder, which is where the English language files are stored.

In this language folder, create a new folder for your new language. The name of the folder is the language tag, for example fr-FR for French.

Go to the en-GB folder and copy the en-GB.com_cmgiftcard.ini file from it into the new language folder that you just created (fr-FR, in this example).

In the new language folder, rename en-GB.com_cmgiftcard.ini to xx-YY.com_cmgiftcard.ini, where xx-YY is the language tag of your new language, for example fr-FR.

Open xx-YY.com_cmgiftcard.ini in a text editor and translate the English strings in this file into your new language.

Important note: Joomla! language INI files must be saved as UTF-8 without the Byte Order Mark (BOM). For more information on the Byte Order Mark, see http://unicode.org/faq/utf_bom.html#BOM

The instructions above are for translating the front end of the CM Gift Card component. To translate the back end and the other extensions, repeat the steps above for the following folders:

• CM Gift Card component’s back end: <Joomla! root folder>/administrator/components/com_cmgiftcard/language/
• Payment method plugins: <Joomla! root folder>/plugins/cmgiftcard/PLUGIN_NAME/language/