Advanced Email Interface v3 Documentation

Upload files and folders

Download RAMEI - ResellerClub Advanced Managment EMAIL Interface 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.

1. Upload the provided php file emailmanagement.php from the unzipped "emailmanagement_x.x.x" folder into your whmcsroot/ folder


2. Upload the folders and files which matches your theme into your active whmcsroot/templates/(five, six)/ theme folder.

WHMCS Template Modifications

Additional Configuration Steps for FIVE based templates

• clientareadomaindetails.tpl

Additional Configuration Steps for SIX based templates

• clientareadomaindetails.tpl

1. Open the whmcs template file "clientareadomaindetails.tpl", located in the folder /whmcsroot/templates/foldername/.


2. Search and locate the code between {if $emailforwarding} ... {/if}. The code between this if statement looks something like this if you haven't customized it before:
   

   
   {if $emailforwarding}<li><a href = "clientarea.php?action=domainemailforwarding&domainid={$domainid}">{$LANG.clientareadomainmanageemailfwds}</a></li>{/if}
   							

   Replace the original code with the following code:

   
   {if $emailforwarding}<li><a href = "emailmanagement.php?action=managemailhosting&domain={$domain}&domainid={if $domainid}{$domainid}{else}{$id}{/if}">{$LANG.clientareadomainmanageemailfwds}</a></li>{/if}
   							



3. Search and locate the code between {if $addonstatus.emailforwarding} ... {else}.
   

   
   <a href = "clientarea.php?action=domainemailforwarding&domainid={$domainid}">{$LANG.manage}</a>
   							

   Replace the original code with the following code:

   
   <a href = "emailmanagement.php?action=managemailhosting&domain={$domain}&domainid={$domainid}">{$LANG.manage}</a>
   							



4. Upload the modified file clientareadomaindetails.tpl back into the active template folder.

1. Open the whmcs template file "clientareadomaindetails.tpl", located in the folder /whmcsroot/templates/foldername/


2. Search and locate the code between {if $addonstatus.emailforwarding} ... {else}.
   

   
   <a class="btn btn-success" href = "clientarea.php?action=domainemailforwarding&domainid={$domainid}">{$LANG.manage}</a> <input type="submit" value="{$LANG.disable}" class="btn btn-danger"/>
   							

   Replace the original code with the following code:

   
   <a class="btn btn-success" href = "emailmanagement.php?action=managemailhosting&domain={$domain}&domainid={$domainid}">{$LANG.manage}</a> <input type="submit" value="{$LANG.disable}" class="btn btn-danger"/>
   							



3. Upload the modified file clientareadomaindetails.tpl back into the active template folder.

TIP! If you are using 2 or more domain registrars, for example ResellerClub and another "non LogicBoxes" Registrar such as Enom, then you should have a look at the TAB "Tips & Tricks" to learn howto modify the template file to offer the RAM Email Interface for LogicBoxes registered domains and the WHMCS Built-in Email Forward Manager for all other domains.

Test the Interfaces

To offer Email Forwarding you have to activate the WHMCS built-in Addon.

1. From the "Management Tools" section for each domain in the domain details page (admin area):
   


2. You should also consider to activate Email Forwarding from Setup » Products/Services » Domain Pricing for each TLD which support Email Forwarding:
   

Your Installation should be done at this point. Login into your whmcs using any customer login and goto "My Domains". Select a domain to access the domaindetails area. Click the email hosting link from the Management Tools Tab to access the RAM Email Interface.

Implementing RAM Email Manager and WHMCS Email Forward Manager together with multiple Domain Registrars

If you are using 2 or more domain registrars, for example ResellerClub and another non LogicBoxes Registrar such as Enom, then you should use the following code to offer the RAM Email Manager for ResellerClub domains and the WHMCS Email Forward interface for all other domains:

Additional Configuration Steps for FIVE based templates

• clientareadomaindetails.tpl

Additional Configuration Steps for SIX based templates

• clientareadomaindetails.tpl

1. Open the whmcs template file "clientareadomaindetails.tpl", located in the folder /whmcsroot/templates/foldername/.


2. Search and locate the code between {if $emailforwarding} ... {/if}. The code between this if statement looks something like the following if you haven't customized it before:
   

   
   {if $emailforwarding}<li><a href = "clientarea.php?action=domainemailforwarding?domainid={$domainid}">{$LANG.clientareadomainmanageemailfwds}</a></li>{/if}
   							

   Replace the original code with the following code:

   
   {if $emailforwarding}
   	{if $registrar eq "resellerclub" || $registrar eq "resellerclubrcm"}
   		<li><a href = "emailmanagement.php?action=managemailhosting&domain={$domain}&domainid={if $domainid}{$domainid}{else}{$id}{/if}">{$LANG.clientareadomainmanageemailfwds}</a></li>
   	{else}
   		<li><a href = "clientarea.php?action=domainemailforwarding?domainid={$domainid}">{$LANG.clientareadomainmanageemailfwds}</a></li>
   	{/if}
   {/if}
   							



3. Search and locate the code between {if $addonstatus.emailforwarding} ... {else}.
   

   
   <a href = "clientarea.php?action=domainemailforwarding&domainid={$domainid}">{$LANG.manage}</a>
   							

   Replace the original code with the following code:

   
   {if $registrar eq "resellerclub" || $registrar eq "resellerclubrcm"}
   	<a href = "emailmanagement.php?action=managemailhosting&domain={$domain}&domainid={$domainid}">{$LANG.manage}</a>
   {else}
   	<a href = "clientarea.php?action=domainemailforwarding&domainid={$domainid}">{$LANG.manage}</a>
   {/if}
   							



4. Upload the modified file clientareadomaindetails.tpl back into the active template folder.

1. Open the whmcs template file "clientareadomaindetails.tpl", located in the folder /whmcsroot/templates/foldername/


2. Search and locate the code between {if $addonstatus.emailforwarding} ... {else}.
   

   
   <a class="btn btn-success" href = "clientarea.php?action=domainemailforwarding&domainid={$domainid}">{$LANG.manage}</a> <input type="submit" value="{$LANG.disable}" class="btn btn-danger"/>
   							

   Replace the original code with the following code:

   
   {if $registrar eq "resellerclub" || $registrar eq "resellerclubrcm"}
   	<a class="btn btn-success" href = "emailmanagement.php?action=managemailhosting&domain={$domain}&domainid={$domainid}">{$LANG.manage}</a> <input type="submit" value="{$LANG.disable}" class="btn btn-danger"/>
   {else}
   	<a class="btn btn-success" href = "clientarea.php?action=domainemailforwarding&domainid={$domainid}">{$LANG.manage}</a> <input type="submit" value="{$LANG.disable}" class="btn btn-danger"/>
   {/if}
   							



3. Upload the modified file clientareadomaindetails.tpl back into the active template folder.

Important: Before Upgrade to version 3.13.x:

• Required
  
  • PHP 5.4 - 5.6 with Ioncube Loaders 5.1.x or above
  • PHP 7.0 with Ioncube Loaders 6.1.x or above
  • PHP 7.1 and 7.2 with Ioncube Loaders 10.1.x or above

1. Make sure you have first installed or updated to the Management Core Console v1.5.4 or above and previously accessed the Resellerclub Mods Console Addon home to get the new version number stored


2. Upload the file "emailmanagement.php" into your whmcsroot/ folder.


3. Apply the Template changes or upload all template files into your current and active template folder. If you use six based custom theme, then upload the six templates. If you use a five based custom theme, then upload the five templates.
   Template changes are now exposed using github compare:
   • https://github.com/imaticon/RAMEI/compare/v3.12.0...v3.12.1
   • https://github.com/imaticon/RAMEI/compare/v3.12.1...v3.12.2
   • https://github.com/imaticon/RAMEI/compare/v3.12.2...v3.13.1


4. Access the Resellerclub Mods Console Addon » R.A.M.Email Interface and click the button "Validate Module"

Important: Before Upgrade to version 3.16.x:

• Required: WHMCS 6.3 - 8.8: PHP 5.6 - 7.4 with Ioncube Loaders 10.4.x or above
• Required: WHMCS 8.0 - 8.8: PHP 7.4 - 8.1 with Ioncube Loaders 12.0.x or above

1. Make sure you have first installed or updated to the Management Core Console v1.8.4 or above and previously accessed the Resellerclub Mods Console Addon home to get the new version number stored


2. Upload the file "emailmanagement.php" into your whmcsroot/ folder.


3. Apply the Template changes or upload all template files into your current and active template folder. If you use six based custom theme, then upload the six templates. If you use a twenty-one based custom theme, then upload the twenty-one templates.
   Template changes are now exposed using github compare:
   • https://github.com/imaticon/RAMEI/compare/v3.12.0...v3.12.1
   • https://github.com/imaticon/RAMEI/compare/v3.12.1...v3.12.2
   • https://github.com/imaticon/RAMEI/compare/v3.12.2...v3.13.1
   • https://github.com/imaticon/RAMEI/compare/v3.13.1...v3.16.0


4. Access the Resellerclub Mods Console Addon » R.A.M.Email Interface and click the button "Validate Module"