Directory / plugin

ClearCrumb – Cookie Consent & GDPR Cookie Banner

v1.1.0 · by ClearCrumb

Fast, accessible cookie banner with script blocking, Google Consent Mode v2, consent log, GPC and EU/US rules. No pageview limits.

About this plugin

ClearCrumb shows a fast, accessible cookie banner and stores each visitor’s choice in their own browser.

  • Auto-blocking: your services’ scripts and embeds wait for consent, even on cached pages.
  • Switching? Import your settings from Complianz, CookieYes or Cookiebot.
  • A two-minute setup wizard: regions, scan, services, design.
  • Works with WPML, Polylang and TranslatePress.
  • Banner in 16 languages (EN, DE, FR, NL, ES, IT, PT, PL, SV, DA, FI, NO, CS, RO, AR, HE), picked from your site language, right-to-left included.
  • A cookie policy page that keeps itself up to date: [clearcrumb_cookie_policy], in English, German, French, Dutch, Spanish and Italian.
  • A cookie scanner that checks up to 50 pages and finds the services your site uses.
  • A Leak Test that shows what still loads before consent.
  • A Compliance Score from 0 to 100 that tells you what to fix.
  • A consent checkbox for Contact Form 7 and WPForms forms.
  • A consent log in your own database: proof of every choice, kept as long as you choose (30 days to forever), with hashed IDs and IPs, and a CSV export.
  • Region rules: GDPR opt-in for the EU, EEA, UK and Switzerland, US opt-out with Global Privacy Control.
  • Google Consent Mode v2 (basic and advanced), Microsoft UET Consent Mode, Meta Pixel and TikTok Pixel consent APIs and the WP Consent API.
  • Placeholders for blocked videos and maps, with a locally stored thumbnail and a “Load video” button.
  • A library of 155 common services with their cookies, so visitors see who is behind each choice.
  • Four banner layouts and six design styles, with a live preview while you edit.
  • Accept, Reject and Preferences with four categories: necessary, preferences, statistics and marketing.
  • Reject always looks exactly like Accept. Saying no is never harder than saying yes.
  • A floating “cookie settings” button and a [clearcrumb_preferences] shortcode, so visitors can change their mind at any time.
  • Small and quick: no jQuery, no external requests, the banner script loads deferred.
  • Settings export and import as a JSON file, to set up your next site in seconds.
  • WP-CLI commands: wp clearcrumb scan and wp clearcrumb log export.
  • A dashboard widget with this week’s consent rate.
  • Block-editor blocks: Cookie policy and Cookie settings link.
  • Keyboard and screen-reader friendly (WCAG 2.2 AA target).

ClearCrumb helps you meet cookie rules but is not legal advice.

For developers

window.ClearCrumb.get() returns the visitor's choice (or `null`), `ClearCrumb.has( 'statistics' )` checks one category, and `ClearCrumb.open()` opens the preferences. Every saved choice fires a `clearcrumb:consent` event on `document`.

Source code & build

Everything ships readable. The banner scripts and styles sit next to their minified copies (assets/js/guard.js, assets/js/banner.js, assets/css/banner.css). The admin app’s source is in src/admin/, with the build tools in src/tools/. To rebuild assets/admin/ and the .min files, run this inside the plugin’s src folder (Node.js 18 or newer):

npm install && npm run build

External services

ClearCrumb sends nothing about your visitors anywhere. Your server contacts two services only to fetch a video thumbnail for the placeholder that replaces a blocked embed, once per video, in the background:

  • YouTube (Google): when a page contains a blocked YouTube embed, your server downloads the video’s thumbnail image from i.ytimg.com. Only the video ID is sent. Terms of Service · Privacy Policy
  • Vimeo: when a page contains a blocked Vimeo embed, your server asks vimeo.com/api/oembed.json for the thumbnail address and downloads the image from i.vimeocdn.com. Only the video ID is sent. Terms of Service · Privacy Policy

The thumbnails are stored in your uploads folder and shown from your own site, so visitors’ browsers contact neither service before they consent.

Plugin tags