Latest Stable Version
v3.14.0
Release Date: 08.02.2019

System Requirements R.A.M.Email Interface v3

The below table shows the minimum and recommended system requirements for running the v3 Module.

Requirement Minimum Recommended
WHMCS Version 6.3 Latest stable 7.8.x
Resellerclub Mods Console Addon RMMCC 1.6.0 Latest 1.6.1
PHP Version and PHP CLI Version 5.6 Latest 7.3.x
PHP Memory Limit 64MB 128MB 1)
PHP Database Extension PDO PDO
MySQL Version 5.1.x 5.7.x
MySQL Strict Mode Disabled Disabled
Ioncube Loaders for PHP and PHP CLI 10.1.x 10.3.x

v3 Modules supports PHP 5.6, 7.0, 7.1, 7.2 and 7.3

While these are the minimum requirements, we strongly recommend using the latest available, stable releases of all software.

Important!
  • All modules upwards v3.13.x requires the Core Addon v1.5.x or above! Make sure you update first the Core Addon to the latest release before you update this module to v3.14.1
  • We validate our Modules to run in Linux based environments running the Apache web server. Other environments such as Windows based configurations may experience compatibility issues and are not officially supported
  • v3 Modules does not support PHP versions with Ioncube loaders below 10.1.x! This applies for the PHP version used by the webserver as well as by the CLI (used by cronjobs)
  • Keep in mind the Database Privilege Restriction if you have applied WHMCS recommendation for "further security steps" at https://docs.whmcs.com/Further_Security_Steps#Restrict_Database_Privileges

1) Memory requirements vary depending upon the size and volume of activity in an installation. Your exact requirements may differ.

Changelog R.A.M.Email Interface v3

Changelog Version:
3.0.1 |  3.0.2 |  3.1.1 |  3.1.2 |  3.1.3 |  3.1.4 |  3.2.1 |  3.3.1 |  3.6.1 |  3.6.2 |  3.6.3 |  3.7.0 |  3.7.1 |  3.7.2 |  3.8.0 |  3.8.1 |  3.9.1 |  3.9.2 |  3.10.0 |  3.11.0 |  3.12.0 |  3.12.1 |  3.12.2 |  3.12.3 |  3.13.0 |  3.13.1 |  3.13.2 |  3.14.0

Version 3.0.1
Release Date: 25/02/2012

  • Initial Release
  • Use of Centralized Management Core Console
  • resellerclubmods_config.php file deprecated
  • License localkey stored in DB to improve performance

Version 3.0.2 (Top)
Release Date: 22/03/2012

  • Support added for client area SSL

Version 3.1.1 (Top)
Release Date: 27/04/2012

  • Multi LogicBoxes Registrars Support added
  • Activate / Deactivate DNS Name Server Check and Change Function added
  • $whmcsroot deprecated

Version 3.1.2 (Top)
Release Date: 26/06/2012

  • Added a second security layer (avoiding management access if email has changed)

Version 3.1.3 (Top)
Release Date: 13/07/2012

  • Support added for LogicBox Registrar Resellercamp

Version 3.1.4 (Top)
Release Date: 27/08/2012

  • Interface for Paid Email Hosting was not working correctly with another hosting product
    for the same domain

Version 3.2.1 (Top)
Release Date: 31/12/2012

  • Disable Email Account related data if Registrar is Resell.biz (stargate)
  • Bugfix for sort Email Account list
  • Bugfix Search/Filter option
  • Template changes: emailmanagementboard.tpl, emailmanagementaccounts.tpl,
    emailmanagementmaillist.tpl, emailmanagementmaillists.tpl
  • Improved upon the complete code and optimized the interface

Version 3.3.1 (Top)
Release Date: 18/02/2013

  • READY FOR API KEY
  • Added disable FREE Mail Hosting Domain Service if a domain has a hosting account
  • Added option to allow FREE Mail Hosting Domain Service even if a domain has a hosting account

Version 3.6.1 (Top)
Release Date: 18/03/2013

  • Ready for WHMCS v5.2 and backwards compatible for WHMCS v4.5.2 - v5.1.x

Version 3.6.2 (Top)
Release Date: 30/04/2013

  • API response format changed from simplexml to JSON to improve performance and speed
  • Bulk delete and bulk suspend for email accounts implemented
  • Bulk delete for mail list members implemented
  • Bulk create email accounts implemented
  • New API function available to list and search more than 200 Email accounts
  • Fixed various Bugs related to search, sort and pagination options in all template files
  • New english and spanish translations added

Version 3.6.3 (Top)
Release Date: 02/07/2013

  • Built-In Debug Mode deprecated and changed to the WHMCS Debug function using the Module log
  • Support added for the new LogicBoxes Compatible Domain Registrar Module

Version 3.7.0 (Top)
Release Date: 19/07/2013

  • IDN Support Implemented

Version 3.7.1 (Top)
Release Date: 02/09/2013

  • Management Support added for Enterprise Email Hosting Service

Version 3.7.2 (Top)
Release Date: 01/11/2013

  • Maintenance update and Bugfix: Multiple non logicboxes hosting products for the same domain cause conflict with the management Interface for Email Hosting Plans

Version 3.8.0 (Top)
Release Date: 27/11/2013

  • Client Area Language setup deprecated. Language translations now served from Resellerclub Mods Console Addon v1.1.4 with auto fallback to english if other language files are missing
  • Support for any other LogicBoxes Registrar Module in WHMCS (Resellerid, etc.)
  • Resell.biz FREE Email Account restriction has been eliminated. You can now create 2 FREE Email Accounts
  • Added option to disable FREE Mail Hosting Service to allow only Email forwarding Management

Version 3.8.1 (Top)
Release Date: 31/01/2014


Version 3.9.1 (Top)
Release Date: 10/11/2014

  • End of life for php 5.2. Required php 5.3 or 5.4 with Ioncube Loaders v4.4.1 or greater
  • Implemented: Management Support for Enterprise Email LITE service
  • Implemented: Language override support (See Knowledgebase Client and Admin Area Language Files)
  • No template changes have been applied to this update

Version 3.9.2 (Top)
Release Date: 27/04/2015

  • Deprecated: Autoresponder and email account mail forwarder setup (OX specific configuration from OX Desktop)
  • Code Maintenance and Improvements
  • Implemented: Templates for Bootstrap 3 compatible themes and Responsioplus3 theme
  • Template changes:
    • Classic based template emailmanagementboard.tpl
      deleted line: 176
      new line: 172
    • Classic based template emailmanagementmailmodify.tpl
      deleted lines: 296 - 359 and 101 - 180
    • Portal based template emailmanagementboard.tpl
      deleted line: 172
      new line: 168
    • Portal based template emailmanagementmailmodify.tpl
      deleted line: 348 - 423 and 107 - 203
    • Default based template emailmanagementmailmodify.tpl
      changed line: 159 - 675

Version 3.10.0 (Top)
Release Date: 13/07/2015

  • Added: Compatibility for WHMCS v6. Valid for WHMCS 5.2.17 - 6.0.x
  • Bugfix: javascript checkbox toggle issue
  • Implemented: Templates for five and six themes
  • Template changes:
    • Classic emailmanagementaccounts.tpl
      changed line: 132
      eliminated line: 128
      changed line: 97, 100
      changed line: 35
      changed line: 6
      changed line: 1 - 5

      Classic emailmanagementboard.tpl
      eliminated line: 210 - 213
      changed line: 1 - 5

      Classic emailmanagementlist.tpl
      changed line: 181
      eliminated line: 177
      changed line: 151, 148
      changed line: 127
      changed line: 7
      changed line: 1 - 6

      Classic emailmanagementlists.tpl
      changed line: 1 - 5

      Classic emailmanagementmailmodify.tpl
      changed line: 1 - 5

    • Portal emailmanagementaccounts.tpl
      changed line: 132
      eliminated line: 128
      changed line: 100
      changed line: 35
      changed line: 6
      changed line: 1 - 5

      Portal emailmanagementboard.tpl
      eliminated line: 206 - 209
      changed line: 1 - 5

      Portal emailmanagementlist.tpl
      changed line: 200
      eliminated line: 196
      changed line: 170, 167
      changed line: 146
      changed line: 7
      changed line: 1 - 6

      Portal emailmanagementlists.tpl
      changed line: 1 - 5

      Portal emailmanagementmailmodify.tpl
      changed line: 1 - 5

    • Default emailmanagementaccounts.tpl
      changed line: 180
      eliminated line: 174
      changed line: 146
      changed line: 77
      changed line: 67
      changed line: 3 - 7

      Default emailmanagementboard.tpl
      eliminated line: 378 - 385
      changed line: 7 - 11

      Default emailmanagementlist.tpl
      changed line: 294
      eliminated line: 288
      changed line: 262
      changed line: 230
      changed line: 97
      changed line: 3 - 8

      Default emailmanagementlists.tpl
      changed line: 3 - 7

      Default emailmanagementmailmodify.tpl
      changed line: 1 - 5

    • Bootstrap 3 emailmanagementaccounts.tpl
      changed line: 176
      eliminated line: 171
      changed line: 143
      changed line: 76
      changed line: 67
      changed line: 3 - 7

      Bootstrap 3 emailmanagementboard.tpl
      eliminated line: 359 - 366
      changed line: 3 - 7

      Bootstrap 3 emailmanagementlist.tpl
      changed line: 278
      eliminated line: 273
      changed line: 247
      changed line: 217
      changed line: 97
      changed line: 3 - 8

      Bootstrap 3 emailmanagementlists.tpl
      changed line: 3 - 7

      Bootstrap 3 emailmanagementmailmodify.tpl
      changed line: 1 - 5

    • Responsioplus3 emailmanagementaccounts.tpl
      changed line: 191
      eliminated line: 185
      changed line: 157
      changed line: 88
      changed line: 78
      changed line: 8 - 12

      Responsioplus3 emailmanagementboard.tpl
      eliminated line: 379 - 386
      changed line: 8 - 12

      Responsioplus3 emailmanagementlist.tpl
      changed line: 305
      eliminated line: 299
      changed line: 273
      changed line: 241
      changed line: 108
      changed line: 8 - 13

      Responsioplus3 emailmanagementlists.tpl
      changed line: 8 - 12

      Responsioplus3 emailmanagementmailmodify.tpl
      changed line: 6 - 10


Version 3.11.0 (Top)
Release Date: 26/02/2016

  • Protection against WHMCS resellerclub module bug #CORE-9485 affecting WHMCS v6.2.x releases only
  • Code improvements and minor bugfixes
  • Fully tested for whmcs v6.2.x

Version 3.12.0 (Top)
Release Date: 20/10/2016


    Maintenance Update
  • Added: Support for WHMCS 7 and PHP 7
  • Bugfix: Minor bugfixes

Version 3.12.1 (Top)
Release Date: 27/02/2017


    Maintenance Update
  • Added: Menu links for Email List Management (six based themes only)
  • Updated: Overall template changes https://github.com/imaticon/RAMEI/compare/v3.12.0...v3.12.1
  • Updated: Language files in Core Addon v1.4.5
  • Bugfix: CSS styling issue on searchbox
  • Bugfix: php fatal error with idnclass under certain circumstances
  • Bugfix: Mail Management Dashboard shows count of email accounts wrong for old email accounts under certain circumstances
  • Bugfix: An unexpected Error has occured if a domain is multiple times present with status cancelled
  • Bugfix: Domain name must be always lowercase

  • Changelog Update

    Version 3.12.1 is fully compatible with WHMCS 7.x.x - 7.4.1


Version 3.12.2 (Top)
Release Date: 18/12/2017


Version 3.12.3 (Top)
Release Date: 29/01/2018


    Maintenance Update
  • Deprecated: Support for PHP 5.3 and Ioncube Loaders 4.1.x. Minium requirements PHP 5.4.x and Ioncube Loaders 5.0.x
  • Updated: Ready for Ioncube Loaders 10.x and PHP 7.1
  • Updated: Language files in Core Addon v1.4.10

Version 3.13.0 (Top)
Release Date: 19/03/2018


  • Updated: Ready for Ioncube Loaders 10.1, PHP 7.1 and PHP 7.2
  • Updated: Ready for WHMCS 7.5.x
  • Updated: Overall code improvements and minor bugfixes

Version 3.13.1 (Top)
Release Date: 05/10/2018


  • Bugfix: Disallow direct access if Email forwarding Domain Addon not active
  • Bugfix: Call to a member function addons() if Marketconnect Promotion sidebar widgets are activated
  • Bugfix: Bulk create email account form always shows an error message
  • Implemented: Sub-account permissions for domain and products
  • Updated: Awesome 5 Icons for WHMCS 7.6
  • Updated: Overall code improvements and minor bugfixes

Version 3.13.2 (Top)
Release Date: 10/01/2019


  • Bugfix: Suspend email action shows confirmation message for delete account
  • Bugfix: Bulksuspend function does delete email accounts instead of suspend accounts
  • Bugfix: Create admin mail forwarder shows wrong limit. Max. 5 for free Email, Max. 10 for Business/Enterprise Email
  • Updated: Template for five and six themes
  • Template change:
    • Six emailmanagementcreatefwd.tpl
      changed line: 55
    • Five emailmanagementcreatefwd.tpl
      changed line: 58

Version 3.14.0 (Top)
Release Date: 08/02/2019


  • Deprecated: Support for WHMCS 6.0 - 6.2. Min version now 6.3.x
  • Deprecated: Support for PHP 5.4 and 5.5. Min version now 5.6
  • Updated: Overall code improvements and minor bugfixes
  • Updated: Ready for WHMCS 7.7.x and PHP 7.3

  • Additional Information - Updated 04/09/2019
    • Release 3.14.0 has been fully tested and no update is required for WHMCS 7.8.x

Howto Install R.A.M.Email Interface v3

Resellerclub Mods Management Core Console (Addon)

 

All v3 Modules requires the Resellerclub Mods Management Core Console Addon "Resellerclub Mods Console v3".

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

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

 

Optional: This step is only required if you want to replace the WHMCS Email Forward Manager with the RAM Email Manager. If you plan to offer the RAM Email Manager only for LogicBoxes Hosting plans such as Business/Enterprise Email, DIY Sitbuilder plans, etc., then you can safely skip this step.

 

Additional Configuration Steps for FIVE based templates

Additional Configuration Steps for SIX based templates

 

clientareadomaindetails.tpl - FIVE based template themes

 

  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.

clientareadomaindetails.tpl - SIX based template themes

 

  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):
    Activate Management Tools in Admin Area

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

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

Additional Configuration Steps for SIX based templates

 

clientareadomaindetails.tpl - FIVE based template themes

 

  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.

clientareadomaindetails.tpl - SIX based template themes

 

  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=managemailhost&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.

Howto Update R.A.M.Email Interface v3

If you have already installed R.A.M.Email Interface v3, then you can easily upgrade to ANY new version very easy.

  1. Download the latest R.A.M.Email Interface Software from our Client Area.
  2. Unzip the file with your prefered decompresion software or use the built-in windows feature to extract the content of the zip file.
  3. Proceed with the upgrade steps provided for the version you have installed by clicking on the corresponding "TAB"

All modules upwards v3.13.x requires the Core Addon v1.5.x or above! Make sure you update first the Core Addon to the latest release before you update this module to v3.13.x

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:

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

All modules upwards v3.13.x requires the Core Addon v1.5.x or above! Make sure you update first the Core Addon to the latest release before you update this module to v3.14.x

Important: Before Upgrade to version 3.14.x:

  • Required: PHP 5.6 - 7.3 with Ioncube Loaders 10.1.x or above
  1. Make sure you have first installed or updated to the Management Core Console v1.6.0 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. Access the Resellerclub Mods Console Addon » R.A.M.Email Interface and click the button "Validate Module"