LiveZilla Live Chat Software
RCM - Resellerclub Mods

Howto install R.E.E.Hosting Module v4

Latest Stable Version
v4.0.4
Release Date: 14.11.2017

 

Before you Start!

R.M.M.Core Console v4

 

Have you installed and configured the Addon R.M.M.Core Console v4?

If you have not installed the Addon, then click the following Installation Documentation link to install the Addon first, required for all our modules: Howto Install R.M.M.Core Console v4

Once you have the Addon installed, proceed with TAB "Install" from this Installation Document.

Install

Install R.E.E.Hosting Module v4

 

Goto to WHMCS » Addons » RCM Core Console v4 and access the R.E.E.Hosting Module Dashboard from the left sidebar Addon Menu. You should be able to see the following Management Area:

Resellerclub Mods Console Module AutoInstall

Auto Install

To install the module, simply click the Button "Install" and the Core Addon will install the Module for you automatically.


Manual Install

If you prefer to use the manual install method, then feel free to do that by following the below small guide:

  1. Download REEHM - Enterprise & Business Email Hosting Module from the product license details page TAB "Downloads". Unzip the file with your prefered decompresion software.

  2. Upload the complete folder "modules" from the unzipped local folder \rcmreehm_X.Y.Z_PHP_5.X\ into the whmcsroot/ folder. The "whmcsroot" folder is where you have installed your WHMCS.

    In order to avoid errors and undesired surprises, you should not upload files and folders individually! Simply upload the complete folder modules into the folder where you have installed WHMCS.


  3. Goto to WHMCS » Addons » RCM Core Console v4 and access the R.E.E.Hosting Module Dashboard from the left sidebar Addon Menu and click the "Validation" Button to finish the manual install.

    Resellerclub Mods Console Module Manual Install

Once the Module has been successfully installed with the Auto or Manual Install Method you are ready to proceed with TAB Administrators Guide!

Administrators Guide

Managing the REEHM - Enterprise & Business Email Hosting Module

 

To manage the Module, navigate in WHMCS to » Addons » RCM Core Console v4 and access the R.E.E.Hosting Module Dashboard from the left sidebar Addon Menu.

 

Getting started

 

First Time Setup

If this is the first time you install our Module to sell and manage OpenXchange based Enterprise & Business Email Hosting plans, then start right away with the AutoSetup Guide. Once you have setup all Products you would like to sell, proceed with the AutoAddons Guide.


Currently using the v3 REEHM - Enterprise & Business Hosting Module

Before you can migrate your current Services to the new v4 Module you need to setup first all Enterprise & Business Email Products and Configurable Options. Start with the AutoSetup and AutoAddons Guide. Once you have Setup Products and Configurable Options, proceed directly with the AutoMigrate Guide to move all current services to the new v4 Module.


Documentation Sections:

R.E.E.Hosting Module

 

This is the Management Area with all details for your License, the Module Overview and the Module Settings at a glance:

Resellerclub Mods Console Module Dashboard

Edit Welcome Email

With the installation, the Module has created automatically a Standard Welcome Email Template which you can use for the Product Setup. Click the Button "Edit Welcome Email" and feel free to modify to your liking.


Selling Prices ManualSync

By default, Selling Prices for Configurable Options will not be updated automatically with the Selling Prices from your Reseller Account when the daily cron runs. You can activate this option in TAB "Settings" or you can use the Button "Selling Prices ManualSync" to update all your Product Selling Prices in WHMCS. Both Options, AutoSync as well as ManualSync will fetch your Selling Prices from your Reseller Account.


Recurring Prices ManualSync

By default, Recurring Prices for Products will not be updated automatically with the Selling Prices from your Reseller Account when the daily cron runs. You can activate this option in TAB "Settings" or you can use the Button "Recurring Prices ManualSync" to update all Active Customer Products. Prices for all Configurable Options (Product specific and custom configurable options if present) are included into the recurring price update.

Further details about Selling Prices and Recurring Prices AutoSync are available in TAB "Settings".

 

AutoUpdate

 

Resellerclub Mods Console Module AutoUpdate

Automated Update

Whenever we release a new update you will be notified instantly by accesing the Management Area in TAB "R.E.E.Hosting Module". From TAB "AutoUpdate" all you need to do is click the Update Button and the Module will be updated automatically to the latest available stable release.


Manual Update

If you prefer to use the manual update method, then feel free to do that by following the below small guide:

  1. Download REEHM - Enterprise & Business Email Hosting Module from the product license details page TAB "Downloads". Unzip the file with your prefered decompresion software.

  2. Upload the complete folder "modules" from the unzipped local folder \rcmreehm_X.Y.Z_PHP_5.X\ into the whmcsroot/ folder. The "whmcsroot" folder is where you have installed your WHMCS.

    In order to avoid errors and undesired surprises, you should not upload files and folders individually! Simply upload the complete folder modules into the folder where you have installed WHMCS.


  3. Goto to WHMCS » Addons » RCM Core Console v4 and access the R.E.E.Hosting Module Dashboard from the left sidebar Addon Menu. Click the "Validation" Button below the License Information to finish the manual update.

 

AutoMigrate

 

Resellerclub Mods Console AutoMigrate

Migration

If you currently have Services configured with our v3 Module then they will appear in TAB "AutoMigrate". Use the AutoMigrate Tool to migrate easily all your current Services to the new Module by clicking the Button "Migrate selected Services ". If you want to migrate only some of the current Services then you can select those Services with the corresponding checkbox.

Post Migration

Once you have all services migrated to the new Module you should consider to remove the old v3 Products in WHMCS » Setup » Products/Services » Products/Services. If for any reason you would like to maintain the old products, then you can just activate the checkboxes "Hidden" and "Retired" from the Products Setup TAB "Details"

 

AutoSetup

 

Resellerclub Mods Console AutoSetup

Automated Product Setup

Creating new Products in WHMCS is a time consuming manual task. With the new AutoSetup Tool you can setup new Products you would like to sell very fast. Everything is preselected and preconfigured by default and you can simply accept and create your Products immediately with a simple click! However, it is recommended to go through the Product Setup form and review all the available Settings:


Global Product Settings

Selling a hosting product requires always a domain name being associated. You can use the whmcs built-in "Require Domain" option to request the domain name or you can use a custom field for this purpose. Further details about the Global Settings are available onscreen.


Importing Selling Prices

Note: All Enterprise & Business Emails Base Products will have a selling price with 0.00! Selling prices are handled exclusively with Configurable Options for Email Accounts.


Products/Services

All Products available in your Reseller Account and not setup yet in WHMCS will be shown in the AutoSetup Form. All settings are preselected and prefilled. Feel free to modify everything to your liking. If you do not want to setup a specific Product, then simply disable it with the enable/disable switch to exclude the Product from the setup Process. Further details about Products/Services are available onscreen.


Once the AutoSetup process has been successfully executed you will be redirected to TAB Products which shows an Overview for all the Current and Active Products/Services as well as the Service Addons (Configurable Options) for each Product

 

AutoAddons

 

Resellerclub Mods Console AutoAddons

Product/Service Addons Setup

This tool will create the required Configurable Options to sell Email Accounts for each Email Hosting Product. These Configurable Options are mandatory and required to sell Enterprise & Business Email Hosting Services.

Background history

Unlike the new v4 module, all Products have shared the same Configurable Option using the old v3 module with a single Base Product Setup for Business Email and a single Base Product Setup for Enterprise Email. The base Product for Business and Enterprise Email was including by default always one Email account and additional Email Accounts were offered with a unique single Configurable Option for each Base Product. With the new v4 module you offer now 4 Products for Business Email and 4 Products for Enterprise Email. Each of the product will have its own Configurable Options with a minimum and maximum of Email accounts.

Configurable Options for Service Addons

The form is prefilled with the labels for Group Name, Group Description, Option Name and Options. Feel free to customize the labels.


Once the AutoAddons process has been successfully executed you will be redirected to TAB Products which shows an Overview for all the Current and Active Products/Services as well as the Service Addons (Configurable Options) for each Product.

 

Products

 

Resellerclub Mods Console Product Overview

Overview

The Products TAB shows all Products and the corresponding Addon for each Product currently setup with the v4 Module at a glance.


Products and Addons

The Product Management Button allows you to access the Products Setup directly without the need to navigate in WHMCS to the Product for which you like to review the configuration or change the settings. The same for the Addon Management. However, the Addon Button may have several colors depending on the status for an Addon:


Orange Button

Resellerclub Mods Console Addon Pending

The Orange color Button indicates that the Addon is missing. Click the Button to access directly the AutoAddon TAB for automated setup. See Documentation Section AutoAddons in this Document.


Red Button

Resellerclub Mods Console Addon AutoFixup

The Red color Button indicates that the Addon is present but not associated to the corresponding Product. Click the Button to fix this issue immediately.


Blue Button

Resellerclub Mods Console Product & Addon

The Blue color Button indicates that the Addon is correctly configured. You can access the Configurable Option and adjust the labels for Group Name, Group Description, Option Name and Options as well as the Sort Order number.


All Configurable Options are prefixed with an unique identifier! Never change the identifier before the Tube sign "|". The Option type is mandatory and should not be changed! Everything else such as label text after the Tube sign "|" and sort order number can be adjusted to your needs.

 

Settings

 

This section is currently under developement. However, each option is explained onscreen in details. If you have questions about any of the available options, do not hesitate to drop in a ticket and let us know your doubts and we will gladly answer.

 

Expert

Advanced Settings

 

This section is intended to provide special configurations and modifications for the Module and will be constantly updated with more content.

Customizing Client Area Dashboard

 

The REEHM - Enterprise & Business Email Hosting Module comes with the Client Area Dashboard built-in and is available for six and five based templates. By default the template is set to "Auto" and applies the template you configured in WHMCS » Setup » General Settings » TAB General: "Template" if it is an original WHMCS template theme (currently five or six). If you use another custom template or if you use an original WHMCS template theme but with a custom folder name, then you can change this in TAB Settings:

  1. Navigate in WHMCS to » Addons » RCM Core Console v4 and access the R.E.E.Hosting Module Dashboard from the left sidebar Addon Menu

  2. Click the TAB "Settings" and follow the onscreen instructions as shown below:

    Resellerclub Mods Console Module Template Settings

 

Howto Style your own Client Area Dashboard

 

If any of the built-in Dashboard Theme fits your custom theme, then you can style your own Client Area Dashboard. Follow the below small Guide to start immediately with a fully working Custom Client Area 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/rcmreehm/templates/ folder

  3. Navigate in WHMCS to » Addons » RCM Core Console v4 and access the R.E.E.Hosting Module Dashboard from the left sidebar Addon Menu.

  4. Click the TAB "Settings" and scroll down to section "Dashboard Handling" and activate the option "Disable Management Dashboard?"

    Resellerclub Mods Console Module Dashboard Handling

 

Complete Code Example for all Enterprise & Business Email Hosting Plans

 

{*
 * RCM Enterprise & Business Email Hosting Module - Custom Management Dashboard Template
 *
 * @package		Resellerclub Mods (gIF)
 * @author		Resellerclub Mods contact[at]resellerclub-mods.com
 * @copyright	Copyright (c) resellerclub-mods.com 2011-2017
 * @license		http://www.resellerclub-mods.com/en/terms-of-service/eula.html
 * @link		http://www.resellerclub-mods.com/
 * @version		v4.0.1
 *}
 
<script language="javascript" type="text/javascript">
	function showdnscheckexternal(){
		jQuery("#dnsexternal").slideToggle();
	}
	function showdnsservers(){
		jQuery("#dnsservers").slideToggle();
	}
</script>

<h2>{$LANG.rcmreehm_managementtitle}</h2>

{if $rcm_status neq "Active"}
	<table width="100%" cellspacing="0" cellpadding="0">
		<tr>
			<td>{$LANG.rcmreehm_statustitle}:</td>
			<td>
				<div style="color:{$rcm_status_color}">
					{if $rcm_status eq 'Suspended'}
						{$LANG.rcmreehm_hostingsuspended}
					{elseif $rcm_status eq 'InActive'}
						{$LANG.rcmreehm_hostingpreparing}
					{elseif $rcm_status eq 'Deleted'}
						{$LANG.rcmreehm_hostingstatusdeleted}
					{else}
						{$LANG.rcmreehm_hostingstatusunknown}
					{/if}
				</div>
			</td>
		</tr>
	</table>
{else}
	<table width="100%" border="0" cellpadding="10" cellspacing="0" style="text-align:left;">
		<tr>
			<td>{$LANG.rcmreehm_statustitle}:</td>
			<td><div style="color:{$rcm_status_color};">{$LANG.rcmreehm_hostingactive}</div></td>
		</tr>
		<tr>
			<td>{$LANG.rcmreehm_controlpanelstitle}:</td>
			<td>
				{if $rcm_mailbutton}<div style="float:left;padding:2px;">{$rcm_mailbutton}</div>{/if}
				{if $rcm_webmailbutton}<div style="float:left;padding:2px;">{$rcm_webmailbutton}</div>{/if}
				{if $rcm_dnsbutton}<div style="float:left;padding:2px;">{$rcm_dnsbutton}</div>{/if}
				{if $rcm_renewbutton}<div style="float:left;padding:2px;">{$rcm_renewbutton}</div>{/if}
			</td>
		</tr>
		{if $rcm_disablequickmailcreate neq 1}
		<tr>
			<td>{$LANG.rcmreehm_quickcreatemailtitle}</td>
			<td colspan="2"><div style="float:left;padding:2px;">{$rcm_quickcreatemailresponse}{$rcm_quickcreatemailbutton}</div></td>
		</tr>
		{/if}
		<tr>
			<td>{$LANG.rcmreehm_mailpoptitle}:</td>
			<td>pop.{$domain}</td>
		</tr>
		<tr>
			<td>{$LANG.rcmreehm_mailpoptitle}:</td>
			<td>imap.{$domain}</td>
		</tr>
		<tr>
			<td>{$LANG.rcmreehm_mailpoptitle}:</td>
			<td>smtp.{$domain}</td>
		</tr>
		<tr>
			<td>{$LANG.rcmreehm_mailspacetitle}:</td>
			<td>{$rcm_mailspace}</td>
		</tr>
		{if $rcm_oxtype neq "Business Email"}
		<tr>
			<td>{$rcmreehm_filespacetitle}:</td>
			<td>{$rcm_filespace}</td>
		</tr>
		{/if}
		<tr>
			<td>{$LANG.rcmreehm_mailaccountstitle}:</td>
			<td>{$rcm_mailnum} {$rcm_buymore}</td>
		</tr>
		<tr>
			<td>{$LANG.rcmreehm_createdaccstitle}:</td>
			<td>{$rcm_createdaccounts}</td>
		</tr>
		<tr>
			<td>{$LANG.rcmreehm_createdfwdstitle}:</td>
			<td>{$rcm_createdfwds}</td>
		</tr>
		<tr>
			<td>{$LANG.rcmreehm_mailacclefttitle}:</td>
			<td>{$rcm_uncreatedaccounts}</td>
		</tr>
		<tr>
			<td colspan="2">
				<p><strong>{$LANG.rcmreehm_nsservertitle}</strong></p>
			</td>
		</tr>			
		<tr>
			<td colspan="2">
				<span style="cursor:pointer;font-weight:bold;" onclick="showdnsservers();return false;">[+]</span> <strong>{$LANG.rcmreehm_nsrecommendedoption}</strong> {$LANG.rcmreehm_nsrecommended}
				<br />
				<div style="display:block;" id="dnsservers">
					{foreach from=$rcm_dns_servers item=dns_server}
						{$dns_server}
						<br />
					{/foreach}
				</div>
				<br />
			</td>
		</tr>
		<tr>
			<td colspan="2" style="border:none;">
				<span style="cursor:pointer;font-weight:bold;" onclick="showdnscheckexternal();return false;">[+]</span> <strong>{$LANG.rcmreehm_nsexternaloption}</strong> {$LANG.rcmreehm_nsexternal}
				<div style="display:none;" id="dnsexternal">
					<table>
						<tr>
							<td colspan="4"><p>{$LANG.rcmreehm_arecords}</p></td>
						</tr>
						{foreach from=$rcm_a_records item=a_record}
							<tr>
								{foreach from=$a_record item=record}
									<td><div style="min-width:100px;word-wrap:break-word;">{$record}</div></td>
								{/foreach}
							</tr>
						{/foreach}
						<tr>
							<td colspan="4"><p>{$LANG.rcmreehm_mxrecords}</p></td>
						</tr>
						{foreach from=$rcm_mx_records item=mx_record}
							<tr>
								{foreach from=$mx_record item=record}
									<td><div style="min-width:100px;word-wrap:break-word;">{$record}</div></td>
								{/foreach}
							</tr>
						{/foreach}
						<tr>
							<td colspan="4"><p>{$LANG.rcmreehm_txtrecords}</p></td>
						</tr>
						{foreach from=$rcm_txt_records item=txt_record}
							<tr>
								{foreach from=$txt_record item=record}
									<td><div style="max-width:200px;word-wrap:break-word;">{$record}</div></td>
								{/foreach}
							</tr>
						{/foreach}
						<tr>
							<td colspan="4"><p>{$LANG.rcmreehm_cnamerecords}</p></td>
						</tr>
						{foreach from=$rcm_cname_records item=cname_record}
							<tr>
								{foreach from=$cname_record item=record}
									<td><div style="min-width:100px;word-wrap:break-word;">{$record}</div></td>
								{/foreach}
							</tr>
						{/foreach}
					</table>
				</div>
			</td>
		</tr>
	</table>
{/if}

 

Smarty variables for further customization

 

The following smarty variables are available and you can use them to code your very own Dashboard without using the Code Example from above:

  • {$rcm_domainid} = string number
  • {$rcm_mailbutton} = string formatted and translated
  • {$rcm_webmailbutton} = string formatted and translated
  • {$rcm_dnsbutton} = string formatted and translated
  • {$rcm_renewbutton} = string formatted and translated
  • {$rcm_quickcreatemailaccount} = string number
  • {$rcm_quickcreatemailbutton} = string formatted and translated
  • {$rcm_quickcreatemailresponse} = string formatted and translated
  • {$rcm_disablequickmailcreate} = array
  • {$rcm_status} = string
  • {$rcm_mailnum} = string
  • {$rcm_mailspace} = string
  • {$rcm_filespace} = string
  • {$rcm_createdaccounts} = string formatted and translated
  • {$rcm_createdfwds} = string
  • {$rcm_uncreatedaccounts} = string formatted and translated
  • {$rcm_buymore} = string formatted and translated
  • {$rcm_dns_servers} = string
  • {$rcm_a_records} = array
  • {$rcm_mx_records} = array
  • {$rcm_cname_records} = array
  • {$rcm_txt_records} = array
  • {$rcm_oxtype} = string formatted and translated
  • {$rcm_contropaneltitle} = string formatted and translated
  • {$rcm_apiactionresult} = string number
  • {$rcm_status_color} = string

 

Howto use the old v3 Provisioning Style

 

By default, the new v4 module offers now 4 Business Email Plans and 4 Enterprise Email Plans with a minium of Email accounts included (Business Email 1 - 4 and EE 1 - 4). The new provisioning style offers a way to sell quantity based Email account Plans and allows you to configure different prices for each Configurable Option Group.

The following Guide below shows you how you can sell Enterprise & Business Email Products like before with the old v3 Module using only one Base Product with one Configurable Option Group.

Prerequisite

  • RCM Core Console v4 Addon v4.0.7 or greater
  • REEHM - Enterprise & Business Email Hosting Module v4.0.2 or greater
  • All Business Email 1 - 4, EE 1 - 4 and all corresponding Configurable Options setup in WHMCS (See AutoSetup and AutoAddons)
  • All Services migrated to the new v4 Module (See AutoMigrate)

Guide to change from the new v4 provisioning style to the old v3 style:

  1. Goto WHMCS » Addons » RCM Core Console v4. From the left sidebar menu click the link R.E.E.Hosting Module and then click the TAB "Settings"
  2. Scroll Down and locate the Section "Service Provisioning Style" and activate the option Switch "Enable old v3 Provisioning Style?". Click the Button "Save Changes"
  3. Now goto WHMCS » Setup » Products/Services » Products/Services and edit the Products Business Email 2 - 4 and EE 2 - 4
  4. In TAB "Details" click the checkbox "Hidden" and save the changes. You will then have only the Business Email 1 and EE 1 Plan visible in the Shopping Cart. You may consider to adjust the Product Descriptions for The Business Email 1 and EE 1 Product since the Product will not have a limit for email accounts
  5. In TAB "Upgrades" » "Packages Upgrades" deselect all plans and finally save de changes
  6. Now goto WHMCS » Setup » Products/Services » Configurable Options
  7. Click the edit icon for the Group RCM_REEHM_182|Email Accounts and then click the edit icon for the RCM_REEHM_182|Emails Configurable Option
  8. Change the value Maximum Allowed from 5 to 0, save the changes and click the Button Back to Groups List
  9. Click the edit icon for the Group RCM_REEHM_52|Email Accounts and then click the edit icon for the RCM_REEHM_52|Emails Configurable Option
  10. Change the value Maximum Allowed from 5 to 0, save the changes and click the Button Back to Groups List

Current Business and/or Enterprise Email Services with more than 5 Email Accounts:

If you have Enterprise and/or Business Email services with more than 5 Email accounts, then you need to locate these services and change the Product to Business Email 1 and/or EE 1

  1. Goto WHMCS » Clients » Products/Services » Shared Hosting. Use the Search Filter function by selecting from the dropdown menu "Product/Service" the Business Email 2 - 4 and EE 2 - 4
  2. From the search result (if any), click the ID or the Domain Name to access the Clients Product
  3. From the details page dropdown menu "Product/Service" select now the Business Email 1 Plan if the service is a Business Email Product or the EE 1 Plan if the service is an Enterprise Email Product. This will automatically reload the details page to apply the new Plan and will also set the Qty field for Emails to 1

    Admin Area Client Product details

  4. Adjust now the correct number of Total Email accounts in the Qty field for Email accounts! You can see the number of total accounts right below in the details field "Add / Delete Email Accounts".
  5. Finally, click the checkbox "Auto Recalculate on Save" and then click the button "Save Changes"

Latest Tweets

More Tweets from resmods

Latest News

Weebly Sitebuilder Provisioning Module now available!

We are happy to announce the launch for our brand new Provisioning Module to sell and manage the newly incorporated ResellerClub Service: Weebly Sitebuilder Hosting!

Read more...

RCM Special Birthday Bundle Promos !

2017 is our 6th Business Year and we are very happy to be your 1# WHMCS Integration provider for ResellerClub, NetEarthOne, Resll.biz and many other LogicBoxes Registrars!

Read more...

About Us

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