Advanced Dns Interface v3 Documentation

Upload files and folders

Download RAMDI - ResellerClub Advanced Managment DNS 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 files dnsmanagement.php and domainforwarding.php from the unzipped "dnsmanagement_x.x.x" folder into your whmcsroot/ folder


2. Upload the *.tpl 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 $dnsmanagement} ... {/if}. The code between this if statement looks something like this if you haven't customized it before:
   

   
   {if $dnsmanagement}<li><a href = "clientarea.php?action=domaindns&domainid={$domainid}">{$LANG.clientareadomainmanagedns}</a></li>{/if}
   							

   Replace the original code with the following code:

   
   {if $dnsmanagement}<li><a href = "dnsmanagement.php?action=managednszone&domain={$domain}&domainid={if $domainid}{$domainid}{else}{$id}{/if}">{$LANG.clientareadomainmanagedns}</a></li>{/if}
   							

   Copy/paste the following html code for the domain forwarding link just underneath the DNS Management code above:

   
   {if $dnsmanagement}<li><a href = "domainforwarding.php?action=managedomfwd&domain={$domain}&domainid={if $domainid}{$domainid}{else}{$id}{/if}">Domain Forwarding</a></li>{/if}
   							



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

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

   Replace the original code with the following code:

   
   <a href = "dnsmanagement.php?action=managednszone&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.dnsmanagement} ... {else}.
   

   
   <a class="btn btn-success" href = "clientarea.php?action=domaindns&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 = "dnsmanagement.php?action=managednszone&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 "Expert" to learn howto modify the template file to offer the RAM Dns Interface for LogicBoxes registered domains and the WHMCS Built-in DNS Manager for all other domains.

Test the Interfaces

To offer DNS Management, 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 DNS Management from Setup » Products/Services » Domain Pricing for each TLD which support DNS Management:
   

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 dns domain link from the Management Tools Tab to access the RAM Dns Interface and the Domain Forwarding Interface.

Implementing RAM Dns Manager and WHMCS Dns 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 Dns Manager for ResellerClub domains and the WHMCS built-in DNS 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 $dnsmanagement} ... {/if}. The code between this if statement looks something like this if you haven't customized it before:
   

   
   {if $dnsmanagement}<li><a href = "clientarea.php?action=domaindns&domainid={$domainid}">{$LANG.clientareadomainmanagedns}</a></li>{/if}
   							

   Replace the original code with the following code:

   
   {if $dnsmanagement}
   	{if $registrar eq "resellerclub" || $registrar eq "resellerclubrcm"}
   		<li><a href = "dnsmanagement.php?action=managednszone&domain={$domain}&domainid={if $domainid}{$domainid}{else}{$id}{/if}">{$LANG.clientareadomainmanagedns}</a></li>
   	{else}
   		<li><a href = "clientarea.php?action=domaindns&domainid={$domainid}">{$LANG.clientareadomainmanagedns}</a></li>
   	{/if}
   {/if}
   							

   Copy/paste the following html code for the domain forwarding link just underneath the DNS Management code above:

   
   {if $dnsmanagement}
   	{if $registrar eq "resellerclub" || $registrar eq "resellerclubrcm"}
   		<li><a href = "domainforwarding.php?action=managedomfwd&domain={$domain}&domainid={if $domainid}{$domainid}{else}{$id}{/if}">Domain Forwarding</a></li>
   	{/if}
   {/if}
   							



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

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

   Replace the original code with the following code:

   
   {if $registrar eq "resellerclub" || $registrar eq "resellerclubrcm"}
   	<a href = "dnsmanagement.php?action=managednszone&domain={$domain}&domainid={$domainid}">{$LANG.manage}</a> | <a href="clientarea.php?action=domainaddons&id={$domainid}&disable=dnsmanagement&token={$token}">{$LANG.disable}</a>
   {else}
   	<a href = "clientarea.php?action=domaindns&domainid={$domainid}">{$LANG.manage}</a> | <a href="clientarea.php?action=domainaddons&id={$domainid}&disable=dnsmanagement&token={$token}">{$LANG.disable}</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.dnsmanagement} ... {else}.
   

   
   <a class="btn btn-success" href = "clientarea.php?action=domaindns&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 = "dnsmanagement.php?action=managednszone&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=domaindns&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 files "dnsmanagement.php" and "domainforwarding.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/RAMDI/compare/v3.12.0...v3.12.1
   • https://github.com/imaticon/RAMDI/compare/v3.12.1...v3.12.2
   • https://github.com/imaticon/RAMDI/compare/v3.12.2...v3.13.1


4. Access the Resellerclub Mods Console Addon » R.A.M.Dns 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 files "dnsmanagement.php" and "domainforwarding.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/RAMDI/compare/v3.12.0...v3.12.1
   • https://github.com/imaticon/RAMDI/compare/v3.12.1...v3.12.2
   • https://github.com/imaticon/RAMDI/compare/v3.12.2...v3.13.1
   • https://github.com/imaticon/RAMDI/compare/v3.13.1...v3.16.0


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