Revision as of 07:50, 4 May 2012

What is Reseller Central

Reseller Central is a Server Control panel that interfaces with WHM AND Plesk to create a more user friendly front end to control your clients. Reseller Central is created, written and maintained by HostNine (http://www.hostnine.com)

This step by step guide explains how to setup your WHMCS to work with the Reseller Central system offered by HostNine. There are two things you need to do, the first is to configure a server and then the next is to configure your packages.

Configuring the Reseller Central Server

1. All server modules require a server, so begin by going to Setup > Products/Services > Servers
2. Next, click on the Add New Server link
3. On the screen that is presented, next you need to enter the details about the server. There are only 2 fields required for the Reseller Central system and they are the server name and type, however you can enter your username and password if you wish to enter your Reseller Central username and password. In the type dropdown, make sure you select ResellerCentral.

Configuring your Reseller Central Packages

1. Go to Setup > Products/Services
2. Click on the Create New Product link at the top of the page (you will need to have at least one group setup first)
3. On the following page, enter the new name for your Package and choose the group you want to assign it to
4. After clicking the submit button, you will then see all the options for this new package - from here you need to configure the description shown on the order form, pricing and any other details
5. Once you have selected the options you want for this package, you are ready to go to the Modules Settings tab to configure the module settings
6. From the Server Type dropdown, choose "Resellercentral"
7. The required fields for the module will then be displayed which include your API Key which you get from your Reseller Central panel, the Package Name as setup in the Reseller Central panel and the location you want the account to be setup in
8. You should also choose at this point whether to setup a Windows or Linux hosting Account. (Windows hosting is only available in Texas)
9. You must complete all the fields and then click Save to save the changes to the product
10. Finally, you need to create a custom field on the product to store the IP assigned by Reseller Central for each account - to do this go to the Custom Fields tab and add a custom field named "IP Address" - you can then use this in the email templates with the merge field {$service_custom_field_ipaddress}
11. That's it! You have now completed the configuration of your Reseller Central Package.

Offering Clients a Location Choice Dropdown (Optional)

• *Linux Hosting Only*

As you will be aware, when creating an account you can choose the location you want the account to be hosted in. With WHMCS, you can take that further and allow your client to choose where their hosting account is hosted. To do this, follow the steps below:

1. Click the edit icon next to an existing Reseller Central package which you have created
2. Next, click on the Custom Fields tab at the top of the page
3. Now, in the Field Name box, enter "Website Location" - this is what is used to identify what the field defines so it must be entered exactly as shown
4. In the field type dropdown, choose "Drop Down"
5. Now in the Field Options box, enter a comma separate list of the options you want to offer - below are all the options which you can copy and paste if you want to offer your clients all of them:
   
   Berkshire (UK),California (USA),Chicago (USA),Georgia (USA),New York (USA),Singapore (ASIA),Texas (USA),Washington DC (USA)
6. Next tick the Show on Order Form checkbox
7. Finally, click Save Changes and that's it (it really is that easy!) - now this field will show during the order process and the value your customer selects will override the default setting on the Server Settings tab.

Common Error Messages

No Matching Location Found

This error message is saying that the location selection in Module Settings for this package is no longer offered by Reseller Central. You will need to choose a different option in the product configuration page and check that your location list is accurate and up to date.