THIS ARTICLE REFERS TO THE OLD WHMCS MODULE. ONLY FOR LEGACY RESELLERS
Overview
Cloud.co.za/VPS.co.za supports Reseller accounts. The Reseller accounts can create multiple VMs based on the resources assigned to their account. This guide is intended for Resellers who wish to sell VMs via WHMCS. WHMCS can be configured to create the VPS as soon as you accept the Order (Automatically or Manually). We provide a module for WHMCS to enable you to do so. Setting it up is relatively easy and you can create, delete and suspend a VPS using this module.
API Key
Cloud.co.za/VPS.co.za can generate a unique Key and Password to make API calls to the Control Panel. You will need the API Key and Password to add the server to WHMCS. This information can be found on the Hostafrica Cloud Panel API Credentials. Login details for the control Panel will be sent to you per email once the registration process has been completed.
Adding the server to WHMCS
To add the Hostafrica server to WHMCS login to WHMCS Admin Panel:
Go to WHMCS Admin Panel -> Setup -> Servers -> Add New Server and complete the form as shown below:
The servers details are as follows:
Hostname: vps.host-ww.net
IP Address: 129.232.207.226
Username: see last step - API Key
Password: see last step - API Password
Secure: Tick the box
Creating a product
The next step is to create the products. Go to the WHMCS Admin Panel -> Setup -> Products/Services -> Create a New Product. Complete the details as per the following image and specify the Product Name of your choice.
Module Settings
Now proceed to the Module Settings.
Click on the Module Settings Tab and choose the Module Name Virtualizor_cloud.
A list of fields will load which will be the settings for the new product.
Setup the following values:
| Type: | "KVM" (for Windows server plans) or "Virtuozzo OpenVZ" (for Linux server plans) |
| Disk Space: | The amount of disk space that the VPS will be allowed to use. (see our plans) |
| Guaranteed RAM: | The amount of RAM to be allocated to the VPS (see our plans) |
| Burstable RAM: | Only valid for OpenVZ - always 512 |
| SWAP RAM: | Only valid for KVM - always 1024 |
| Bandwidth: | The allowed bandwidth to the VPS in GBs (see our plans) |
| CPU Cores: | Number of CPU Cores (see our plans) |
| VNC: | Yes |
| IPs: | The number of IPs to be allocated to this VPS - always 1 |
| IPv6 Subnets: | Leave empty |
| IPv6: | Leave empty |
| Region : | "KVM (Windows)" for KVM and "OpenVZ7 (Linux)" for Virtuozzo OpenVZ |
Custom Fields
Now Click on the Custom Fields Tab and complete the following additional fields:
OS
- Field Type: Drop down
- Description: OS
- Select Options: Paste the following list in the field
- Windows VMs: win2012_r2.img, win2016.img
- Linux VMs: ubuntu-14.04-x86_64, ubuntu-16.04-x86_64, centos-6-x86_64, centos-7-x86_64, debian-7.6-x86_64, debian-8.0-x86_64, fedora-23-x86_64
- Required field, Show on Order Form
vpsid
- Field Type: TextBox
- Description: vpsid
- Admin only
iso
Currently, we don't offer ISOs. Do not set up the option ISO
noemail
- Field Type: TextBox
- Description: Do not send an email to the client
- Admin only
Please note:
Configurable Options [OPTIONAL]
You can add the Configurable Options as per your requirements or exclude one or more of the options below if you do not need it.
Note: The order of preference for selection of Configurable Options is first i.e. If a Product/Service has (lets say) Ram defined as 512 MB and you have also created a Configurable Option with variable Ram options, then the users chosen Ram value from configurable options will be used and not the RAM value in Product/Service.
The following are the Configurable Options available in Hostafrica WHMCS module.
- Number of IPs
- Bandwith
To add, go to WHMCS Admin Panel -> Setup -> Products/Services -> Configurable Options. Then click on Create a new Group
Now, click on the Add New Configurable Option button. A new window will open.
Add a configurable option for the Number of IPs as below:
Add a configurable option for Bandwidth as below: 
Other options are possible but should only be used when a Ressler Pool has been bought. Further information can be found here: http://www.virtualizor.com/wiki/WHMCS_Module_for_Resellers_V2
Changing VPS or mask
When ordering a VPS WHMCS would ask for a nameserver. This is not necessary with our VPS. Therefore this option should be hided in order not to confuse the customer when ordering the VPS.
This file has to be altered: /folderofyourWHMCS/templates/orderforms/cart/configureproduct.tpl
Please follow this instruction:
Firewall Port
Please make sure, that the whmcs server has ports 4082,4083,4084 and 4085 TCP and UDP opened (incoming and outgoing).
IP Whitelisting
In order to enable WHMCS to connect to the CLOUD/VPS Cloud backend, your WHMCS IP has to be whitelisted. Please send an email with your WHMCS IP address to support@cloud.co.za
