Difference between revisions of "Easy Translation"

From WHMCS Documentation

(Localising a Field)
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
==What is Easy Translation==
 
==What is Easy Translation==
 
 
Easy Translation allows you to localise supported database field values into multiple languages.
 
Easy Translation allows you to localise supported database field values into multiple languages.
  
Localised field values are displayed within the client area when a given language is selected by the end user.
+
Localised field values display in the client area when an end user selects a given language.
  
[[File:Easy-translation-animation.gif]]
+
[[File:choose-language-ca.png|500px]]
  
 
==Easy Translation Fields==
 
==Easy Translation Fields==
 
+
 
Currently supported fields include:
 
Currently supported fields include:
 
+
 
* Product Group Names
 
* Product Group Names
 
* Product Group Headlines
 
* Product Group Headlines
 
* Product Group Taglines
 
* Product Group Taglines
 
* Product Names
 
* Product Names
 +
* Product Taglines<div class="docs-alert-info">We added product taglines in WHMCS 8.5.</div>
 
* Product Descriptions
 
* Product Descriptions
 +
* Product Short Descriptions<div class="docs-alert-info">We added product short descriptions in WHMCS 8.5.</div>
 
* Custom Field Names (all types)
 
* Custom Field Names (all types)
 
* Custom Field Descriptions (all types)
 
* Custom Field Descriptions (all types)
 +
* Support Department Names
 +
* Support Department Descriptions
  
 
==Enabling Easy Translation==
 
==Enabling Easy Translation==
  
To enable translations, navigate to ''Setup > General Settings > Localisation''
+
To enable translations, go to the '''[[Localisation Tab|Localisation]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' or, prior to WHMCS 8.0, '''Setup > General Settings'''.
  
Tick the checkbox labelled "Dynamic Field Translation" and click '''Save Changes'''
+
Check the '''Dynamic Field Translation''' checkbox and click '''Save Changes'''.
  
 
==Localising a Field==
 
==Localising a Field==
  
The value you enter in the field located beside the Translate button (the parent field) should always be for the default system language. You can find your default system language in ''Setup > General Settings > Localisation > Language''.
+
The value you enter in the field located beside the '''Translate''' button (the parent field) should always be for the default system language. You can find your default system language in the '''Language''' setting in the '''[[Localisation Tab|Localisation]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' or, prior to WHMCS 8.0, '''Setup > General Settings'''.
  
If you wish to define a value in other languages, click on the '''Translate''' button next to the field like the one pictured below.
+
If you wish to define a value in other languages, click '''Translate''' next to that field.
  
'''Note:''' If you do not see a Translate button next to a field for which translations are supported, double check the Dynamic Field Translation setting is enabled.
+
<div class="docs-alert-warning">
 +
If you do not see a '''Translate''' button next to a field that supports translations, double-check whether the '''Dynamic Field Translation''' setting is enabled.
 +
</div>
  
This will open a dialog window displaying all available languages in the system. The default system language will not be displayed as the parent field value is used for that.
+
This will open a dialog window displaying all available languages in the system. The default system language will not display because the system uses the parent field value for that.
  
If you do not wish to provide a localised version of a field for a language, leave the field empty. When no value is defined, the parent field value will be used.
+
If you do not wish to provide a localized version of a field for a language, leave the field empty. When no value is defined, the system will use the parent field value.

Latest revision as of 17:08, 13 May 2022

What is Easy Translation

Easy Translation allows you to localise supported database field values into multiple languages.

Localised field values display in the client area when an end user selects a given language.

Choose-language-ca.png

Easy Translation Fields

Currently supported fields include:

  • Product Group Names
  • Product Group Headlines
  • Product Group Taglines
  • Product Names
  • Product Taglines
    We added product taglines in WHMCS 8.5.
  • Product Descriptions
  • Product Short Descriptions
    We added product short descriptions in WHMCS 8.5.
  • Custom Field Names (all types)
  • Custom Field Descriptions (all types)
  • Support Department Names
  • Support Department Descriptions

Enabling Easy Translation

To enable translations, go to the Localisation tab at Configuration () > System Settings > General Settings or, prior to WHMCS 8.0, Setup > General Settings.

Check the Dynamic Field Translation checkbox and click Save Changes.

Localising a Field

The value you enter in the field located beside the Translate button (the parent field) should always be for the default system language. You can find your default system language in the Language setting in the Localisation tab at Configuration () > System Settings > General Settings or, prior to WHMCS 8.0, Setup > General Settings.

If you wish to define a value in other languages, click Translate next to that field.

If you do not see a Translate button next to a field that supports translations, double-check whether the Dynamic Field Translation setting is enabled.

This will open a dialog window displaying all available languages in the system. The default system language will not display because the system uses the parent field value for that.

If you do not wish to provide a localized version of a field for a language, leave the field empty. When no value is defined, the system will use the parent field value.