1===============================================================================
2WHMCS - The Complete Client Management, Billing & Support Solution
3===============================================================================
4
5 Managing Language Files with Overrides
6
7 Documentation: https://docs.whmcs.com/Language_Files
8
9===============================================================================
10[ CONTENTS ]
11===============================================================================
12
131. Overview
142. Usage Instructions
15
16===============================================================================
17[ OVERVIEW ]
18===============================================================================
19
20These language files are provided unencoded to allow you to view the language
21strings that WHMCS uses.
22
23We do not recommend editing these files directly. They are often overwritten
24during software upgrades to introduce new and updated text.
25
26Instead we recommend that you use overrides which allow you to customise the
27default variables with your own in a way which can be safely preserved through
28the upgrade process.
29
30===============================================================================
31[ USAGE INSTRUCTIONS ]
32===============================================================================
33
34Steps for customising language strings via overrides are as follows:
35
361. Create the folder 'overrides' within the 'lang' folder.
37
382. Create or copy the language file you want to override.
39 For example, to create an override for the English language you create
40 ./lang/overrides/english.php
41
423. Open the newly created file in your preferred editor.
43
444. Start the file with a PHP tag '<?php' indicating PHP code is to be used.
45
465. Enter the variable(s) you wish to override.
47 For example, if you wanted to change "Welcome to our members area" you
48 would locate the proper variable within ./lang/english.php and place it
49 into the overrides english file with your preferred change:
50
51 ./lang/english.php
52 $_LANG['headertext'] = "Welcome to our members area.";
53
54 ./lang/overrides/english.php
55 $_LANG['headertext'] = "Welcome home!";
56
576. For each variable you wish you change, repeat step #5.
58 For example, a completed overrides file should look something like this:
59
60 ./lang/overrides/english.php
61 <?php
62 $_LANG['headertext'] = "Welcome home!";
63 $_LANG['addtocart'] = "Add to Basket";
64 $_LANG['cartproductaddons'] = "Product Extras";
65
667. Save, and you're done!
67
68For further help, please visit https://docs.whmcs.com/Language_Overrides
69
70===============================================================================
71
72Thank you for choosing WHMCS
73
74WHMCompleteSolution
75www.whmcs.com