# Localization

Concord CRM supports multiple locales, each user can use Concord CRM in his local language if the locale is already translated and included in Concord CRM.

You can translate Concord CRM and use it in a different locale, you can achieve this with our built-in translator directory and perform translate directly via the dashboard.

# Create New Locale

If the locale/language you are in need does not exist, you can create a new locale directly via the dashboard.

  • Go to Settings and from the menu choose System->Translator.
  • Click on the New Locale button.
  • Enter the locale name you want to create, for example, nl_NL, pt_BR, etc...
  • Click Create.

WARNING

The locale name must contain only alpha characters and dash.

# Translate Locale

To translate locale, in Go to Settings and from the menu choose System->Translator and from the top right side, choose the locale you want to perform translations.

The translations will be grouped in various groups for better readability and easier translation.

  • Click on the arrow down icon right of the group.
  • The group translations will be shown in a table so you can perform translate.
  • On the last table column where you can enter custom text, write the actual translated text for the locale you selected.
  • When finished, scroll to the bottom of the group and click Save.

# User Language

As noted before, each user can choose one of the available Concord CRM locales to be used when this user is logged-in in the dashboard.

To choose a locale, follow the steps below:

  • Login in the dashboard.
  • On the navigation bar top right side, click on the user name then click on Profile.
  • Scroll down to the locale select field and select the desired locale.

# Performing Full Translation

When performing translations via the settings area, the original locale translations are not edited, instead, new translations files are created and are deeply merged with the existing ones.

Assuming you created a locale pt_BR, Concord CRM will create a folder in resources/lang with name pt_BR and the groups will be copied from the core English locale in resources/lang/en.

Then when you navigate to System->Translator and for example translate some keys from the Actions group, Concord CRM will put your custom translations in resources/lang/.custom/pt_BR.

WARNING

If you can't see the .custom folder make sure that via your file manager choose to show hidden (dot) files.

Via your file manager, if you open to resources/lang/pt_BR/actions.php you will be able to see that this file is untouched.

If you are using the translator via the dashboard for your own purposes, it's totally fine, you should not worry about performing full translation, however, in cases, when you want to contribute the translation, you may want to perform a full translation.

To perform full translation, follow the steps below.

  • Download all group files for example in resources/lang/pt_BR.
  • In your local machine/pc, open each file and translate them directly in your favorite code editor.
  • After you are done, upload all the groups' files again in resources/lang/pt_BR.
  • Go to Settings and from the menu choose System->Tools and run the i18n-generate tool.

Now, if you go to System->Translator and select the pt_BR language, for the "Source" table data you will be able to see the actual original translation key source instead of the English source.

Translation Source

# Contributing The Translated Locale

We accept contributions of the translations so we can include the translated texts in the core Concord CRM build if you want you can contribute the translation and let other users from your country benefit from your translations.

  • To contribute a translations performed via the dashboard settings, create a .zip with the files located in resources/lang/.custom/[LOCALE], we will make sure to check them and merge them as a full translation.
  • To contribute a full translation, create a .zip file with the files n resources/lang/[LOCALE].

You can send us the translations at hello@concordcrm.com, we will be happy to review them and include in the core build.