Languages

• Translations
  • MarketConnect Banners
• Overrides
• Adding New Language
• RTL Language Support

Lagom WHMCS Client Theme uses its own translation strings. However, you can enhance the user experience in the WHMCS client area and during the ordering process. Where possible, we have applied strings provided by default by WHMCS (opens new window) but there are places where we had to create custom strings.

Translations

MarketConnect Banners

1. To translate these elements, you need to activate Dynamic Field Translation (opens new window).
2. Go to the product group and translate “Tagline” and “Headline”.
3. Open the newly created file in your preferred editor.
4. Translate all strings in this file.

Overrides

“Overrides” have been implemented to let you override the existing Lagom WHMCS Client Theme translations or to create new translation strings that then can be used in the Lagom WHMCS Client Theme files.

1. Log in to FTP/SFTP of your WHMCS server.
2. Go to /templates/lagom2/core/lang and create the overrides folder. All files created in the overrides folder will not be overwritten by future Lagom updates.
3. Open the newly created file in your preferred editor.
4. Start the file with a PHP tag <?php indicating that the PHP code will be used.
5. Enter the variable(s) you wish to override. For example, if you would like to change “Already registered with us?”, you need to locate the proper variable within the /templates/lagom2/core/lang/english.php file:

Then place it in the overrides English file along with your preferred change:

6. To create new translation strings, you need to add a new array based on the below example. Please do not forget to create the override files for all languages that you are using in your WHMCS system.

Your new translation can work in the Lagom WHMCS Client Theme files using the {$rslang->trans(key_1.key_2')} variable.

Adding New Language

The language system in the Lagom WHMCS Client Theme allows you to add your own additional language translations. Before you begin, ensure that the language is properly created and configured in your WHMCS system. For detailed instructions on creating and customizing language files within WHMCS, visit Creating and Customizing Language Files (opens new window). Next, we recommend starting by duplicating one of the existing language files.

1. Log in to FTP/SFTP of your WHMCS server.
2. Go to /templates/lagom2/core/lang and duplicate the english.php file.
3. Rename the duplicated file. The language file name should be a single word consisting of only lowercase letters and numbers. The file has to end with the extension .php.
4. Translate all strings located in your new language file.

RTL Language Support

Lagom WHMCS Client Theme is designed to support Right-to-Left (RTL) languages, such as Arabic, Hebrew, and Persian. This support ensures that the theme's layout and elements are properly aligned and displayed for RTL languages, enhancing the user experience for RTL readers. You can view our RTL support in action on our Demo Website (opens new window).

Limitations and Third-Party Modules

Due to inherent limitations within the WHMCS system, certain pages currently do not support RTL languages. The pages affected include:

• View Invoice Page
• View Quote Page

This is primarily because these specific pages do not undergo translation by WHMCS, preventing our theme from identifying the selected language and consequently, not loading the appropriate RTL CSS files.

Furthermore, it is important to note that neither WHMCS nor the Lagom WHMCS Client Theme provides RTL versions of PDF documents for:

• PDF Invoices
• PDF Quotes

Lastly, we wish to highlight that compatibility with third-party modules in RTL mode cannot be fully assured. These modules often incorporate their own CSS styling, which might override the Lagom theme's CSS, potentially leading to inconsistencies in RTL display. We recommend verifying RTL support with third-party module providers for a seamless experience.