# Module Translations

While developing a module, You write your strings in the English language. But you are not creating your modules for the English language audience only.

You must want your module is for every language (French, Dutch, Spanish, etc) the website provides for its employees and customers. So you have to translate them into every language available on your website.

If you do this task manually it is very tedious. But QloApps provides an easy way to make your strings of the module translatable in every language.

Your translatable strings may reside in two types of files in the QloApps module -

  • PHP files
  • Smarty files (.tpl)

# PHP files translations

In PHP files, use $this->l('My Module String.') method call. This method is in the Module abstract class and available in all the modules of QloApps.

Below is the example of the module's main file myqlomodule.php

$this->displayName = $this->l('My QloApps Module');
$this->description = $this->l('Write a description of the module.');

Mostly in all cases in php files you have to use $this->l() method.

But in some special cases this method will not work::

CASE - 1 : In the Front controller of the module you have to use $this->module->l() for string translations.

$this->module->l('My QloApps String to translate in front controller.', 'front_controller_file_name')

Let us understand it with an example. Below we are translating string in the /cheque/controllers/front/validation.php file:

die($this->module->l('This payment method is not available.', 'validation'));

CASE - 2: In the Classes of the module you have to first create the module's object and then call the l() method with the module's object.

If there is a class named ModuleHelper in the file myqlomodule/classes/ModuleHelper.php. Then we have to make string translatable in this class like below -

$objModule = new MyQloModule();
$objModule->l('My QloApps String to translate in module classes.', 'ModuleHelper')
// ModuleHelper is file name of the class

# Smarty files (.tpl) Translations

In the .tpl files, use {l s='My string' mod='mymodule'} function call which is replaced by smarty by the translation of the chosen language.

For example, If we have to make below line's strings translatable -

<a href="{$moduleControllerLink}" title="Click Here">Click here to visit the link!</a>

Below is the translatable string code:

<a href="{$moduleControllerLink}" title="{l s='Click Here' mod='myqlomodule'}">{l s='Click here to visit the link' mod='myqlomodule'}</a>

Sometimes there are complex codes to translate:

Lets take a look at the below code:

This is
{if isset($module_name_var) && $module_name_var}
    QloApps Module

In the above code "This is QloApps Module" string is translatable. In the first method, you can make strings "This is" and "QloApps Module" translatable separately.

{l s='This is' mod='myqlomodule'}
{if isset($module_name_var) && $module_name_var}
    {l s='QloApps Module' mod='myqlomodule'}

In the second method, sprintf() markers can mark the variables as %s or %2$s.
In the above example, %s must be replaced by the QloApps module if and only if variable $module_name_var is not there. And we have to keep in our mind to make "QloApps Module" string translatable.

This can be achieved through the below code -

  • {capture} function in Smarty only collects the template output into a variable between the tags to use later on. It does not display it.
  • translated "QloApps Module" is Replaced with the variable if the $module_name_var is empty or absent, using a temporary variable ($temp_mod_name).

See the below code:

{if !isset($module_name_var) || !$module_name_var}
    {capture name='temp_mod_name'}{l s='QloApps Module' mod='myqlomodule'}{/capture}
    {assign var='module_name_var' value=$smarty.capture.temp_mod_name}
{l s='Hello %s' sprintf=$module_name_var mod='myqlomodule'}
  • mod parameter is mandatory in module translations.
    QloApps translation system use it to know which translations belongs to which module.\

  • single quotes delimiter is used to delimit Translation Strings. If you want to use single quotes in a string then it should be escaped with a backslash (\).

{l s='Learn to write \'Hello World\'.' mod='myqlomodule'}

So this is how strings in the template files are translated.

# Translate the strings in QloApps

Below are steps to translate strings in QloApps:

  • Visit Localization -> Translations tab.

  • Select Installed modules translations from the Modify translations drop-down.

  • Select the language in which you want to translate the module.

  • Click the Modify button to proceed.

  • Now in the loaded page all the strings from all the installed modules in QloApps will be displayed. The fieldsets of the module will be closed which all the strings are already translated. Otherwise, if at least one string is left for translations module's fieldset is expanded.

  • Next step is to find your module in the list to translate and fill the translations in the text fields.

  • After filling in all the translations, click on the Save and Stay or Save button. this way your translations will be saved.

  • Module's translations are saved in a file named using the languageCode.php format i.e. /myqlomodule/traslations/fr.php. Below is the demo file how translation files actually look like:

global $_MODULE;
$_MODULE = array();
$_MODULE['<{myqlomodule}QloApps>myqlomodule_2ddddc2a736e4128ce1cdfd22b041e7f'] = 'Mon module';
$_MODULE['<{myqlomodule}QloApps>myqlomodule_d6968577f69f08c93c209bd8b6b3d4d5'] = 'Description du module Qlo.';
$_MODULE['<{myqlomodule}QloApps>myqlomodule_533937acf0e84c92e787614bbb16a7a0'] = 'Êtes-vous certain de vouloir désinstaller ce module ? Vous perdrez tous vos réglages !';
$_MODULE['<{myqlomodule}QloApps>myqlomodule_0f40e8817b005044250943f57a21c5e7'] = 'Aucun nom fourni';
$_MODULE['<{myqlomodule}QloApps>myqlomodule_fe5d926454b6a8144efce13a44d019ba'] = 'Valeur de configuration non valide.';
$_MODULE['<{myqlomodule}QloApps>myqlomodule_c888438d14855d7d96a2724ee9c306bd'] = 'Réglages mis à jour';

Note : The translation files created in the translations/ folder of the module must not be edited manually. You have to use the QloApps translations page to translate the strings of the module again.

When you have translated the module's string in the french language (or any other language) then selecting that language in the front office or back office of the website the translated content in the french language (or any other language) will be shown.