Home

Gold WHMCS-Cpanel Bridge - It's FREE!

INSTALLATION

If you have no HTML/PHP knowledge, we will be happy to integrate this free plugin module for you with a one time integration cost of $20 USD. Just let us know which WHMCS area/pages you would like your clients to be able to access from your cPanel servers and we'll implement it for you.

If you know what you are doing, have fun and enjoy!

PART 1 - Getting The WHMCS-cPanel Bridge Plugin

  1. Get the plugin here - requires free registration to get your license key
  2. Unzip the gold-whmcs-cpanel-bridge.zip
  3. You will see there are two folders one is cpanel and one is whmcs
  4. Continue below

PART 2 - cPanel Bridge (files in cpanel folder)

  1. Open file bridge.php and edit it according to your WHMCS config settings. We recommend you to enter your SECURE (https) WHMCS URL in the config, so your clients will not get any kind of warning notices from the browser.
  2. Place bridge.php in /usr/local/cpanel/base/frontend/x3 or put it to the location of your active cPanel theme.
  3. You're done for now.

PART 3 - WHMCS Bridge (files in whmcs folder)

  1. Upload all files in the whmcs folder into your existing whmcs installation server
    The default template we used is portal, you may need to upload the .tpl files into your active template folder
  2. Edit your header template file (header.tpl) located in templates/portal/header.tpl (or your active template folder) and add the following code anywhere you want the link to go back to cPanel to display. On our particular example of WHMCS V4.0 installation, we place it on the top navigation menu, which started from the <div id="top_menu">, at the last line of the <li> menus, add this code:
  3. For WHMCS V.40 only: go to your WHMCS admin area, go to Setup > General Settings > Other and list all your cPanel server IP Addresses which will be using the bridge at the bottom of the page where it says API IP Access Restriction.
  4. Edit your cpbridge_license.php file in your WHMCS folder and enter your License Key there.
  5. You're done for now.

PART 4 - Putting It to Use

Now you can pass through both GET and POST variables through the bridge into your WHMCS system. Below are a few examples of what we did on our video guide.

To pass through NON-FORM variables:

  • WHMCS Target URL: http://www.yourdomain.com/whmcs/clientarea.php?action=creditcard
  • Bridge Link (on cPanel side): bridge.php?file=clientarea.php&action=creditcard

 

  • WHMCS Target URL: http://www.yourdomain.com/whmcs/cart.php?a=add&pid=4
  • Bridge Link (on cPanel side): bridge.php?file=cart.php&a=add&pid=4

Notice that the bridge link always starts with file=xxxx.php which is the WHMCS file you want to access, in the above example are clientarea.php and cart.php.

Notice that after the file=xxxx.php there is the & sign, make sure you use that instead of the original ? sign

 

To pass through FORM variables:

I am going to give you a form example I used to register a domain name from cPanel which you see on the video:

<strong>Register New Domain</strong>
<form action="bridge.php?file=cart.php&a=add&domain=register" method="post">
<input type="text" name="sld" value="newdomain">
<select name="tld">
<option value=".com">.com</option>
<option value=".net">.net</option>
<option value=".org">.org</option>
<option value=".ca">.ca</option>
<option value=".info">.info</option>
<option value=".biz">.biz</option>
<option value=".co.uk">.co.uk</option>
<option value=".com.au">.com.au</option>
<option value=".us">.us</option>
<option value=".cc">.cc</option>
<option value=".name">.name</option>
<option value=".kids">.kids</option>
<option value=".tv">.tv</option>
</select><br />
<input type="submit" value="Check Availability" />
</form>

Notice the bolded text on the form above, on the action part, pass through any GET variables you want to pass through. Then simply add any form variables you want to pass through WHMCS. In this case we are passing through two POST variables, which is sld and tld

All POST variables you post through the bridge.php file will be posted through to the WHMCS file you are accessing. So you can create any type of forms which you want to pass through to your WHMCS system.

 

Another FORM example is to pass on WHMCS Add-On products.

I am going to show you the HTML code I used to place a link on cPanel to directly oder any kind of Add-On product you have

<form method="post" action="bridge.php?file=cart.php&a=add" name="form_name_sslcert">
<input type="hidden" name="aid" value="2">
<input type="image" src="https://whmcsgold.com/cpanelicons/file_lock.png" alt="Order SSL For This Account"><br />
<a href="#" onclick="document.form_name_sslcert.submit()">Order SSL Certificate</a>
</form>

Notice the bold text on the form code above, to order an Add-On you must pass through the Add-On ID (aid) which you want to place. You can get the aid of any Add-On product you have from your WHMCS Admin Area > Setup > Product Addons, on this page click to edit any add-on, after you click it and arrive on the edit Add-On page, see your browser's URL, such as http://www.whmcsplugins.com/demo/admin/configaddons.php?action=manage&id=2. That is your aid

Secondly, notice the onclick javascript session, match the form_name there with the name="form_name" section of the form. It has to match, so the form will auto submit when the image/icon is clicked.

Thirdly, when putting your icon images in cPanel, in this case https://whmcsgold.com/cpanelicons/file_lock.png, always use https to avoid security notices from browser when trying to pull the icon images from your website.

 

How To Add Custom Section on Your cPanel

We have provided you with a file called whmcsgold_cpanel.html, now this file is hand written. The HTML file explains for itself (if you're familiar with HTML). So use this file to add your own custom sections and icons on your cPanel for clients to access your WHMCS area.

Where to place whmcsgold_cpanel.html?

  1. Login to your cPanel server and upload/create/place whmcsgold_cpanel.html to /usr/local/cpanel/base/frontend/x3/branding
  2. Open /usr/local/cpanel/base/frontend/x3/branding/index.html
  3. Find the line <div id="boxes">
  4. Place this code below that line: <cpanel Branding="include(whmcsgold_cpanel.html)">
  5. Open your cPanel now (as a client) - you should now see all that new section

Also, as you can see on your cpanel folder there is a folder named cpanelicons which contains many icon images which you can use as icons on your own cPanel area. Enjoy!

Congratulations! We hope this has been fine and you ended up with a smile. If you're having any kind of problem, you may request an installation service for only $20 USD here.

 

UPCOMING RELATED MODULE - WHMCS-cPanel Bridge Manager

With this management module, you will be able to manage every aspect of the bridge plugin through an easy to use user interface where you can actually "pick" which products/addons you want to add to your cPanel or which WHMCS sections you want to link to your cPanel.

Additionally, all your cPanel servers will automatically syncronize the new customized cPanel sections when it is being updated on the bridge manage.

Stay tune!