Personal tools
Namespaces

Variants
Actions

DirectAdmin Extended For WHMCS

From ModulesGarden Wiki
Jump to: navigation, search

Contents

About DirectAdmin Extended For WHMCS

DirectAdmin Extended For WHMCS will bring the automation into the provisioning and management of web hosting accounts in your WHMCS.

The module will allow your clients to remotely handle FTP accounts, create backups, install SSL certificates as well as set up various applications with the inbuilt installers.

  • Admin Area Features:
✔ Create/Suspend/Unsuspend/Terminate Account
✔ Change Package And Account Password
✔ Log In To Each DirectAdmin Account On Click
✔ Log In As Admin To DirectAdmin Panel On Click
✔ Automatically Suspend Client Account Upon Reaching Bandwidth Limit
✔ Configure Client Area Features Per Product
✔ Configure Resource Limits Per Product
✔ Define FTP Backups Endpoints Per Product
✔ Define Backup Directory Paths Per Product
✔ Enable And Configure Application Auto Installer To Use Per Product - Softaculous Or Installatron
✔ View All DirectAdmin Extended Products And Servers In One Place
  • Client Area Features:
✔ Remote Access And Management Of:
✔ Addon Domains, Their Details, PHP Version And Logs
✔ Apache Handlers
✔ Applications And Their Backups
✔ Autoresponders
✔ Backups, Remote FTP Backups And Admin Backups
✔ Catch All Email
✔ Cron Jobs
✔ Custom Error Pages
✔ Databases And Their Backups
✔ DNS Records
✔ Domain Pointers And Their DNS Records
✔ Email Accounts
✔ Email Forwarders
✔ File Manager
✔ FTP Accounts
✔ Git Repositories
✔ Hotlinks Protection
✔ Mailing Lists
✔ MX Records
✔ Perl Modules
✔ Protected Directories
✔ SPAM Filters
✔ SSH Keys
✔ SSL Certificates
✔ Site Redirections
✔ Site Summary
✔ SpamAssassin Setup
✔ Subdomains
✔ Unban IP Address
✔ Vacation Messages
WordPress Manager - Separate Module Required
✔ One Click Login To:
✔ DirectAdmin
✔ phpMyAdmin
✔ SitePad
✔ Webmail
✔ View Account Resource Usage
✔ Change Account Password
  • Application Auto Installer Features:
✔ Ordering Process:
✔ Auto Install Chosen Application After Account Creation
✔ Auto Install Application Chosen By Client During Order - With Configurable Options
✔ Allow Custom Settings Of Auto Installed Application - With Custom Fields
✔ Client Area:
✔ Install New Applications With Softaculous And Installatron
✔ View And Manage Installed Applications
✔ Backup Installed Applications
✔ View And Manage Created Backups
✔ Restore Applications From Backups
✔ Delete Applications Along With Their Backups
  • Configurable Options:
✔ Addon Domains
✔ Anonymous FTP Accounts
✔ Autoresponders
✔ Bandwidth
✔ CGI Access
✔ Catch All Email
✔ Cron Jobs
✔ DNS Control
✔ Dedicated IPv4 Address
✔ Dedicated IPv6 Address
✔ Disk Space
✔ Email Accounts
✔ Email Forwarders
✔ FTP Accounts
✔ Inode Limit
✔ Mailing Lists
✔ MySQL Databases
✔ PHP Access
✔ Parked Domains
✔ Server IPv4 Address
✔ SSH Access
✔ SSL Access
✔ SpamAssassin
✔ Subdomains
✔ Suspend At Limit
✔ System Information
  • General Info:
✔ Integrated With Advanced Billing For WHMCS - Actual Server Resource Usage Billing
✔ Integrated With IP Manager For WHMCS - Complete Control And Easy Assignment Of IP Subnets
✔ Integrated With Server Allocator For WHMCS - Automatic Assignment Of Most Suitable Servers To Products
✔ Integrated With WordPress Manager For WHMCS - Remote Installation And Management Of WordPress Instances
✔ Fully Integrated With Lagom WHMCS Client Theme
✔ Multi-Language Support
✔ Supports WHMCS Server Sync Tool
✔ Supports WHMCS Metric Billing - Integration: Disk Space, Bandwidth, Email Accounts, Addon Domains, Parked Domains, Subdomains, MySQL Databases, MySQL Disk Usage, Sub-Accounts
✔ Supports PHP 8.2 Back To PHP 7.4
✔ Supports WHMCS Themes "Six" And "Twenty-One"
✔ Supports WHMCS V8.11 Back To WHMCS V8.8
✔ Requires DirectAdmin Administrator Account
✔ Requires ionCube Loader V13 Or Later
✔ Easy Module Upgrade To Open Source Version

Installation and Configuration

This tutorial will focus on how to successfully install and manage DirectAdmin Extended For WHMCS.

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

Installation

1. Log in to our client area and download the module.
DA 1.png
2. In the downloaded file you might find one or two packages that support different PHP versions.

In the most recent versions of the module, you will find only one package that supports PHP 7.2 and later.

PHP72 74.png
Previous updates of the module may contain two packages dedicated to various PHP versions.

The first one that supports PHP 5.6 up to PHP 7.1, and the second one addressed to PHP 7.2 up to PHP 7.4.
Note: Keep in mind that PHP versions 5.6 up to 7.1 are no longer officially supported and their security issues are not fixed or released any more. Find more info here.

PHP56 74.png
Note: You can check the current PHP version in your WHMCS. To do so, proceed to 'Utilities' → 'System' → 'PHP Info'.
3. Extract the package and upload its content into the main WHMCS directory.

The content of the package to upload should look like this.

DA 2 1.png
4. When you install DirectAdmin Extended For WHMCS for the first time you have to rename the 'license_RENAME.php' file.

The file is located in 'modules/servers/directadminExtended/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

DA 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'.

DA 4.png
6. In the next step, set up the two 'storage' folders as recursively writable.

Both folders are available at 'yourWHMCS/modules/addons/DirectAdminExtended/storage' and 'yourWHMCS/modules/servers/directadminExtended/storage' .

DA 4 1.png

Addon Activation

7. Now, you have to activate the module in your WHMCS system.

Log in to your WHMCS admin area. Move to 'System Settings' then choose 'Addon Modules'.
Afterwards, find 'DirectAdmin Extended' and press the 'Activate' button.

DA3 5.png
8. In the next step you need to permit access to this module.

To do so, click on the 'Configure' button, select required administrator groups and press 'Save Changes'.

DA3 6.png
9. Well done! You have just successfully installed DirectAdmin Extended For WHMCS!

You may access your addon under 'Addons' 'DirectAdmin Extended'.

Server Configuration

10. Now, we will show you how to configure a new server.

To do so, log into your WHMCS and go to 'System Settings' 'Servers'.
Once you are there, press 'Add New Server'.

DA3 8.png
11. Next, enter your server name, IP address, username and password. Choose 'DirectadminExtended' from a dropdown menu and press 'Save Changes'.

In this section, you can also provide other server details like nameservers or the maximum number of accounts.
Note: Please remember that you can use login credentials of administrator or reseller account (reseller's login credentials can be used from the 3.3.0 version of the module).

DA3 9.png
12. After you configure your server correctly, you will see the following screen.

At this point, you need to create a new group for your server. For that purpose, press 'Create New Group'.

DA3 10.png
13. Enter the name, click on your previously created server, press 'Add' and then 'Save Changes'.
DA3 11.png

Product Configuration

14. In order to create and configure the product, click on 'System Settings' 'Products/Services'.

If you do not have a product group, click on 'Create a New Group'. If you do, simply move to the step 15.

DA3 12.png
15. Enter the product group name and press 'Save Changes'.
DA3 13.png
16. When you have a product group, you can create your product and assign it to DirectAdmin Extended. If you already have a product, jump to the step 17.

To create a product, click on 'Create a New Product'.

DA3 14.png
17. Afterwards, choose your product type and product group from dropdown menus, then enter your product name and select the used module: 'DirectAdmin Extended'.

Press 'Continue'.

DA3 15.png
18. Then, you need to move to the 'Module Settings' section and choose your previously created server group from dropdown menu.
  • Choose a preconfigured 'Package' you want to use
  • Select 'Reseller IP Address' if required:
    • 'Shared' - the domain will use the server's main IP
    • 'Shared - Reseller's IP' - the domain will set the resellers IP to shared and assign the reseller to it
    • 'Assigned' - the domain will use one of the reseller's IPs
  • 'Share Server IP Address with Reseller' - allow resellers to create sites with the server IP address (resellers only)
  • 'IP Addresses Assigned to Reseller' - define the number of IP addresses assigned to a reseller for product configuration (resellers only)

You can also activate the feature to automatically suspend accounts when the bandwidth limit is reached. Simply tick 'Suspend at Limit'.
Don't forget to press 'Save Changes' in the end.

DA3 16.png
19. If you would like to set up your own configuration, choose 'Custom' from the 'Package' dropdown.

A list of customizable options will appear. Configure them at your own discretion or generate Configurable Options instead.
Also, you can generate custom fields if you wish to use the product with Auto Installed Applications.

DA3 16 1.png

Addon Configuration

20. Go to 'Addons' 'DirectAdmin Extended'.

The dashboard located there contains the precise data on available products and servers:

  • see the number of active/suspended/terminated products
  • check the number of active accounts
  • log into panel
  • upgrade your DirectAdmin products
  • press the 'Documentation' tab to be moved to this very site!
DA3 17 0.png
21. Proceed to the 'Features' section, find the product you are interested in and press the 'Configuration' button next to it.
DA3 17.png
22. You should see boxes dedicated to 'Features', 'Applications' and 'Other'

Begin by selecting the features you would like to activate for your customers.

DA3 18.png
23. Choose whether to activate the 'Install Applications' option.

In case you wish to enable this feature, you will have to select 'Auto Installer' from a dropdown menu. After, activate 'Install Button' and 'Backup Button'.
You can also choose a desired language of the applications by typing in its two-letter code into the 'Language' field. A complete list of language codes can be found here.
If the field is left blank, a default value, which is 'en' (English) will be used.
Note: You can also create a configurable option with app to be installed, you can find the relevant instruction here.

DA3 19.png
24. Finally, select the 'Webmail' button redirection from the 'Other' and choose 'Show Server IP' address.

Do not forget to 'Save' changes once the product configuration is ready!

DA3 20.png
If the 'Show Server IP' address option is on, it will be visible in the client area for customers.
DA3 20 1.png
If the 'Let's Encrypt' button is toggled on, your customers will see it under the 'SSL Certificates' menu.
DA3 20 2.png
25. (Optional) Move to the 'Backups' tab where you can define the FTP backup path under 'FTP Backups Endpoints' and 'Backup Directory Path'.

This will allow creating backups on external servers defined by their admin, which then will be available for the clients to choose. Find more about Backups here.

DA3 21.png
Define the FTP backup path under 'FTP Backups End Points'.

Simply fill out the form with 'Backup Name', 'Host', 'Port', 'User', 'Password' and 'Path to Files'.
Afterwards, save it by pressing the 'Save' button.

DA3 21 1.png
Under the Backup Directory Path, enter the backup path which can be found in your DirectAdmin server → 'Admin Backup/Transfer' 'Local' textbox.
DA3 22.png
26. If you already have another product configured, you may copy its configuration.

Find the 'Copy Configuration' button on the list with products or select multiple items at once. Then choose the product configuration which settings you wish to copy into the selected products.

DA3 22 1.png
27. That's all, you have just correctly created and customized a new product, now you can check the results.

This is what your customers should see in your client area.

DA3 23.png
28. From now on, all your clients who will order the previously created product, will be able to manage their DirectAdmin accounts via your WHMCS system.

Below you can see the view of the ordered product summary in the admin area. Available actions:

  • Log In To Control Panel
  • Use the module commands: 'Create', 'Suspend', 'Unsuspend', 'Terminate' the product; 'Change Package' and 'Change Password'
DA3 23 0.png

Management

DirectAdmin Extended allows your customers to manage their DirectAdmin accounts directly in your WHMCS client area.

This short guide will present you the possibilities of our addon module.

Your Account

In the below sections, you will find basic tools used to manage your DirectAdmin account shown and described.

Analyze them carefully to enjoy full and easy management.

Addon Domains

Addon domains allow you add and manage your addon domains.
Take a look at the domain details, view error and usage logs, change the PHP version if applicable and suspend or unsuspend domains.
DA3 24.png
Press the 'Create Addon Domain' button and enter a new domain name, specify bandwidth and disc space, select options you may need:
  • 'Secure SSL'
    • 'Force SSL With HTTPS Redirect'
  • 'CGI Access'
  • 'PHP Access'
  • 'Local Mail Server'
DA3 24 1.png
Press the 'Information' icon to see the domain details.
DA3 24 3.png
You may also check the list of 'Error' and 'Usage Logs' of each addon domain.
DA3 24 4.png
Select a 'PHP Version' and enable/disable the 'Local Mail Server' of the addon domain.
Keep in mind that this option is available only if it is enabled and managed on the product's DirectAdmin server.
Otherwise, the 'There is no PHP Selector Enabled' information will be displayed and the option disabled.
DA3 24 2.png

Applications

Manage your applications straight from your WHMCS client area. Install new applications, create backups if needed and delete unused apps.

A separate section has been dedicated to applications, please move to section Install Applications to learn how to manage applications and their backups.

DA3 23 1.png

Backups

This tab, 'User Backups', allows you to back up your DirectAdmin user account.

To delete backup, simply press an adequate icon.

DA3 25.png
You can select what exactly you want to backup. Mark checkboxes next to the setting you would like to make the backup of.

Afterwards, press the 'Create' button to order it.

DA3 26.png
You may restore your backups at any time, you can do it by pressing the 'Restore' button next to the backup.

Then, toggle options that you want to restore with this action.
Note: Only backed up features are available here to choose, all the others are hidden.

DA3 26 1.png
At 'Admin Backups' and 'FTP Backups' sections you will get a list of backups created by your administrator and FTP Backups, you may view a list of backups of a given server.

Note: Please refer to Tips section, point 4, to learn how to manage FTP and Admin backups.

DA3 26 2.png

Databases

Owing to the MySQL databases management, you can create and delete databases.
DA3 27.png
Type in the required information and generate a secure password.
DA3 27 1.png
You can also add users to particular databases, use action buttons to delete needless users or change their password.
DA3 27 2.png
Remember that you should always use the secure password generator while creating a user.
DA3 27 3.png
Once the user has been created, you can edit it to set appropriate privileges then.

Toggle privileges you wish to assign to the user and confirm the changes.

DA3 27 4.png
It is also possible to change the user's password in case of any need.
DA3 27 5.png

DNS Management

This section gives you the possibility to manage the 'DNS Records' of your domain easily. You can create new records as well as edit the existing ones.
DA3 27 6.png
As presented below, there is a list of your existing 'DNS Records' .
You can edit them or delete if they are no longer needed. If you wish to add a new 'DNS Record' , simply click on the appropriate button.
DA3 27 7.png
Now, choose the type of your 'DNS Record' and provide its name and value.
DA3 27 8.png
Press the button to restore the DNS configuration to default.
DA3 27 9.png
You must be aware that after restoring the default configuration, all the custom entries you have made will be erased. </br>If you are sure, just press 'Confrirm' button to restore default DNS configuration.
DA3 27 10.png

File Manager

Manage files and folders of your DirectAdmin account. Upload files and create directories.

View the list of files with specific data on them: name, file size, last modification date and given permissions.

DA3 29.png
You can create a new directory by pressing a corresponding button as well as upload new files by pressing additional actions.
DA3 29 1.png
Rename, change permissions, copy, protect and delete a single file or directory.

Note: Only folders placed in the public_html directory can be protected, no other files have this option.
All files with this opton enalbed will be listed in the Protected Directoiries section.

DA3 29 3.png
You can also change permissions and remove single or multiple files or directories.
DA3 29 2.png

FTP Accounts

Manage FTP accounts in the easiest possible way. Type in your login, generate a new password and select the directory.

Handle the accounts to be able to access your website files through an FTP protocol. You can also suspend or unsuspend created accounts.

DA3 30.png
Add and configure FTP Accounts, just type in your login on a selected domain, provide or generate a secure password, select directory: 'Domain', 'FTP', 'User' ' or a custom one.
DA3 30 1.png

Hotlinks Protection

'Hotlinks Protection' section is a place where you may enable and disable protection of single links to the content of your website.
This way you mayt avoid your content, for example images, from being stolen or badwidth abused.

Press the icon next to every of your domains to see existings, currently protected URLs.

DA3 33 1.png
In this section you may add new URLs to protected or remove existing ones from the list of hotlinks.

Press 'Add new URL' to protect another link.

DA3 33 2.png
Type in your URL, you may use '*' sign to hide part of the URL and confirm the action.
DA3 33 3.png
Define protection settings for all the URLs
DA3 33 4.png
  • Enable/disable protection
  • Type in the protected file types, use commas to separate, and do not use spaces in between
  • Allow blank referrer
  • Allow redirection
    • Provide redirection URL if enabled
DA3 33 5.png

MX Records

The 'MX Records' section provides a convenient way to handle your domain's MX records. You can both create new records and modify existing ones.
Start by selecting the desired domain first.
DA3 33 6.png
Under Domain → MX Records, you can either manage existing records by editing them or create new records. To do so just press the 'Create MX Record ' button.
DA3 33 7.png
Before creating a new record, it is important to be confident in your actions. MX records are crucial for directing emails to the correct mail server for your domain.
Therefore, modifying these records could disrupt your email service, impacting all email accounts associated with your domain.

If you are certain about creating a new record, please fill out the form with the following information:

  • Name - The hostname or domain name to which the record applies. If left empty, the domain name will be used for the created MX record.
  • Priority - The priority value, an integer between 0 and 65535, determines the order in which mail exchangers are verified. Lower values indicate a higher priority of the record.
  • Value - The mail exchanger (MX) server's hostname or IP address. Please ensure to add a period symbol at the end of the domain name if it should not be auto-appended.
DA3 33 8.png
The newly created record immediately appears on the list.

It is also possible to 'Set MX Tmeplate' from this point. You will find this option as marked on the screen below:

DA3 33 11.png
Fill out the form to easily add pre-defined MX records to your domain. Choose the MX template from the list.
You can also activate the 'Affect Pointers' feature to update the pointer records that alias MX records.
DA3 33 9.png
The MX records list will be automatically updated. You can edit individual records, delete them one by one, or use the mass action button to delete multiple records at once.
DA3 33 10.png

Perl Modules

Move to the next section, which is 'Perl Modules'. All Perl based modules installed on your server are listed there.
DA3 33.png

Subdomains

Create subdomains for your website sections. All you need to do is choosing the domain from the list of available domains and typing in the subdomain name.
Once created, you can remove the subdomain if needed, see its bandwidth usage and view a list of subdomain logs.
DA3 31.png
Choose the domain for your available subdomain from the list.
DA3 31 1.png

Site Summary

Proceed to the 'Site Summary' section in order to check and analyze precise statistics.
Control usage level for each setting here.
DA3 32.png

Email Management

Email management section includes all tools related to emails. Go through them to learn more.

Autoresponders

In this section you may compose and add extremely useful default messages.

They will be automatically sent as a response message when you have no access to your mailbox.

DA3 34.png
Press 'Add Autoresponder' to create one. Provide the email address and compose the whole message here.
You may also add a CC recipient address if you need to send a copy.
DA3 34 1.png

Catch All Email

'Catch All Email' is a feature that allows you to forward emails that are sent to the non-existent email address of your domain name.
Click on the 'Edit' button as shown here:
DA3 34 2.png
Now, here are three options available. Choose the preferred option and save changes.
  • Fail - the sender will be informed that the recipient does not exist
  • Ignore - the email is dropped, no message is sent back
  • Address - the email will be forwarded to an email address of your choice.
DA3 34 3.png

Email Accounts

View and edit email accounts that are associated with your domains. Use a filter to find required email addresses, preview its selected quota, number of sent messages and manage the account.
  1. View SMTP Logs - incoming and outgoing
  2. Change Password
  3. Edit Limits
  4. Download Outlook Configuration
  5. Delete Account
DA3 35.png
Press 'Create Account' and select to which domain it shall be added, type or generate password, define limited or unlimited quota and limit of messages.
DA3 35 1.png

Email Forwarders

In this section you can set up email forwarders and choose from several destination options to adjust mail forwarding perfectly to your needs.
DA3 36.png
Press the 'Create Forwarder' button, specify the forwarded email and define the destination emails.
You may add more than one forwarder name and destination emails, use a comma to separate them.
DA3 36 1.png

Mailing Lists

Mailing lists allow you to use a single address to send message to multiple email addresses.
This feature is very useful when you need to send a newsletter or another update to a group of people.
Underneath, you can find a list of your mailing lists. Use action buttons to delete a list, view its details and alter settings.
DA3 37.png
Create a new mailing list by providing its name.
DA3 37 1.png
Modify the mailing list in the 'Settings' section.
DA3 37 2.png
DA3 37 2 1.png
DA3 37 3.png
When you 'Edit' the list, you will be moved to the section where a list of subscribers is available.
DA3 37 4.png
Add new email addresses to the list of 'Subscribers' or 'Digest Subscribers' from the according tab.
DA3 37 5.png

SPAM Filter

SPAM Filters give you the possibility to add numerous filters for a selected domain.
DA3 38.png
Add and configure the filter as desired for the selected mailbox.
  • block email addresses
  • block email domains
  • block emails with a chosen word
  • block emails larger than the specified number of kilobytes
DA3 38 2.png
Move to settings and define options per domain:
  • define the action for blocked emails: 'Drop Email' or 'Send To SPAMbox'
  • adult filter - enable/disable
DA3 38 1.png

SpamAssassin Setup

On this page, you can configure your SpamAssassin.

You can set up:

  • Action performed on spam emails
  • Threshold
  • Define separate actions for spam emails of the above defined threshold
  • Define whether to change the spam email subject or leave it intact
  • Choose how spam should be delivered
  • Specify blacklisted email addresses
  • Specify whitelisted email addresses
DA3 41.png

Vacation Messages

The goal of 'Vacation Messages' is similar to the one of Autoresponder shown above.

The only difference is that the vacation message replies only to the first email received per email address.
Note: If there is already an autoresponder set up for the account, it will be impossible to set a vacation message to that account.

DA3 42.png
Type in the message content, define your vacation start and end time.
DA3 42 1.png

Advanced Features

Advanced tools are used to configure sophisticated settings of your account.

Apache Handlers

Under the 'Apache Handlers' page, you can define custom handlers for chosen file extensions or specific files. You can read more about Apache Handlers here.
DA3 43.png
To add a new handler, type its name and then extensions it will process.
DA3 43 1.png

Cron Jobs

Cron Jobs section allows you to easily add and remove your cron tasks.
DA3 44.png
Select cron job settings to fully automate commands and scripts on your site.
DA3 44 1.png

Custom Error Pages

Defining custom apache error pages is easy with 'Error Pages'.
DA3 46.png
You can alter or define a new HTML code of error pages displayed during 401, 403, 404 and 500 errors.
DA3 46 1.png

Domain Pointers

In the 'Domain Pointers' section you can manage your aliases and pointers.
You can have access to the content of one domain from another one!
DA3 45.png
Enter a source domain, then select type: 'Alias' or 'Pointer'.
DA3 45 1.png
Manage DNS records of the domain pointer.
DA3 45 2.png
Edit, delete and create DNS records of a single domain pointer.
DA3 45 3.png
Select record type, enter name and value. In case of 'MX' record type define priority and a hostname.
Note that the lower preference number stands for the higher priority.
DA3 45 4.png

Git Repositories

This section provides you with the possibility to create as well as manage your Git repositories.
Git is a fast and modern implementation of version control. It not only allows you to check the history of content changes but also facilitates collaborative changes to files.

To start tracking, simply click on the 'Create Repository' button.

DA3 45 5.png
Fill out the simple form to ad dyou repository.

Select the domain and provide a name. You may also provide an optional directory that will direct you to the remote repository. this field is required for synchronization only.
Select your key file or choose the "Without SSH" option. It is an optional public key authorized by the remote repository, required for syncing to a private remote repository only.

DA3 45 6.png
Allowed actions on a repository:
  • display repository details (1)
  • deploy repository (2)
  • fetch repository (3)
  • access repository logs (4)
  • modify details (5)
  • delete repository (6) - accessible via mass actions as well to delete repos in bulk
DA3 45 7.png
Repository details:
DA3 45 8.png
Repository Logs: when accessed, you will see a list of all branches existing on its repo. Check logs for every branch separately:
DA3 45 9.png
DA3 45 10.png
Modify details - select a branch to deploy the repo and (optionally) provide the new directory.
DA3 45 11.png

Protected Directories

Protected directories section includes a list of domains with any folders protected with a password.
Press the icon to see an exact list of protected folders.

Important: You may protect single folders directly in 'File Manager' section, however, they must be located in the 'public_htlm' directory only.

DA3 46 3.png
Details section contains a direct path to the protected folder, you may also perform flowing actions on single directories:
  1. View/Add directory users
  2. Edit directory name
  3. Delete single directory protection

Use mass action button to remove the password protection of the selected directories.

DA3 46 4.png
1. View existing users and add new ones by pressing button. Then provide the username and a password.
DA3 46 5.png
DA3 46 6.png
2. Change the folder name
DA3 46 7.png

Site Redirections

Easy access to site redirections is very advantageous. Within a few seconds, you can redirect the page to another.
DA3 47.png
For example, if your main domain is mytestdomain.com, you can forward it like this:

mytestdomain.com/redirect → adomainwithlongname-averylongname.com
Choose the type: 'Permanent', 'Temporary' or 'Replaced'.

DA3 47 1.png

SSH Keys

SSH Keys are responsible for providing secure file transfer and remote logins to the account. This section allows you to manage your SSH Keys easily.
DA3 47 2.png
Now, provide 'Key ID' and 'Comment' . Enter a strong ' Password' , optionally, you can generate it.
Finally, choose the size of your SSH Key from the dropdown menu and decide if you want to authorize the Key.
Afterwards, click the 'Create' button.
DA3 47 3.png
All newly created SSH Keys are visible here. You can 'Authorize' or 'Delete' your SSH Key using the buttons shown below:
DA3 47 4.png
If you wish to 'Authorize' or ' Delete' a few SSH Keys, click the appropriate mass action button.
DA3 47 5.png
All of authorized SSH Keys are listed in the 'Authorized Keys' section. Here you can edit one of the existing SSH Keys or delete any if no longer needed.
DA3 47 6.png
It is also possible to paste an existing, authorixed SSH Key. All you need to do is press the button marked on the creen and then paste your authorized key.
DA3 47 7.png

SSL Certificates

Your customers can benefit from generating free certificates provided by 'Let's Encrypt' . Assuming that this option was previously enabled in the Addon Configuration.

Generating a CSR or a certificate with 'Let's Encrypt' will result with automatically added private keys to the list.

You may also upload a ready certificate with a private key or a CA SSL Certificate (Certificate Authority). Use 'More Actions' to find appropriate buttons.

DA3 48.png
If you decide to use the easiest method of generating cerificates, that is 'Let's Encrypt' option, you will only have to fill in a short form with basic information.

In 'Entries' tab you will find all existing subdomains for the selected domain.

DA3 48 0.png
DA3 48 01.png
This feature relocates completely the management of your private keys, CSR keys and SSL certificates into your WHMCS client area.

Thanks to it, you can conveniently manage all the aspects of your SSL certificates without the necessity to log in to your DirectAdmin account.

DA3 48 1.png
If you want to obtain a certificate from a trusted provider, complete the Certificate Signing Request form to generate a CSR, which will then be used to generate the certificate by that provider.
DA3 48 2.png

Unban IP Address

The 'Unban IP Address' section allows clients to unban their IP address if it has been blocked in the DirectAdmin panel.
Both IPv4 and IPv6 addresses can be unbanned here. Simply type in the address, press the 'Unban' button and wait until the action is complete.
DA3 48 5.png

WordPress Manager

If you have WordPress Manager For WHMCS module installed, your customers will fully benefit from its seamless integration with the DirectAdmin Extended For WHMCS module.
DA3 48 3.png
Thanks to this integration, your customers will have the capability to install and manage WordPress instances in detail without the bother of leaving the DirectAdmin Extended panel in your WHMCS client area.

Full and detailed instructions on the 'WordPress Manager' itself is located here.

DA3 48 4.png
Please note that this entire section can only be available if you have purchased and installed the WordPress Manager For WHMCS module.

Install Applications

'Install Applications' is a very interesting and time-saving feature of DirectAdmin Extended For WHMCS module. In merely seconds, you can install your favorite applications without even accessing DirectAdmin!

Firstly, you need to enable one of the two auto-installation managers. To do so, go to 'Addons' → 'DirectAdmin Extended' → 'Features'.
Press the 'Configure' button next to the product you are interested in. Then, find the 'Applications ' box.
Enable the 'Install Applications' checkbox, select the autoinstaller from a dropdown menu (you can choose 'Installatron' or 'Softaculous' ).
You can also choose a desired language of the application by entering value into the 'Language' field. A complete list of language codes can be found here.
If the field is left blank, the default value 'en' (English) will be used.
Finish the process by enabling 'Install Button' and 'Backup Button'. Do not forget to save the changes.

DA3 49.png
In the client area section, move to the 'Applications' section and then find the 'Install New' tab as shown on the following screen.

You will see an extensive menu of application categories.

DA3 50.png
For presentation purposes we will install 'Claroline' located in the 'Educational' section.
DA3 50 1.png
Necessary installation fields should be automatically filled in. In case the 'Directory' field is left empty, the application will be installed in the main folder of the selected domain.
DA3 50 2.png
If the installation process has been successful your newly installed application will appear on the list of installed ones when you go back to that tab.
DA3 51.png
Here you can find the name of the application, its domain, installation time and version.

Available actions on installed applications:

  1. 'One Click Login' - works with 'WordPress' only, press the icon and you will be automatically moved to the admin panel created while installing 'WordPress' first instance
  2. 'Create Staging' application - create staging instances from an application, e.g. for testing purposes before pushing them to the live installation ('Softaculous' only)
    • 'Push To Live' - push a staging application to the live environment. 'Push To Live' button (2.1) is available for 'Staging' applications only ('Softaculous' only)
  3. 'Clone' application - clone existing website installations to modify or use them on different domains ('Softaculous' only)
  4. 'Generate Backup'
  5. 'Edit' application - a form with pre-filled values will appear, you may easily modify them now.
  6. 'Delete' application

Note: Please keep in mind that creating staging applications, cloning, and generating backups might last up to a few minutes and the instances are not visible right away.
Please wait until they appear on the list.

DA3 51 1.png

Management of Auto Installed Applications

To set up DirectAdmin Extended products with the auto installed app, follow these steps:

In the beginning, go to 'Product/Services', find your product connected with DirectAdmin Extended and enter the 'Module Settings' tab.
Press 'Generate Custom Fields' to automatically create the required fields.

DA3 55 1.png
Select which of the available fields you wish to generate.
DA3 55 0.png
You can also create these fields manually by going to the 'Custom Fields' tab. You will need to add 8 custom fields.

These are: 'Directory', 'Database Name', 'Database Username', 'Database Password', 'Table Prefix', 'Site Name', 'Site Description' and 'Language'.
Remember to set the field type as 'Text Box', tick 'Required Field ' and/or 'Show on Order Form' exactly as it is shown on the screen below.

Note 1: 'Site Description' is needed only for Softaculous autoinstaller.
Note 2: 'Database Name', 'Database Username', 'Database Password' and 'Table Prefix' fields do not need to be filled upon ordering product by a client.
If they are not filled, the database will be automatically generated.
Note 3: For the Installatron auto installer use 'Site Title' in place of 'Site Name'.

DA3 55.png
Afterwards, go to 'Addons' 'DirectAdmin Extended' 'Features' → 'Configuration'.

Enable 'Install Applications' in the Applications section. Select the auto installer and application to install from dropdown menus. Confirm by pressing the 'Save' button.

DA3 56.png
Once you add all the custom fields, they will appear while placing an order.

Voila! Now your customers can personalize each application without the necessity of installing it later on.

DA3 56 1.png

Configurable Options For Application Auto Install

Let your clients decide which application they would like to install on their new DirectAdmin account.

While placing an order, your customer can choose an application which will be installed upon account creation.
There is nothing else you need to do. The application will be ready to use instantly!
To set up this feature, return to the configuration of your product, find the 'Applications' section, activate 'Install Applications', choose 'Auto Installer' and activate 'Use Configurable Options'.

DA3 58.png
Go back to the list of products and click on a download icon to view the applications list.
DA3 59.png
These are the names of values that you can enter in the fields of configurable options. We will configure them in the next step.

For example, if you would like to set up 'Drupal' in your applications list, you will need to enter the 'Drupal 7.59' or 'Drupal' value.
1. If you make a mistake with the application name, the auto installer will not work.
2. If you do not enter the version number, the auto installer will install the latest version of the application.
Now that you know what values should be entered in configurable options for particular applications, we can proceed further.

DA3 60.png
Go to your 'WHMCS' 'Setup' 'Products/Services' 'Configurable Options' and press 'Create a New Group' .
DA3 61.png
Enter the group name of your choice, select the product to which you want to assign configurable, then press 'Save Changes' .
DA3 62.png
Now click on 'Add New Configurable Option' .
DA3 63.png
This moment is very important. As 'Option Name', you have to enter 'Installation App'. Otherwise the entire functionality will not work.

Here you can set up as many applications as you want. To do so, enter a value name, e.g. 'WordPress 4.9.8' and press 'Save Changes' .
Repeat this as many times as you need and do not forget to set 'Option Type' to 'Dropdown' .

Remember that if you do not provide the version number of the application, the latest version will be installed.

DA3 64.png
As you can see on the following screen, we decided to offer our customers five applications.

When you finish adding applications, press 'Save Changes' and 'Close Window'.

DA3 65.png
You can also create a new configurable option - Auto Backup On Update with the 'Yes/No' type.

This option is used to enable the creation of auto update backups for the first chosen application after the initial order in WHMCS.
Please note that this option works only with Installatron plugin and Auto Update Backup Enabled By Default On Order setting in the module features has to be disabled to make this configurable option work properly.

DA3 65 1.png
Afterwards, come back to 'DirectAdmin Extended Features' 'Configuration' 'Applications' , activate 'Use Configurable Options' and choose 'Apps/Configurable Options' from a dropdown menu.

Please note that you can have more configurable options groups at your disposal. Press 'Save' . You have just successfully assigned configurable options to the application autoinstall.

DA3 65 2.png
Let us find out what your customers are going to see in your client area while placing an order.

As you can see, a dropdown menu with the previously configured applications has shown up.

DA3 65 3.png

Backups Management For Apps

You can also create a backup of your application. It is very easy! To do so, click 'Create Backup'.
DA3 66.png
After a few seconds, you should see the 'Success' message as a confirmation of the performed operation.

To manage your backups, simply press 'Backups'.

DA3 67.png
You can quickly view, delete or restore your existing backups.
DA3 68.png

Log In To DirectAdmin

With a single click on the 'Log In To DirectAdmin' button, you can log in to your DirectAdmin without the necessity to enter login details.
DA3 69.png

Log In To phpMyAdmin

You can easily log in to your phpMyAdmin by clicking 'phpMyAdmin'. You will be redirected to that site on the run.
DA3 70.png

Log In To SitePad

To be redirected to SitePad, click on the 'SitePad' button as presented below:
DA3 71.png

Log In To Webmail

In order to enter Webmail, press 'Webmail' button as shown on the following screen.

Note: Webmail type login has been defined by the admin and can be either 'Horde', 'Roundcube' or 'Squirellmail'.

DA3 71 1.png




Management of Billing

When you combine DirectAdmin Extended For WHMCS with Advanced Billing For WHMCS, you will be able to set up additional billing options.

The module allows you to charge your customers basing on the actual server resource usage.

DA2 73.png
With Advanced Billing module, you can also show your customers the current usage of server resources and their cost.
DA3 74.png

Importing Existing Account

In this section, you can find short instruction on how to connect one of your clients to your already existing account in DirectAdmin.
Take the following steps to make sure that the process will be carried out properly.

1. Firstly, manually create an order for your customer in WHMCS. Choose a client and in the summary, view click on the ' Add New Order' button. Next, select a 'Product/Service' and press 'Submit Order' .
What is important, do not perform the 'Create' action. The status has to remain as 'Pending' .
More info about placing orders can be found here
2. Proceed to the newly created product's card in your admin area. Find the following empty fields:

  • Domain
  • Username
  • Password

The above-mentioned information has to be consistent with the data from your DirectAdmin account. Now, complete these fields as presented below.
Important! Remember to make sure that the format of the provided data is compatible with the format supported by the module. You can preview it for another product of the module you have already created and enter it in a similar way.
Note: You need to enter a password to your DirectAdmin account. If for some reason, you do not remember your password, there has to be the possibility to reset your password and create a new one in your panel.
If you completed the required data, now change the status from 'Pending' to 'Active' and 'Save Changes' .

Import DA.png
3. If the completed data is correct, you can log in to the account by pressing the 'Login to Control Panel' button.
Moreover, to make sure that everything works as expected, you can check if the newly-created account can be managed in the client area.
Important! Remember to manually add other missing parameters of the product in configurable options, custom fields, billing cycle, etc. so they match the parameters of the connected account from DirectAdmin.

4. If you have Account Synchronization For WHMCS installed, you can use it to quickly and automatically import and synchronize your DirectAdmin account with WHMCS.
The detailed instruction can be found here.

Use Cases

This section presents example scenarios that demonstrate typical use cases and practical applications of the module's features.

Review the examples below to see how the module can be used in real-world situations.

Automatic App Installation With Service Order

You can set up applications to be installed automatically in DirectAdmin Extended For WHMCS products.
Start by opening the 'DirectAdmin Extended' addon, then navigate to 'Features' 'Settings' and find the 'Applications' section.
DA3 75.png
To initiate, enable the 'Install Applications' feature.
You can select an application for automatic installation in new DirectAdmin accounts by choosing the 'Auto Installer Type' and then selecting your preferred application.
DA3 76.png
Alternatively, you can enable customers to select an application during their order process.
To do this, toggle on the 'Use Configurable Options' feature and choose from the options available in the dropdown menu.
For a comprehensive guide on how to set up these Configurable Options, refer to the 'Management' section.
DA3 77.png
Once the client submits an order and the 'Create' action is completed, the new DirectAdmin account will be set up with the chosen application (for example, a WordPress installation).
DA3 78.png

Tips

1. Keep in mind that user packages and reseller packages are two different things.

When you configure a typical product for your customers in the WHMCS, you would usually need to enter one of your user packages, not the reseller packages.

2. To manage SSL certificates, your customers require the owned IP address.

Otherwise, the module will return the following error: 'You can manage SSL certificates when you own the IP you are using. Info for admins: Assign an owned IP'.

To add the owned IP address, log in to your DirectAdmin admin area, go to the 'IP Management' section, add the IP and assign it to the admin.
DA 76.png
DA 76 1.png
Afterwards, manage the user for whom you want to add the IP address.

Set IP to your previously created IP address, save changes and make sure that this IP will be the current IP address of your customer.

DA 77.png
If you add more IP addresses with free status in your DirectAdmin, you can quickly assign those IP addresses to your customers in WHMCS.

For this purpose, simply type the IP in the 'Dedicated IP' field, press 'Enter' on your keyboard and update the product package by clicking on the 'Change Package' button.

DA 78.png
3. As this module supports templates system, any changes made in the module's template files will be saved after the upgrade process.
4. Backups management in DirectAdmin panel:

Admin Backups:

  • Log into Your DirectAdmin Panel and find Admin Backup/Transfer and create a new one.
  • Select your user and define 'When', 'Where' - set to Local and 'What' to backup.
  • Go back to WHMCS → Addons → DirectAdmin Extended → Features (of the backed up product) → Backups. Fill out the 'Backup Directory Paths' with the very same data as in the panel.


FTP Backups:

  • Log into Your DirectAdmin Panel and find Admin Backup/Transfer and create a new one.
  • Select your user ('Who') and define 'When', 'Where' - set to FTP and 'What' to backup.
  • Go back to WHMCS → Addons → DirectAdmin Extended → Features (of the backed up product) → Backups. Fill out the ' 'FTP Backup Endpoints' with the very same data as in the panel.
5. Please remember that if you want to use Configurable Options then set ' -- Custom -- ' in the 'Package' field of the WHMCS product configuration.

Update Instructions

The essential guidance through the process of updating the module is offered here.
When migrating your product from version 2.x to 3.x, you must deactivate your old addon (version prior to 3.x.x) and then activate the new one (v3.x.x) to successfully migrate your current settings. (Please ignore point 8 of our modules update instruction).

No other additional steps are required to keep your addon's configuration and products' settings.

Upgrade Guide

Seeking a solution that offers greater flexibility, customization tailored to your precise needs, and unrestricted availability?
There is an option that not only proves to be cost-effective in the long run but also includes prioritized support services, making it a truly valuable investment.

Opt for the Open Source version of your DirectAdmin Extended For WHMCS module to unlock these benefits.
Simply click on either the Get Source Code or Upgrade To Lifetime button found on the product's page in our client area to complete the one-step upgrade process, with a dedicated discount already applied.

Follow a comprehensive guide covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
2. If you have problems with connection, we recommend that you make sure that the default DirectAdmin port 2222 is open.

You can also change the DirectAdmin port to other than 2222 by using the 'Override with Custom Port' option while configuring the server.

3. If you run into an ionCube encoder problem (wrong version) after the installation, please open a support ticket.

We will provide you with a different version of the module encrypted with the older version of ionCube.

4. DirectAdmin Extended For WHMCS module functions only on the administrator account.
5. Change Package option currently does not support the Configurable Options.
6. If you encounter error: 'Unexpected Module Error(Token 'f80e57b1be9752d7d4658434bd55aafa2'). Please Contact Administrator.' displayed in the client area,

reissue your license in our client area, if that does not help, please contact our support department.

Navigation
WHMCS Modules
WHMCS Widgets
Translations
cPanel Modules
General
FAQ
Community
DirectAdmin Extended For WHMCS