Application Links and cPanel Quick Start Guide

From WHMCS Documentation

Revision as of 19:10, 4 February 2016 by Matt (talk | contribs) (Getting Started)

CPanelAppLinkingUI.png

Application Links combines WHMCS Single Sign-On with cPanel & WHM to provide links to up to 14 areas of WHMCS from directly within the cPanel user interface. For clients, using Application Links inside of cPanel allows them to transition seamlessly from web hosting control panel to billing and support resources without ever having to re-authenticate.

Find out more in our launch announcement here.

Getting Started

If you already have cPanel & WHM servers setup in your WHMCS installation, turning on Application Links is simply a button press away. The follow steps assume you're already logged in to your WHMCS admin area.

  1. Navigate to Setup > Application Links
  2. Slide the toggle setting from Off to On next to the Application you wish to enable it for
    The option to enable Application Links will be unavailable if you do not have at least one active cPanel server configured
  3. The status indicator will update to reflect the provisioning of links has begun
Please wait while the process completes. If you have a lot of cPanel Accounts, this may take some time to complete. Do not navigate away from the page.

When complete the status indicator will update to show Application Links are Active for cPanel

Requires cPanel & WHM Version 54 which entered RELEASE status on Monday, 25h January, 2016

Customising the Links

There are 14 possible links available with the cPanel integration.

You can choose which links appear, the labels they have and in which order they are displayed.

ApplicationLinksConfiguration.png

To configure application links:

  1. Click the Configure link under the status toggle
  2. A modal will load showing all the available cPanel Application Links. From here you can:
    • Slide the toggle setting on/off to enable/disable a given link
    • Customise the display label for a link
    • Drag and drop to re-order the display of links within the cPanel UI
  3. When you're happy with your changes, click Save Changes
  4. If Application Links are enabled, the status indicator will update to reflect the syncing of your configuration changes has begun
  5. Please wait while the process completes
  6. When complete the status indicator will update to show Application Links are Active for the application
Navigating away from the page while the sync is still in progress may leave some products/services without the new configuration.

Common Problems

When enabling Application Links, if the links fail to provision for any accounts you will receiving some warnings. The View Log button can be used to view those warnings. In most cases warnings can safely be ignored. Some examples of the types of warnings you may receive:

  • cPanel Account Username not found - indicates a cPanel account in your WHMCS system that is no longer present on the server
  • The value of “user” may not be empty - indicates one or more cPanel accounts in your WHMCS system have no username defined for them so the links are unable to be provisioned

More Information

For further help and information, please refer to the Application Links Full Documentation