Knowledgebase

IMPORTANT NOTE: UPGRADING FROM OLDER VERSION THEN v1.6 MODULE DEACTIVATION MUST BE DONE AFTER UPDATE NOT BEFORE

[2021/01/19] Version 1.7.5 Changelog:

• WHMCS 8.1 cart theme update

[2020/09/30] Version 1.7.3 Changelog:

• Backup quota validation

[2020/08/25] Version 1.7.1 Changelog:

• Text Changes

[2020/08/25] Version 1.7.0 Changelog:

• Fixed Change Package functionality

[2020/06/11] Version 1.6.9 Changelog:

• Fixed Module Change

[2020/06/11] Version 1.6.8 Changelog:

• Fixed Module Change

[2020/05/26] Version 1.6.7 Changelog:

• Fixed admin panel vm info
• Fixed version numbering

[2020/04/17] Version 1.6.6 Changelog:

• Fixed custom orderform template issues.

[2020/02/02] Version 1.6.5 Changelog:

• Fixed hooks errors.

[2020/01/10] Version 1.6.4 Changelog:

• Extended suspend/unsuspend functionality.

[2019/11/19] Version 1.6.3 Changelog:

• Fix for wrong redirection after backup create.

[2019/08/29] Version 1.6.2 Changelog:

• Stability tweaks

[2019/07/08] Version 1.6 Changelog:

• Stability tweaks
• Added additional locations
• UPDATING TO 1.6 AFTER UPDATE PLEASE DISABLE AND ENABLE MODULE IN WHMCS (DISABLE AFTER UPDATE NOT BEFORE)

[2019/06/10] Version 1.5.1 Changelog:

• Stability tweaks
• Compatibility tweaks for older PHP versions

[2019/04/06] Version 1.5 Changelog:

• Added JWT encryption/decryption
• Stability tweaks
• Special template for reseller products (Refer to updated point 16 in this guide to learn how to change template for product gorup)

[2019/04/06] Version 1.4 Changelog:

• Added Backup management
• Added Usage Statistics
• Stability tweaks

[2019/03/06] Version 1.2 Changelog:

• Upgrade functionality has been added
• Upgrade configurable options has been added
• Console access from client area has been added
• Minor Bug Fixes
• Clients now can generate API credentials themselves

API documentation here

1.   Download our reseller module version 1.7.5 : Download



2. You will need to extract downloaded file, using software like “7zip”, “winrar”, “unzip”, in which you will find folder shown in screenshot below.


 
3. The folder needs to be uploaded to your root whmcs folder, where the “modules” directory is located.



4. Login into your WHMCS admin control panel



5.  Go to Setup -> Addon Modules




6. Find the “HostAfrica API Module”. Click Activate and after Module is active press the Configure button




7.  Check the “Full Administrator” checkbox and click “Save Changes”



8. Open API Management Page in profile

9. In API Management page

• Enter IP address of server where your whmcs is located.
• Press Generate on both buttons
• Copy Your API Key and API Secret (do not share these keys with anyone else)
• Press Submit Button.

10. In your WHMCS admin control panel go to Addons -> HostAfrica API Module

11.     Click on the “Add Credentials” button

12.     In the following form, enter the required credentials and press the “Submit” button

• Email address – Enter the email address that you use for your client profile in our WHMCS.
• API Key – Enter the API key we have provided you.
• API Secret – Enter the API Secret we have provided you.
• Host – URL of WHMCS where your account located. (https://my.hostafrica.co.za)

13.  In your WHMCS admin control panel go to Setup -> Products/Services -> Products/Services




14. Create a new product group by the clicking button at the top of the page



15.  Configure product group. You can name it anything you want. 
In Order Form Template select HA VPS Reseller Cart.



16. Create New product from Products/Services. Press Continue.

⦁    Product Type – Dedicated/VPS Server
⦁    Product Group – Group you have previously created
⦁    Product Name – This is your product name



17.  Go to Module Settings and Chose Module “Host Africa”, then save changes




18. After saving, product dropdown will load into the page. Choose product you want to setup. Press “Save Changes”.




19.  Select Product plan you want to resell and press “Save Changes” once more.




20. Go to Custom Field tab and enter fields data and Save Changes.

• For Windows Cloud Server (Reseller), Cloud Server (Reseller),  Virtuozzo Container (Reseller) configure custom fields like this:
  • Field Name – OS|OS Template
  • Field Type – Drop Down
  • Select Options – Available OS template list:

• • Required Field – Should be checked
  • Show on Order Form – Should be checked

• For Additional location servers configure custom fields like this:
  
  • Field Name – osTemplate|OS Template
  • Field Type – Drop Down
  • Select Options – Available OS template list

21. Go to Setup -> Products/Services -> Configurable Options




22.  Click “Create a New Group”



23. Fill Out New Configurable Options Group Details and press “Save Changes”.

-          Group name – Name can be anything     

-          Description – Not required

-          Assigned Products – Select products you just created



24. For Windows Cloud Server (Reseller), Cloud Server (Reseller),  Virtuozzo Container (Reseller): Press “Add New Configurable Option” and fill out the form and press “Save Changes”

25. For Windows Cloud Server (Reseller), Cloud Server (Reseller),  Virtuozzo Container (Reseller): Repeat step 22 with following configurable options


26. For Additional location servers: Press “Add New Configurable Option” and fill out the form and press “Save Changes”

27. For Additional location servers: Repeat step 22 with following configurable options




The Setup is now complete