Translation

CM Gift Card uses English by default however you can always translate CM Gift Card to other languages just like Joomla! or other Joomla! extensions.

Installation

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

From the left menu, you navigate to System -> Languages (in Manage card).

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

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

If the language is installed successfully, you can see the successful message from Joomla!.

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

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

Preparation

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

In this language folder, you 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 en-GB folder copy en-GB.com_cmgiftcard.ini file in this folder to the new language folder that you just create (fr-FR as in the example).

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

Translate

Open xx-YY.com_cmgiftcard.ini with a text editor and translate the English strings in this file to 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 Byte Order Mark see http://unicode.org/faq/utf_bom.html#BOM

The above instruction is for translating the front-end of CM Gift Card component. To translate the back-end and other extensions, you need to repeat the above steps 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/