Customising MarketConnect Promotions and Upsells - Revision history

John at 09:59, 30 August 2018

2018-08-30T09:59:03Z

John: /* Installing the hook */

2018-04-16T10:05:33Z

‎Installing the hook

Matt at 11:29, 15 June 2017

2017-06-15T11:29:32Z

Matt: Created page with "MarketConnect Promotions and Upsells content can be manipulated and modified using hooks. An example of such a hook is provided below. ==Installing the hook== To install th..."

2017-05-17T16:04:49Z

Created page with "MarketConnect Promotions and Upsells content can be manipulated and modified using hooks. An example of such a hook is provided below. ==Installing the hook== To install th..."

New page

MarketConnect Promotions and Upsells content can be manipulated and modified using hooks.

An example of such a hook is provided below.

==Installing the hook==

To install the hook, copy and paste the code below into a new file and save and upload it to the ''includes/hooks/'' directory of your WHMCS installation.

<source lang="php">
<?php

add_hook('ClientAreaFooterOutput', 1, function() {
return <<<EOF
<script>

var hashtable = {};
hashtable['Protect your website'] = 'Protect your domain';
hashtable['Included with your SSL certificate'] = 'What you get with your SSL Certificate';
hashtable['Display a security seal on your site'] = 'Display a site seal to add trust';

$(document).ready(function() {
$('.promo-banner').each(function( index ) {
var banner = $(this);
$.each(hashtable, function( index, value ) {
banner.html(banner.html().replace(index, value));
});
});
});
</script>
EOF;
});

</source>

==How it works==

The hook works by looping through each promotional banner displayed on the page and replacing all the given phrases with their replacement values.

You can add as many different search and replace values as you wish, simply by adding additional hashtable lines. Their format is as follows:

<source lang="php">
hashtable['Phrase to look for'] = 'Phrase to replace with';
</source>

← Older revision		Revision as of 09:59, 30 August 2018
Line 5:		Line 5:
	==Promotions and Upsells==		==Promotions and Upsells==

		+	<div class="docs-alert-warning">
		+	<span class="title">Note:</span><br />
		+	This documentation apples only to WHMCS version 7.5 and earlier. For version 7.6 and later refer to [https://marketplace.whmcs.com/help/connect/kb/overview/general/customisation_and_localisation_of_promotions these instructions].
		+	</div>
	MarketConnect Promotions and Upsells displayed within the client area and shopping content can be manipulated and modified using hooks.		MarketConnect Promotions and Upsells displayed within the client area and shopping content can be manipulated and modified using hooks.

@@ Line 26: / Line 26: @@
 $(document).ready(function() {
-     $('.promo-banner').each(function( index ) {
+     $('.promo-banner,.addon-promo-container').each(function( index ) {
          var banner = $(this);
          $.each(hashtable, function( index, value ) {

@@ Line 1: / Line 1: @@
-MarketConnect Promotions and Upsells content can be manipulated and modified using hooks.
+==Landing Pages==
-An example of such a hook is provided below.
+The MarketConnect landing pages are controlled by template files and can be customised by editing the files located within the ''store'' directory of your active WHMCS template.
-==Installing the hook==
+==Promotions and Upsells==
 To install the hook, copy and paste the code below into a new file and save and upload it to the ''includes/hooks/'' directory of your WHMCS installation.
@@ Line 33: / Line 39: @@
 </source>
-==How it works==
+===How it works===
 The hook works by looping through each promotional banner displayed on the page and replacing all the given phrases with their replacement values.
@@ Line 41: / Line 47: @@
 <source lang="php">
 hashtable['Phrase to look for'] = 'Phrase to replace with';
 </source>