How to configure WHMCS in Hosting Controller?

Question: How to setup Hosting Controller with WHMCS?

Solution: 

Setting up servers for WHMCS.

1.  Copy WHMCS installation folder at HCInstalledPath/Tools. WHMCS directory name must be "WHMCS".
2.  Create folder with name "HC" at WHMCS\modules\servers\ path and copy the HC.php file in it.
3.  Rename file Configuration.php.new to Configuration.php located at HCInstalledPath/Tools/Whcms.
4.  Repeat Step 1 and 2 for all of your Windows web servers.    

           Configure & Install WHMCS from HC

1. Enable HCAPI in HC from Host level path My Server :: API Configuration. (Make sure API link is browseable/accessible)
2. Enable WHMCS from My Servers :: Configure Panel :: General Settings. 
3. Select WHMCS Billing from Billing System :: Configure Billing and then click on the Next button. 
4. Select the website on which you wisj to install WHMCS*.
5. Enter the virtual directory name to be accessed under selected website.  
6. Select the DB server instance for WHMCS database. Now enter the database name and the login information and click on the Install WHMCS button. 
7. Clicking on Install WHMCS button will open the actual WHMCS installation wizard. Follow the steps and run the wizard.  
8. Now on the Database information page in the wizard enter the same database information as entered in step 5.
9. After the successful installation, close the wizard and return to HC then click on the Finish Installation button. 

• While Adding Server; 

1. Add HC web server in WHMCS and enter the information same as entered in HC for this server.  
2. Select "HC" from the server type combo under Server Details heading. Enter HC login name and password. All of WHMCS accounts will be added under this HC owner on this server in HC. 
3. In WHCMS go to Setup :: Custom Client Fields  create Panel Login Name and check the required field & shown on order form. And add the second custom field with name Panel Login Password check the required field & shown on order form  
4. If you have multiple web servers in HC cluster that you wish to be managed through WHMCS then you will need to add all web servers as mentioned above in points 1 & 2.
5. If you have both Linux & Windows web servers in HC clusters then you will need to create two separate groups in WHMCS Setup :: Servers and assign respective servers in it.

• While Adding products;  

1. From the Module Settings tab select the Module Name as HC from the combo.
2. Assign any of WHMCS added servers to this Product from Default Install Server combo. If the assigned server owner is a host then uncheck this option. Tick to show domain registration options from the Detail tab, because you can not add a domain directly under a host in HC.
3. Enter Plan Name exactly same as any of your HC plans depending upon selected Default Install Server. 

 This is it!!! All configurations and settings for WHMCS are done. On the "Products & Services" tab in Clients Detail page. Here there will be 5 buttons ‘Create’, ‘Suspend’, ‘Unsuspended’, ‘Terminate’ and ‘Change Password’. This is the place to manage all clients for HC. 

Note:   

• Install only one instance of WHMCS on a website.
• These information will also be required in the actual WHMCS installation wizard.
• The name of the field must be "Panel Login Name". This Field will be shown in product signup and the user in HC will be created with the data entered in this field.

WHMCS on standAlone Machine
If WHMCS is running on a machine where HC is not installed then follow these instructions:
 
    1.    On remote WHMCS machine, create folder with name "HC" at WHMCS\modules\servers\ path and copy the HC.php and hcsettings.xml files in it (view readme file for tags description of hcsettings.xml file).

    2.    Enable API on a website from HC panel at My Server :: API Configuration  from host level in HC panel.