LiveZilla Live Chat Software
RCM - Resellerclub Mods

Howto install R.A.M.Email Interface V3

RAMEI - Resellerclub Advanced Management Email Interface
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.6 - 13-07-2015

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 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 *.tpl files which matches your theme into your active whmcsroot/templates/(portal, classic, default, responsioplus3, bootstrap3_compatibe)/ theme folder.

Modify clientareadomaindetails.tpl

 

Note If you use the new WHMCS v6 six template, then you can safely skip this step! Link manipulation will be handled automatically with the new menu hook system available in WHMCS v6

The following instruction explains how you have to setup the template and css file.

Optional: This step is only required if you like to offer FREE Email Hosting and/or Email Forwarding with every domain. If you plan to use the RAMEI interface only for the Enterprise and Business Email Hosting plans, then you can safely skip this step.

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 setup the R.A.M.Email Interface for multiple domain registrars.

For classic and portal based template themes

 

  1. Open the whmcs template file "clientareadomaindetails.tpl", located in whmcsroot/templates/portal or classic/. You may have renamed this folder or are using an other template design. In such case, simply open the "clientareadomaindetails.tpl" from your active template folder

  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}
    <td><form method="post" action="{$smarty.server.PHP_SELF}?action=domainemailforwarding">
      <input type="hidden" name="domainid" value="{$domainid}">
      <p align="center">
        <input type="submit" value="{$LANG.domainemailforwarding}" class="button">
      </p>
    </form></td>
    {/if}
    

    Replace the original code with the following code:

    {if $emailforwarding}
    <td><form method="post" action="emailmanagement.php?action=managemailhosting">
      <input type="hidden" name="domainid" value="{if $domainid}{$domainid}{else}{$id}{/if}"/>
      <input type="hidden" name="domain" value="{$domain}"/>
      <p align="center">
        <input type="submit" value="{$LANG.domainemailforwarding}" class="button">
      </p>
    </form></td>
    {/if}
    

  3. Open the whmcs "style.css" file located in your active template folder and insert (copy/paste) at the end, the new style content from the [stylename]_update_style.css file.

  4. Upload the modified files style.css and clientareadomaindetails.tpl back into the active template folder.

For default and five based template themes

 

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

  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 (all in one line):
    {if $emailforwarding}<li><a href = "clientarea.php?action=domainemailforwarding&domainid={$domainid}">{$LANG.clientareadomainmanageemailfwds}</a></li>{/if}
    

    Replace the original code with the following code (all in one line!):

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

Additionally only for default and five based template themes

 

  1. Search and locate the code between {if $addonstatus.emailforwarding} ... {else}. Replace the line:
    <a href = "clientarea.php?action=domainemailforwarding&domainid={$domainid}">{$LANG.manage}</a>
    

    Replace the original code with the following code (all in one line!):

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

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

Step 3

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 button or link from the Management Tools Tab if you use WHMCS v5.3.x and access the R.A.M.Email Interface.

Tips & Tricks

Using RAMEI with multiple LogicBoxes and Other Domain registrars

 

Note If you use the new WHMCS v6 six template, then you can safely skip this step! Link manipulation will be handled automatically with the new menu hook system available in WHMCS v6

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 if else condition for the registrar modules you use to offer the Advanced EMAIL Management Interface for ResellerClub domains and the WHMCS built-in Email forwarding interface for Enom.

Follow the below steps:

For classic and portal based template themes

 

  1. Open the whmcs template file "clientareadomaindetails.tpl", located in your whmcsroot/templates/portal or classic/. You may have renamed this directory or are using an other template design. In such case, simply open the "clientareadomaindetails.tpl" from your active template directory

  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}
    <td><form method="post" action="{$smarty.server.PHP_SELF}?action=domainemailforwarding">
      <input type="hidden" name="domainid" value="{$domainid}">
      <p align="center">
        <input type="submit" value="{$LANG.domainemailforwarding}" class="button">
      </p>
    </form></td>
    {/if}
    

    Replace the original code with the following code:

    {if $emailforwarding}
      {if $registrar eq "resellerclub" || $registrar eq "resellerclubrcm"}
        <td><form method="post" action="emailmanagement.php?action=managemailhosting">
          <input type="hidden" name="domainid" value="{if $domainid}{$domainid}{else}{$id}{/if}"/>
          <input type="hidden" name="domain" value="{$domain}"/>
          <p align="center">
            <input type="submit" value="{$LANG.domainemailforwarding}" class="button">
          </p>
        </form></td>
      {else}
        <td><form method="post" action="{$smarty.server.PHP_SELF}?action=domainemailforwarding">
          <input type="hidden" name="domainid" value="{$domainid}">
          <p align="center">
            <input type="submit" value="{$LANG.domainemailforwarding}" class="button">
          </p>
        </form></td>
      {/if}
    {/if}
    

For default and five based template themes

 

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

  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 (all in one line!):

    {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}
    

Additionally only for default and five based template themes

 

  1. Search and locate the code between {if $addonstatus.emailforwarding} ... {else}. Replace the line:
    <a href = "clientarea.php?action=domainemailforwarding&domainid={$domainid}">{$LANG.manage}</a>
    

    Replace the original code with the following code (all in one line!):

    {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}
    

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: