Difference between revisions of "MarketConnect"

From WHMCS Documentation

(Customizing Promotion & Merchandising)
(Connecting WHMCS with the WHMCS Marketplace)
 
(26 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<div class="docs-alert-info"><i class="fa fa-question-circle"></i> This page describes a feature available in version 7.2 and above</div>
+
{{MarketConnect}}
 +
<div class="docs-alert-info"> We added this feature in WHMCS 7.2.</div>
  
WHMCS MarketConnect is a platform through which you can resell products and services to your customers via your WHMCS installation. WHMCS MarketConnect can automatically setup and configure these products as well as populate the Client Area with merchandising content and upsell recommendations.
+
[https://marketplace.whmcs.com/connect WHMCS MarketConnect] is a platform through which you can resell products and services to your customers via your WHMCS installation. WHMCS MarketConnect can automatically set up and configure these products as well as populate the Client Area with merchandising content and upsell recommendations.
  
 +
You can activate and configure WHMCS MarketConnect at  '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > MarketConnect''' or, prior to WHMCS 8.0, '''Setup > MarketConnect'''.
  
 
==Getting Started==
 
==Getting Started==
  
Offering products and service via WHMCS MarketConnect can be done in as few as 3 simple steps from within your Admin Area.
+
You can offer products and service via WHMCS MarketConnect with as few as three simple steps from within your Admin Area.
* Visit the MarketConnect Management page in the Admin Area
 
* Connect your WHMCS install with the WHMCS Marketplace
 
* Activate the Service Provider whose products you wish to resell to your clients
 
  
Upon activating a Service Provider, the products & their configuration will automatically be setup in your WHMCS installation for you.  As well, promotional and merchandising copy will be activated for your visitors and clients within the Client Area.
+
* Visit the MarketConnect Management page in the Admin Area.
 +
* Connect your WHMCS installation with the WHMCS Marketplace.
 +
* Activate the Service Provider whose products you wish to resell to your clients.
 +
 
 +
Upon activating a Service Provider, the system will automatically set up products and their configuration in your WHMCS installation for you.  Additionally, it will activate promotional and merchandising copy for your visitors and clients within the Client Area.
 +
 
 +
<div class="docs-alert-warning"><i class="fa fa-question-circle"></i> MarketConnect requires you to enable the USD currency under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Currencies]]''' or, prior to WHMCS 8.0, '''Setup > Payments > Currencies'''.</div>
  
 
===MarketConnect Management Page===
 
===MarketConnect Management Page===
  
 
The MarketConnect Management page in WHMCS provides you the three tools you'll need to get started:
 
The MarketConnect Management page in WHMCS provides you the three tools you'll need to get started:
* WHMCS MarketConnect login so your can connect to the WHMCS Marketplace
+
* A WHMCS MarketConnect login, so that you can connect to the WHMCS Marketplace.
* WHMCS Marketplace account balance and deposit functionality
+
* A WHMCS Marketplace account balance and deposit functionality.
* WHMCS MarketConnect Exclusive Service Provider Showcase. Each Exclusive Service Provider has their own unique portfolio of products, cost-price structures, activation settings and configuration controls.
+
* A WHMCS MarketConnect Exclusive Service Provider Showcase. Each Exclusive Service Provider has their own unique portfolio of products, cost-price structures, activation settings, and configuration controls.
 
 
Visit the MarketConnect Management page by navigating to Setup > MarketConnect in the Admin Area menu bar
 
 
 
[[File:MC_admin_nav.png|300px]]
 
 
 
<div class="docs-alert-info"><i class="fa fa-info-circle fa-fw"></i>&nbsp; If you do not see this option, make sure that your Admin Role has the "Manage MarketConnect" permission.</div>
 
  
 +
<div class="docs-alert-info"><i class="fa fa-info-circle fa-fw"></i>&nbsp; If you do not see this option, make sure that your [[Administrator Roles|admin role]] has the "Manage MarketConnect" permission.</div>
  
 
===Connecting WHMCS with the WHMCS Marketplace===
 
===Connecting WHMCS with the WHMCS Marketplace===
  
To utilize MarketConnect you first need to establish a link between your WHMCS installation and your WHMCS Marketplace account.  You may choose to make this association in one of three ways:
+
To use MarketConnect, you first need to establish a link between your WHMCS installation and your WHMCS Marketplace account.  You may choose to make this association in one of three ways:
  
* Using your pre-existing WHMCS Marketplace account
+
* Using your preexisting WHMCS Marketplace account.
* Using your pre-existing whmcs.com account
+
* Using your preexisting whmcs.com account.
* Registering a new WHMCS Marketplace account
+
* Registering a new WHMCS Marketplace account.
  
 
[[File:MC_login.png|405px]]
 
[[File:MC_login.png|405px]]
  
If you chose to use your pre-existing whmcs.com account, a new WHMCS Marketplace account will be created for you.  If you chose to directly register a new WHMCS Marketplace account you will receive an email confirmation from the Marketplace. Please make sure to follow up with that confirmation for seamless integration with the Marketplace.
+
If you chose to use your preexisting whmcs.com account, the system will create a new WHMCS Marketplace account.  If you chose to directly register a new WHMCS Marketplace account, you will receive an email confirmation. Make sure to complete the confirmation process for seamless integration with the Marketplace.
 +
 
 +
<div class="docs-alert-info">
 +
To ensure uninterrupted MarketConnect sales, you must ensure that your WHMCS Marketplace account always has sufficient funds. You can do this by [https://help.whmcs.com/m/marketconnect/l/739174-deposit-funds manually depositing funds] whenever your balance is low or by setting up '''[https://help.whmcs.com/m/marketconnect/l/1745394-set-up-automatic-balance-reloading Automatic Balance Reloading]''' to reload your account whenever it is below a set amount.
 +
</div>
  
 
===Exploring WHMCS MarketConnect Exclusive Service Provider Portfolios===
 
===Exploring WHMCS MarketConnect Exclusive Service Provider Portfolios===
  
Each WHMCS MarketConnect Exclusive Service Provider has their own portfolio which can be accessed by clicking the "Learn More" button within their listing.
+
Each WHMCS MarketConnect Exclusive Service Provider has their own portfolio. You can access this by clicking the "Learn More" button within their listing.
 
<div>
 
<div>
 
[[File:MC_learn_more_button.png|250px]][[File:MC_learn_more_dialog.png|550px]]
 
[[File:MC_learn_more_button.png|250px]][[File:MC_learn_more_dialog.png|550px]]
 
</div>
 
</div>
  
The portfolio will be presented within a shadow box and will have a multi-tab interface that allows you quick discovery and exploration of the Service Provider and their products. Each Service Provider portfolio is unique, but all portfolios provide you the following core artifacts:
+
The portfolio appears in a shadow box and will have a multi-tab interface that allows quick discovery and exploration of the Service Provider and their products. Each Service Provider portfolio is unique, but all portfolios provide you the following core artifacts:
* A brief abstract about the Service Provider
+
* A brief abstract about the Service Provider.
* List of available products and services available for resell from the Service Provider
+
* A list of available products and services available for resale from the Service Provider.
* The cost-price structure available through your Marketplace account
+
* The cost-price structure available through your Marketplace account.
  
 
===Activating WHMCS MarketConnect Exclusive Service Providers===
 
===Activating WHMCS MarketConnect Exclusive Service Providers===
In order to resell a Service Provider's products or services you must activate their service in WHMCS.  To activate the Service Provider open the portfolio via the "Start Selling" button.  This will open the portfolio and focus on the "Activate" tab where you click the "Activate Now" button.
+
In order to resell a Service Provider's products or services, you must activate their service in WHMCS.  To activate the Service Provider, open the portfolio via the "Start Selling" button.  This will open the portfolio and focus on the "Activate" tab, where you click the "Activate Now" button.
  
 
[[File:MC_activate_now.png|650px]]
 
[[File:MC_activate_now.png|650px]]
  
Upon activation, WHMCS MarketConnect will register you as a reseller with the Service Provider.  Following this, WHMCS MarketConnect will automatically setup the associated products and services within your WHMCS. Promotional and merchandising copy will be activated for your visitors and clients within the Client Area as well.
+
Upon activation, WHMCS MarketConnect will register you as a reseller with the Service Provider.  Following this, WHMCS MarketConnect will automatically set up the associated products and services within WHMCS. The system will activate promotional and merchandising copy for your visitors and clients within the Client Area as well.
  
If you wish to review and optimize how WHMCS MarketConnect will setup products, sale-price, and promotions within WHMCS before activation, you may do so through the "Advanced Mode" link on the activation tab of the portfolio.
+
If you wish to review and optimize how WHMCS MarketConnect will set up products, sale-price, and promotions within WHMCS before activation, you may do so through the "Advanced Mode" link on the activation tab of the portfolio.
  
Currently available providers are:
+
Currently, the available providers are:
 
* [[SSL_Certificates_via_WHMCS_MarketConnect|Symantec]]
 
* [[SSL_Certificates_via_WHMCS_MarketConnect|Symantec]]
 
* [[Weebly_via_WHMCS_MarketConnect|Weebly]]
 
* [[Weebly_via_WHMCS_MarketConnect|Weebly]]
 
* [[SpamExperts_via_WHMCS_MarketConnect|SpamExperts]]
 
* [[SpamExperts_via_WHMCS_MarketConnect|SpamExperts]]
 +
* [[SiteLock_via_WHMCS_MarketConnect|SiteLock]]
 +
* [[SiteLock_VPN_via_MarketConnect|SiteLock VPN]]<div class="docs-alert-info">SiteLock has discontinued SiteLock VPN and does not accept new orders.</div>
 +
* [[NordVPN_via_WHMCS_MarketConnect|NordVPN]]
 +
* [[CodeGuard_via_WHMCS_MarketConnect|CodeGuard]]
 +
* [[Marketgoo_via_WHMCS_MarketConnect|Marketgoo]]
 +
* [[OX_App_Suite_via_WHMCS_MarketConnect|OX App Suite]]
 +
* [[Web.com_Site_Builder_via_WHMCS_MarketConnect|Web.com Site Builder]]
 +
* [[XOVI_NOW_via_WHMCS_MarketConnect|XOVI NOW]]
 +
* [[360_Monitoring_via_WHMCS_MarketConnect|360 Monitoring]]
  
 
==Management and Customization==
 
==Management and Customization==
Line 69: Line 82:
 
===Managing Your Value-Added Services===
 
===Managing Your Value-Added Services===
  
Active Service Providers will display a "Manage" button in their listing on the MarketConnect Management page.
+
Active Service Providers will display a "Manage" button in their listing.
  
 
[[File:MC_manage_button.png|250px]]
 
[[File:MC_manage_button.png|250px]]
  
Click the "Manage" button to open the respective management panel.  Each Service Provider will have unique management options organized within a multi-tab interface. All provide you with following core controls:
+
Click the "Manage" button to open the respective management panel.  Each Service Provider will have unique management options within a multi-tab interface. These provide you with the following core controls:
* Products & Services configuration & settings for WHMCS
+
 
* Promotion & Merchandising settings for the Client Area
+
* Products & Services configuration and settings for WHMCS.
 +
* Promotion & Merchandising settings for the Client Area.
  
 
[[File:MC_manage_dialog.png|550px]]
 
[[File:MC_manage_dialog.png|550px]]
 
[[File:MC_manage_promotions.png|551px]]
 
[[File:MC_manage_promotions.png|551px]]
 +
 +
===Pricing===
 +
To view your cost price and set pricing for each product,  visit the '''Products''' tab and click the edit icon. You will then be able to define your required selling price and, if applicable, enable the billing cycles you wish to offer.
 +
 +
[[File:Mc-pricing.png|650px]]
 +
 +
===Landing Pages===
 +
When you activate a service, the system will create ready-made landing pages that provide ready-made sales information and direct access to the order flow. The URL of the landing pages depends on the Friendly URL Setting. For example, if you use Full Friendly URLs, the URL format would be:
 +
 +
* https://www.example.com/whmcs/store/website-builder
 +
* https://www.example.com/whmcs/store/ssl-certificates
 +
* https://www.example.com/whmcs/store/email-services
 +
 +
Replace example.com in the examples above with your own domain name.
 +
 +
By default, the system adds links to these pages to the '''Store''' primary navigation menu when you activate the service. You can add or remove these links under the ''Other Settings'' tab when managing a service.
  
 
===Customizing Promotion & Merchandising===
 
===Customizing Promotion & Merchandising===
Client Area promotion and merchandising content can be customized or extended through template modifications and hooks.
+
You can customize or extend Client Area promotion and merchandising content through template modifications and hooks.
  
====Templates====
+
====Order Form Templates====
All templates related to products and service provisioned with WHMCS MarketConnect can be found the the "store" directory of the Six theme. Once you have updated your Six theme and have that directory, simple make your desired changes to your theme as described in the developer [http://developers.whmcs.com/themes/ Themes documentation].
+
 +
All of the order form templates for products and service that you provision with WHMCS MarketConnect are in the <tt>store</tt> directory of your system theme. After you update your system theme, copy the files from the <tt>store</tt> directory into your custom order form template. Then, you can make the desired changes to your system theme templates using our [http://developers.whmcs.com/themes/ Themes] documentation.
  
 
====Promotions and Upsells====
 
====Promotions and Upsells====
MarketConnect Promotions and Upsells content can be manipulated and modified using hooks. Replace all the given phrases with your customised values. Details and example code is available on this page: [[Customising_MarketConnect_Promotions_and_Upsells]].
+
You can manipulate and modify MarketConnect Promotions and Upsells content using hooks. Replace all the given phrases with your customised values. Details and example code is available on this page:  
 +
[https://marketplace.whmcs.com/help/connect/kb/overview/general/customisation_and_localisation_of_promotions Customisation and Localisation of Promotions].
  
 
====Hooks====
 
====Hooks====
WHMCS MarketConnect utilizes the standard hooks and rendering workflow of the Client Area.  You may leverage any existing hook point to tailor the workflow or navigation to your specification as described in the developer [http://developers.whmcs.com/themes/ Themes documentation].
+
WHMCS MarketConnect utilizes the standard hooks and rendering workflow of the Client Area.  You may leverage any existing hook point to tailor the workflow or navigation to your specification using our developer [http://developers.whmcs.com/themes/ Themes documentation].

Latest revision as of 22:32, 17 November 2023

We added this feature in WHMCS 7.2.

WHMCS MarketConnect is a platform through which you can resell products and services to your customers via your WHMCS installation. WHMCS MarketConnect can automatically set up and configure these products as well as populate the Client Area with merchandising content and upsell recommendations.

You can activate and configure WHMCS MarketConnect at Configuration () > System Settings > MarketConnect or, prior to WHMCS 8.0, Setup > MarketConnect.

Getting Started

You can offer products and service via WHMCS MarketConnect with as few as three simple steps from within your Admin Area.

  • Visit the MarketConnect Management page in the Admin Area.
  • Connect your WHMCS installation with the WHMCS Marketplace.
  • Activate the Service Provider whose products you wish to resell to your clients.

Upon activating a Service Provider, the system will automatically set up products and their configuration in your WHMCS installation for you. Additionally, it will activate promotional and merchandising copy for your visitors and clients within the Client Area.

MarketConnect requires you to enable the USD currency under Configuration () > System Settings > Currencies or, prior to WHMCS 8.0, Setup > Payments > Currencies.

MarketConnect Management Page

The MarketConnect Management page in WHMCS provides you the three tools you'll need to get started:

  • A WHMCS MarketConnect login, so that you can connect to the WHMCS Marketplace.
  • A WHMCS Marketplace account balance and deposit functionality.
  • A WHMCS MarketConnect Exclusive Service Provider Showcase. Each Exclusive Service Provider has their own unique portfolio of products, cost-price structures, activation settings, and configuration controls.
  If you do not see this option, make sure that your admin role has the "Manage MarketConnect" permission.

Connecting WHMCS with the WHMCS Marketplace

To use MarketConnect, you first need to establish a link between your WHMCS installation and your WHMCS Marketplace account. You may choose to make this association in one of three ways:

  • Using your preexisting WHMCS Marketplace account.
  • Using your preexisting whmcs.com account.
  • Registering a new WHMCS Marketplace account.

MC login.png

If you chose to use your preexisting whmcs.com account, the system will create a new WHMCS Marketplace account. If you chose to directly register a new WHMCS Marketplace account, you will receive an email confirmation. Make sure to complete the confirmation process for seamless integration with the Marketplace.

To ensure uninterrupted MarketConnect sales, you must ensure that your WHMCS Marketplace account always has sufficient funds. You can do this by manually depositing funds whenever your balance is low or by setting up Automatic Balance Reloading to reload your account whenever it is below a set amount.

Exploring WHMCS MarketConnect Exclusive Service Provider Portfolios

Each WHMCS MarketConnect Exclusive Service Provider has their own portfolio. You can access this by clicking the "Learn More" button within their listing.

MC learn more button.pngMC learn more dialog.png

The portfolio appears in a shadow box and will have a multi-tab interface that allows quick discovery and exploration of the Service Provider and their products. Each Service Provider portfolio is unique, but all portfolios provide you the following core artifacts:

  • A brief abstract about the Service Provider.
  • A list of available products and services available for resale from the Service Provider.
  • The cost-price structure available through your Marketplace account.

Activating WHMCS MarketConnect Exclusive Service Providers

In order to resell a Service Provider's products or services, you must activate their service in WHMCS. To activate the Service Provider, open the portfolio via the "Start Selling" button. This will open the portfolio and focus on the "Activate" tab, where you click the "Activate Now" button.

MC activate now.png

Upon activation, WHMCS MarketConnect will register you as a reseller with the Service Provider. Following this, WHMCS MarketConnect will automatically set up the associated products and services within WHMCS. The system will activate promotional and merchandising copy for your visitors and clients within the Client Area as well.

If you wish to review and optimize how WHMCS MarketConnect will set up products, sale-price, and promotions within WHMCS before activation, you may do so through the "Advanced Mode" link on the activation tab of the portfolio.

Currently, the available providers are:

Management and Customization

Managing Your Value-Added Services

Active Service Providers will display a "Manage" button in their listing.

MC manage button.png

Click the "Manage" button to open the respective management panel. Each Service Provider will have unique management options within a multi-tab interface. These provide you with the following core controls:

  • Products & Services configuration and settings for WHMCS.
  • Promotion & Merchandising settings for the Client Area.

MC manage dialog.png MC manage promotions.png

Pricing

To view your cost price and set pricing for each product, visit the Products tab and click the edit icon. You will then be able to define your required selling price and, if applicable, enable the billing cycles you wish to offer.

Mc-pricing.png

Landing Pages

When you activate a service, the system will create ready-made landing pages that provide ready-made sales information and direct access to the order flow. The URL of the landing pages depends on the Friendly URL Setting. For example, if you use Full Friendly URLs, the URL format would be:

Replace example.com in the examples above with your own domain name.

By default, the system adds links to these pages to the Store primary navigation menu when you activate the service. You can add or remove these links under the Other Settings tab when managing a service.

Customizing Promotion & Merchandising

You can customize or extend Client Area promotion and merchandising content through template modifications and hooks.

Order Form Templates

All of the order form templates for products and service that you provision with WHMCS MarketConnect are in the store directory of your system theme. After you update your system theme, copy the files from the store directory into your custom order form template. Then, you can make the desired changes to your system theme templates using our Themes documentation.

Promotions and Upsells

You can manipulate and modify MarketConnect Promotions and Upsells content using hooks. Replace all the given phrases with your customised values. Details and example code is available on this page: Customisation and Localisation of Promotions.

Hooks

WHMCS MarketConnect utilizes the standard hooks and rendering workflow of the Client Area. You may leverage any existing hook point to tailor the workflow or navigation to your specification using our developer Themes documentation.