How do I use the cookie consent popup?

Notice: The Cookie Consent Popup functionality will only work on approved SwiftModders WHMCS Themes. It will not affect default WHMCS or other third-party WHMCS themes.

As of version 1.1.0 of the SwiftModders WHMCS Theme Installer, you will have the option to turn on the Cookie Consent Popup for your SwiftModders WHMCS Theme. To take advantage of this functionality, please read through the following guide.

Setting up the Cookie Consent Popup

By default, the Cookie Consent Popup will be disabled for your theme. You will need to login to your WHMCS Admin panel and navigate to “Addons” > “SwiftModders WHMCS Theme Installer.” Once the Theme Installer is loaded, you can select the “Configuration” option from the module menu.

Clicking the toggle for the “Enable Cookie Consent Popup” will activate the cookie consent message with the predefined settings above. Before enabling, it might be best to configure the various options here so that your clients will see the messaging you want. Here are the options you can configure:

  • Cookie Message: This is the cookie message that will display to first-time users of your WHMCS installation. It is recommended that this message generally explain what you’re using cookies for and the agreement in place for new users. This message field will also support <a>, <strong>, <em>, and <br> tags for more flexibility.
  • Cookie Accept Label: By default, a button with the label “Accept” will be present for your users to click. You can change the English label in this field directly. Once clicked, the cookie consent popup will disappear. Please note that the popup will not return for users unless they clear their Local Storage or use another device.
  • Cookie Information URL: If you have a specific URL that houses your cookie/privacy policy information, you should enter it here.
  • Cookie Information Label: This will be the label for the Cookie Information URL button. If you leave this field blank, no button will be rendered.

The above options assume that you’re using English as your primary language and will only impact your users/clients with the English set as their language. If you wish to translate this for your users with different language needs, you will need to create a new language file in:

/yourwhmcsinstall/modules/addons/swiftmodders/lang/

You will need to name the language file to one of the supported languages in WHMCS. In the default “english.php” file, you will find the following variables:

// Cookie Message
$_ADDONLANG['cookieMessage'] = 'We use cookies to <strong>support</strong> and <strong>improve</strong> your experience on our website. By using this website you agree to our cookie policy.';
$_ADDONLANG['cookieAccept'] = 'Accept';
$_ADDONLANG['cookieUrlLabel'] = 'Learn More';

You will copy these variables into the language file you’ve created and translate where appropriate.

For more information on how to edit languages in WHMCS, please read their language documentation.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.