Difference between revisions of "Application Links and cPanel Quick Start Guide"

From WHMCS Documentation

 
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
[[Application Links]] combines [[WHMCS Single Sign-On]] with cPanel & WHM to provide access to 14 of the most commonly used areas of WHMCS from directly within the cPanel user interface.
 +
 
[[File:CPanelAppLinkingUI.png]]
 
[[File: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.
+
Application Links allows end users to transition quickly and effortlessly from web hosting control panel to billing and support resources without having to re-authenticate, removing the separation between control panel and billing, making it easier for customers to get help when they need it, and keeping your brand in customers minds.
 +
 
 +
Find out more in our [http://blog.whmcs.com/?t=109078 launch announcement here].
  
Find out more in our launch announcement here.
+
<div class="docs-alert-warning">
 +
In WHMCS 8.8 and higher, you can also use Application Links with [[WP Squared]] servers.
 +
</div>
  
 
==Getting Started==
 
==Getting Started==
  
If you already have cPanel & WHM servers setup in your WHMCS installation, turning on Application Links is simply a button press away.
+
<html><a href="https://www.youtube.com/watch?v=esAsImsRlcY&hd=1" class="docs-video-tutorial"><em>Watch the video tutorial for this feature</em><span>&nbsp;<img src="https://assets.whmcs.com/icons/youtube.png">&nbsp;</span></a></html>
  
# Login to your WHMCS Admin Area
+
To get started with Application Links:
# Navigate to Setup > Application Links
 
# Slide the toggle setting from Off to '''On''' next to the Application you wish to enable it for<div class="docs-alert-success">The option to enable Application Links will be unavailable if you do not have at least one '''active''' cPanel server configured</div>
 
# 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 the application
 
  
<div class="docs-alert-danger">Requires cPanel & WHM Version 54 which entered RELEASE status on Monday, 25h January, 2016</div>
+
# Add one or more cPanel & WHM [[Servers|servers]] to your WHMCS installation.
 +
# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Application Links]]''' or, prior to WHMCS 8.0, '''Setup > Application Links'''.<div class="docs-alert-warning">Make sure that you have the ''Configure Application Links'' permission and are using up-to-date Admin Area templates.</div>
 +
# Set '''cPanel''' to ''On''. The status indicator will update to reflect the new setting.
 +
# Wait for the process to run. It may require a large amount of time to complete depending on the number of cPanel accounts on your servers. Do '''not''' navigate away from the page.
 +
# When the status indicator changes to ''Active'', log in to any cPanel account to verify that the links display correctly.
  
 
==Customising the Links==
 
==Customising the Links==
  
There are 14 possible links available with the cPanel integration.
+
There are 14 possible links available with the cPanel Application Links integration.
  
 
You can choose which links appear, the labels they have and in which order they are displayed.
 
You can choose which links appear, the labels they have and in which order they are displayed.

Latest revision as of 19:45, 28 August 2023

Application Links combines WHMCS Single Sign-On with cPanel & WHM to provide access to 14 of the most commonly used areas of WHMCS from directly within the cPanel user interface.

CPanelAppLinkingUI.png

Application Links allows end users to transition quickly and effortlessly from web hosting control panel to billing and support resources without having to re-authenticate, removing the separation between control panel and billing, making it easier for customers to get help when they need it, and keeping your brand in customers minds.

Find out more in our launch announcement here.

In WHMCS 8.8 and higher, you can also use Application Links with WP Squared servers.

Getting Started

Watch the video tutorial for this feature  

To get started with Application Links:

  1. Add one or more cPanel & WHM servers to your WHMCS installation.
  2. Go to Configuration () > System Settings > Application Links or, prior to WHMCS 8.0, Setup > Application Links.
    Make sure that you have the Configure Application Links permission and are using up-to-date Admin Area templates.
  3. Set cPanel to On. The status indicator will update to reflect the new setting.
  4. Wait for the process to run. It may require a large amount of time to complete depending on the number of cPanel accounts on your servers. Do not navigate away from the page.
  5. When the status indicator changes to Active, log in to any cPanel account to verify that the links display correctly.

Customising the Links

There are 14 possible links available with the cPanel Application Links 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