Revision as of 16:17, 4 June 2021

Supported Features

The following ports should be open for outbound connections from your WHMCS server: 8443

Setting Up a Plesk Server

The following steps guide you through the process of setting up a server in WHMCS for Plesk Hosting Accounts in Plesk 11-12.

1. Go to Configuration () > System Settings > Servers or, prior to WHMCS 8.0, Setup > Products/Services > Servers.
2. Click Add New Server.
3. Enter the server name, IP address, username and password as appropriate.
4. Set the type to Plesk.
   

   Setting a custom port
5. Custom Port: If you have a non-standard (8443) port for Plesk, you should enter the port number in the Access Hash section of the Server setup.
6. Be sure to check the Secure option to connect using SSL mode as it is required by Plesk.
7. Click the Test Connection button to make sure the details are entered correctly and WHMCS can connect to Plesk.
8. Once the test connection reports success, click Save Changes to complete the process and add your new server.

Setting Up a Plesk Package

Plesk Module Settings

Creating a Hosting Plan

To set up a Plesk package, go to Configuration () > System Settings > Products/Services or, prior to WHMCS 8.0, Setup > Products/Services > Products/Services. From there, you can create the product and configure the general settings and pricing info as normal, then for a shared hosting plan:

1. On the Module Settings tab, select "plesk" in the module dropdown field and then for a shared hosting package:
2. Create a Service Plan inside Plesk itself (in Hosting Services > Service Plans) and select the Service Plan Name from the dropdown that appears.
3. From the Which IP addresses to use? dropdown select how you wish Plesk to assign IP addresses when accounts using this product are created.
4. And then finally as with all products you have the option of choosing the automatic setup option you want for new orders, be it immediately as soon as the order is placed, as soon as the initial payment has been received (recommended) or waiting until an admin manually reviews & accepts the pending orders

For a reseller package

Plesk Module Settings

Creating a Reseller Plan

1. Set the settings for the resellers own hosting account as above with one difference, the Product Type setting must be Reseller Account.
2. Create a service plan inside Plesk itself (in Hosting Services > Service Plans > Reseller Plans tab)
3. Under the Module Settings tab, select the desired Service Plan Name and Reseller Plan Name to define the resellers limits & permissions.

Notes

Creating a Reseller account will not create a shared hosting space for the reseller's website. Once the account has been created, the reseller can login to Plesk and set up their own hosting space.

Additional Options

The Plesk module supports multiple ways of increasing the value of your services (or upsell options) via configurable options, addons, and dedicated IP addresses.

Configurable Options for Plesk Panel Addons

Plesk Panel Addons

WHMCS Plesk Configurable Options

WHMCS Plesk Bandwidth Configurable Options

To create configurable options that can attach Plesk's Panel Addons to your Plesk products:

1. Navigate to Configuration () > System Settings > Configurable Options.
2. Create a configurable option. Use Plesk Panel-Addon-Name format, replacing Panel-Addon-Name with the exact name that displays in Plesk for that Plesk Panel Addon.

• • For example:
    • In the Plesk Panel Addons image above, one of the configured Panel Addons is Extra Bandwidth, with resources of 5GB or 10GB.
    • In WHMCS in the WHMCS Plesk Configurable Options image above, this is Plesk Extra Bandwidth.
    • In the WHMCS Plesk Bandwidth Configurable Options image above, 10Gb Extra Bandwidth and 5Gb Extra Bandwidth are set to ensure that the bandwidth options in Plesk and WHMCS match.
  • We recommend that you set the first option to be None or a similar value. When you do this, ensure that that option and the Panel Addon match with a value of 0. This gives the user the ability to choose not to have any additional values per option.

1. Select Yes/No as the Option Type for these options.
2. Ensure that the products for these options are selected in Assigned Products.

For more information, see Addons_and_Configurable_Options.

To add configurable options to a product:

1. Navigate to Configuration () > System Settings > Products/Services.
2. Edit the desired product or service.
3. Choose the Configurable Options tab.
4. Select the desired options.

Dedicated IP Address

To create configurable options that provision a dedicated IP address:

1. Navigate to Configuration () > System Settings > Products/Services or, prior to WHMCS 8.0, Setup > Products/Services.
2. Choose the Configurable Options tab.
3. Create configurable options with the names Dedicated IPv4 or Dedicated IPv6, depending on the type of IP addresses that you want to offer.
4. Select Yes/No as the Option Name.
5. Ensure that the products for these options are selected in Assigned Products.

For more information, see Addons_and_Configurable_Options.

Add-On Features

In WHMCS 8.2 and later, in addition to WHMCS's existing product addon functionality (now an Independent Product), you can create an Add-On Feature. These addons let you sell module-specific features like the WordPress Toolkit offerings available through both cPanel and Plesk.

For more information and steps to create an addon, see Product Addons.

Common Problems

The client account is getting setup but the domain is not

This is usually due to the permissions of the domain template exceeding the server resources or containing something such as ColdFusion support when the server doesn't support it. You should always test your domain template works directly in Plesk after setting it up if it is a new setup.

I get a blank command error from WHMCS when it tries to setup an account

This can occur if your firewall is blocking connections on port 8443. You need to open it on both the server WHMCS is on and the server WHMCS is connecting to for inbound and outbound connections.

With accounts created on my Plesk server from WHMCS the www. subdomain doesn't work

This happens due to the default DNS settings on a Plesk server and the requirement to tick a box when creating an account to enable it. To avoid that, simply follow the steps below.

1. Login to Plesk
2. Click "Server"
3. Click "DNS Settings"
4. Click "Add New Record"
5. Choose "CNAME" under record type
6. Enter "www" in "Enter Domain Name"
7. Enter "<domain>" in "Enter Canonical Name"
8. Hit OK to complete the changes

Page not Found/Timeout/502 Bad Gateway error creating accounts

By default Plesk performs a forced restart of apache when an account is created or suspended which causes WHMCS to lose connection to the server, and if your WHMCS is on the same server, you will also lose connection to WHMCS at the same time. In order to resolve this please refer to the following knowledgebase article for instructions on configuring Plesk to perform a graceful restart instead: https://support.plesk.com/hc/en-us/articles/213907285

503 Service Temporarily Unavailable error creating accounts

By default Plesk performs a forced restart of apache when an account is created or suspended which causes WHMCS to lose connection to the server, and if your WHMCS is on the same server, you will also lose connection to WHMCS at the same time. In order to resolve this please refer to the following knowledgebase article for instructions on configuring Plesk to run PHP as an FPM application served by nginx instead: https://support.plesk.com/hc/en-us/articles/115003664213-Unable-to-create-domain-through-WHMCS-503-Service-Temporarily-Unavailable

Unable to create account in Panel. The field 'username' is required.

This means the username under the client's Products/Services tab is empty.

You should enter a username, save changes and try module creation again. Also ensure Configuration () > System Settings > Products/Services > Edit > Require Domains or, prior to WHMCS 8.0, Setup > Products/Services > Products/Services > Edit > Require Domains is checked to avoid this in future.

0 - Unable to find appropriate manager for this version of Panel. Plesk should be at least 8.0 version

This is a generic error message returned by the Plesk module; for example it could be indicative of a connection error or invalid credentials To identify the underlying error that is occurring, use Configuration () > System Logs or, prior to WHMCS 8.0, Utilities > Logs > Module Log. Please enable it, reproduce the error, disable it again and the Response column will show the underlying error.

More detailed instructions using the Module Log are published at Troubleshooting_Module_Problems.

1006 - Permission denied

This indicates your Plesk login doesn't have the necessary permissions to use the API. You need the admin of the server to grant your Plesk reseller account permission to use the API - specifically this permission "Ability to use remote API" and that should resolve it

1013 - Template does not exist

This error message is coming direct from the Plesk API. When configuring the product, you have to enter the client and domain template names. These are currently incorrect or missing so you will need to correct them in Setup > Products/Services on the Modules Settings tab when editing your product

1013 - Error message: Customer with email 'johndoe@example.com' is not found in panel. Please contact your service provider

There are two potential causes of this error message:

1. The product type is set incorrectly in WHMCS. Ie. A reseller plan is configured as a shared hosting product in WHMCS or vice versa. To resolve this:

• Login to WHMCS Admin Area
• Navigate to Configuration () > System Settings > Products/Services or, prior to WHMCS 8.0, Setup > Products/Services > Products/Services.
• Review the Product Type setting.
• Adjust to Shared Hosting or Reseller Hosting to match the Plesk plan type.
• Click Save Changes.

2. Missing data from a table inside Plesk.

If the error persists after following step 1 above, then refer to this article to correct missing data in Plesk: https://support.plesk.com/hc/en-us/articles/213932225-Error-while-accessing-Plesk-from-WHMCS-via-API-Customer-with-external-id-whmcs-plesk-XX-is-not-found-in-panel

1014 - Parser error: Request is invalid

This error message indicates there is a field value missing - this is most commonly caused by having no assigned IPs in the client or domain templates IP pool.

1014 - Parser error: Cannot parse the XML from the source specified

The Plesk API only supports the characters a-z 0-9. If the client's profile contains other characters, accents etc, it will cause account creation to fail. You should edit the client's profile to remove these characters.

1018 - Unable to create hosting. IP address does not exist in client's pool

This error generally indicates that there is an issue with the IP pool configuration in Plesk. For example there not be any available IP addresses or having the first IP set as dedicated when it should be shared.

1023 - Unable to accept the template: the following limitations are exceeded

This issue occurs when the resources provided by the serivce plan add-on were already used by the subscription.

The resolve it, inside Plesk, within the subscription for that domain name, remove the referenced addon-on. Once removed, inside WHMCS on the service itself within the Products/Services tab of the admin user interface, use the "Upgrade/Downgrade" option selecting the addon-on and creating an upgrade order for it to be applied.

2306 - Domain adding was failed. Error: xxxxx template failed: Unable to apply limits

This error message comes direct from the Plesk API. It means that the template you are attempting to use exceeds your limits or has a feature your server doesn't support. You should try creating an account with the template inside Plesk itself as then you get more details about the problem.