Plesk Extended For WHMCS
| Line 403: | Line 403: | ||
|style="padding: 0px 0px 15px 15px;"|'''26. If you already have another product configured, you may copy its configuration. <br/> | |style="padding: 0px 0px 15px 15px;"|'''26. If you already have another product configured, you may copy its configuration. <br/> | ||
Find the '' 'Copy' '' button on the list with products or select multiple item at once. <br/> | Find the '' 'Copy' '' button on the list with products or select multiple item at once. <br/> | ||
| − | Then choose the product configuration whose settings you wish to copy into the selected products.<br/> | + | Then, choose the product configuration whose settings you wish to copy into the selected products.<br/> |
|} | |} | ||
{| | {| | ||
| Line 416: | Line 416: | ||
|} | |} | ||
{| | {| | ||
| − | |style="padding: 0px 0px 15px 15px;"|Enter proper | + | |style="padding: 0px 0px 15px 15px;"|Enter the proper domain and IP address to allow a connection with Plesk panel and Webmail accordingly.'''<br/>Do not forget to '' 'Save' '' changes once you are finished! |
|} | |} | ||
{| | {| | ||
| Line 423: | Line 423: | ||
{| | {| | ||
|style="padding: 0px 0px 15px 15px;"|'''28. From now on, all your clients who ordered a previously created product will be able to manage their Plesk accounts via your WHMCS system.'''<br /> | |style="padding: 0px 0px 15px 15px;"|'''28. From now on, all your clients who ordered a previously created product will be able to manage their Plesk accounts via your WHMCS system.'''<br /> | ||
| − | Here is | + | Here is the summary of the ordered product in admin area. The available actions include: |
*Log In To Control Panel | *Log In To Control Panel | ||
| − | *Use Module Commands: '' 'Create', 'Suspend', 'Unsuspend', 'Terminate' | + | *Use Module Commands: '' 'Create', 'Suspend', 'Unsuspend', 'Terminate', 'Change Package' '' and '' 'Change Password'. '' |
|} | |} | ||
{| | {| | ||
| Line 457: | Line 457: | ||
{| | {| | ||
|style="padding: 10px 0px 15px 15px;"|'''Plesk Extended allows your customers to manage their accounts via client area in your WHMCS system.'''<br /> | |style="padding: 10px 0px 15px 15px;"|'''Plesk Extended allows your customers to manage their accounts via client area in your WHMCS system.'''<br /> | ||
| − | In this short guide we will present you the management possibilities of our module. | + | In this short guide we will present you with the management possibilities of our module. |
|} | |} | ||
==Client Area== | ==Client Area== | ||
| Line 463: | Line 463: | ||
===Addon Domains=== | ===Addon Domains=== | ||
{| | {| | ||
| − | |style="padding: 10px 0px 15px 15px;"|Addon domains | + | |style="padding: 10px 0px 15px 15px;"|Addon domains section allows you to link the domain to a subdirectory of your account. <br/>You can view and manage addon domains, edit document root and make redirections.<br/> |
| − | '' '''Note:''' Make sure this feature is | + | '' '''Note:''' Make sure this feature is enabled for your account before using'' |
|} | |} | ||
{| | {| | ||
| Line 503: | Line 503: | ||
{| | {| | ||
|style="padding: 0px 0px 20px 15px;"|View the list of your installed applications by clicking on the '' 'Installed Applications' '' tab and manage the application.<br/> | |style="padding: 0px 0px 20px 15px;"|View the list of your installed applications by clicking on the '' 'Installed Applications' '' tab and manage the application.<br/> | ||
| − | Here you will the name of the application, its path, size and available actions: | + | Here you will find the name of the application, its path, size and available actions: |
*Create backup | *Create backup | ||
*Delete application | *Delete application | ||
| Line 550: | Line 550: | ||
===Backups=== | ===Backups=== | ||
{| | {| | ||
| − | |style="padding: 10px 0px 20px 15px;"|All available backups are displayed under the '' 'Backups' '' section. To add a new one press '' 'Create Backup' '' button | + | |style="padding: 10px 0px 20px 15px;"|All available backups are displayed under the '' 'Backups' '' section. To add a new one, press the '' 'Create Backup' '' button |
|} | |} | ||
{| | {| | ||
| Line 556: | Line 556: | ||
|} | |} | ||
{| | {| | ||
| − | |style="padding: 0px 0px 20px 15px;"|Next add prefix and backup description, choose split size, backup content type and decide whether to make backup '' 'locally' '' on Plesk server or on your '' 'remote' '' FTP storage.'' | + | |style="padding: 0px 0px 20px 15px;"|Next, add prefix and backup description, choose split size, backup content type and decide whether to make backup '' 'locally' '' on Plesk server or on your '' 'remote' '' FTP storage.'' |
|} | |} | ||
{| | {| | ||
| Line 562: | Line 562: | ||
|} | |} | ||
{| | {| | ||
| − | |style="padding: 0px 0px 15px 15px;"|The backup creation might take a while. When ready it can be downloaded by client or deleted from the server.<br/> | + | |style="padding: 0px 0px 15px 15px;"|The backup creation might take a while. When ready, it can be downloaded by client or deleted from the server.<br/> |
'' '''Important:''' For a large backup files we strongly recommend to increase the 'max_execution_time' setting in your server's 'php.ini' configuration.'' | '' '''Important:''' For a large backup files we strongly recommend to increase the 'max_execution_time' setting in your server's 'php.ini' configuration.'' | ||
|} | |} | ||
| Line 569: | Line 569: | ||
|} | |} | ||
{| | {| | ||
| − | |style="padding: 0px 0px 20px 15px;"|If you want to use the '' 'remote' '' backup type you will also need to provide the '' 'FTP Storage Settings' ''. | + | |style="padding: 0px 0px 20px 15px;"|If you want to use the '' 'remote' '' backup type, you will also need to provide the '' 'FTP Storage Settings' ''. |
|} | |} | ||
{| | {| | ||
| Line 575: | Line 575: | ||
|} | |} | ||
{| | {| | ||
| − | |style="padding: 0px 0px 15px 15px;"|Provide your FTP server IP address or hostname, access credentials, mode, and the directory path to which the backup will be uploaded.<br/> Then, | + | |style="padding: 0px 0px 15px 15px;"|Provide your FTP server IP address or hostname, access credentials, mode, and the directory path to which the backup will be uploaded.<br/> Then, when you create the backup for a second time, select the remote type to upload it directly to your FTP server. |
|} | |} | ||
{| | {| | ||
| Line 583: | Line 583: | ||
===Databases=== | ===Databases=== | ||
{| | {| | ||
| − | |style="padding: 10px 0px 20px 15px;"|Owing to '' 'Databases' '' management you can create/delete new databases and users. Press '' 'Create Database' '' to add a new | + | |style="padding: 10px 0px 20px 15px;"|Owing to '' 'Databases' '' management you can create/delete new databases and users. Press '' 'Create Database' '' to add a new database. |
|} | |} | ||
{| | {| | ||
| Line 589: | Line 589: | ||
|} | |} | ||
{| | {| | ||
| − | |style="padding: 0px 0px 15px 15px;"|To create a new database, type in its name | + | |style="padding: 0px 0px 15px 15px;"|To create a new database, type in its name into the appropriate field and select its type. <br/>Optionally, you can also create a user directly assigned to the database.<br/> |
| − | '' '''Note:''' that only 'MySQL' and 'PostgreSQL' databases | + | '' '''Note:''' that only 'MySQL' and 'PostgreSQL' databases are currently supported and must be enabled in your Plesk panel first. '' |
|} | |} | ||
{| | {| | ||
| Line 596: | Line 596: | ||
|} | |} | ||
{| | {| | ||
| − | |style="padding: 0px 0px 20px 15px;"|You can also delete already assigned users as well | + | |style="padding: 0px 0px 20px 15px;"|You can also delete already assigned users as well as add new ones to particular databases by choosing '' 'Create Database User' '' in the '' 'Users' '' tab. |
|} | |} | ||
{| | {| | ||
| Line 606: | Line 606: | ||
|style="padding: 10px 0px 15px 15px;"|Here you can add and manage your domain aliases.<br /> | |style="padding: 10px 0px 15px 15px;"|Here you can add and manage your domain aliases.<br /> | ||
This allows you to read content of one domain from another domain name.<br /> | This allows you to read content of one domain from another domain name.<br /> | ||
| − | To create a new redirection press '' 'Create Domain Alias' ''.<br/> | + | To create a new redirection, press '' 'Create Domain Alias' ''.<br/> |
'' '''Note:''' that domains should be registered with a valid registrar and point to your DNS server.'' | '' '''Note:''' that domains should be registered with a valid registrar and point to your DNS server.'' | ||
|} | |} | ||
| Line 613: | Line 613: | ||
|} | |} | ||
{| | {| | ||
| − | |style="padding: 0px 0px 20px 15px;"|Next provide your alias domain, chose domain redirections as well as toggle the remaining options. | + | |style="padding: 0px 0px 20px 15px;"|Next, provide your alias domain, chose domain redirections as well as toggle the remaining options. |
|} | |} | ||
{| | {| | ||
| Line 677: | Line 677: | ||
{| | {| | ||
|style="padding: 0px 0px 15px 15px;"|Add and configure FTP Accounts in the easiest way possible.<br/> Just type in your login on a domain, provide or generate a secure password, define directory access and declare available quota.<br/> | |style="padding: 0px 0px 15px 15px;"|Add and configure FTP Accounts in the easiest way possible.<br/> Just type in your login on a domain, provide or generate a secure password, define directory access and declare available quota.<br/> | ||
| − | '' '''Note:''' if you have some other addon domains, creating a FTP account on the main domain will also add it to these | + | '' '''Note:''' if you have some other addon domains, creating a FTP account on the main domain will also add it to these domains.'' |
|} | |} | ||
{| | {| | ||
| Line 693: | Line 693: | ||
|style="padding: 10px 0px 15px 15px;"|Enable and configure the filter as desired for the selected mailbox.<br/> | |style="padding: 10px 0px 15px 15px;"|Enable and configure the filter as desired for the selected mailbox.<br/> | ||
| − | You can also adjust sensitivity - by default it might be set to 7 so all messages with that score or more points | + | You can also adjust sensitivity - by default it might be set to 7 so that all messages with that score or more points will be classified as spam.<br />If mailboxes receive lots of spam messages with the current setting, to make the filter more sensitive, try setting a lower value, for example, 6. <br />If any emails are missing because spam filter considers them as spam, try reducing the filter's sensitivity by setting a higher value, for example, 8.<br/> |
| − | You can also add email messages to white list that | + | You can also add email messages to a white list that will not be checked by the spam filter, and black list that will block all emails coming from a particular sender.<br/> Simply type domain names in appropriate fields (one domain name per line). Addresses can also contain ''' "*" ''' and ''' "?" ''' wildcard characters, for example, ''*@domain.com, user?@*.com''. |
|} | |} | ||
{| | {| | ||
| Line 709: | Line 709: | ||
|} | |} | ||
{| | {| | ||
| − | |style="padding: 0px 0px 15px 15px;"|Choose'' 'Generate Certificate' '' fill out required fields. You can also decide whether you want the private key to be automatically generated or | + | |style="padding: 0px 0px 15px 15px;"|Choose'' 'Generate Certificate' '' and fill out the required fields. You can also decide whether you want the private key to be automatically generated or provide your own key.<br/>Once ready, you will see it on the list of ready certificates.<br/> |
| − | '' '''Note:''' the current Plesk API does not give the possibility to preview the automatically generated private key. To do this, you need to | + | '' '''Note:''' the current Plesk API does not give the possibility to preview the automatically generated private key. To do this, you need to log directly into the Plesk panel.'' |
|} | |} | ||
{| | {| | ||
| Line 716: | Line 716: | ||
|} | |} | ||
{| | {| | ||
| − | |style="padding: 0px 0px 15px 15px;"|If you already have certificate you can provide it by choosing '' 'Upload Certificate' '' | + | |style="padding: 0px 0px 15px 15px;"|If you already have a certificate, you can provide it by choosing '' 'Upload Certificate' ''.<br/> Next, provide the certificate and domain name, and paste the content of yours '' 'Private Key (*.key)' '', '' 'Certificate (*.crt)' '' and '' 'CA Certificate (*-ca.crt)' '' files.<br/>Once ready, you should see the provided certificate on the list. |
|} | |} | ||
{| | {| | ||
| Line 730: | Line 730: | ||
|} | |} | ||
{| | {| | ||
| − | |style="padding: 0px 0px 20px 15px;"|Choose | + | |style="padding: 0px 0px 20px 15px;"|Choose a domain for your available subdomain from the list and provide a document root. |
|} | |} | ||
{| | {| | ||
| Line 753: | Line 753: | ||
===Log In To Panel=== | ===Log In To Panel=== | ||
{| | {| | ||
| − | |style="padding: 10px 0px 15px 15px;"|With a single click on the | + | |style="padding: 10px 0px 15px 15px;"|With a single click on the '' 'Log In To Panel' '' button you can be redirected to your Plesk Panel account.<br/> |
''Note that you must have a proper IP address or domain entered in the admin area panel to use this button.'' | ''Note that you must have a proper IP address or domain entered in the admin area panel to use this button.'' | ||
|} | |} | ||
| Line 774: | Line 774: | ||
{| | {| | ||
|style="padding: 10px 0px 15px 15px;"|Let your clients decide which application they would like to install on their new Plesk account.<br /> | |style="padding: 10px 0px 15px 15px;"|Let your clients decide which application they would like to install on their new Plesk account.<br /> | ||
| − | While placing an order your customer | + | While placing an order, your customer will choose an application and along with the account creation, this very application will be installed on the account.<br /> |
| − | There is nothing else you need to do. Application will be instantly ready | + | There is nothing else you need to do. Application will be instantly ready for use!<br /> |
To set up this feature, come back to your product's configuration, find the '' 'Applications' '' section, activate '' 'Install Applications' '', choose '' 'Autoinstaller Type' '' and activate '' 'Autoinstall On Create' '' with '' 'Use Configurable Options' ''. | To set up this feature, come back to your product's configuration, find the '' 'Applications' '' section, activate '' 'Install Applications' '', choose '' 'Autoinstaller Type' '' and activate '' 'Autoinstall On Create' '' with '' 'Use Configurable Options' ''. | ||
|} | |} | ||
| Line 782: | Line 782: | ||
|} | |} | ||
{| | {| | ||
| − | |style="padding: 0px 0px 20px 15px;"|Next go back to | + | |style="padding: 0px 0px 20px 15px;"|Next, go back to the features list and click on the download icon to view the list of applications. |
|} | |} | ||
{| | {| | ||
Revision as of 15:35, 21 June 2018
Article update is ongoing on this page, watch out for broken links, unclear descriptions and images!
We are sorry for the inconvenience caused.
Contents |
About Plesk Extended For WHMCS
| Plesk Extended For WHMCS is a module which empowers your customers to manage their web hosting accounts directly from the WHMCS client area. They will be able to manage their FTP accounts, backups, databases, mailboxes, spam filters, DNS settings and other key aspects in a fully remote manner. |
- Admin Area Features:
| ✔ Create/Suspend/Unsuspend/Terminate Account |
| ✔ Change Package And Password Of Account |
| ✔ Configure Client Area Features Per Product |
| ✔ Log In To Plesk Administrator Panel On Click |
| ✔ Define Service Plan Name Per Product |
| ✔ Define Reseller Plan Name Per Product |
| ✔ Enable And Configure Application Auto Installer To Use Per Product: |
| ✔ Default Plesk App Installer |
| ✔ Installatron |
| ✔ Softaculous |
| ✔ View All Plesk Extended Products In One Place |
| ✔ View All Plesk Extended Server Configurations In One Place |
| ✔ Toggle 'Power User' Plesk Panel View |
| ✔ Define Custom URL Of Panel And Webmail |
- Client Area Features:
| ✔ Remote Access And Management Of: |
| ✔ Addon Domains |
| ✔ Applications |
| ✔ Backups |
| ✔ Databases - MySQL And PostgreSQL Databases Support |
| ✔ Domain Aliases |
| ✔ DNS Records |
| ✔ Email Addresses |
| ✔ Email Forwarders |
| ✔ FTP Access |
| ✔ Spam Filter |
| ✔ SSL Certificates |
| ✔ Subdomains |
| ✔ Web Users |
| ✔ One Click Login To: |
| ✔ Plesk |
| ✔ Webmail |
| ✔ Plesk Single Sign-On |
| ✔ 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 Installatron, Softaculous Or Default Plesk App Installer |
| ✔ View And Manage Installed Applications |
| ✔ Backup Installed Applications |
| ✔ Perform Auto Backups Upon Application Updates By Installatron |
| ✔ View And Manage Created Backups |
| ✔ Restore Applications From Backups |
| ✔ Delete Applications Along With Their Backups |
- General Info:
| ✔ Utilizes Ajax Loaded Pages |
| ✔ Supports SSO Into Panel And Webmail |
| ✔ Integrated With Advanced Billing For WHMCS - Actual Server Resource Usage Billing (read more) |
| ✔ Integrated With Server Allocator For WHMCS - Automatic Assignment Of Specified Servers To Products (read more) |
| ✔ Multi-Language Support |
| ✔ Supports Windows & Linux |
| ✔ Supports Plesk 9 up To Plesk Onyx 17.8 |
| ✔ Supports PHP 5.6 Up To PHP 7.2 |
| ✔ Supports WHMCS Template Six |
| ✔ Supports WHMCS V7.2 And Later |
Installation and Configuration
Installation
| This tutorial will show you how to successfully install and configure Plesk Extended For WHMCS. We will guide you step by step through the whole installation and configuration process. |
| 1. Log in to our client area and download the module. |
|
| 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 5.6 up to PHP 7.0, while the second one is aimed at PHP 7.1 up to PHP 7.2. It does not apply to open source versions. Note: You can check the current PHP version in your WHMCS. To do so, proceed to 'Utilities' → 'System' → 'PHP Info'. |
|
| 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 the PHP version files should look like this. |
|
| 4. When you install Plesk Extended For WHMCS for the first time you have to rename the 'license_RENAME.php' file. The file is located in 'modules/servers/pleskExtended/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'. |
|
| 5. In order to configure your license key, you have to edit the previously renamed 'license.php' file. Enter your license key between the quotation marks as presented on the following screen. You can find your license key in our client area → 'My Products'. |
|
| 6. In the next step, set up the 'storage' folder as recursively writable. This folder is available at two locations:
|
|
Activation of Addon
| 7. Now, you have to activate the module in your WHMCS system. Log in to your WHMCS admin area. Click 'Setup' and then choose 'Addon Modules'. |
|
| 8. In the next step you need to permit access to this module. To do so, press 'Configure'. Next, select the required administrator roles and press 'Save Changes' . |
|
| 9. Congratulations, you have just successfully installed Plesk Extended For WHMCS! |
Configuration of Server
| 10. Now, we will show you how to configure a new server. To do so, log in to your WHMCS. Go to 'Setup' → 'Products/Services' → 'Servers'. Afterward, press 'Add New Server'. |
|
| 11. Next, enter your server name, hostname/IP address, username and password. Choose 'PleskExtended' from the dropdown menu and press 'Save Changes'. Here you can also provide other server details like nameservers or maximum number of accounts. Finally, click 'Test Connection' to check if the provided credentials are valid. Important: Due to changes in the original WHMCS Plesk module, it may be required to additionally enter the IP address into the Hostname field even if you have already provided it in the IP Address field below. |
|
| 12. After you have configured your server correctly, you will see the following screen. Now, you need to create a new group for your server. For that purpose, press 'Create New Group'. |
|
| 13. Enter a name, click on your previously created server, press 'Add' , then 'Save Changes'. |
|
Configuration of Product
| 14. In order to create and configure the product, move to 'Setup' → 'Products/Services' → 'Products/Services'. If you do not have a product group, choose 'Create a New Group'. |
|
| 15. Enter a product group name and press 'Save Changes'. |
|
| 16. Once you have a product group, you can create your product and assign it to Plesk Extended. To create a product, press 'Create a New Product'. |
|
| 17. Afterward, choose your product type and the product group from the dropdown menus, enter your product name and press 'Save Changes'. Please note that you may choose only between 'Hosting Account' and 'Reseller Account' as the product type since only those are supported by the Plesk module. |
|
| 18. Now, move to the 'Module Settings' section, choose both 'PleskExtended' and your previously created server group from the dropdown menus. Remember to add your 'Client Template Name' or 'Service Plan Name'. Plesk Extended will not work properly without a specified plan name. |
|
| 19. Good job! You have just correctly created and customized your new product. It will now appear in Plesk Extended Center admin area. |
Configuration of Addon
| 20. After you have correctly created and customized a new product, it is time to configure it. Go to 'Addons' → 'Plesk Extended' in your WHMCS.
|
|
| 21. Proceed to the 'Features' section and find the product you are interested in. Press the 'Configuration' button next to the product. |
|
| 22. You will find here boxes dedicated to 'Features' and 'Applications'. To show you an example, we will set the configuration from the very beginning, without using other configuration options of the product. Select the features you would like to activate for your customers. |
|
| 23. Next, toggle 'Install Application' that will be used to install applications by your clients. In the 'Autoinstaller Type' field you will be free to choose between 'Installatron' , 'Softaculus' and 'Default' auto installers. |
|
| 24. You may also enable the option for automatic installation of selected applications once an order is created. Use the 'Autoinstall On Create' toggle and select the default option from the 'Apps / Configurable Options' list. You can also choose the desired language of applications by typing in its two-letter code in the 'Language' field. A complete list of language codes can be found here. Moreover, you can permit your clients to toggle automatic backups for application updates or enable them for the first application after the initial order. Note: You can also create a configurable option with an app to be installed. You can find the instruction on how to do that here. |
|
| 25. You can let your clients decide about the automatic application installation during ordering process by using the 'Use Configurable Options' switch and choosing the appropriate option from the list. |
|
| By selecting this option, you will notice a download button next to the dropdown list on the product's features list. Its purpose is to download the available application list in the text format that can be then used for configurable options. More information about the available configurable options and custom fields can be found here. |
|
| 26. If you already have another product configured, you may copy its configuration. Find the 'Copy' button on the list with products or select multiple item at once. |
|
| 27. In the next step, move to 'Server Configuration' to set up a connection. Press the ' Configuration' button next to a desired server. |
|
| Enter the proper domain and IP address to allow a connection with Plesk panel and Webmail accordingly. Do not forget to 'Save' changes once you are finished! |
|
| 28. From now on, all your clients who ordered a previously created product will be able to manage their Plesk accounts via your WHMCS system. Here is the summary of the ordered product in admin area. The available actions include:
|
|
| Client area view: |
|
Upgrade Plesk to Plesk Extended Product
| Once you have already configured the standard Plesk products, you can easily upgrade them to the Plesk Extended products. Note: Before you start, make sure that you have already configured the Plesk Extended server. |
|
| Now, select the new server group configured for the Plesk Extended module.
Note: Make sure that this server configuration is exactly the same as the standard cPanel server configuration. |
|
Management
| Plesk Extended allows your customers to manage their accounts via client area in your WHMCS system. In this short guide we will present you with the management possibilities of our module. |
Client Area
Addon Domains
| Addon domains section allows you to link the domain to a subdirectory of your account. You can view and manage addon domains, edit document root and make redirections. Note: Make sure this feature is enabled for your account before using |
|
| Press the 'Create Addon Domain' button and enter the desired details. Please note that an FTP account will not be automatically created with the domain. |
|
Applications
| Install your favorite applications in a few seconds without even accessing Plesk. Use Plesk Extended For WHMCS to:
To start, simply proceed to 'Applications' , and then find the 'Install New' section. |
|
| Afterwards, you will see an extensive menu with application categories. For presentation purposes we will install 'PrestaShop' located in the 'E-Commerce And Business' category. Find 'PrestaShop' and click on it. |
|
| Now, you have to enter necessary installation details and then press 'Install Application' to follow. Wait for the 'Success' notification. |
|
| View the list of your installed applications by clicking on the 'Installed Applications' tab and manage the application. Here you will find the name of the application, its path, size and available actions:
|
|
Application Backups
| You can also create a backup of your installation. To do so, simply press the 'Create Backup' button next to the installed application. |
|
| Confirm the action and backup generation will start immediately. |
|
| After a moment you should receive the 'The backup has been created successfully' message confirming that the operation has been performed successfully. Once you have created a backup of your application, proceed to the 'Backups' tab. |
|
| If you use the Installatron plugin, you can also let your customers create automatic backups for application updates. To do this, go to 'Addons' → 'Plesk Extended' → 'Features' → 'Configuration' and enable Auto Update Backups. |
|
| Then, when a client installs a new application, it will be possible to toggle the option for automatic update backups and restore them if the application update fails. |
|
Backups
| All available backups are displayed under the 'Backups' section. To add a new one, press the 'Create Backup' button |
|
| Next, add prefix and backup description, choose split size, backup content type and decide whether to make backup 'locally' on Plesk server or on your 'remote' FTP storage. |
|
| The backup creation might take a while. When ready, it can be downloaded by client or deleted from the server. Important: For a large backup files we strongly recommend to increase the 'max_execution_time' setting in your server's 'php.ini' configuration. |
|
| If you want to use the 'remote' backup type, you will also need to provide the 'FTP Storage Settings' . |
|
| Provide your FTP server IP address or hostname, access credentials, mode, and the directory path to which the backup will be uploaded. Then, when you create the backup for a second time, select the remote type to upload it directly to your FTP server. |
|
Databases
| Owing to 'Databases' management you can create/delete new databases and users. Press 'Create Database' to add a new database. |
|
| To create a new database, type in its name into the appropriate field and select its type. Optionally, you can also create a user directly assigned to the database. Note: that only 'MySQL' and 'PostgreSQL' databases are currently supported and must be enabled in your Plesk panel first. |
|
| You can also delete already assigned users as well as add new ones to particular databases by choosing 'Create Database User' in the 'Users' tab. |
|
Domain Aliases
| Here you can add and manage your domain aliases. This allows you to read content of one domain from another domain name. |
|
| Next, provide your alias domain, chose domain redirections as well as toggle the remaining options. |
|
| After alias creation, you can also rename it, change its settings or delete it. |
|
DNS Settings
| Here you can add and manage DNS records to define the structure and content of the chosen domain name space. |
|
| Add records by selecting the type and providing their hostname and value. |
|
Email Accounts
| View and edit email accounts that are associated with your domains. Use filter to find required email addresses, preview its selected quota or delete manage the account. |
|
| Press 'Add Email Account' and select to which domain it shall be added, type or generate password and define limited or unlimited quota. |
|
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. |
|
| Press the 'Create Email Forwarder' button, specify the forwarded email and define the destination address. |
|
FTP Access
| In the very first section you are given the possibility to manage your FTP access or create new FTP accounts. FTP access management is dependent on the system your Plesk panel is set up on. |
|
| Add and configure FTP Accounts in the easiest way possible. Just type in your login on a domain, provide or generate a secure password, define directory access and declare available quota. Note: if you have some other addon domains, creating a FTP account on the main domain will also add it to these domains. |
|
Spam Filter
| The 'Spam Filter' powered by SpamAssassin is designed to identify spam messages among emails sent to mailboxes hosted on your Plesk server. |
|
| Enable and configure the filter as desired for the selected mailbox. You can also adjust sensitivity - by default it might be set to 7 so that all messages with that score or more points will be classified as spam. You can also add email messages to a white list that will not be checked by the spam filter, and black list that will block all emails coming from a particular sender. |
|
SSL Certificates
| This section will allow you to generate or paste ready SSL certificates and private keys. |
|
| Choose 'Generate Certificate' and fill out the required fields. You can also decide whether you want the private key to be automatically generated or provide your own key. Once ready, you will see it on the list of ready certificates. Note: the current Plesk API does not give the possibility to preview the automatically generated private key. To do this, you need to log directly into the Plesk panel. |
|
| If you already have a certificate, you can provide it by choosing 'Upload Certificate' . Next, provide the certificate and domain name, and paste the content of yours 'Private Key (*.key)' , 'Certificate (*.crt)' and 'CA Certificate (*-ca.crt)' files. Once ready, you should see the provided certificate on the list. |
|
Subdomains
| Create subdomains for different parts of your website by pressing the 'Create Subdomain' button. |
|
| Choose a domain for your available subdomain from the list and provide a document root. |
|
Web Users
| Add and manage the list of web users that have personal pages on your website. |
|
| Provide login name and its password and and decide whether to provide support for PHP and FastCGI. |
|
One Click Login
Log In To Panel
| With a single click on the 'Log In To Panel' button you can be redirected to your Plesk Panel account. Note that you must have a proper IP address or domain entered in the admin area panel to use this button. |
|
Log In To Webmail
| You can quickly access your webmail through pressing the 'Log In To Webmail' button. Note that you must have a proper IP address or domain entered in the admin area panel to use this button. |
|
Applications Configuration
Configurable Options For Application Auto Install
| Let your clients decide which application they would like to install on their new Plesk account. While placing an order, your customer will choose an application and along with the account creation, this very application will be installed on the account. |
|
| Next, go back to the features list and click on the download icon to view the list of applications. |
|
| These are the names of values that you can enter in configurable options' fields, we will configure them in the next step. For example, if you would like to set up 'Drupal 8.3.2' in your applications list, you will need to enter 'Drupal' or 'Drupal|Drupal 8.3.2' into the value field. |
|
| Go to your 'WHMCS' → 'Setup' → 'Products/Services' → 'Configurable Options' and press 'Create a New Group' . |
|
| Enter 'Group Name' of your choice, select product you want to assign configurable options to, then press 'Save Changes' . |
|
| Now click on 'Add New Configurable Option' . |
|
| 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. 'Wordress |WordPress 4.7.5' and press 'Save Changes' . |
|
| As you can see on the following screen we decided to offer our customers 5 applications. When you finish adding applications, press 'Save Changes' and 'Close Window'. |
|
| From the module's version 3.1.0 you can also create a new configurable option Auto Backup On Update with the 'Yes/No' option type. This option is used to enable the creation of auto update backups for a firstly chosen application after the initial order in WHMCS. |
|
| Afterward, come back to 'Plesk Extended Features' → 'Configuration' → 'Applications' , activate 'Use Configurable Options' and choose 'Apps / Configurable Options' from the dropdown menu. Please note that you can have more configurable options groups. Press 'Save' and that's it. You have just successfully assigned configurable options to the application autoinstall. |
|
| Let's check out what your customers are going to see in their client area while placing the order. As you can see, a dropdown menu with the previously configured applications has shown up. |
|
Assignment of Custom Fields To Application Autoinstall
| Now, when you know how to allow your customers to choose which application they would like to install on their account, we can proceed one step further. Until that moment applications had been installed with use of default details like e.g. directory names or database name.
Remember to set each field type as 'Text Box' , tick 'Required Field ' and 'Show on Order Form'. |
|
The next 3 fields are:
Set them as 'Text Box' and tick 'Show on Order Form'. |
|
The last field is:
Set it as 'Drop Down' , enter 'Yes, No' into 'Select Options' , tick 'Required Field ' and 'Show on Order Form'. |
|
| 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. |
|
Custom Installatron Application Language
| We will show you how to quickly set a custom language for Installatron web applications. For this purpose you need to add a new custom field for your product. The field should be called 'Language' . |
|
| Afterward go to your 'Products/Services' and check whether the 'Language' field has appeared. In order to change the default application language for a certain account enter here the appropriate value. |
|
| From now on the new field will be visible for your customers as well. While installing a new application they can choose a desired language by entering its value into the field. Here you will find a complete list of language codes. |
Management of Existing Products
| You can easily use Plesk Extended module with your already configured Plesk products. To do so change the type of servers and module names of products from 'Plesk' to 'PleskExtended'. |
Billing Management
| When you combine Plesk 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 server resources used by them. |
|
| With Advanced Billing module, you can also display your customers the current server resource usage and their cost. |
|
Tips
| 1. To set up an existing customer's account in your Plesk Extended, create a new WHMCS order with the same username, password and email address. Then set the account status to active. |
| 2. As this module supports templates system, any changes made in the module's templates files will be saved after the upgrade process. |
Update Instructions
| Essential guidance through the process of updating the module is offered here. Important: If you are upgrading from Plesk Extended 2.X to 3.X module version, you have to delete the old /modules/servers/pleskExtended/ folder (started with a lower case letter) before you start using a new version.
Then after activation of the new addon version, the all data from the old version of the addon and the products configurations will be automatically migrated to the new version. Note: since 3.0.0 module version the cron execution is also no longer required.
|
Common Problems
| 1. When you have problems with connection, check whether your SELinux or firewall does not block ports. |
| 2. If you see an error as shown on the screen below, it means that you haven't provided your service plan name or reseller plan name in product's 'Module Settings'. Once you enter the name, the problem will disappear. |
|
| 3. If you are unable to connect with your Plesk server or client area functionalities don't work properly, then make sure that you are connecting with your server on port 8443. Here you can find more information on how to change default port in Linux and Windows |
| 4. CURL Error: [6] Could not resolve host. Try enter your Plesk IP address into the Hostname field in the server configuration. |
| 5. Unable to get the version number from the server. CURL Error: 7 - couldn't connect to host. Check server connection details. Check connection details and the connection itself between WHMCS and server. |
| 6. Unable to get the version number from the server. Permission denied. You have to set admin account access details. You need admin account access to use PPPE module, reseller account API is not supported. |
| 7. Blank page at 'Applications'. Reason: Some libraries may be missing. |
| 8. If you have problems with your license, please make sure that the content of the file is correct. Please note that for Plesk Extended For WHMCS V2.0.0 and later the license key begins with: $plesk_extended_licensekey="ModulesGarden_PleskEX_LicenseKey"; Not as it was for the previous versions: $parallels_plesk_panel_extended_licensekey="ModulesGarden_PleskEX_LicenseKey"; |
| 9. In case you see an error: 'Request Is Invalid: Error In Line 5: Element 'owner-id' is not a valid value of the atomic type 'int'.' while creating the product, please verify your product type. Most probably it is set to 'Dedicated/VPS Server' or 'Other' which are not supported. See point 17 of installation for more info. |
| 10. If you see an error similar to: 'Unable to find appropriate manager for this version of Panel. Plesk should be at least 8.0 version.' while creating the product please verify your server configuration. Make sure that you have SSL 'Secure' ticked in your server configuration, depending on your Plesk settings. |
| 11. Plesk Extended For WHMCS functions only on the administrator account. |
| 12. For a large backup files we recommend to increase the 'max_execution_time' setting in your server's 'php.ini' configuration. Otherwise, fatal errors like 'Allowed memory size of 134217728 bytes exhausted (tried to allocate 100401152 bytes)' may occur when trying to download local backups. |
| 13. Due to removed support for 'XML API' by Plesk, Plesk Onyx from version 17.8 is only partial supported. This means the following functionalities:
will not work anymore and even the more features may become incompatible with further versions of Plesk. If you need full compatibility please use the the last compatible Plesk 17.5 version. |