LiveZilla Live Chat Software
RCM - Resellerclub Mods

Howto install R.R.D.Hosting Module V3

RRDHM - Resellerclub Reseller Domain Hosting Module
Release Date
Latest Version
20.10.2016
3.12.0

 

Would you like to have it installed by us? - Order installation service for this module here

Document Version: 2.7 - 31-05-2016

Step 1

Resellerclub Mods Management Core Console (Addon)

 

All our products requires the Resellerclub Mods Management Core Console Addon. Download the Addon from the product license details page TAB "Download" and install first this Addon.

If already installed, make sure you run version v1.4.0 or greater.

Visit the install instructions for the ResellerClub Mods Management Core Console Addon if you havent the Addon installed/updated. Once installed/updated and configured your reseller credentials as well as the product license, go ahead with the Module Installation in STEP 2.

Step 2

Upload files and folders

 

Download RRDHM - ResellerClub Reseller Domain Hosting Module from the product license details page TAB "Download". Unzip the file with your prefered decompresion software. Please read carefully all the steps in this document. You should not skip any steps provided.

The following instruction explains where you have to upload folder and files:

  1. Server Module
    Upload the folder "modules" into your whmcsroot/ folder

You are now ready for setup your first Reseller Bulk Hosting Product!

Step 3

Email Template Setup

 

A standard default welcome email named as "RRDHM - Hosting Welcome Email" will be automatically installed in Setup » Email Templates once you configure your first Reseller Bulk Hosting Product.

Setup a Hosting Product in WHMCS

 

The following instruction explains how you have to setup a product in WHMCS. Most of users are yet familiar with this step. However, we strongly recommend to follow each of the steps provided below to assure correct setup. All steps are examples and based on Linux Reseller Hosting Plan R3 Product setup:

Product Group setup

 

  1. You should create a new global product group for all your Reseller Hosting plans if you do not have any yet created. Goto Setup » Products/Services and click "Create a New Group". Set a Product Group Name, for example "Reseller Hosting" and click the button "Create Group".

    Product Group setup

Hosting Product setup

 

  1. Goto Setup » Products/Services, click "Create a New Product", select product type "Hosting Account" and select the group you just created in the above step. Name the product, for example "Linux R3" then click "Continue".

    MANDATORY: Product Type must be set to "Hosting Account"

    Hosting Product setup


  2. You are now on the "Edit Product" page. Clic the TAB "Module Settings" and select the Module Name called "Rcmodrdhosting". This will load the module configuration:

    Module Settings Hosting Product setup

    Before anything else, select first the LogicBoxes Registrar you have previously configured in the Resellerclub Mods Console Addon (TAB Step 1) and then click the button "Save Changes".

    Select LogicBoxes Registrar


    Now you should see that the module has found "your reseller account credentials" and the API connection has been established successfully. If the API connection has been successfully established, then proceed with the configuration steps below to setup the module for this product, otherwise check your Reseller Account settings in Addons » "ResellerClub Mods Console":

    Hosting Module Settings


  3. Select the "Hosting plan" from the dropdown menu the module has detect in your LogicBoxes Products account. In this example we use the hosting plan "Linux Reseller Hosting Plan - R3"

  4. Set if you like, other colors for the messages or just leave blank to use the standard values.

  5. The Dashboard check box allows "deactivating" the Management Dashboard in the Client Area. If you do not want allow Customers to manage the Service, then you can activate the checkbox and the Dashboard will not be displayed.

  6. Dashboard Style: Accordingly to your WHMCS design, you can select the apropiate built-in Dashboard design. If you use a custom theme and any of the provided built-in style does not match your theme, then you may have a look at TAB "EXPERT" to learn how you can create easly your own Dashboard design to fit your custom theme.
    • Dashboard Style default for WHMCS template style "default"
    • Dashboard Style five for WHMCS template style "five"
    • Dashboard Style six for WHMCS template style "six"
    • Dashboard Style classic for WHMCS template style "classic"
    • Dashboard Style portal for WHMCS template style "portal"

  7. The "R.A.M.D.I" check box allows you to use our Dns Management Interface Solution if you have it installed. If not checked, OrderBox Dns Management button for direct login would be shown instead.

  8. WHMCS License: If activated, the customer can request a free provided WHMCS License key from the Client Area Dashboard. If not activated, a link to open a support ticket for license activation will be displayed.

  9. Select "Automatically setup the product as soon as the first payment is received". This will add a Hosting order immediately into your LogicBoxes account when a customer pays the invoice and if you have sufficient funds available. This is the recommended setup for full automated provisioning and renewals.

  10. Click now the "Details" tab from where you can see the Product Type, Product Group and the Product Name. Create a product description for the Hosting Product, select the "RSDHM - Hosting Welcome Email" from the "Welcome Email Dropdownlist" and activate the option "Require Domain" . All other options as per your needs:

    Details Hosting Product setup


  11. Click now the "Upgrade" tab and tick the checkbox "Configurable Options " but do not select any of products from the Packages Upgrade menu:

    Activate Hosting Module


  12. Under the "Pricing" tab select Payment type "Recurring" and setup your selling prices for Monthly, Quarterly, Semi-Annually, Annually, Biennially and Trieannally.

    NOTE: Make sure you have activated all the pricing/billing slabs for the product in your reseller account!

    TIP! You only need to set the selling prices for the default currency. All other currencies can be updated automatically using the whmcs built-in function "Update Product Prices" from Setup » Payment » Currencies:

    Pricing Hosting Product setup


  13. Finally click the "Save Changes" and "Back to Product List" button from where you will see your created product, similar to the below image:

    Hosting Product Overview

Repeat the "Hosting Product Setup" Steps above for all other Reseller Hosting Plans you would like to sell.

TIP! Use the "Duplicate Product" option and simply adjust the duplicated product details, selling prices and select the appropriate product plan from the dropdownlist "Hosting Plan".

When finished with the "Hosting Product Setup", proceed to the "Configurable Options" from STEP 4 in this document.

Step 4

Configurable Options

 

The next step is setting up configurable options to sell additional IP's for all your Reseller Hosting Plan's. This setup is mandatory and you need to setup the configurable options even if you would not offer to sell these Addons. However, you can use the hide option to stop the selling of configurable options.

IMPORTANT: Please read all carefully and follow exactly the given setup steps.

Setup Additional Server IPs (valid for Reseller Hosting Plans, Dedicated and VPS Servers)

 

TIP! If you have our R.V.P.Server Module and/or D.H.S.Server Module installed, then you have the configurable option for selling Additional IP's set up and configured! You only need to edit and select the newly created Reseller hosting plans from the Menulist "Assigned Products". However, if you require more control over selling prices for each product, then you can create for each module a separate configurable option group for Additional IP's. In this case, be sure to name Group Name and Option Name different.

  1. Goto Setup » Configurable Options and click "Create a new Group"

    Configurable Options Group


  2. You will see in the menu field "Assigned Products (3)" the Reseller Hosting Plans you have created in the "PRODUCT SETUP" step. Insert a "Group name (1)", for example "Server IPs" and insert a "Description (2)", e.g. "Additional Server IPs (ResellerClub Reseller Hosting, VPS and Dedicated Servers)"

  3. Select the Reseller Hosting Plans you have created.

    Note: Select all Reseller Hosting Plans you are selling. Multiple selects by pushing Keyboard key "Ctrl". If you have our Module for VPS and/or Dedicated Server installed, make sure you select also all VPS and Dedicated Server plans since the same configurable option can be used for all products!


  4. Click the "Save Changes (4)" Button and hold on until you see the "Add new Configurable Option" Button with a new empty table as shown below:

    Manage Configurable Options for Additional IP's


  5. Click the button "Add New Configurable Option (5)". This opens a new window for setup the pricing and other options.

    Setup Configurable Options for Additional IP's


  6. Insert under "Option Name (6)" for example: Server IPs. From the "Option Type (7)" dropdown select "Quantity". Under "Add Option (8)" insert, for example Server IPs. Then Simply click the button "Save Changes (9)" and you will see the pricing tables below:

    TIP! You only need to set the selling prices for the default currency. All other currencies can be updated automatically using the whmcs built-in function "Update Product Prices" from Setup » Payment » Currencies:

    Pricings for Additional IP's


  7. Leave the field "Maximum Allowed (10)" blank for no limit. Setup your "Selling Prices (11)" according the billing cycle product setup, Monthly, Quarterly, Semi-Annually, Annually, Biennially and Triennially. Do not change the Order value. This must be set to 0

  8. Click the "Save Changes (12)" and then the "Close Window (13)" Button. This creates automatically a new entry in the table as shown below:

    Overview Configurable Options


  9. Click "Save Changes (14)" and then the "Back to Groups List (15)" Button.

Your Reseller Hosting Plans with Configurable Options setup is now completely done and you can start selling the services. Optionally, you may have a look at the tab's "TEMPLATE" and "EXPERT" to learn more about styling and customizing your own Dashboard.

Template

Dashboard Setup

 

There is no special setup needed for implementing the Reseller Domain Hosting Management Dashboard. It will be displayed based on the style settings and automatically if not deactivated in the Product Setup tab "Module Settings".

Reseller Bulk Hosting Dashboard

If the Dashboard is not displayed on the client area details page for the product even if you haven't deactivated the same, then you have to check if the smarty variable {$moduleclientarea} is present in your customized clientareaproductdetails.tpl template file:

  1. Open the "clientareaproductdetails.tpl" from your active template folder.

  2. Check if you have the following code in your clientareaproductdetails.tpl:

    For WHMCS classic and portal template:

    <div align="center">{$moduleclientarea}</div>

    For WHMCS default based templates:

    {if $moduleclientarea}<div class="moduleoutput">{$moduleclientarea|replace:'modulebutton':'btn'}</div>{/if}
    

    if the above code is not present, then you need to insert it just above the statement "{if $username}"


  3. Upload your modfied files back into your whmcs active template folder.

Expert

Customizing Dashboard

 

The R.R.D.Hosting module allows you to offer your own and fully customized Management Dashboard. The following smarty variables are available to build your own dashboard for your customized template design.

The following smarty variables are available:

  • {$domainid} = Domain ID (string)
  • {$rc_status} = The status of the Reseller Hosting Service: Active, Suspended, etc. (string)
  • {$rc_ipaddr} = The hosting server Primary IP address (string)
  • {$rc_adminuser} = Username for Cpanel / Plesk / FTP login (string)
  • {$rc_adminpass} = Password for Cpanel / Plesk / FTP login (string)
  • {$rc_webspace} = Allocated Webspace (string)
  • {$rc_nsservers1} = Primary DNS Server (string)
  • {$rc_nsservers2} = Secondary DNS Server (string)
  • {$rc_bandwidth} = Allocated bandwidth (string)
  • {$rc_demourl} = Assigned Demo URL (string)
  • {$rc_addips} = Additional IPs, <br /> separated and with buy link(string)
  • {$rc_newaddips} = Additional IPs, <br /> separated (string)
  • {$rc_bulkhostingdetails} = The complete Bulk Hosting details (array)
  • {$hostingbutton} = Prestyled form button for cPanel or Plesk Auth login (string)
  • {$whmbutton} = Prestyled form button for WHM Auth login (string)
  • {$whmcsrequestbutton} = Prestyled form button for request WHMCS License (string)
  • {$passresetbutton} = Prestyled form button for Control Panel Password reset (string)
  • {$dnsbutton} = Prestyled form button for DNS management, Orderbox DNS or R.A.M.Dns Interface (string)
  • {$dnssetupbutton} = Prestyled form button for Auto Change Name server and DNS Record setup (string)
  • {$rc_buyips} = Link to buy Additional IP's (string)
  • {$no_addon_links} = If Addon links are set to be exposed or not. Empty if enabled and "on" if disabled (string)
  • {$a_records} = All A Records for external DNS Setup (array)
  • {$mx_records} = All MX Records for external DNS Setup (array)
  • {$is_servers_autons} = If Hosting Nameservers autochange button should be exposed or not. Empty if disabled and "on" if enabled (string)
  • {$is_branded_autons} = If Branded Reseller Nameservers autochange button should be exposed or not. Empty if disabled and "on" if enabled (string)
  • {$dns_servers} = Hosting Server Name Servers (array)
  • {$dns_servers_branded} = Partially or full branded required DNS Servers (array)
  • {$rc_rcplanname} = The Reseller Plan name (string)
  • {$module} = Identifies the name of the module: rcmodrdhosting (string)
  • {$nschangemessage} = Auto change success or error message (string)
  • {$active_color} = Font Color for status message "Active" as HEX value (string)
  • {$suspend_color} = Font Color for status message "Suspended" as HEX value (string)
  • {$inactive_color} = Font Color for status message "InActive and Pending " as HEX value (string)

Howto Style your own Dashboard

 

  1. Create an empty file with your html editor or any text file editor such as notepad and add your customized html code. A valid Complete Code Example is available below.

  2. Save the file as clientarea.tpl and upload it into the /whmcsroot/modules/servers/rcmodrdhosting/ folder

  3. Goto to the Products Setup TAB "Module Settings" and deactivate the Built-in Dashboard

Complete Code Example

 

{*
 * RCM Reseller Domain Hosting Management Dashboard Template
 *
 * @package		Resellerclub Mods (gIF)
 * @author		Resellerclub Mods contact[at]resellerclub-mods.com
 * @copyright	Copyright (c) resellerclub-mods.com 2011-2016
 * @license		http://www.resellerclub-mods.com/en/terms-of-service/eula.html
 * @link		http://www.resellerclub-mods.com/
 * @version		v3.11.1
 *}
 
<div align="center">
	<h2>{$LANG.rcrdh_managementtitle}</h2>
	{if $rc_status eq "Active"}
		<table>
			<tr>
				<td><h4>{$LANG.rcrdh_statustitle}</h4></td>
				<td>
					<span style="color:{if $active_color}{$active_color}{else}#006600{/if};">{$rc_status}</span>
				</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcrdh_controlpanelstitle}</strong></td>
				<td>
					<div style="float:left;padding:2px;">{$hostingbutton}</div>
					<div style="float:left;padding:2px;">{$whmbutton}</div>
					<div style="float:left;padding:2px;">{$passresetbutton}</div>
					{if $dnsbutton}
						<div style="float:left;padding:2px;">{$dnsbutton}</div>
					{/if}
				</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcrdh_whmcslicensekeytitle}</strong></td>
				<td>
					<div style="float:left;padding:2px;">{$whmcsrequestbutton}</div>
				</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcrdh_demourltitle}</strong></td>
				<td><a href="/{$rc_demourl}" target="_blank">{$rc_demourl}</a></td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcrdh_cpaneladminusertitle}</strong></td>
				<td>{$rc_adminuser}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcrdh_cpaneladminpasstitle}</strong></td>
				<td>{$rc_adminpass}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcrdh_ipaddresstitle}</strong></td>
				<td>{$rc_ipaddr}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcrdh_addonipaddresstitle}</strong></td>
				<td>{$rc_newaddips}{if $no_addon_links neq "on"} {$rc_buyips}{/if}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcrdh_webspacetitle}</strong></td>
				<td>{$rc_webspace}</td>
			</tr>
			<tr>
				<td><strong>{$LANG.rcrdh_bandwidthtitle}</strong></td>
				<td>{$rc_bandwidth}</td>
			</tr>
			<tr>
				<td colspan="2"><strong>{$LANG.rcrdh_nsservertitle}</strong></td>
			</tr>
			<tr>
				<td colspan="2">
					{if $is_branded_autons eq "on"}
						<strong>{$LANG.rcrdh_nsrecommended}</strong><br />
						{foreach key=num item=ns from=$dns_servers_branded}
							{$ns}<br />
						{/foreach}
						<br />
					{else}
						<strong>{$LANG.rcrdh_geonsrecommended}</strong><br />
						{foreach key=num item=ns from=$dns_servers}
							{$ns}<br />
						{/foreach}
						<br />
					{/if}
					{if $is_branded_autons eq "on" || $is_servers_autons eq "on"}
						{if $nschangemessage}{$nschangemessage}{/if}
						{if $dnssetupbutton}{$dnssetupbutton}{/if}
					{/if}
				</td>
			</tr>
			<tr>
				<td colspan="2"><strong>{$LANG.rcrdh_nsexternal}</strong><br />
					{foreach key=num item=arecs from=$a_records}
						<div>{$arecs.0} - {$arecs.1} - {$arecs.2} - {$arecs.3}</div>
					{/foreach}
					{foreach key=num item=mxrec from=$mx_records}
						<div>{$mxrec.0} - {$mxrec.1} - {$mxrec.2} - {$mxrec.3}</div>
					{/foreach}
				</td>
			</tr>
		</table>
	{else}
		<table>
			<tr>
				<td><h4 style="width:30%">{$LANG.rcrdh_statustitle}</h4></td>
				<td>
					<span style="color:{if $inactive_color}{$inactive_color}{else}#FC7202{/if};">{$LANG.rcrdh_hostingpreparing}</span>
				</td>
			</tr>
		</table>
	{/if}
</div>

Latest Tweets

More Tweets from resmods

Latest News

Black Friday and Important News!

Black Friday is coming and will start tonight! Don't miss it and get the best possible discount on our complete Portfolio!
Read more...

About Us

Who we are, what we do and everything else about Resellerclub Mods, a gIF Business Project: