Documentation index

Cookie solution ›

How to use the iubenda Cookie Solution plugin for WordPress to automate the blocking of scripts


The WordPress plugin by iubenda allows you to automate the implementation of cookie law regulations, thus drastically reducing the need for direct interventions in the code of the site.

Note:

We’re happy to receive feedback, the best option at the moment is this forum by Uservoice.

  • The iubenda Cookie Solution requires at least jQuery 1.4.4 at the moment
  • The plugin doesn’t need PHP 5.3, but certainly works better with versions of that number or later.

newsletter illustration copy

Functionality

  • The plugin automatically adds the iubenda code to all the pages of a site (to the HEAD section)
  • Automatically blocks more common scripts such as:
    • Facebook widgets
    • Twitter widgets
    • Google+ widgets
    • Google AdSense
    • YouTube widgets
    • AddThis widgets
    • ShareThis widgets
  • Allows the manual blocking of all other resources without direct intervention on the actual scripts
  • Manages the visualization of the banner and of the cookie policy, as well as the saving of the consent preferences by the users regarding the installation of cookies
  • Allows the management of the iubenda Cookie Solution for multilingual sites using WPML. More information regarding this can be found in this article
  • It displays a clean page (without banner) to users who have already provided their consent
  • It detects bots/spiders and serves them a clean page

Instructions

  1. Download the plugin from the WordPress plugin repository. Access the administration panel within WordPress and click on Plugin > Add New Plugin > iubenda Cookie Solution. Then install and activate it.
  2. Once it’s been installed, access the Settings panel where you’ll be asked to fill in the script that was generated in your iubenda account when you activated the cookie policy and the iubenda Cookie Solution (if you haven’t please do so now). For more information on how to activate the iubenda Cookie Solution, consult this guide: https://www.iubenda.com/help/posts/1177
  3. At this point the plugin will start to show the banner that your cookie policy will link to users who visit for the first time without the need for further configuration
  4. In addition, the plugin automatically recognizes and blocks cookies from third parties as listed above
  5. The other scripts for which there isn’t an automatic block yet – and that install cookies that require blocking prior to user consent – should be “wrapped” using these comments:
<!--IUB_COOKIE_POLICY_START-->
<!--IUB_COOKIE_POLICY_END-->

For example a conversion pixel for AdWords would be handled this way:

<!--IUB_COOKIE_POLICY_START-->
<script type="text/javascript">
    /* <![CDATA[ */
    var google_conversion_id =CONVERSION_ID;
    var google_conversion_label = "CONVERSION-LABEL";
    var google_custom_params = window.google_tag_params;
    var google_remarketing_only = true;
    /* ]]> */
</script>
<script type="text/javascript" src="//www.googleadservices.com/pagead/conversion.js">
</script>
<noscript>
    <div style="display:inline;">
        <img height="1" width="1" style="border-style:none;" alt="" src="//googleads.g.doubleclick.net/pagead/viewthroughconversion/1030205862/?value=0&amp;guid=ON&amp;script=0"/>
    </div>
</noscript>
<!--IUB_COOKIE_POLICY_END-->

If however there are parts of HTML / IMG / IFRAME, you’ll need to take these steps:

<!--IUB_COOKIE_POLICY_START-->
<iframe src="...
<img src=" width="300" height="150">
<!--IUB_COOKIE_POLICY_END-->
  1. For WordPress posts (as opposed to the above template level as for example footer.php) there are shortcodes available:
[iub-cookie-policy]
[/iub-cookie-policy]
  1. In the event of continued browsing by the user, the latter’s cookie use preference will be set to “yes” thereby removing the banner and releasing the cookies. Moreover, banners and blocking codes will not be delivered on the user’s subsequent visits since consent is registered as granted (these preferences will update at each visit).

Further information

For API calls and xmlrpc we suggest the following parameter ?iub_no_parse=1: this will place the iubenda script in a disactivated state and therefore avoids all parsing/replacing operations.

Download the plugin and use it!

Note:

We’re happy to receive feedback, the best option at the moment is this forum by Uservoice.

  • The iubenda Cookie Solution requires at least jQuery 1.4.4 at the moment
  • The plugin doesn’t need PHP 5.3, but certainly works better with versions of that number or later.

What are the compliance obligations for different cookie typologies?

We’ve prepared a Table (italian only) to better understand which categories of cookies require the banner, preemptive consent, notification to the appropriate regulatory body and so on.

How to install a Beta version of the Plugin

We often provide updated versions of our plugin which are unstable during the testing phase as Beta versions are.

To install a Beta version of the plugin, the first thing to do is install an external plugin called “WP Rollback”, which allows you to select an unofficial version of our plugin.

WP Rollback installation

Please note: WP Rollback requires a WordPress version above 4.0.

As for other plugins, you can install WP Rollback by accessing the Plugin area in your WordPress admin panel and clicking on “Add new”; from here you can search for “WP Rollback” and install it.

After the installation and activation, it will be necessary to go back to the page in which all the installed plugins are listed. Here you’ll notice that “Rollback” will have appeared next to every entry.

All that needs to be done now is to look for the “iubenda Cookie Solution” plugin and click on the “Rollback” entry. Here you’ll find all the different versions of the plugin; the version currently in use will be labelled “installed version”, while the Beta versions will be labeled as such.

To install and test the Beta version of the plugin, simply click on the Beta entry you wish to use. This will cause the current version of the Plugin to be overwritten by the Beta version; to revert the process, the same process will have to be undertaken, the difference being the selecting of the previous stable version and not the Beta one.

How to signal a bug or request support

To signal a bug please visit the following link and provide a clear and detailed description of the problem:
support.iubenda.com/forums/314835-general/suggestions/9670701-discussion-regarding-the-iubenda-cookie-law-soluti

It’s always useful to attach the debug information provided by WordPress along with your request for support. To access the debug information, you must open the WordPress installation folder and look for the file named wp-config.php.

Once inside, please look for the following line:

  define('WP_DEBUG', false);

Modify it to:

  define('WP_DEBUG', true);

Once the file saved, open a page on your WordPress and the debug information will start to appear. Keep our plugin active and send us any errors or messages shown by WordPress.


Still have questions?

Visit our support forum Email us