Domain Orders Extended For WHMCS

From ModulesGarden Wiki
Jump to: navigation, search

Article update is ongoing on this page, watch out for broken links, unclear descriptions or images!
We are sorry for the inconvenience caused.


About Domain Orders Extended For WHMCS

Domain Orders Extended For WHMCS allows you to group domains into categories and perform bulk actions on multiple domains.

You will be free to import predefined sets of TLDs, apply easily adjustable domain labels, plus regulate the priority and order of TLDs.
The module lets your clients perform multiple lookup and checkout for domain names in a single request, browse suggestions powered by three built-in domain spinners.
In addition, the module supports gTLDs and ccTLDs allowing your customers to conveniently order their favorite domain names without leaving your website.

  • Client Area Features:
✔ Supports Three External Domain Search Forms
✔ Fast Cron Domain Lookup
✔ Simultaneous Domain Searches In Multiple Spinners
✔ Display Domain Name Suggestions
✔ Display Domain Labels
✔ Display TLDs Basing On Defined Prioritization And Order
✔ Multiple Checkout Of Domains In One Request
  • Admin Area Features:
✔ Group TLDs Into Categories & Subcategories
✔ Set Promoted Categories And TLDs
✔ Set Order Of Categories, Subcategories And TLDs
✔ Perform Bulk Changes On Multiple TLDs:
✔ Change TLD Categories And Registrars
✔ Set Domain Pricing
✔ Set Domain Labels
✔ Toggle Promoted TLDs
✔ Delete TLDs From Categories
✔ Import TLD Sets To Categories From Predefined List
✔ Choose Domain Lookup Submodules:
✔ Default Or Custom WHMCS Provider
✔ OpenSRS
✔ eNom
✔ Add Your Own Lookup Submodules
✔ Set TLDs Searched By Default
✔ Toggle Search Of Domain Suggestions
✔ Add Customized TLD Labels
✔ Choose Domain Search Form:
✔ List View
✔ General Category View
✔ Multi Category View
✔ Configure Cron Domain Lookup:
✔ Define Number Of Simultaneous Processes
✔ Define Number Of Search Records Per Process
  • General Info:
✔ gTLDs & ccTLDs Support
✔ IDN Support
✔ Multi-Language Support
✔ Supports PHP 5.6 Up To PHP 7
✔ Supports WHMCS Template Six
✔ Supports WHMCS V7


This tutorial will show you how to successfully install Domain Orders Extended For WHMCS.

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

Note: If you are still using any of the module's previous versions prior to v3.x, follow these instructions.

1. Log in to our client area and download the module.
DOE3 1.png
2. Extract the downloaded file into the main WHMCS directory.

The content of the package should look like this.

DOE3 2 2.png
3. When you install Domain Orders Extended For WHMCS for the first time you have to rename 'license_RENAME.php' file.

You can find it in 'modules/addons/DomainOrdersExtended/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

DOE3 3.png
4. 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'.

DOE3 4.png
5. Now, set up the 'storage' folder as writable.

This folder should be available at 'your_whmcs/modules/addons/DomainOrdersExtended/' . If not, create one manually.

DOE3 6 2.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 Orders Extended' and press 'Activate' button.

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

To do so, click on 'Configure' button, select administrator groups which should have access to this addon and press 'Save Changes'.

DOE3 6.png
8. You have just successfully installed Domain Orders Extended For WHMCS!

You can access your module in 'Addons' 'Domain Orders Extended'.

Configuration and Management

Domain Orders Extended will help you with the management of your domains and their pricing.

It will also reduce the time required for performing actions on domains due to the implemented bulk actions feature.
Additionally, you can group TLDs into categories and select TLDs assigned to a given registrar.

TLDs Configuration

In 'TLDs Configuration' tab you can view all the information related to your domains, such as: categories, assigned registrars, prices and labels.

By default, the 'Unassigned' category is created where not yet assigned TLDs are stored.

DOE3 7.png

Add Category

Let's start with creating a category, go to your addon → 'TLDs Configuration'.

Click on 'Add TLDs Group' button, enter the category name into the 'Title' field.
You can also decide whether this category is to be promoted on the top domain search list, regardless of the specified order.
Note that a category can also be created as a subcategory of another category. Click here to see an exemplary result.
Press the 'Add Category' button when ready.

DOE3 2 8.png
You can also edit or delete a created category at any time by clicking on the corresponding button in the upper right corner.
DOE3 2 8 2.png

Assign TLDs

In order to add new TLDs to a category, press the 'Assign TLDs' button.

You can assign multiple TLDs at once and decide whether the searched domains should be promoted at the top within this category, regardless of the order of the remaining, not promoted TLDs.
Afterwards, press the 'Assign TLDs' button.
Note: The given TLD can be assigned to only one category at a time.

DOE3 2 9.png

Edit TLD Configuration

Click the 'Edit TLD Configuration' button to access the settings of the selected TLD.

Here you can change the category to which a given TLD belongs, set the domain registrar, assign labels or decide whether to promote searched domains on top of the category.

DOE3 2 10.png

Edit TLD Pricing

In the Edit TLD Pricing tab, you can set a domain pricing for each of registration periods in each available currency.
DOE3 2 17.png

Bulk Actions

Our module allows you to perform actions simultaneously on multiple TLDs.

You can mass edit TLDs configuration, pricing or delete TLDs from the assigned categories.
Simply select multiple extensions on which you want to perform actions and choose the corresponding button from the displayed menu.

DOE3 15.png

Order of Categories and TLDs

Using drag & drop allows you to change the order of the categories, subcategories and TLDs.

This enables you to decide on the order in which categories and TLDs appear in the domain search list.
Note that promoted categories and TLDs are always on top regardless of the specified order.

To change the order, simply grab the chosen item and drag it to the desired location.

DOE3 19.png
After dragging, the new order is automatically saved.
DOE3 20.png

Depending on the selected domain search type, the order of TLDs display in search results will be set in the following sequence (from the most important to least):

  1. Promoted categories
  2. Categories order on the list
  3. Promoted TLDs
  4. TLDs with labels
  5. TLDs order on the categories list

Predefined TLD Sets

You can install predefined sets of TLDs. Proceed to 'Predefined TLD Sets' tab.

As you can see, TLDs are sorted into categories. Some of them can have their own subcategories.
Choosing a parent category will also show all the TLDs belonging to their subcategories.
Click the 'select all' checkbox or mark the single TLD that belong to a selected category and press 'Add TLDs' .

DOE3 25.png
Now you can create a new category from the set with the same name or add the selected TLDs to one of the previously created categories or subcategories in the 'TLDs Configuration' .

Press 'Add TLDs' when ready.

DOE3 26.png


In 'Settings' tab you are able to define behavior of the module domain search, suggestions as well as configure the lookup cron.

Module Settings

Here you can set up domain searching and suggestions' behavior in the client area. These options are:

  • Replace Standard Registrar With Module Order Form - if enabled, the default domain lookup page in the client area will be replaced with the module's customized one.
    Otherwise, the standard WHMCS lookup page will be used and you will have to access the module lookup using an external URL.

  • TLDs Searched By Default - select the TLDs you want to be searched by default when the client enters the domain without specifying the search results.
    If left empty, all supported TLDs will be searched at once.

  • Domain Search Type - select one of three available domain search views in the client area:
    • List View - all searched domains will be displayed in a single list, regardless of their categorization
    • General Category View - the display of the searched domains will be allocated between the main categories, without specifying the subcategories
    • Multi Category View - all searched domains will be split into the main categories and their subcategories

Note: Check the 'Client Area' section to see the visual differences between the domain search types.

  • Suggested Search - select the provider you want to use in order to search for domain suggestions:
    • Disabled - choose if you do not want to display domain suggestions
    • WHMCS Lookup Provider - the default WHMCS provider will be used or any other that has been configured in the WHMCS 'Domain Pricing' settings as a lookup provider
    • eNom Lookup - use only if configured in the 'Submodules' settings
    • OpenSRS Lookup - use only if configured in the 'Submodules' settings

Note: For your convenience, suggested domains available for registration will be shown in the search results, despite the provider that might also suggest the already taken domains.
Note 2: If in the meantime any of the providers is deactivated in submodules, remember that you need to reset the suggested search selection and save data again.

DOE3 27.png

Cron Settings

The default WHMCS lookup may work extremely slowly while checking a large number of domains, therefore we have introduced an additional cron solution.
The cron processes are responsible for searching a large quantity of domains and suggestions.

Here you can configure the number of simultaneously run processes and how many domains can be handled by one process at the same time.
For example, you can set 5 processes to work simultaneously, and each of them can deliver up to 20 search results at once.

Note: The higher the number of processes and search records per process, the faster the search for domains, but also the increased usage of server resources and number of requests to the lookup provider.
Use these options reasonably.

To run cron processes, simply add a cron job as shown below (each 5 minutes suggested).

php -q /yourWHMCS/modules/addons/DomainOrdersExtended/cron/cron.php DemonTask

Do not forget to replace 'yourWHMCS' with your WHMCS root location.
Important: It is required that 'exec' function is not blocked in your PHP configuration.
Moreover once the cron process has been launched, you cannot change the number of running processes on the fly.
To change them, stop the the cron, change the number and launch it again.

DOE3 28.png
If you would like to stop the cron processes manually, delete all content of the '/yourWHMCS/modules/addons/DomainOrdersExtended/storage/crons/' folder or execute the command below:
rm -r /yourWHMCS/modules/addons/DomainOrdersExtended/storage/crons/*

As previously, do not forget to replace 'yourWHMCS' with your WHMCS root location.


In this section, you can configure the connection data to use an external domain lookup provider. The currently available are:
  • Default Submodule
  • OpenSRS
  • eNom

You can use these providers at the same time, but make sure they actually support the available TLDs.
You can also exclude TLDs that shall not be presented among the results offered by a given domain spinner.
In addition, you can enable the 'Default Submodule' to search for domains if you do not have the submodules configuration, or if they do not support relevant TLDs.
In this case, the WHMCS lookup provider configured in the 'Domain Pricing' settings will be used.

Note: If all submodules are used and a domain search is started for TLD mutually supported by them, then the domain will be checked first by the OpenSRS submodule,
next if not found it will be searched by the eNom submodule, and then, finally, by the default WHMCS lookup.

DOE3 29.png


Here you can create labels that can then be assigned to the selected TLDs.

Each label may be distinguished by its own color and may receive priority.
Labels will then be displayed next to the assigned TLD on the domain search and suggestions results.

DOE3 30.png
To start, press the 'Add Label' button to create the first one.

Then, set a title that will appear on the label and message that appears when you move the cursor over the label.
Next, set its priority which will determine the label's position next to a domain. The higher the number, the higher the priority, and thus the closer the label to a domain.
Note: You can also prioritize different labels with the same value.
Finally, set the color of the text and the background of the label, and save changes when ready.

DOE3 31.png
Once the label has been created, it will appear on the list, where you can edit or delete it.

To learn how to assign the label to a particular TLD, see the 'Edit TLD Configuration ' section.

DOE3 32.png

Client Area

Now, we are about to show you the main functionality of this module, which is located in the client area.

Domains Lookup

As soon as you check 'Replace Standard Registrar With Module Order Form' in 'Settings ', your clients will see a different domain order form under 'Domains' → 'Register a New Domain'.

Your clients have access only to the TLDs assigned to categories and with the pricing set.
By default, only TLDs selected in the 'Module Settings' will be searched for an entered phrase.
If your customers want to get results concerning other TLDs, they can select them from the drop-down list.

DOE3 30 1.png
Below you can also see the differences in the display of the domain search depending on the previously chosen settings.

List View

The list view represents all the domains searched in one common list.
Your customers will not see the search results divided into previously created categories and subcategories.
Nevertheless, the order of the displayed domains will still depend on the set order of categories and TLDs in the configuration but the promoted TLDs will be displayed at the top of the list.
If enabled, the list also contains domain suggestions.
DOE3 2 30.png

General Category View

In this view, your clients will see a categorization of the searched domains in tabs, but without showing their subcategories.
TLDs from the subcategories will be displayed in the main categories.
If none of the TLDs in a given category is included in the search results, this subcategory will not be displayed in the results list.
The order of the displayed results depends on the first set order of the categories, and then on the order of the TLDs within them. Promoted TLDs will be displayed at the top.
DOE3 33 5.png

Multi Category View

This view works similarly to the 'General Category View' , but also includes a subcategorization of search results that customers will be able to expand from category tabs.
DOE3 2 31.png


1. TLDs are hidden for clients as long as they are not assigned to any category.
2. The module does not support the migration from previous versions 2.X. All settings have to be defined anew.
3. The bulk domain search is not yet implemented. It will be reimplemented in the future updates.

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 Orders Extended For WHMCS