Difference between revisions of "Language Files"

From WHMCS Documentation

(New page: The language files in WHMCS contain all the text strings shown to clients. This allows you to customise any of the text your clients see. ==Adding Support for a New Language== If WHMCS ...)
 
(Removing Languages)
 
(32 intermediate revisions by 10 users not shown)
Line 1: Line 1:
The language files in WHMCS contain all the text strings shown to clients.  This allows you to customise any of the text your clients see.
+
== Default Languages ==
 +
 +
WHMCS includes 26 client area translations by default. These are:
  
==Adding Support for a New Language==
+
'''Azerbaijani, Arabic, Catalan, Chinese, Croatian, Czech, Danish, Dutch, English, Estonian, Farsi (Persian), French, German, Hebrew, Hungarian, Italian, Macedonian, Norwegian, Brazilian & Native Portuguese, Russian, Spanish, Swedish, Turkish''' & '''Ukranian'''
  
If WHMCS doesn't currently have a language file for your language then you can create your own.  This is a fairly simple thing to do but will take some time to translate all the text strings.
+
And for the admin area there are 13 translations included:
  
#Begin by duplicating an existing language file in the lang directory.
+
'''Arabic, Czech, Dutch, English, Farsi (Persian), French, Hebrew, Hungarian, Italian, Portuguese, Russian, Spanish''' & '''Turkish'''
#Save this with the name you want shown in the language selection dropdown menu of WHMCS - it should not contain any special characters.
 
#Once the file is duplicated, you can begin translating all the text strings in it for your language.
 
#Once complete, just save and upload the file to your live WHMCS lang directory.  You will then find the language available as an option in the language dropdown in the admin and client areas.
 
  
Be careful not to delete any of the quotation marks (") around the text strings or the semi-colons on the ends of each line (;). Doing so will result in errors occuring when you select your language from within WHMCS.
+
We rely on the dedication and generosity of our users for contributing translations, as we find real life translations are a much higher quality compared with using automated translation systems as some softwares do. So if you have any suggestions for improvements, or a new language file you are willing to contribute, please get in touch.
  
==Modifying Existing Language Strings==
+
==Adding Languages==
 +
Instructions for translating WHMCS into a new language are located at https://developers.whmcs.com/languages/adding-a-language/
  
You can change any of the text displayed in the WHMCS Client Area by editing the relevant language file in the lang folder of your WHMCS system. All text strings in the client area can be found in the language file and modified in any way you want.
+
==Removing Languages==
 +
In order to remove a language from the WHMCS client area, delete the language file from the ''/lang'' directory. To remove a language from the admin area, delete the language file in the ''/admin/lang'' directory.
 +
 
 +
You can also prevent users from being able to change the language of your system by unchecking '''Enable Language Menu''' 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'''.
 +
 
 +
==Customising Text==
 +
Instructions for customising text in an existing language are located at https://developers.whmcs.com/languages/overrides/
 +
 
 +
==See Also==
 +
[http://help.whmcs.com/m/localisation Localisation Guides & Tutorials]

Latest revision as of 20:08, 25 April 2022

Default Languages

WHMCS includes 26 client area translations by default. These are:

Azerbaijani, Arabic, Catalan, Chinese, Croatian, Czech, Danish, Dutch, English, Estonian, Farsi (Persian), French, German, Hebrew, Hungarian, Italian, Macedonian, Norwegian, Brazilian & Native Portuguese, Russian, Spanish, Swedish, Turkish & Ukranian

And for the admin area there are 13 translations included:

Arabic, Czech, Dutch, English, Farsi (Persian), French, Hebrew, Hungarian, Italian, Portuguese, Russian, Spanish & Turkish

We rely on the dedication and generosity of our users for contributing translations, as we find real life translations are a much higher quality compared with using automated translation systems as some softwares do. So if you have any suggestions for improvements, or a new language file you are willing to contribute, please get in touch.

Adding Languages

Instructions for translating WHMCS into a new language are located at https://developers.whmcs.com/languages/adding-a-language/

Removing Languages

In order to remove a language from the WHMCS client area, delete the language file from the /lang directory. To remove a language from the admin area, delete the language file in the /admin/lang directory.

You can also prevent users from being able to change the language of your system by unchecking Enable Language Menu in the Localisation tab at Configuration () > System Settings > General Settings or, prior to WHMCS 8.0, Setup > General Settings.

Customising Text

Instructions for customising text in an existing language are located at https://developers.whmcs.com/languages/overrides/

See Also

Localisation Guides & Tutorials