header-logo

Knowledgebase

Customisation and Localisation of Promotions

In WHMCS 7.6 and later, MarketConnect promotions and upsell content can be customised and translated via language files.

Customising and Translating the Content

An example promotional banner for SSL is shown below.

Let's begin by breaking this down into the individual parts that create the promotional content:

In this example, the promotion is for SSL, it is a promotion (not an upsell), and it is for the RapidSSL product.  These pieces of information are important when it comes to building the language string name you will need to use in a language file to customise the content.

Below is the structure of a MarketConnect promotional language string.  It contains these five parts:

  1. The first element is always 'store'. It represents the namespace used for all MarketConnect language strings.
  2. The second element contains the product type. In WHMCS 8.0 and later, this can be symantec, weebly, spamexpertssitelock, or codeguard.
  3. The third element is the promotion type. Promotions are the banners and content displayed to users who have not yet purchased one of the MarketConnect services. Upsells are the banners and content displayed to users when there is a recommended upgrade to the product they currently have. Valid values for this element are promo or upsell.
  4. The fourth element is the product name and in the format service_product. In this example, it's the rapidssl_rapidssl product.
  5. The fifth element is the element name for the promotional content to be modified. Valid values for this include: headline, tagline, description, feature1, feature2, feature3, feature4, and cta.

As with all language customisations, we recommend that you create an override file to ensure that your customisations are preserved in future upgrades. For more information, see our Languages Overrides developer documentation.

After you add the lines to the language file, it should resemble this example:

$ cat lang/overrides/english.php 
<?php
/**
 * Language Override File
 * English (en)
 */
$_LANG['store']['symantec']['promo']['rapidssl_rapidssl']['headline'] = 'Add SSL to your website';
$_LANG['store']['symantec']['promo']['rapidssl_rapidssl']['tagline'] = 'with the #1 choice in SSL Certificates';
$_LANG['store']['symantec']['promo']['rapidssl_rapidssl']['feature1'] = 'Add the padlock to your website';
$_LANG['store']['symantec']['promo']['rapidssl_rapidssl']['feature2'] = 'Avoid Chrome Security Warnings';
$_LANG['store']['symantec']['promo']['rapidssl_rapidssl']['feature3'] = 'Protect your customers' privacy';
$_LANG['store']['symantec']['promo']['rapidssl_rapidssl']['feature4'] = 'Secure your website';
$_LANG['store']['symantec']['promo']['rapidssl_rapidssl']['cta'] = 'Act now, add';

When you refresh the client area page, the promotion should now appear similar to this example:

Differentiating Upsells and Promos

The following definitions should aid in deciding whether to use "upsell" or "promo" in your language string when translating the  content.

Promo

Use "Promo" when you display a promotion for a product that the customer does not yet own.

For example, if the customer currently has no RapidSSL products in their account and they see a promotion for a RapidSSL certificate, this is considered a "promo" to promote that product.

Upsell

Use "Upsell" when you display a promotion for a product that the customer already owns.

For example, if the customer has a Weebly  Lite plan in their account and they see a promotion for another more expensive Weebly product (for example, Weebly Pro), this would be considered an "upsell". 

Supported Product Types and Product Names

SSL Certificates

Product Name Value Product
rapidssl_rapidssl
RapidSSL Certificate
rapidssl_wildcard
RapidSSL Wildcard
geotrust_quickssl
GeoCert QuickSSL
geotrust_quicksslpremium
GeoTrust QuickSSL Premium
geotrust_quicksslpremiumwildcard
GeoTrust QuickSSL Premium Wildcard
geotrust_truebizid
GeoTrust True BusinessID
geotrust_truebizidev
GeoTrust True Business ID with EV
geotrust_truebizidwildcard
GeoTrust True Business ID Wildcard
digicert_securesite
DigiCert Secure Site
digicert_securesitepro
DigiCert Secure Site Pro
digicert_securesiteev
DigiCert Secure Site EV
digicert_securesiteproev
DigiCert Secure Site Pro EV

 Weebly

Product Name Value Product
weebly_lite
Weebly Lite (7.9 and below)
weebly_free Weebly Free (7.10 and above)
weebly_starter
Weebly Starter
weebly_pro
Weebly Pro
weebly_business
Weebly Business
weebly_performance
Weebly Performance

 SpamExperts

Product Name Value Product
spamexperts_incoming
SpamExperts Incoming
spamexperts_outgoing
SpamExperts Outgoing
spamexperts_incomingoutgoing
SpamExperts Incoming/Outgoing
spamexperts_incomingarchiving
SpamExperts Incoming Archiving
spamexperts_outgoingarchiving
SpamExperts Outgoing Archiving
spamexperts_incomingoutgoingarchiving
SpamExperts Incoming & Outgoing Archiving

 SiteLock

Product Name Value Product
sitelock_lite
Sitelock Lite
sitelock_find
Sitelock Find
sitelock_fix
Sitelock Fix
sitelock_defend
Sitelock Defend
sitelock_emergency
Sitelock Emergency

SiteLock VPN

Product Name Value
Product
sitelockvpn_standard SiteLock VPN

 CodeGuard

Product Name Value Product
codeguard_lite
CodeGuard Lite
codeguard_personal
CodeGuard Personal
codeguard_professional
CodeGuard Professional
codeguard_business
CodeGuard Business
codeguard_businessplus
CodeGuard Business Plus
codeguard_power
CodeGuard Power
codeguard_powerplus
CodeGuard Power Plus

marketgoo

Product Name Value
Product
marketgoo_lite marktegoo Lite
marketgoo_pro marketgoo Pro

If you have any questions or need assistance identifying the language strings to use for your particular use case, contact our support team.