This WHMCS module provides provisioning integration with CubeCoders AMP with WHMCS.
This guide assumes you have knowledge of WHMCS and the software is configured for basic use. More information can be found on https://www.whmcs.com.WHMCS must be configured as its own subdomain (e.g. whmcs.example.com).
WHMCS CANNOT be in Maintenance Mode or you will fail to receive callbacks.
Ensure you have configured your ADS instances by following the Configuring AMP for Enterprise or Network Usage guide.
- Download the Zip file from this GitHub
- Upload the package content into your main WHMCS directory. (We recommend using an FTP Client)
- Login to WHMCS Admin Area
- Navigate to System Settings -> Product & Services -> Servers
- Click on Add New Server and enter the following:
- Name - Any name to distinguish the server in WHMCS
- Hostname - The URI for your server excluding
https:// - Module - AMP
- Username and Password - An AMP user made specifically for use with WHMCS that has the Super Admin role and MFA disabled
- Secure - Check the box for "Check to use SSL Mode for Connections"
- Click Test Connection
- If the connection was successful you will see a green banner that says
Connection successful. Some values have been auto-filled.
- Click Save Changes
- From the Servers overview page click on Create New Group
- Enter a Name for your AMP Server Group
- Select your AMP Server(s) from the list and Add to Selected Servers
- Click Save Changes
- Navigate to System Settings -> System -> Email Templates
- Click on Create New Email Template
- For Email Type, click the dropdown and select Product/Service
- Enter the name “AMP Welcome Email” for this template.
-
Enter an Email Subject that your customers will see such as “Important Account Information”
-
Copy and paste the below template into the text area of the email template
Congratulations {$client_name}, Your order has now been activated and you are minutes away from starting an epic journey with your friends in {$service_product_name} Username: {$service_username} Generated Password: {$service_password} Console Login: https://{$service_server_hostname}/?instance={$service_instance_id} Lets get started! Now that you are a {$service_product_name} Server owner, you'll need to login to the above link and accept the {$service_product_name} EULA and then Start your server. Please raise a ticket on our website if you require assistance. {$signature}
- Click Save Changes
- Next, we'll setup the AMP Password Reset email.
- Navigate to System Settings -> System -> Email Templates
- Click on Create New Email Template
- For Email Type, click the dropdown and select Product/Service
- Enter the name “AMP Password Reset” for this template.
-
Enter an Email Subject that your customers will see such as “Password Reset Information”
-
Copy and paste the below template into the text area of the email template
Hello {$client_name}, We've reset your password to your Control Panel. Please find your new login details below: Username: {$service_username} Generated Password: {$service_password} Console Login: https://{$service_server_hostname}/?instance={$service_instance_id} If you did not request this password change, please reply to this email. {$signature}
16: Click Save Changes
-
Login to your AMP Control Panel
-
Navigate to Configuration -> Instance Deployment
-
Set the Template deployment callback URL as follows :
https://WHMCS_URL/index.php?ampCallback=1 eg. https://example.com/index.php?ampCallback=1
- Navigate to System Settings -> Products & Services -> Products/Services
- Create New Product Group ( or use existing one )
- Select Create New Product
- For the Product Type, select [Other]
- From the Product Group dropdown, select the Product Group you created earlier
- Enter a product name (For Example, Minecraft Java)
- Click on the drop down menu for Module and select AMP
- Click on Continue
- Click on the Module Settings tab
- Ensure that Module Name is set to AMP
- Click on the Server Group drop down menu and select the Server Group you created earlier
-
You will now see new fields appear that are specific to this product
-
The Provisioning Template allows you to select your deployment template within AMP for specific server you want to deploy
-
Then select the Post Create Action from the below list depending on your desired outcome. The instance is always started. Updates and/or starts may not complete if additional setup is required on the customers behalf such as EULA acknowledgement or Steam sign in.
Do Nothing = Doesn't start the application Update Once = Updates but doesn't start the application automatically Update Always = Performs an application update every instance start Update and Start Once = Updates the application and starts the application once Update and Start Always = Updates the application and starts the application every instance start Start Always = Updates and starts the application once, then starts the application every future instance start -
Set the Required Tags field as per below
-
If you are running AMP in Standalone or Hybrid mode, enter the value ‘Local’
-
If you are running AMP in Controller/Target mode, enter the Tag value that you have set on a Target within the AMP panel
-
Extra Provision Setting field allows you to set a static setting that will apply to all Instances created for this product. If you wish to sell customizable parameters such as RAM & CPU allocations, please see the Configurable Options section further down.
-
The Mode selection allows you to specify how the Endpoints are displayed in the Client section of WHMCS. For example:
Standalone URL will be displayed as https://yourdomain.com:25565 Target/Node IP Address will be displayed as 0.0.0.0:25565 -
Now select your preference for the Automatic Setup
- Click Save Changes
You’re ready to go! Module is ready to use. After activation of ordered product, module will wait for callback - then Application URL will be show in client area.
You can set custom configuration options within WHMCS for settings such as RAM Allocation & CPU Allocation.
-
Navigate to System Settings -> Products & Services -> Configurable Options
-
Click on Create a New Group and give it a name such as ‘AMP Product Options’
-
From the Assigned Products select the products that these configurable options applies to
-
Click on Add New Configurable Option
-
Enter the configurable option that you would like to set from the list below and click Save Changes
+$$ContainerCPUs|Server CPU Allocation 2|2 CPU Cores 4|4 CPU Cores +$$ContainerMemoryMB|RAM Allowance 1024|1 GB 2048|2 GB 4096|4 GB
If you want to add additional Required Tags that are selectable by the client, you can prefix the settings with @ like below:
@RequiredTags|Datacenter
US|United States
EU|Europe
- You can configure Custom Fields in a similar way by navigating back to System Settings -> Products & Services -> Products/Services. These can be useful for allowing a user to set values for settings on server creation.
- Further values can be set using a template as described in the following article or can be set in WHMCS directly by adding a
+to the beginning of the key. Configuring AMP for Enterprise or Network Usage
You can view a large portion of the communication between AMP and WHMCS by enabling debug logging in both.
- In WHMCS, go to System Logs -> Module Log and enable Module Logging.
- In AMP, search for "Debug" in the top right to change the logging level.
- Repeat the action you were trying and look for output from both sides.
- If you cannot figure out the issue on your own, you can share the logs through the support channels.
Q: Do I need to set a Product Welcome Email in each product?
A: No, the AMP WHMCS Module will always send out the email Template called “AMP Welcome Email”. You can however send an additional welcome email by selecting another email template in the Welcome Email drop down box within each product.