Setting up Web Host Manager Complete Solution (WHMCS) with your Exodus Hosts reseller hosting account allows you to automate the provisioning of your Exodus Hosts services to your own clients. Clients will be able to buy products from your site without the need for you to set them up these manually from within your Exodus Hosts account.
Here's a handy video guide, or you can follow the steps below.
1.1 Getting Started
To setup WHMCS with Exodus Hosts you'll firstly need to buy a licence. If you have an existing licence you can purchase Exodus Hosts's discounted WHMCS licence and switch this over using the guide here: How do I change the license key WHMCS uses?
Once you've bought the WHMCS licence you'll need to install it to your webspace.
1.2 Installing WHMCS
At Exodus Hosts we provide a one-click installation process for WHMCS. To use this head to https://my.Exodus Hosts.com/whmcs. You'll see the 'Install' button next to your active licence. Choose this and you'll be prompted to choose a package and a directory to install WHMCS.
Once you’ve installed WHMCS, login into your admin panel: www.Yourdomain.com/yourWHMCSdirectory/admin
Now that you’ve logged-in you'll need to obtain the combined API key. This can be found within your Exodus Hosts Reseller account by going to “Reseller Management” > “Reseller Preferences” > “API”, or by going here: https://my.Exodus Hosts.com/reseller/api
Note: Please keep a note of the Combined API Key as this will be used later on.
1.3 Adding your Exodus Hosts Products to WHMCS
1.3.1 Creating custom client fields
When your clients sign-up and purchase products from you, a exodusCP User needs to be created to allow them access to manage their products. Their level of access can be controlled by you as the reseller. To enable exodusCP User creation when your clients sign-up you'll just need to create a custom client field.
- Within your WHMCS admin, navigate to “Setup” > “Custom Client Fields”. Create the new field, You will need to check 'Admin Only' from the check boxes shown.
- You can name the first field anything you like, for example “exodusCP User”.
- You can now proceed to creating product/services fields.
1.3.2 Connecting to the API
- Within your WHMCS admin, navigate to “Setup” > “Products/Services” > “Servers”
- You can name the server anything, for example “Exodus Hosts’s WHMCS module”.
- You will need to enter your default name servers this will be:
Note: If you have Virtual Nameservers (custom nameservers) you can enter these instead.
Locate server details a little further down the page and choose “Exodus Hosts”. You can leave the username blank and then enter in the combined API key as the password.
1.3.3 Creating product/services fields
- You'll now want to look at adding the products that you'll be selling from Exodus Hosts via WHMCS. These will be the hosting package types that you have set up within your MyExodus Hosts account.
- Navigate to “Setup” > “Products/Services” > “Product/Services”, then choose the 'Custom Fields' tab.
- The Field Name will need to be “packageId”. You will need to choose this field to be 'Admin Only'.
- Once you've done this head to the 'Module Settings' tab - from here, choose 'Exodus Hosts' from the 'Module Name' drop down menu.
- From the 'Type Code' dropdown, choose the package type for the product you're configuring.
- Click 'Save Changes'.
Note: For each product/service you configure you will need to add a new custom field.
You can now proceed to set up Exodus Hosts as the domain registrar.
1.3.4 Setting up domain registrars
- Within your WHMCS admin, navigate to “Setup” > “Products/Services” > “Domain registrars”.
- You should see 'Exodus Hosts' in the list of modules, please choose'Configure'.
- Enter your combined API key into 'Password' field. (You can leave your admin username blank)
- Choose your admin user.
- Choose your custom user field that you created. Our example was “exodusCP User”.
- You can now click 'Activate'.
1.3.5 What's next?
Now the Exodus Hosts WHMCS module should now be linked with your account. If you already have services and exodusCP users within Exodus Hosts then you'll want to import those into your WHMCS set up.