Domain Orders Extended 2.X For WHMCS
From ModulesGarden Wiki
(Difference between revisions)
|
|
Line 5: |
Line 5: |
| {| | | {| |
| |style="padding: 10px 0px 5px 0px;"|'''Domain Orders Extended For WHMCS''' allows you to group domains into categories and perform bulk actions on multiple domains.<br /> | | |style="padding: 10px 0px 5px 0px;"|'''Domain Orders Extended For WHMCS''' allows you to group domains into categories and perform bulk actions on multiple domains.<br /> |
− | Most of all, the module lets your clients perform multiple lookup and checkout for domain names in a single request, in the entirely new domain order form in the WHMCS client area.<br />
| + | The module lets your clients perform multiple lookup and checkout for domain names in a single request, in the entirely new domain order form in the WHMCS client area.<br /> |
| Worth mentioning feature is a domain spinner based on eNom and OpenSRS that will automatically suggest your clients the domain names which may interest them.<br /> | | Worth mentioning feature is a domain spinner based on eNom and OpenSRS that will automatically suggest your clients the domain names which may interest them.<br /> |
| In addition, the module supports gTLDs and ccTLDs allowing your customers to conveniently order they favourite domain names without leaving your website. | | In addition, the module supports gTLDs and ccTLDs allowing your customers to conveniently order they favourite domain names without leaving your website. |
Revision as of 15:19, 22 August 2014
Domain Orders Extended For WHMCS allows you to group domains into categories and perform bulk actions on multiple domains.
The module lets your clients perform multiple lookup and checkout for domain names in a single request, in the entirely new domain order form in the WHMCS client area.
Worth mentioning feature is a domain spinner based on eNom and OpenSRS that will automatically suggest your clients the domain names which may interest them.
In addition, the module supports gTLDs and ccTLDs allowing your customers to conveniently order they favourite domain names without leaving your website.
|
✔ Group TLDs Into Categories & Subcategories
|
✔ Make Bulk Changes On Multiple TLDs:
|
✔ Change Domain Prices - Fixed Or Percentage
|
✔ Delete Categories, Prices And TLDs
|
✔ Change Categories And Registrars
|
✔ Add Your Own Lookup Submodules
|
✔ Choose Domain Lookup Submodule - eNom, OpenSRS Or Default
|
✔ Import TLD Sets From Predefined List
|
✔ Completely New Domain Order Form
|
✔ Multiple Lookup For Domains In One Request
|
✔ Multiple Checkout Of Domains In One Request
|
✔ Ajax Search - One By One
|
✔ Domain Spinner (Name Suggestion) - eNom And OpenSRS
|
✔ New External Forms - Three Types Of Lookup
|
✔ Supports WHMCS V5 and Later
|
Installation
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.
|
1. Log in to your client area and download Domain Orders Extended For WHMCS.
|
2. Upload and extract the module into the main WHMCS directory.
Files in your WHMCS directory should look like this.
|
3. When you install Domain Orders Extended for the first time you have to rename 'license_RENAME.php' file.
File is located at 'modules/addons/TLDsForm/license_RENAME.php' . Rename it from 'license_RENAME.php' to 'license.php' .
|
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 at your client area → 'My Products' .
|
5. 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.
|
6. 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' .
|
7. You have just successfully installed Domain Orders Extended For WHMCS!
You can access your module at 'Addons' → 'Domain Orders Extended' .
|
8. The last step concerns confirming the usage of default WHMCS lookup module.
Go to the 'Settings' tab and press 'Update Settings' button.
|
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 to do any actions on the domains owing to the bulk actions.
Additionally, you can group TLDs into categories and decide which TLD is assigned to which registrar.
|
Add Category
Let's start from creating a category, go to your addon → 'Domain Categories' .
Afterwards, enter category name into the 'Categories Names' field and press 'Create Categories' button.
Note: You can create a multiple quantity of categories at once. To do so, simply fill in one category per line in the 'Categories Names' field.
|
New TLD
In order to add TLD, go to your addon → 'Bulk Actions' .
Afterwards, press 'Add TLD To List' button and type your TLD (both 'com' and '.com' forms are acceptable).
Note: You can create a multiple quantity of TLDs at once by repeating this step.
|
Now select the previously created category, unmark 'Toggle Autoupdate Mode' and enter pricing for the chosen TLDs.
To disable pricing term, mark 'Toggle 0 and -1 Price Ignoring' checkbox and type '0' for Register or '-1' for Transfer and Renew.
On the following screen you can see 3 TLDs with only 2 payment terms enabled for Register, Transfer and Renew.
Note 1: Autoupdate mode will automatically fill in the fields, on the right side of field you are currently filling in, with incremented values.
Note 2: While 'Toggle 0 and -1 Price Ignoring' is enabled, you need to make changes in TLD's yearly price to apply other price changes for selected TLD.
|
The last step is assigning registrar to TLDs, select 'Basic' category (it contains all the previously created TLDs) and press 'Bulk Registrar Change' .
|
Afterwards, select a desired registrar and press 'Update Registrars' button.
|
TLDs Configuration
In the 'TLDs Configuration' tab you can view all the information related to your TLDs, like their categories, assigned registrars and prices.
To switch between Register/Renew/Transfer pricing, select one from the marked dropdown menu and press 'Filter Results' .
To display/hide TLDs assigned to a category, press the category name as shown on the following screen.
|
Another useful feature enables you to make quick changes, like altering assigned registrar, category or pricing at a specific term.
To make such adjustments, simply press value you desire to change and enter the values.
Value for the registrar and the category will be saved automatically, while at the price change you have to confirm changes as shown on the following screen.
|
Bulk Actions
Our module allows you to order actions on multiple TLDs simultaneously. There are three methods to do it.
For the first one, go to the 'TLDs Configuration' tab and mark checkboxes next to the TLDs you want to order action for.
Afterwards, press the button bounded to a certain action. For example, to change category of all selected TLDs press 'Bulk Category Change' .
The second method: go to the 'Category' tab and press 'Bulk Actions For Domains' .
And last but not least method, number three: go to 'Bulk Actions' tab and manually add TLDs to 'Domains List' .
Below we will guide you through the available bulk actions.
Note: On the following screen you can see the first method.
|
As soon as you are moved to bulk actions, you can switch between them via entering different subtabs marked on the following screen.
Note: You can also add new TLDs or already existing ones to the bulk action you are currently performing.
Simply, press 'Add TLD' button under TLD list and type TLD you wish to add.
|
Pricing
In the bulk 'Set Pricing' action you can set a new pricing or copy the pricing assigned to any of the existing TLDs.
Disable 'Toggle Autoupdate Mode' if you are not going to set up all of the payment terms.
Afterwards, fill in the fields and press 'Save Pricing' .
|
If you desire to copy the pricing from an older TLD, choose it from 'Copy Pricing From' dropdown menu. The pricing will be automatically updated.
You can also reassign category for selected TLDs, simply type its name into 'Assign To Category' auto-complete box.
Confirm changes through pressing 'Save Changes' at the bottom of the screen.
Note: If category you entered does not exist, it will be automatically created.
|
Pricing Change
If, for some reason, you need to change the payment for TLDs by fixed or percentage value, then our module will make it available to you.
At the 'Price Change' you can change pricing for selected TLDs by fixed or percentage amount specified by you.
Start by selecting change way from an 'Increase/Decrease ' dropdown menu and the change type from 'Percentage/Fixed' dropdown menu.
Afterwards, type the value to change by and press 'Submit Changes' .
Setup shown on the following screen will remove 10% value of prices from every fields of chosen TLDs.
|
Delete Pricing
In the 'Delete Pricing' subtab, you can remove the pricing from the selected TLDs.
To do so, simply press 'Yes, Proceed' button.
|
Change Category
To assign selected TLDs to one category, go to 'Change Category' subtab.
Afterwards, type a category name into 'New Category' auto-complete box.
If category you entered does not exist, it will be automatically created during the process.
|
Registrar Change
Bulk actions tab allows you to change registrar.
Proceed to 'Registrar Change' subtab, select desired registrar and press 'Update Registrars' .
|
Delete Domain
You can also remove chosen TLDs.
To do so, move to 'Delete Domain' subtab and press 'Yes, Proceed' .
|
Domain Categories
In the 'Domain Categories' you can add new categories and manage existing ones.
You can also order bulk actions for the TLDs assigned to a specified category by pressing 'Bulk Actions For Domains' .
|
Additionally, you can view TLDs assigned to categories.
Simply, move mouse cursor over the fields in 'Domains' column as shown on the following screen.
|
Predefined TLDs
You can install predefined sets of TLDs. Proceed to 'Predefined TLD Sets' tab.
As you can see, TLDs are sorted into three subtabs. Each tab contains TLDs sorted into categories, each category can have its own subcategories.
Mark checkbox as shown on the following screen to mark all TLDs that belong to a selected category and press 'Install Extensions' .
|
The installing of TLDs from selected subcategories is also possible, press category name to extend it and show all of its subcategories.
Afterwards, mark checkboxes next to the desired TLDs and press 'Install Extendions' .
Note: This way you can install multiple TLDs from different categories, the only limitation are subtabs. You can install TLDs from one subtab at once.
|
Settings
In the 'Settings' tab you are able to define behaviour of the module as well as configure external lookup module.
|
Base Settings
Here you can set up behaviour of the Domain Orders Extended For WHMCS module.
1. If marked, a standard registration form will be replaced with Domain Orders Extended form, no integration code required.
2. Place here URL to the domain lookup form from integration code if you are using it.
3. Shows results directly on the lookup page - multiple domain search only.
4. Enables to search multiple domain names at once.
5. Auto expand categories at the addon → 'TLDs Configuration' .
6. Auto expand subcategories at the addon → 'TLDs Configuration' .
|
Domain Lookup Module
The ability to order a group of domains entails a large quantity of requests.
Default WHMCS lookup module may work extremely slow at lookup of large amount of domains. Therefore we integrated additional lookup module.
To use external lookup module, select it from a 'Domain Lookup Module' dropdown menu.
Next, fill in module configuration.
|
Additionally, you can define configuration of the domain spinner.
Press 'Update Settings' to save settings.
|
Integration Code
'Integration Code' tab contains integration code allowing your clients to access bulk domain lookup form at the location defined in the 'Path To External Form' .
As you can see on the following screen, you can choose from a wide variety of domain order forms.
Additionally, you can check here if Domain Orders Extended domain order form is currently used.
|
Client Area
Now, we are about to show you the main functionality of this module, which is placed in the client area.
|
Domains Lookup & Order
As soon as you check 'Replace Standard Registrar With Module Order Form' , your clients will see a way different domain order form under 'Domains' → 'Register a New Domain' .
Using the marked field, your clients are able to define multiple domains to order. They can choose even from the gTLDs and ccTLDs!
Note: Check 'Enable Multiple Domain Search' to allow defining multiple domain names with chosen TLDs.
Otherwise, your clients will be able to define only one domain with chosen TLDs during one lookup.
|
Your clients have access only to the TLDs assigned to categories.
Clients can search TLDs by categories or switch back to 'All Categories' and use quick search.
As you can see on the following screen, our module supports subcategories, therefore you can sort your TLDs even better.
|
After typing domain and selecting TLDs your clients should press 'Check Availability' to proceed.
Important: There is disjunction relation between entered domain and selected TLDs.
For example, client type 'example' and 'mytestingdomain' domains and select '.com' and '.org' TLDs.
He will lookup 'example.com' , 'example.org' , 'mytestingdomain.com' and 'mytestingdomain.org' .
Note: When switching between categories, TLDs chosen at other categories are not cleared.
Therefore your clients can order domains with TLDs from different categories during one order.
|
After lookup, your clients will see a screen similar to the one on the following screen.
If some of the domains are unavailable, clients can go to domains www address, view its whois and transfer it.
|
For available domains, clients can decide if they want to order domains, and select registration period from a dropdown menu.
If clients do not want to order some of the domains, they have to unmark checkboxes next to those domains.
By pressing 'Proceed To The Cart' , your clients are moved to the cart.
|
Domain Spinner
Owing to integration with eNom and OpenSRS, our module allows you to enable domain spinner for your clients.
Let's take a look at how it works, for this purpose, order single domain with 2 TLDs.
|
As you can see, domain spinner shows domains with similar names to the one you were looking for.
It is extremely useful when the domains you were looking for are already taken.
|
Now, make another lookup, but this time enable 'Enable Multiple Domain Search' at the module settings.
Additionally, unmark 'Enable Transfer For Domain Spinner' at the lookup module settings.
Fill in 2 domains, choose 2 TLDs and press 'Check Availability' .
|
As shown on the screen below, domain spinner mixed domain names you were looking for.
Additionally, due to 'Enable Transfer For Domain Spinner' is unmarked, domain spinner suggested only unregistered domains.
|
As you can see, our inbuilt domain spinner will suggest your customers the domain names that should interest them.
This will definitely come in handy and will let your clients order their favourite domains quickly and capably. Make sure that you will enable this functionality!
|
Migration
You can easily upgrade your Domain Orders Extended For WHMCS 1.0 to the latest version owing to the migration tool.
1. First of all, deactivate the module at 'Setup' → 'Addon Modules' .
2. Next, upload and extract the latest version of Domain Orders Extended archive to your WHMCS main directory.
3. Remove content of 'templates_c' folder located at 'your_whmcs\template_c' .
4. Activate the module and assign permission to it at 'Setup' → 'Addon Modules' .
5. Proceed to 'Addons' → 'Domain Orders Extended' → 'Migration Tool' and press 'Migrate' button.
|
As you can see, 'Migration Tool' disappeared from the module navigation, we will not need it any more due to successfully completed migration.
|
Tips
1. TLDs are hidden for clients as long as they are not assigned to any category.
|
Common Problems