G Suite v4 Documentation

Install R.G.S.Provisioning Module v4

 

Goto to WHMCS » Addons » RCM Core Console v4 and access the R.G.S.Provisioning Module Dashboard from the left sidebar Addon Menu or from the Core Addon Home widget. You should be able to see the following Management Area:

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 RGSPM - Google Suite Provisioning 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 \rcmrgspm_4.6.1_PHP_5.6_7.3\ 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.G.S.Provisioning Module Dashboard from the left sidebar Addon Menu or from the Core Addon Home widget and click the "Validation" Button below the license details to finish the 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!

Managing the RGSPM - Google Suite Provisioning Module

 

To manage the Module, navigate in WHMCS to » Addons » RCM Core Console v4 and access the R.G.S.Provisioning Module Dashboard from the left sidebar Addon Menu or from the Core Addon Home widget.

 

Getting started

 

First Time Setup

If this is the first time you install our Module to sell and manage Google Suite 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 RGSPM - Google Suite Provisioning Module

Before you can migrate your current Services to the new v4 Module you need to setup first all geolocated Google Suite 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.G.S.Provisioning Module
• Edit Welcome Email
• Selling Prices ManualSync
• Recurring Prices ManualSync
• AutoUpdate
• Automated Update
• Manual Update
• AutoMigrate
• Automated Migration
• Post Migration
• AutoSetup
• Global Product Settings
• Import Selling Prices
• Products/Services
• AutoAddons
• Product/Service Addons Setup
• Configurable Options for Service Addons
• Products
• Settings
• AutoImport
• New G Suite Plans

 

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

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".

 

 

Automated Update

Whenever we release a new update you will be notified instantly by accesing the Management Area in TAB "R.G.S.Provisioning 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 RGSPM - Google Suite Provisioning 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 \rcmrgspm_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.G.S.Provisioning Module Dashboard from the left sidebar Addon Menu or from the Core Addon Home widget. Click the "Validation" Button below the License Information to finish the manual update.

 

 

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"

 

 

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

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.

 

 

Product/Service Addons Setup

This tool will create the required Configurable Options to sell Email Accounts for each Google Suite Product. These Configurable Options are mandatory and required to sell Google Suite 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 each geolocated Google Suite Service. The base Product for a Google Suite Service was including by default always one Email account and additional Email Accounts were offered with a unique single Configurable Option for each geolocated Base Product. With the new v4 module you offer now 4 Plans for each geolocated Google Suite Product. 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.

 

 

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

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

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

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.

 

 

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.

 

 

Overview

This tool will help you to import into WHMCS all your current Active and Suspended Orders for each Product type. In addition to importing Orders, this tool also shows the Orders that already exist with their corresponding status as well as Orders which can be imported and those with issues who need to be fixed first before import.

Search Orders

Begin by selecting the Product type for which you would like to obtain details and click the Button Search Orders. The AutoImport Wizard will search all Orders you have in your Reseller account and generate a list of Orders based on their status. There are 4 possible Import status:

Service Domains found, ready for Import!
Shows you the service domains which are missing in your WHMCS. You can import those Orders which have a checkbox. You can select all or some of the Orders you would like to import. Orders with an exclamation sign instead of a checkbox cannot be imported because the required Product is missing and you need to setup the same before you can Import services.

Service Domains fully In Sync
Shows you the service domains which are fully in sync between WHMCS and your Reseller Account. You can access a Service directly with the Service ID Link.

Service Domains out of Sync!
Shows you those services which are present in your WHMCS but considered out of sync due to customer email mismatch between WHMCS and your Reseller account. The customer email address must be the same in both systems. You should fix this asap. Click the Service ID link to access the service to obtain more details about the out of sync status.

Service Domains found but missing WHMCS Customer!
Shows you the services which cannot be imported until you have added the missing Customer in WHMCS. Use our FREE Tools Addon to easly import all your customers from your Reseller account into WHMCS.

 

 

Resellerclub has deprecated the Old Basic G Suite plans based on email qty. The new Basic G Suite plan as well as the new Business and Enterprise G Suite plans are now anymore email account qty based. Before you start with the below instructions you should review first your selling and renewal prices as they will be imported automatically with the AutoAddons Wizard to setup the required Configurable options.

1. Goto WHMCS » Setup » Products/Services » Products/Services. Locate the old G Suite plans and click the edit icon for each product. In TAB "Details" activate the checkbox "Hidden" and save the changes.
2. Goto WHMCS » Addons » RCM Core Console v4 » Manage Core Addon » Update Core Console and update to v4.4.5 release or above
3. Goto WHMCS » Addons » RCM Core Console v4 » R.G.S.Provisioning Module » AutoUpdate and update to v4.4.4 or above
4. Once updated Core Console and G Suite Module, click TAB "AutoSetup" and proceed with the setup of the new G Suite plans. We recommend to use the "Custom Field" Option to require the Domain Namen and not the WHMCS Built-in option "Require Domain"
5. Once created all the G Suite Products, proceed with TAB "AutoAddons" to create the new Configurable Options.
6. The next step is locating your current G Suite services. Click the TAB "AutoImport" and proceed with the Onscreen instructions to search the services. Access each service with the provided link and proceed with the below instructions:

1. From the "Products/Service" Droppdown Menu, select the new Basic GBL Plan and hold on until the page has been reloaded and saved.
2. In the Text field for the Configurable options "Emails" make sure you have there the correct number of Emails set. You can see the correct value below the Module Command buttons "Total Email Accounts".
3. Review the next due date as well as the Billing Cycle, activate the checkbox "Auto Recalculate on Save" and finally click the Button "Save Changes". Repeat these 3 steps for each active and old Basic G Suite service.

 

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
• Howto Style your own Client Area Dashboard
• Dashboard Code Example
• Smarty variables for further customization
• Howto use the old v3 Provisioning Style

 

The RGSPM - Google Suite Provisioning 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.G.S.Provisioning Module Dashboard from the left sidebar Addon Menu or from the Core Addon Home widget


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

   

 

 

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/rcmrgspm/templates/ folder


3. Navigate in WHMCS to » Addons » RCM Core Console v4 and access the R.G.S.Provisioning Module Dashboard from the left sidebar Addon Menu or from the Core Addon Home widget.


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

   

 

 

								
{*
 * RCM Google Suite Provisioning Module - Custom Management Dashboard Template
 *
 * @package		Resellerclub Mods (gIF)
 * @author		Resellerclub Mods contact[at]resellerclub-mods.com
 * @copyright	Copyright (c) resellerclub-mods.com 2011-2019
 * @license		https://www.resellerclub-mods.com/whmcs/terms-of-service.php#tabEula
 * @link		https://www.resellerclub-mods.com/
 * @version		v4.3.0
 *}
 
<h2>{$LANG.rcmrgspm_managementtitle}</h2>

{if $rcm_status neq "Active"}
	<table class="table table-list">
		<tr>
			<td>{$LANG.rcmrgspm_statustitle}:</td>
			<td>
				<div style="color:{$rcm_status_color}">
					{if $rcm_status eq 'Suspended'}
						{$LANG.rcmrgspm_hostingsuspended}
					{elseif $rcm_status eq 'InActive'}
						{$LANG.rcmrgspm_hostingpreparing}
					{elseif $rcm_status eq 'Deleted'}
						{$LANG.rcmrgspm_hostingstatusdeleted}
					{else}
						{$LANG.rcmrgspm_hostingstatusunknown}
					{/if}
				</div>
			</td>
		</tr>
	</table>
{else}
	<table class="table table-list" style="text-align:left;">
		<tr>
			<td><strong>{$LANG.rcmrgspm_statustitle}:</strong></td>
			<td><div style="color:{$rcm_status_color};">{$LANG.rcmrgspm_hostingactive}</div></td>
		</tr>
		<tr>
			<td><strong>{$LANG.rcmrgspm_mailaccountstitle}:</strong></td>
			<td>{$rcm_mailnum} {$rcm_buymore}</td>
		</tr>
		<tr>
			<td><strong>{$LANG.rcmrgspm_createdaccstitle}:</strong></td>
			<td>{$rcm_createdaccounts}</td>
		</tr>
		<tr>
			<td><strong>{$LANG.rcmrgspm_mailacclefttitle}:</strong></td>
			<td>{$rcm_uncreatedaccounts}</td>
		</tr>
		<tr>
			<td><strong>{$LANG.rcmrgspm_controlpanelstitle}:</strong></td>
			<td>
				{if $rcm_apiresult}<br />{$rcm_apiresult}{/if}
				{if $rcm_gsuiteadminpending eq "WAITING_FOR_ADMIN_DETAILS"}
					<p><strong>{$LANG.rcmrgspm_adminaccountsetup1}</strong><br />{$LANG.rcmrgspm_adminaccountsetup2}</p>
					<form action="clientarea.php?action=productdetails&id={$rcm_domainid}" method="post">
					<div class="input-group" style="min-width:300px;">
					  <span class="input-group-addon">{$LANG.rcmrgspm_emailaliaslabel}</span>
					  <input type="text" name="gsuite-email-address" value="{$rcm_gsuiteemailalias}" class="form-control">
					  <span class="input-group-addon">@{$domain}</span>
					</div><br />

					<div class="input-group">
					  <span class="input-group-addon">{$LANG.rcmrgspm_emailpasswordlabel}</span>
					  <input type="text" name="gsuite-password" value="{$rcm_gsuiteemailpass}" class="form-control">
					</div><br />

					<div class="input-group">
					  <span class="input-group-addon">{$LANG.rcmrgspm_adminaccountfirstname}</span>
					  <input type="text" name="gsuite-first-name" value="{$rcm_gsuitefirstname}" class="form-control">
					</div><br />

					<div class="input-group">
					  <span class="input-group-addon">{$LANG.rcmrgspm_adminaccountlastname}</span>
					  <input type="text" name="gsuite-last-name" value="{$rcm_gsuitelastname}" class="form-control">
					</div><br />

					<div class="input-group">
					  <span class="input-group-addon">{$LANG.rcmrgspm_clientalternatemail}</span>
					  <input type="text" name="gsuite-alternate-email-address" value="{$rcm_gsuitealternatemail}" class="form-control">
					</div><br />

					<div class="input-group">
					  <span class="input-group-addon">{$LANG.rcmrgspm_clientname}</span>
					  <input type="text" name="gsuite-name" value="{$rcm_gsuitefullname}" class="form-control">
					</div><br />

					<div class="input-group">
					  <span class="input-group-addon">{$LANG.rcmrgspm_clientcompanyname}</span>
					  <input type="text" name="gsuite-company" value="{$rcm_gsuitecompany}" class="form-control">
					</div><br />

					<div class="input-group">

					  <span class="input-group-addon">{$LANG.rcmrgspm_clientzipcode}</span>
					  <input type="text" name="gsuite-zip" value="{$rcm_gsuitezipcode}" class="form-control">
					</div><br />

					<input type="hidden" name="gsuite-orderid" value="{$rcm_gsuiteorderid}">
					<p align="center"><input class="btn btn-success" name="setupadmin" type="submit" value="{$LANG.rcmrgspm_setupadminaccountlabel}" onclick="this.form.submit()" /></p>
					</form>
				{else}
					<div style="float:left;padding:2px;"><a class="btn btn-primary" href="/{$gsuite_url}" target="_blank">{$LANG.rcmrgspm_adminconsolebutton}</a></div>
					{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}
				{/if}
			</td>
		</tr>
		<tr>
			<td colspan="2">
				<br />
				{$rcm_nschangemessage}
				<p><strong>{$LANG.rcmrgspm_nsservertitle}:</strong></p>
			</td>
		</tr>			
		{if $rcm_hostingnstype eq '1'}
		<tr>
			<td colspan="2" style="border:none;">
				{$rcm_nsoption1}
				<div>
					<br />
					{$rcm_dns_servers}
					{if $rcm_dnssetupbutton}
						<div>{$rcm_dnssetupbutton}</div>
					{/if}
				</div>
			</td>
		</tr>
		{/if}
		<tr>
			<td colspan="2" style="border:none;">
				{$rcm_nsoption2}
				<div>
					<table>
						<tr>
							<td colspan="5">
								<p style="text-align:center"><strong>{$LANG.rcmrgspm_mxrecords}</strong></p>
							</td>
						</tr>
						{foreach from=$rcm_mx_records item=mx_record}
							<tr>
								{foreach from=$mx_record item=record}
									<td><div style="{if $record eq $domain}min-width:300px;word-wrap:break-word;{else}min-width:50px;word-wrap:break-word;{/if}">{$record}</div></td>
								{/foreach}
							</tr>
						{/foreach}
					</table>
				</div>
			</td>
		</tr>
	</table>
{/if}
								
							

 

 

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_renewbutton} = string formatted and translated
• {$rcm_dnsbutton} = string formatted and translated
• {$rcm_status} = string
• {$rcm_mailnum} = string
• {$rcm_createdaccounts} = string
• {$rcm_uncreatedaccounts} = string
• {$rcm_buymore} = string formatted and translated
• {$rcm_dns_servers} = string
• {$rcm_mx_records} = array
• {$rcm_dnssetupbutton} = string formatted and translated
• {$rcm_hostingnstype} = string (1 if branded)
• {$rcm_nschangemessage} = string
• {$rcm_gsuiteorderdetails} = array
• {$rcm_gsuiteplandetails} = array
• {$rcm_nsoption1} = string formatted and translated
• {$rcm_nsoption2} = string formatted and translated
• {$rcm_apiresultmessage} = / string success or the api failure message
• {$rcm_apiresult} = string formatted and translated
• {$rcm_gsuiteorderid} = string number
• {$rcm_gsuitesetup} = string number (1 = error, 2 = success)
• {$rcm_gsuiteadminpending} = string WAITING_FOR_ADMIN_DETAILS
• {$rcm_gsuiteurl} = string
• {$rcm_gsuiteemailalias} = string
• {$rcm_gsuiteemailpass} = string
• {$rcm_gsuitefirstname} = string
• {$rcm_gsuitelastname} = string
• {$rcm_gsuitealternatemail} = string
• {$rcm_gsuitefullname} = string
• {$rcm_gsuitecompany} = string
• {$rcm_gsuitezipcode} = string
• {$rcm_status_color} = string