This document outline the basic installation, configuration and the basic usage of the WHMCS DNS Provider Module
Requirements
In order to use the module's functionality, you will need the following
- DirectAdmin hosting account with ability to create addon domains
- PHP INTL module enabled on your WHMCS server
The DirectAdmin hosting account should not be on the same hosting server you serve your regular hosting with.
Your WHMCS server must have outgoing port to the DirectAdmin account's server (default is 2222) open in order to connect to the DirectAdmin server.
Installation
Upload all the files in the modules folder to your WHMCS /modules/addons and the /modules/server directory.
No template upload is needed
Language Uploads
The module includes English as the base language. If you wish to translate it to your enabled language in WHMCS. Make a copy of the english.php in /modules/addons/dnsprovideradmin/lang/ to your associated language. For example, french.php. The filename must match to the ones in the WHMCS/lang/french.php
Configuration
Module Activation
Log into your WHMCS admin backend and enable the module by going to Setup → Addon Modules → DNS Provider Admin→ Activate
Once activated, click on Configure and fill in the license key and make any settings adjustment.
Module Options
| Option | Description | |||||
|---|---|---|---|---|---|---|
| Verification Mode | Check for domain ownership when a customer add a domain into the database | |||||
| Verification IntervalWhen enabled, sub-accounts without the Manage Domains permission (Set under main account) will not be able to use the module | The interval (in minutes) when a domain under verification is checked again during a cronrun | |||||
| Allow Manual Domain Verification | Allow for the customer to manually trigger a verification in the client area | |||||
| Re-verify Period | Allow client to set to receive email notification on changes madeTrigger for a re-verification to see if the domain is still set to the allocated nameservers. Set 0 to disable | |||||
| Disable Re-Verify Suspension | ||||||
| Re-Verification Template | The hostname or IP without http://or https:// | |||||
| Enable this to disable the module to NOT suspend the domain on the DirectAdmin server if it fails re-verification | ||||||
| Disable Suspension Renaming | Enable this to disable the module from suspending the domains on the DirectAdmin server if the customer's service under WHMCS is being suspended | |||||
| Unverified Termination Period | The allowable period a domain can go unverified before it is removed from the customer's service. Set 0 to disable. | Disable Suspension Renaming | Unverified Termination Period | This is the login credentials for you DirectAdmin Account | ||
| Re-verification Termination Period | The ZIP package name of the web templates you want to extract files from onto new domains allowable period a domain can be unverified (after it enters Re-verify period) before it is removed from the customer's service. Set 0 to disable. | |||||
| Migration Task Retry Limit | Allow PHP files to be run on new domains. The DA account must have PHP function enabledThe amount of retries for a migration task before the task is removed from the queue. | |||||
| Migration Task Retry Interval | The interval (in minutes) before re-running a migration task. | |||||
| Enable email notification | Allow customer to receive email notification on DNS, Email forwarding, Catch-all changes. | |||||
| Email Verify Template | The email template of (Email Destination Verification) | |||||
| Notification Email Template | The email template to send for notification | |||||
| Re-Verification Template | The email template to send to the client to notify their domain failed re-verification | |||||
| Large DB exclusion | When this option is enabled, the Admin panel will no longer load the list of Active domains in the Drop Down search. You will have to fill in the domain manually. This is useful if you have a large domain database | |||||
| Fetch from NS on load | Enable email notification | Email Verify Template | When enabled | Admin Clients will load records from the DA | Server regardless of the local cacheNotification Email Template | The amount of time (in seconds) before Server regardless of the local cache expiresLarge DB exclusion |
| Fetch from NS on load Fetch from NS on load (Admin) | When enabled Admin will load records from the DA Server regardless of the local cache | |||||
| TTL on zone refresh | The order in the Domains menu for the DNS Manager link to appear | |||||
| Default TTL | The amount of time (in seconds) before the local cache expires | |||||
| Display under Service menu | When enabled it will display the DNS Hosting link under the WHMCS Navigation menu's Services Tab | When enabled, a new link Manage DNS Record, Email Forwarding & Redirect will appear on the side Manage bar of a domain details page | Display under Service menu | |||
| Menu Showing Order | Creates the domain on the DA server upon registration processThe order in the Service menu for the DNS Hosting link to appear | |||||
| Systemwide Dynamic Dns DNS API | Enable systemwide Dynamic DNS support | |||||
| Enable API Force Detection | Enabling this will block an IP if it is exceeding the per hour API limit | |||||
| Bruteforce Timer | Enable clients to Restore DNS Templates from the systemThe amount of seconds to check in the bruteforce log before denying | |||||
| Bruteforce Ban Timer | Enable clients to create their custom DNS TemplateThe amount of seconds to ban the IP address from accessing the API |
| Table of Contents | ||
|---|---|---|
|