Lagom WHMCS Client Theme Documentation
Docs v2.x
/ /website-builder/ /extensions/ /module-integration/ /order-form/

# Languages

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:

  1. 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.

# Lagom Email Template

Please be aware that the Lagom Email Template is not designed to support RTL languages. When using this template, all elements and text strings will be displayed in an LTR format. This limitation is important to consider if RTL language support is crucial for your email communications.

# Languages Removing

For both the Lagom WHMCS Client Theme and the Lagom WHMCS Website Builder, you may wish to customize the language options available to your users. This can be efficiently managed by applying custom CSS to hide certain languages or display only selected ones.

# Methods to Manage Language Visibility

Choose one of the following methods based on your site's needs:

# Preserving Selected Languages:

To only display certain languages and hide the rest, use the CSS snippet below. This example demonstrates how to keep only English and German:

[data-language-select] [data-language-select-list] [data-value]:not([data-value="english"]):not([data-value="german"]) {
    display: none!important;
}

# Removing Specific Languages:

If you need to remove particular languages, modify the CSS to target those specific ones. The following code removes English and German:

[data-language-select] [data-language-select-list] [data-value="english"], 
[data-language-select] [data-language-select-list] [data-value="german"] {
    display: none!important;
}

These adjustments allow for a tailored presentation of language options, aligning them with your audience's preferences. Double-check the language codes to ensure they match those configured in your WHMCS.

# Where to Add Custom CSS

Insert your custom CSS into the active style's Custom CSS section within our addon - RS Themes Addon -> Styles -> Manage your active style -> Custom CSS.

← WHMCS Child Theme →