Domain And Email Forwarding For WHMCS

From ModulesGarden Wiki
Jump to: navigation, search


About Domain And Email Forwarding For WHMCS

Domain & Email Forwarding For WHMCS is a module which allows your clients to create and manage forwarders directly in your client area.

The extent of management depends on the administrator, who needs to define the level of allowed domain management per each TLD.
Your client can create redirections for domains or directories as well as emails.

  • Admin Area Features:
✔ Define Per TLD:
✔ Domain Forwarders Availability
✔ Directory Forwarders Availability
✔ Domain Email Forwarders Availability - cPanel Only
✔ Single Email Forwarders Availability
✔ Nameservers
✔ Navbar Elements
✔ Define Default Nameservers
✔ Park/Unpark Domains
✔ Check If Domains Are Parked
✔ Disable Module For Domains Assigned To Hosting
✔ Test Connection With External Server
✔ View Logs
  • Client Area Features:
✔ Forward Domain/Directory
✔ Set Redirection Type - Permanent (301) or Temporary (302)
✔ Define Redirection With `www.` - Only With, Only Without or Both Rules
✔ Toggle Wild Card
✔ Forward Domain Emails
✔ Forward Chosen Email Accounts
✔ View Domain And Directory Forwarders
✔ View Current Domain Email Forwarder
  • Supported Servers:
✔ WHM/cPanel
✔ DirectAdmin
  • General Info:
✔ Multi-Language Support
✔ Supports PHP 5.6 Up To PHP 7.2
✔ Supports WHMCS V7


This tutorial will show you how to successfully install and configure Domain & Email Forwarding For WHMCS.

We will guide you step by step through the whole installation and configuration process.

1. Log in to our client area and download the module.
DEF 1.png
2. In the downloaded file you will find two packages that support different PHP versions.
As presented on the screen below, the first one is dedicated to PHP 5.6 up to PHP 7.0, while the second one is aimed at PHP 7.1 up to PHP 7.2.
It does not apply to open source versions.

Note: You can check the current PHP version in your WHMCS. To do so, proceed to 'Utilities' › 'System' › 'PHP Info'.

PHP56 72.png
3. Extract the downloaded file and choose the one with the right PHP version. Upload and extract the PHP file into the main WHMCS directory.

The content of PHP version files should look like this.

4. When you install Domain & Email Forwarding For WHMCS for the first time you have to rename 'license_RENAME.php' file.

File is located in 'modules/addons/DomainAndEamilForwarding/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

DEF 3.png
5. In order to configure your license key, you have to edit the previously renamed 'license.php' file.

Enter your license key between quotation marks as presented on the following screen. You can find your license key in our client area → 'My Products'.

DEF 4.png
6. Now you have to activate the module in your WHMCS system.

Log in to your WHMCS admin area. Go to 'Setup' 'Addon Modules'. Afterwards, find 'Domain & Email Forward' and press 'Activate' button.

DEF 5.png
7. In the next step you need to permit access to this module.

To do so, click on 'Configure' button, tick 'Full Administrator' and press 'Save Changes'.

DEF 6.png
8. You have just successfully installed Domain & Email Forwarding For WHMCS!

You can access your module under 'Addons' 'Domain & Email Forward'.

DEF 7.png

Configuration and Management

Domain & Email Forwarding For WHMCS brings some of the management actions on domains from your external servers to your client area.

Underneath, you will find a complete guide which will show you how to take a full advantage of the module.


'Dashboard' of the addon includes only a short guide that is placed to help you quickly move through the configuration.

If you are already familiar with it, you may press 'Don't Show Again' button.
Then the 'Settings' page will be claimed as the home page and there you will be redirected when pressing home icon or addon name.

DEF 10.png


The module is currently compatible with two outside servers, these are cPanel and DirectAdmin.
Before you can completely work with the module, you must have an account created on the server. Domain and email redirections will be attached to this account.


Let's finally move to the addon itself. The first step of the configuration includes activating the module you want to work with.
Move to 'Domain & Email Forwarding' → 'Settings' → 'Modules' and 'Activate' the module you need to connect to the external server. You may activate cPanel and DirectAdmin modules.
For presentation purposes, we will show how to properly activate and then configure cPanel module. DirectAdmin works alike.
DEF 11.png
Confirm the action to continue.
DEF 12.png
You may deactivate the used module at any moment. Simply press the button marked on the screen.
DEF 13.png
When a module is active, you must configure connection with its server. Press 'Configure' to do so.
DEF 14.png
Here, you must provide all necessary details to successfully connect with the server:
  • Host or IP address
  • WHM username and password
  • Account - name of the previously created account on your cPanel server with no or a very high limit.
    All redirections will be assigned to this account.

Press ' Test Connection' button to make sure everything is working properly.

DEF 15.png
Finally, save the configuration.
DEF 16.png


Once you have active and properly configured connection with an outside server of your cPanel, you may move to the general settings of the module.

You can find them under 'Settings' → 'General'.

DEF 17.png
There are three sections: 'General', 'Domains' and 'Nameservers'. We will start with 'Namaeservers'.
DEF 18.png
'Nameservers' section includes default entries that will be used in case domain nameservers are not provided.
Prepare a list of your standard nameservers here.
DEF 18 1.png
'Domains', contains a complete list of allowed in your WHMCS TLDs.
Press pencil icon under 'Action' to set up forwarding options for each of the TLDs.
DEF 18 2.png
Here, in 'General' part, you may allow options per TLD, such as:
  • domain forwarding
  • directory forwarding (only if domain forwarding is allowed)
  • email forwarding

Select which module it should be applied to (if more than one is active).

DEF 19.png
Finally, you may provide nameservers per TLD. If you do not do it, the default nameservers will be used.
DEF 20.png
Prepare configuration for each of the TLDs according to your needs.
DEF 20 1.png
In the last section, 'General', you may decide whether you wish to hide 'Domain Management' box in the client area if the domain is used in a hosting.
DEF 20 2.png


Under 'Domains' tab, there are all existing domains listed.
DEF 29.png
Here the administrator may check the current status of the domain.
Just press the marked button and a notification will appear with information whether the domain is parked or not.
DEF 30.png
Use the action buttons to either park(1) or unpark(2) the domain.
DEF 31.png


Under 'Logs' tab you will find all log entries.

There are details on any successful or failed action in the module. Check it out any time you need to find some details on the actions taken.
Press 'Delete All Entries ' to clear all logs or delete single ones.

DEF 21.png


The last position in your navigation menu, when pressed, redirects to the article you are currently reading.
DEF 22.png

Client Area

Domain & Email Forwarding For WHMCS module gives your clients the possibility to perform some actions typical to the ones that are performed directly in cPanel.
If you have allowed the options to your clients per used by them TLD, they now can see a new management box when they move to their domain details.
DEF 23.png

Domain Forwarders

Under 'Domain Forwarders' clients may now specify new forwarders per domain or directory.
DEF 24.png
To add a new domain forwarder:
  • select its type: 'Permanent' or 'Temporary'
  • provide directory forward - if allowed
  • provide redirect URL to redirect domain
  • select 'www' redirection type
DEF 25.png

Email Forwarders

The second option 'Email Forwarders' allows clients to forward email from one domain to another one.
You may also provide a new destination for a specific email account.
DEF 26.png
In order to add an email forwarder, please specify firstly address you want to forward and then the final destination.
DEF 27.png
To add a new email forwarder simply type in the final domain to redirect email to.
To delete an email forwarder simply press button under 'Actions' column.

Note: Please keep in mind that this option is available only for cPanel module.

DEF 28.png


1. If you want to quickly set up the configuration for all your TLDs, then you can use the 'Mass Edit' option to shorten the process.
2. As this module supports templates system, any changes made in the module's templates files will be saved after the upgrade process.

Update Instructions

Essential guidance through the process of updating the module is offered here.

Keep in mind there is a quick and easy option in our client area that will let you upgrade the license of your module to an open source version at any time - and at a lower price!
To take advantage of it, simply use the License Upgrade button located on the product's page and a discounted invoice will be generated automatically.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
Personal tools

WHMCS Modules
cPanel Modules
Magento Extensions
Magento Themes
PrestaShop Modules
Blesta Extensions
Domain And Email Forwarding For WHMCS