Difference between revisions of "Language Files"

From WHMCS Documentation

(Overriding Language Strings)
(Removing Languages)
 
(20 intermediate revisions by 7 users not shown)
Line 1: Line 1:
WHMCS supports numerous languages, in both in the client and admin areas. To enable this, all text used throughout the system is stored within language files.
+
== Default Languages ==
 +
 +
WHMCS includes 26 client area translations by default. These are:
  
Language files are stored in the '''/lang/''' sub-folders of both the client and admin directories.
+
'''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'''
  
__TOC__
+
And for the admin area there are 13 translations included:
==Default Languages==
 
  
WHMCS includes 20 client area translations by default. These are:
+
'''Arabic, Czech, Dutch, English, Farsi (Persian), French, Hebrew, Hungarian, Italian, Portuguese, Russian, Spanish''' & '''Turkish'''
 
 
'''Arabic, Catalan, Croatian, Czech, Danish, Dutch, English, Farsi, French, German, Hungarian, Italian, Norwegian, Brazilian & Native Portuguese, Russian, Spanish, Swedish, Turkish & Ukranian'''
 
 
 
And for the admin area there are 6 translations included:
 
 
 
'''Czech, English, French, Portuguese, Russian & Spanish'''
 
  
 
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.
 
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 a New Language==
+
==Adding Languages==
 
+
Instructions for translating WHMCS into a new language are located at https://developers.whmcs.com/languages/adding-a-language/
If a language you operate in is not available as standard, then you can create your own translation. Here's how:
 
 
 
#Begin by opening an existing language file
 
#Save this file with a new name - the name you want to be shown in the language selection dropdown menu in WHMCS - the name should only consist of a-z0-9 characters and end with the extension ".php"
 
#Once the file has been created, you can then begin going through and translating the lines within it
 
#An example line is as follows - you should only change the part in bold:
 
  
$_LANG['accountinfo'] = "'''Account Information'''";
+
==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.
  
''Be careful not to delete any of the quotation marks (") around the text strings or the semi-colons on the ends of each line (;). Also should you want to use a quote character (") within your translated text, you must escape it - for example: \"  The language files are written in PHP syntax so valid PHP code must be maintained.''
+
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'''.
  
==Overriding Language Strings==
+
==Customising Text==
 +
Instructions for customising text in an existing language are located at https://developers.whmcs.com/languages/overrides/
  
{{:Language_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