Difference between revisions of "Language Files"

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/

@@ 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.
-==Overriding Existing Language Strings==
+==Adding Languages==
+Instructions for translating WHMCS into a new language are located at https://developers.whmcs.com/languages/adding-a-language/
-The language files in the /lang directory are the defaults but as of version 5 you can change any of the text displayed in the WHMCS Client Area by creating an override file containing the new strings, these will then be used to override the defaults. 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.
-#Begin by opening a text editor (such as Notepad) and copying in the language strings to be changed from the default language file
+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'''.
-#Edit the string in the new file as necessary
-#Save it with the same name as the default language file (eg. english.php, french.php etc.)
-#Then upload it to the '''/lang/overrides/''' directory
-For example if you wanted to change the "You are here" text to say "Current Page" then you would copy the following string from /lang/english.php and paste it into the new file:
+==Customising Text==
+Instructions for customising text in an existing language are located at https://developers.whmcs.com/languages/overrides/
-  $_LANG["globalyouarehere"] = "You are here";
+==See Also==
+[http://help.whmcs.com/m/localisation Localisation Guides & Tutorials]
-Then edit so it reads:
-  $_LANG["globalyouarehere"] = "Current Page";
-The advantage of using the overrides method instead of editing the default language files directly is that any changes made here won't be lost with each upgrade.

Documentation