Skip to main content

Translation

The module is fully translation-ready, allowing you to easily adapt its interface and labels into your preferred language.

Whether you're translating for a multilingual team or just personal convenience, follow the steps below to apply your own translations.

Location of Language Filesโ€‹

All language strings used by the module are stored in the following path:

modules/your_module_name/language/english/

Inside this folder, you'll find one or more .php files (usually mailbox_lang.php) that contain all the text labels used in the module.

Option 1: Create a New Language Folderโ€‹

To add a new translation:

  1. Navigate to the module's language directory
  2. Create a new folder using the ISO language code of your preferred language (e.g., french, german, greek, etc.)
  3. Copy the existing english file(s) into your new folder
  4. Open the copied file and translate the right-hand side of each string:
$lang['mailbox_inbox'] = 'Boรฎte de rรฉception'; // French example
  1. Save your file and make sure your language is set in Perfex CRM > Setup > Settings > Localization

Perfex will automatically load the matching language file if it exists.

Option 2: Override from Perfex's Global Language Fileโ€‹

Alternatively, if you prefer not to touch the module files, you can override specific strings globally from:

application/language/your_language/custom_lang.php

This approach is useful for central management or minor edits. Just define any language keys used in the module with your own custom text:

$lang['mailbox_compose'] = 'Nouveau message';
tip

This method ensures your custom changes are preserved during module updates.

Tips & Best Practicesโ€‹

  • Always backup your language files before making edits
  • Use a UTF-8 compatible editor (such as VSCode, Sublime Text, or Notepad++) to prevent encoding issues
  • Avoid editing the english file directly if you plan to support multiple languages
Support

If you're unsure about a translation key or your language isn't showing up, feel free to contact our support team at the Themesic Support Portal. We're happy to help you localize the module properly!