Description
EC ‑ GDPR Cookie Banner shows your visitors a cookie banner and remembers their choice. Scripts are held back only when you mark them, until the visitor accepts that category.
Banner and design
- Six templates (classic, illustrated, icon card, minimal, cookie card, privacy notice) in a banner, dialog or box layout, placed at the top, bottom, left or right.
- Light, dark, midnight, custom and “match my theme” colour schemes, fonts, button colours, opacity and background blur, plus sliders for the text size, heading size, width and height of the banner.
- An optional close (×) button that hides the banner for the rest of the session, an optional imprint link next to the privacy policy link, and an optional “Powered by” credit (off by default).
- A cookie icon to re-open the settings: 17 icon styles or a text link, four corner positions, and your own size, colours and shadow. There is also a
[entangle_cookie_consent_cookie_settings]shortcode. - Show the banner and the icon on every page, only on the home page, or on every page except the paths you list.
- Right-to-left layouts (Arabic, Hebrew) and keyboard-friendly controls: the banner comes first in the tab order and never traps the keyboard unless you force an interaction.
- Edit every banner text in the editor. The default texts follow the site language when a translation is available.
- Live preview while you edit.
Consent behaviour
- Consent models: accept / reject / preferences, accept and preferences, do not sell or share, accept only, notice only.
- Explicit or implied consent, and the option to make visitors choose before they can use the page.
- Storage period of 7 or 14 days, or 1, 3, 6 or 12 months, and a way to require new consent from everyone.
- Regional rules: choose which regions see the banner (worldwide, Europe, USA, Australia and New Zealand, Canada, Japan, Brazil, UAE, India, Thailand, South Africa, China, South Korea, Mexico, Argentina), and optionally set a different model per country (and US state) with Smart Geo. Visitors outside your regions see no banner and their scripts run normally.
- Global Privacy Control: Smart Geo’s opt-out model honours the browser’s Global Privacy Control signal and keeps marketing off.
- Script blocking: scripts you mark by hand, or list by WordPress handle with a filter, are held back until the matching category is accepted, and start as soon as the visitor accepts.
- Works with the WP Consent API.
Records and analytics
- Views, accepts, rejects and custom choices per day, by country and device.
- Consent records with a masked IP address, searchable and exportable to CSV. Records are deleted automatically after 12 months (adjustable with a filter).
- A cookie scanner that lists the cookies and browser storage your site uses and sorts them into categories.
Important
A cookie banner is one part of handling privacy. This plugin does not make a website compliant with any law, and it does not provide legal advice. Check your own obligations, your cookie policy and your other tools with a qualified advisor.
External services
This plugin does not connect to any third-party or external service. It does not load fonts, scripts, images or styles from other websites, and it does not send visitor data to any company.
The only outside contact it can make is this:
- The cookie scanner, run by an administrator from Cookie Consent > Analytics > Cookies, requests the pages of your own site.
- The optional “Powered by” credit links to entanglecommerce.com only when a visitor clicks it.
- If you add a MaxMind-format
.mmdbfile, the plugin reads it from your own server. It never downloads a database. - Translations and updates are delivered by WordPress.org through WordPress itself.
Source code
Third-party libraries bundled in compiled files:
- Chart.js (MIT) – https://www.chartjs.org/
- react-simple-maps (MIT) – https://www.react-simple-maps.io/
- world-atlas 110m topojson (ISC) – https://github.com/topojson/world-atlas
Screenshots










Installation
- Upload the
entangle-cookie-consentfolder to/wp-content/plugins/, or install the plugin from the Plugins screen in WordPress. - Activate the plugin.
- Open Cookie Consent > Cookie Banner, adjust the banner and switch it on. Activating the plugin leaves the banner off.
- If you use a page cache or CDN, purge the cache after saving settings.
FAQ
-
Does this plugin make my site compliant with GDPR, CCPA or any other law?
-
No. It gives you the tools to ask for consent and to hold back scripts, but compliance depends on how your whole site is set up and on your legal situation. The plugin does not provide legal advice.
-
How is the visitor’s country detected?
-
Only on your own server, in this order: (1) headers set by your host or CDN (Cloudflare
CF-IPCountry, CloudFront, Vercel and similar), (2) WooCommerce geolocation, if WooCommerce is active and has its own local database, (3) a local MaxMind-format.mmdbfile that you provide. No lookup is sent to an outside service. If no country can be found, the strictest rules for your selected regions are used.You can change the trusted headers with the
entangle_cookie_consent_trusted_country_headersfilter. These headers are trusted by default, so if your site is not behind one of these hosts or CDNs, remove them with that filter: otherwise a visitor could send the header themselves. If the site sits behind a proxy and you want to trust a header for the visitor IP, return it from theentangle_cookie_consent_trusted_ip_headersfilter, for examplearray( 'HTTP_CF_CONNECTING_IP' ). -
What do visitors outside my selected regions see?
-
No banner. Their scripts run as if no consent were needed. A visitor whose country cannot be detected is treated as inside your regions and gets the strict rules. With Smart Geo turned on, every visitor sees a banner and the model is chosen per country.
-
How do I add a .mmdb file?
-
Download a country or city database in the MaxMind DB format yourself, for example GeoLite2 Country (free with a MaxMind account and subject to MaxMind’s licence) or DB-IP Lite. Upload it to your server in a folder that is not publicly downloadable, then enter its absolute path under Cookie Banner > Regions > Visitor location. The plugin never downloads or ships a database.
-
Use the shortcode
[entangle_cookie_consent_cookie_settings label="Cookie settings"], or add this HTML anywhere:<a href="#cookie-settings" data-fcc-open>Cookie settings</a>. Any link to#cookie-settingsalso works. The shortcode prints nothing while the banner is switched off. -
How are scripts blocked?
-
The plugin does not block any script on its own. A script that WordPress loads through its script system (
wp_enqueue_script) is printed withtype="text/plain"and re-activated by the banner after consent only when its handle is listed in theentangle_cookie_consent_script_gate_handlesfilter. The page HTML does not depend on the visitor’s choice, so page caches keep working.To block other scripts, either print them by hand as
<script type="text/plain" data-fcc-category="marketing">...</script>(usestatistics,marketingorpreferences), or map a script handle to a category with theentangle_cookie_consent_script_gate_handlesfilter. Scripts that are hard-coded in a theme template are not changed automatically. A script that depends on a blocked script is not blocked with it, so block both or neither. -
Does it work with the WP Consent API?
-
Yes. The plugin registers itself with the WP Consent API and keeps the consent categories (functional, preferences, statistics, marketing) up to date.
-
Does it support right-to-left languages?
-
Yes. The banner switches to a right-to-left layout for Arabic and Hebrew, or when the page direction is right-to-left.
-
What data does the plugin store?
-
The visitor’s choice is stored in their own browser. When a visitor makes a choice, the site stores a consent record (random consent ID, choices, page address, date, country, device, language, policy version and a partly masked IP address) and anonymous daily counters. Consent records are deleted after 12 months; change this with the
entangle_cookie_consent_consent_retention_monthsfilter. The daily counters are kept for about 25 months (761 days); change this with theentangle_cookie_consent_analytics_retention_daysfilter. The full IP address is never stored. Settings are stored in WordPress options and the records in four database tables. Deleting the plugin removes all of it. -
How are saved preferences counted in the analytics?
-
By what the visitor allowed: as accepted when every category was allowed, as rejected when none was, and as a custom choice otherwise.
-
Yes. Open Cookie Consent > Analytics > Cookies and run a scan. The scanner loads a few pages of your own site (home page, latest post, privacy policy and, with WooCommerce, the shop, cart and account pages), reads the cookies and storage keys it finds and sorts them into categories. You can change a category or add a cookie by hand.
-
Where can I get help?
-
Email support@entanglecommerce.com. The address is also shown at the top of Cookie Consent > Help Center, above the frequently asked questions.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“EC ‑ GDPR Cookie Banner” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “EC ‑ GDPR Cookie Banner” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release.
