Iubenda logo
Start generating

Documentation

Table of Contents

iubenda All-in-one Compliance – WordPress plugin

Let us introduce you to our new All-in-one Compliance for GDPR / CCPA Cookie Consent WordPress plugin. A totally revamped solution that allows you to manage all of the iubenda compliance solutions to give you access to everything you need!

The iubenda plugin is an all-in-one, extremely easy-to-use 360° compliance solution that quickly scans your site and auto-configures to match your specific setup. It supports multiple legislation and minimizes the need for code copy-pasting.

 All-in-one Compliance for GDPR / CCPA Cookie Consent

Functionality

  • Our WP cookie plugin automatically scans your site and auto-configures the solutions needed to match your site’s specific needs.
  • Provides a fully customizable cookie banner/consent banner, manages cookie consent, and stores legally required GDPR consent proofs for cookies.
  • Manages CCPA notice with working DNSMPI link
  • Compatible with IABs TCF to maximize ad earning.
  • Allows you to generate a fully customizable privacy and cookie policy quickly.
  • Auto-detect user location and auto-applies the correct data privacy settings (needed if you have users from multiple regions like the US and the EU).
  • Capture, store and manage GDPR consent records for your webforms.
  • Allows the manual blocking of all other resources without direct intervention on the scripts.
  • It displays a clean page (without a cookie banner/consent banner) to users who have already provided their consent.
  • It detects bots/spiders and serves them a clean page.
  • It supports the auto-assignment of categories when blocking scripts.
  • It supports AMP pages.
  • Effortlessly generate professional Terms and Conditions to protect you from liabilities and more.
  • Translate all documents with a single click (15 languages supported).

Our solutions are fully responsive (perfect for all screen sizes) and WCAG Level AAA Compliant.

  • AdRoll
  • AddThis widgets
  • Bing
  • CodePen
  • Criteo
  • Disqus
  • Elevio
  • Facebook Comments
  • Facebook widgets
  • Freshchat
  • Google AdSense
  • Google Analytics
  • Google Maps
  • Google Site Search
  • Google oAuth
  • Google+ widgets
  • Headway
  • Instagram widgets
  • Kissmetrics
  • LinkedIn widgets
  • Mixpanel
  • Neodata
  • Olark
  • Optimizely
  • Outbrain
  • PayPal widgets
  • Pingdom
  • Pinterest widgets
  • Segment
  • ShareThis widgets
  • Twitter widgets
  • UserVoice
  • Vimeo
  • YouTube

Requirements

  • WordPress 5.0 or higher
  • PHP 7.0.0 or higher

How to start

To begin, you can either download the plugin from the WordPress plugin repository and add it manually to your WordPress installation or access the administration panel within WordPress and click on Plugins > Add New Plugin > iubenda | All-in-one Compliance for GDPR / CCPA Cookie Consent + more.
Then install and activate it.

Once activated, head to iubenda in your WP admin panel.

How to use

Once there, you’ll see a page like the one below in loading. Our WP plugin scans your site and provides a rating based on your site’s specific needs.

iubenda rating

On this page, you can find your site’s compliance elements summarized.
Then, click on “Help me get compliant” to proceed.

Now you can start from scratch with iubenda solutions, or if you already use some of our products, you can directly synchronize them with our plugin.

installation
👀 Already using our products?

If you already use iubenda products for the site you want to manage with our WP plugin, you can skip straight to -> Synchronize your iubenda account with the WP plugin.

New users – Configure your products from scratch

To set up the plugin, you will be asked to choose the language of your website and then click continue.

🔎 Multilanguage website?

Choose the main language of your site, you can easily add the other languages in the following steps. For more information you can read our guide on multilingual WordPress Sites.

Finally, you will need to enter the website and email address.

quick generator

Great, we’ve now created an account on iubenda.com and generated the essentials you need to proceed. You’ll receive an email to complete your account configuration, but you can still continue to configure the plugin.

Set up your Cookie banner/consent banner (and add the privacy policy button)

You’re now ready to set up your cookie banner/consent banner. In this step, you can select the main elements of the banner, such as the:

  • Banner’s position and theme
  • The legislation with which you need to comply. Doubts? Find here what you need to comply with.
  • Enable IAB TCF options (recommended if you run ads on your site).
  • Enable Google AMP support
  • Automatically block scripts detected by the plugin and set
🔎 Want to customize more?

After the first set up, you can customize all the aspect and behavior of the cookie banner/consent banner with our Privacy Controls and Cookie Solution configurator. For more info read here

cookie banner setup

After setting up your Privacy Controls and Cookie Solution, you can add your privacy policy button, choosing the style and the button position.

synchronize products

When you’re done, click on Integrate.

You have now completed the basic configuration of the cookie banner/consent banner and added the privacy policy button.
From the plugin dashboard, you will be able to configure and manage the products you have activated or add new ones.

To find out how to configure your products, you can read the specific section of this guide.

Synchronize your already set up iubenda products with the WP plugin

If you have already activated some iubenda products, on the first step of the configuration process, click on “I’ve already made the set up on iubenda.com.”

synchronize cookie solution

Then, paste the embed code of your Privacy Controls and Cookie Solution (required) and other products you have set up in your iubenda account, and that’s it. Our plugin will automatically synchronize your products within the plugin.

iubenda All-in-one plugin dashboard

Once you finish the first setup, you’ll have complete control of all the iubenda products you can manage and integrate within the plugin.

plugin dashboard

Learn how to configure the products available for the plugin below:

Privacy Controls and Cookie Solution

The simplified cookie banner/consent banner settings already ensure seamless operation, but you may want to customize your banner’s behavior and aspect thoroughly.
To do that, click on the configure button within the Privacy Controls and Cookie Solution area, then select Manual embed. Next, see the collapsible element below for advanced configuration options.

Next, you can configure the cookie banner/consent banner directly in our configurator here.
You can check our complete guide on the Privacy Controls and Cookie Solution for more information.

Finally, paste the embed code and click save settings in the bottom-right of the page.

Automated prior-blocking of scripts

Our WP plugin will also recognize and automatically detect and block the cookies indicated in the above block list on your site.

Important

Our WordPress plugin automatically blocks scripts that are generated on the server side (therefore returned by PHP by WordPress). Scripts that are inserted into the page via JavaScript after the loading process of that page are not and cannot be blocked automatically.

These scripts can be blocked by entering the source into the Custom Script boxes in the plugin console or by using the manual wrapping method illustrated in the example below and (in more detail) in this help post

Blocking custom scripts from within the console

The Custom Scripts field makes it easy for you to block scripts inserted into the page directly from within the plugin console. This dramatically reduces the need for direct edits to the site’s code.

Here’s how to do it:

  • In the left menu within your administration panel, click on iubenda.
  • Next, click on configure in the Privacy Controls and Cookie Solution area and scroll down to find the Blocked domains setting.Wordpress custom and iframe scripts fields
  • Enter your script or iframe sources as needed, assign their purpose (optional), and click the Save Changes button at the bottom-left of the page.

Usage Examples

Using these fields is pretty straightforward. Simply enter the script or iframe src attribute you’d like to block.

Script

If you wanted to block a social button (which inserts scripts into the page via JavaScript), you’d simply need to enter the script source, e.g. connect.socialwebsite.net/en_US/track.js into the scripts field.

iframe

Let’s say you wanted to block scripts inserted into the page via the following iframe

What you’ll need to enter into the iframe field would be videowebsite.com/embed/ as this is the actual source of the scripts. Be careful NOT to enter the component id (videowebsite.com/embed/xxFhMChxx) to ensure that all scripts coming from the actual source are blocked.

Manual Use (wrapping method)

This method requires you to modify your site’s code directly. As explained below, you’ll need to go into the relevant section of your site’s code and add the scripts to be blocked.

For example, a conversion pixel for Google Ads would be handled this way:






If you’ve enabled the per-category consent feature, you’ll need to assign the purpose. Resuming the previous example, being part of the “Targeting & Advertising” purpose (id 5):


      
      
      

If there are HTML / IMG / IFRAME elements, you will need to do it this way: