Difference between revisions of "Easy Translation"

From WHMCS Documentation

(Localising a Field)
 
(5 intermediate revisions by the same user not shown)
Line 4: Line 4:
 
Localised field values display in the client area when an end user selects a given language.
 
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)
Line 22: Line 24:
 
==Enabling Easy Translation==
 
==Enabling Easy Translation==
  
To enable translations, navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings > [[Localisation_Tab|Localisation]]''' or, prior to WHMCS 8.0, '''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'''.
  
 
Check the '''Dynamic Field Translation''' checkbox and click '''Save Changes'''.
 
Check the '''Dynamic Field Translation''' checkbox and click '''Save Changes'''.
Line 28: Line 30:
 
==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 the '''Language''' setting at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings > [[Localisation_Tab|Localisation]]''' or, prior to WHMCS 8.0, '''Setup > General Settings > Localisation'''.
+
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 '''Translate''' next to the field that resembles the image below.
 
  
[[File:Translate_buttons.png]]
+
If you wish to define a value in other languages, click '''Translate''' next to that field.
  
 
<div class="docs-alert-warning">
 
<div class="docs-alert-warning">
<span class="title">Note</span><br />
 
 
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.
 
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>
 
</div>

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.