Domain Allocator For WHMCS

From ModulesGarden Wiki
Jump to: navigation, search

Contents

About Domain Allocator For WHMCS

Domain Allocator For WHMCS gives your clients the opportunity to assign domains to their own hosting accounts and allows to set its type to either parked or addon.
With this module domain parking and creating addon domains will be possible over the ordering process and as a measure of handling already owned domains, within both admin and client area.

The module connects finely with web hosting accounts of cPanel, Plesk and DirectAdmin.

  • Admin Area Features:
✔ Enable Domain Allocation For Selected Products
✔ Manage Domain Assignments
✔ View Summary Of Domain Assignments
  • Client Area Features:
✔ Domain Allocation During Order Checkout:
✔ Assign Domain As Parked Or Addon Domain
✔ Order New Web Hosting Account
✔ Domain Allocation In Overview Section:
✔ Assign Domain As Parked Or Addon Domain
✔ Switch Domain Assignment Between Web Hosting Accounts
✔ Change Nameservers To Match Web Hosting Configuration
  • Supported Modules:
✔ DirectAdmin & DirectAdmin Extended For WHMCS
✔ cPanel & cPanel Extended For WHMCS
✔ Plesk & Plesk Extended For WHMCS
  • General Info:
✔ Multi-Language Support
✔ Supports PHP 5.4 Up To PHP 7
✔ Supports WHMCS V6 and V7

Installation and Configuration

This tutorial will show you how to successfully install and configure Domain Allocator For WHMCS.

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

Installation

1. Log in to your client area and download the module.
DAlloc 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 7, while the second one is aimed at PHP 5.4 up to PHP 5.6.
It does not apply to open source versions.

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

DAlloc 2.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.

Etrr5.png
4. When you install Domain Allocator For WHMCS for the first time you have to rename 'license_RENAME.php' file.

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

DAlloc 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 your client area → 'My Products'.

DAlloc 4.png

Addon Configuration

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 Allocator' and press 'Activate' button.

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

To do so click on 'Configure' button, tick 'Access Control' near desired admin role groups and press 'Save Changes'.

DAlloc 6.png
8. You have just successfully installed Domain Allocator For WHMCS!

Management

In this section we will show you the possibilities of Domain Allocator For WHMCS.

Our module allows your clients to manage assignment of parked and addon domains.

Admin Area

Dashboard

Here you can see the short summary on the module details and the list of all domain assignment.
DAlloc 7.png

Products Configuration

In 'Configuration' tab you will find the list of your products. Here you can enable or disable automatic domain assignment for each of them.

Note that not all submodules are supported thus management of your other products will not be available.

DAlloc 8.png

Integration Code

In order to allow your clients to manage assignment, follow these steps.
1. Open the file found in the below directory.
templates/orderforms/standard_cart/configuredomains.tpl
2. Delete the line:
{if $domain.hosting}[{$LANG.cartdomainshashosting}]{else}<a href="cart.php" style="color:#cc0000;">[{$LANG.cartdomainsnohosting}]</a>{/if}
and add the proper code:
{if $loggedin}
    {if $hostcheck}
        <button data-domain-name="{$domain.domain}" class="assign_order btn btn-primary" role="button" type="button">{$btnassign}</button>
    {else}
        <div class="alert alert-warning alert_custom" role="alert">
            {$user_no_hosting}
        </div>
    {/if}
{else}
    <div class="clear_f"></div>
    <button data-domain-name="{$domain.domain}" data-toggle="modal" data-target="#loginmodal" type="button" class="login_btn btn btn-primary">{$btnlogin}</button>
{/if}
<div class="clear_f"></div>
{if $domain.hosting}
    <span class="active_hosting alert alert-info alert_custom" role="alert">{$has_hsoting}</span><br />
{else}
    <a class="add_hosting btn btn-primary" href="cart.php">{$no_hsoting}</a>
{/if}
3. You can see correctly placed code below.
DAlloc 10.png
4. This is how it should be seen in the client area.
DAlloc 11.png

Client Profile

When you want to assign a domain from your admin area, just look at the details in the client profile. Select 'Domains' tab and click 'Manage Assignment' .
DAlloc 14 1.png
Then select Web Hosting account to which your domain will be assigned and define this assignment type.
DAlloc 14.png

Client Area

Your customers can perform various actions on their domains from the client area.
Read the description below to see exactly what can be done.

Manage Assignment

In the client area proceed to 'Domains' → My Domains' . Here clients can view basic information related to domains and perform several actions on them.
DAlloc 12.png
Press 'Manage Assignment' to assign domain to Web Hosting Account.
DAlloc 13.png
Select preferred options from the dropdown menu and click 'Submit' button.
DAlloc 14.png

Register Domain

It is also possible to register a completely new domain. Go to 'Domains' → 'Register a New Domain' and type in a name to check its availability.
If so, add it to cart and click 'Checkout'.
DAlloc 15.png
Details will be visible now. 'Manage Assignment' to assign domain to already existing Web Hosting Account is one of the choices.
DAlloc 16.png
Just select preferred options from the dropdown menu and click 'Submit' button.
DAlloc 14.png
Apart from that, a new account can be ordered. To do so, press 'Order New Hosting Account' button.
DAlloc 17.png
Select the hosting that suits your needs most.
DAlloc 18.png

Unassign Domain

Clients are also given the possibility to unassign their domains.
To unassign a domain go to 'Domains' → My Domains' and select one from the list.
DAlloc 12.png
Press 'Manage Assignment' to unassign domain from Web Hosting Account.
DAlloc 13.png
Then click the button as shown here:
DAlloc 19.png
A proper note will show up.
DAlloc 20.png

Change Hosting Account

Clients are also enabled to change the hosting accounts.
To do so, proceed to 'Domains' → My Domains' and select one from the list.
DAlloc 12.png
Press 'Manage Assignment' to change the account.
DAlloc 13.png
Then click the button as shown here:
DAlloc 19 1.png
Now, simply choose the new account and type of assignment. Then submit your request.
DAlloc 21.png
You have successfully changed the account and your domain has been assigned to the new one.
DAlloc 22.png

Tips

1. Should you encounter any problems related to nameservers, you need to check their setup in the server configuration.
Proceed to 'Setup' 'Products/Services' 'Servers' .
You need to have nameservers set for the server using cPanel, Plesk or DirectAdmin products.
Lack of their proper configuration may result in difficulties during domain assignment or changing hosting accounts.
DAlloc 23.png
2. As this module supports templates system, any changes made in the module's templates files will be saved after the upgrade process.

Common Problems

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

Variants
Actions
Navigation
WHMCS Modules
cPanel Modules
Magento Extensions
Magento Themes
PrestaShop Modules
Blesta Extensions
General
Social
Domain Allocator For WHMCS