View source for WHMCS Billing Module for XUI

== Overview ==

This module allows Users to be auto-provisioned instantly on payment for XUI. Automates the adding of credits for Reseller's and Users. 

== Requirements ==
Requirements are the same as WHMCS.

Requirement Minimum Recommended PHP Version 7.2 Latest 7.3 or 7.4 Release PHP Memory Limit 64MB 128MB**

== Installation and Configuration ==

=== Download and Upload ProjectX for XUI ===

In this tutorial we will show you how to successfully install ProjectX For XUI.
We will guide you step by step through the whole installation and configuration process.

1. Log in to our client area and download the module.

[[File:step1.jpg|600px]]

2. In the downloaded file you might find one or two packages that support different PHP versions.
In the most recent versions of the module, you will find only one package that supports PHP 7.2 and later.

[[File:PHP71_74.png]]


3. Extract the package and upload its contents
'''addonxuiresell''' will be uploaded to whmcs/modules/addons
'''xuiresell''' will be uploaded to whmcs/modules/servers

The content of the package to upload should look like this.

[[File:step2.jpg|800px]]

[[File:step3.jpg|800px]]

=== License ProjectX for XUI ===

4. Log in to our client area and get your license key.

[[File:step4.jpg|600px]]

5. In Whmcs go to "System Settings" > "Addon Modules".

[[File:step5.jpg]]

6. Click Activate.

7. Click Configure.

8. Paste your License Key in, Check the box "Full Administrator" and click Save.

[[File:step6.jpg|800px]]

=== Configure ProjectX for XUI ===

9. In order to create and configure a product, go to 'System Settings' → 'Products/Services'.

10. Click "Create New Group" and click save.

11. Click "Create a New Product".

[[File:step7.jpg|800px]]

12. Fill in the above information. Make sure you select "XUIResell" as the module. Click Continue.

[[File:step8.jpg|800px]]

13. Fill in product Description. You can leave Welcome email as the default. We will setup a Email template later and you can come back and change the Welcome Email. Click continue.

[[File:step9.jpg|800px]]

14. If the product is for a free trial you would use the above settings. "Auto Terminate/Fixed Term" is the number of days to auto terminate the product. If its a 24 hour trial you would set that to 1 and 2 for 48 hours. Leave that as 0 for Paid Subscriptions.

[[File:step10.jpg|800px]]

15. For Paid subscriptions you would use something similar to the above. Select "Recurring". The customer would then receive Recurring invoices on a Monthly, Quarterly etc, etc period. Set your pricing. Make sure "Auto Terminate/Fixed Term" is set to 0. Click save changes.

[[File:step11.jpg|800px]]

16. Fill in the above information. make sure you add a / of the end of your url's. If you are setting up a trial and wish to select all trial products from the panel select "trial_username". Click save. Your Trial products will now show in the drop down boxes

[[File:step13.jpg|800px]]

17. Note for "trial_username" I have selected the contents of the "Trial_ID" drop down box. If its a trial you must select that drop down box.

[[File:step15.jpg|800px]]

19. If you don't want the user to choose their own username or password you can check these boxes. This will generate a "Numeric" username and password. We did this because people find it easier to read numbers then complex randomly generated alpha, numeric ones.

[[File:step14.jpg|800px]]

20. Because this is a free trial we select "Automatically setup the product as soon as an order is placed" and click save.

[[File:step16.jpg|800px]]

21. For Paid Subscriptions. We select "official_username" for "Line Type". We then select products from the drop down boxes. NOTE: in the previous tab where you added your prices they should match. i.e If you only set Monthly pricing then you will only setup Monthly here.

[[File:step17.jpg|800px]]

21. Because this is a paid subscription we set "Automatically setup the product as soon as the first payment is received". So once whmcs receives payment it will automatically setup the user.

[[File:step18.jpg|800px]]

22. In the next tab "Custom Fields". in the field "Field Name" enter "Username" NOTE: Its starts with a capital U. If the line is for a mac you would enter "MAC" here. NOTE: All in capitals.(if you are setting up a mac in the previous step you would select "official_mac or trial_mac from the "line Type" drop down box.
If you want the user to choose their own username you would check all three boxes. "Required Field" "Show on Order Form" "Show on Invoice".
If you selected "Random Username" in the previous section you will only check. "Required Field" "Show on Invoice"
If you want to use the password generated by XUI make sure in the previous section you have not checked "Random Username" and select "Required Field" "Show on Invoice" here.

23. Click "save" your product has now been setup.