=== CookieBloom Consent Manager ===
Contributors: agentdmitro
Donate link: https://www.paypal.me/agentdmitro
Tags: cookie consent, gdpr, consent manager, google consent mode, consent mode v2, cookies, privacy, analytics, marketing, wp consent, cmp, wordpress gdpr, cookie banner, consent management platform
Requires at least: 6.2
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

GDPR-compliant cookie consent solution with real-time analytics, Google Consent Mode v2, and multilingual support. Lightweight and accessible.

== Description ==

CookieBloom is a GDPR-compliant cookie consent manager for WordPress, built with full support for Google Consent Mode v2. It provides granular consent controls for analytics, marketing, and functional cookies, with a fast, accessible, and lightweight banner.

== Who is CookieBloom for? ==
CookieBloom is ideal for website owners, marketers, and developers who need a modern WordPress consent management platform with Google Consent Mode v2 support and full control over cookie behavior.

== Features ==
* Full Google Consent Mode v2 support
* GDPR and ePrivacy compliant
* Granular consent categories (analytics, marketing, functional)
* Lightweight and fast-loading banner
* Accessible keyboard-friendly UI
* Multilingual-ready with locale fallback
* Developer-friendly API and filters

= Key Features =

* **GDPR & ePrivacy Compliant** – Meets EU data protection requirements with granular consent controls
* **High Performance** – Minimal JavaScript footprint with optimized asset loading and zero external dependencies
* **Google Consent Mode v2** – Native integration with Google Analytics and Ads consent signals
* **Multilingual Support** – 27 European languages with automatic fallbacks (Ukrainian/Polish first, then English)
* **Real-time Analytics** – Track consent rates, user preferences, and trends with detailed statistics
* **Granular Consent Categories** – Functional, Marketing, Statistics, and Analytics toggles with accessible markup
* **Brand-ready Styling** – Adjustable color palette, font sizes, live icon preview, and optional custom CSS
* **Dynamic Admin Preview** – Full-width banner preview updates instantly as you type
* **WCAG Compliant** – Keyboard navigation and screen reader support
* **Developer Friendly** – AJAX-powered banner rendering, `window.CookieBloom.open()` helper, and filterable defaults

= Privacy & Compliance =

* Local storage preferences
* Secure cookie handling
* Analytics tracking only with consent
* GDPR-compliant data processing
* No external dependencies
* No data sent to third parties by default

= Optional Remote Analytics =

CookieBloom can send consent analytics to a remote service if you configure `COOKIEBLOOM_REMOTE_API_BASE` and `COOKIEBLOOM_REMOTE_SITE_KEY`. When enabled, analytics events are transmitted to the configured endpoint for processing and reporting.

= Multilingual =

Built-in support for 27 European languages with placeholder `.po` files for rapid translation:

English, Ukrainian, Polish, German, French, Spanish, Italian, Czech, Slovak, Romanian, Hungarian, Greek, Slovenian, Bulgarian, Croatian, Lithuanian, Latvian, Estonian, Dutch, Danish, Swedish, Finnish, Norwegian, Portuguese, Turkish, Irish, Serbian, Bosnian, Macedonian, Albanian.

== Installation ==

1. Upload the `cookiebloom` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to **Settings → CookieBloom** to configure the banner
4. Customize text, colors, and behavior for each language
5. Save changes and test on your website

== Frequently Asked Questions ==

= Is CookieBloom GDPR compliant? =

Yes, CookieBloom is designed to meet GDPR and ePrivacy requirements with granular consent controls and user-friendly interface.

= Does it work with Google Consent Mode v2? =

Yes, CookieBloom has native integration with Google Consent Mode v2 for Google Analytics and Google Ads.

= Can I customize the banner appearance? =

Absolutely! You can adjust colors, font sizes, position, animation, and even add custom CSS in the admin panel.

= Is it compatible with WPML and Polylang? =

Yes, CookieBloom works seamlessly with WPML and Polylang for multilingual websites.

= Where is consent data stored? =

Consent preferences are stored in the browser's localStorage and cookies. Analytics data is stored in your WordPress database unless you enable optional remote analytics.

= Does it affect website performance? =

No, CookieBloom is highly optimized with minimal JavaScript footprint and zero external dependencies.

== Screenshots ==

1. Cookie consent banner with customizable design
2. Admin settings page with live preview
3. Analytics dashboard showing consent trends
4. Multilingual support with language switcher
5. Granular cookie category controls
6. Recall button and preferences modal

== Changelog ==

= 1.0.0 - 2024-12-XX =
* Initial release
* Full GDPR and ePrivacy compliance with granular consent controls
* Google Consent Mode v2 integration
* Real-time analytics dashboard with Chart.js visualizations
* Performance optimized: minimal JavaScript footprint, zero external dependencies
* Full-width, real-time admin preview with instant updates
* Dismiss behavior with optional recall tab
* Multilingual support for 26 European languages with automatic fallbacks
* Enhanced locale fallback logic (pl/uk → en_US → en_GB)
* WCAG-compliant accessibility features with keyboard navigation
* Cookie preference persistence with localStorage backup
* GPL v2+ license compliance
* WordPress plugin directory guidelines compliance
* WebP images for better performance

== Upgrade Notice ==

= 1.0.0 =
Initial release of CookieBloom Consent Manager. A lightweight, GDPR-compliant cookie consent solution.

== Support ==

For support, please use the [WordPress.org support forum](https://wordpress.org/support/plugin/cookiebloom/).

For customizations or consulting, contact via Telegram: [@agentdmitro](https://t.me/agentdmitro)

== Credits ==

Developed by [Dmytro Fedorchenko](https://www.linkedin.com/in/agentdmitro/)

== License ==

CookieBloom is licensed under the GNU General Public License v2 or later.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

== Changelog ==
= 1.1.0 =
* Added Google Consent Mode v2 support
* Improved accessibility
* Performance optimizations
