=== Web357 Cookie Consent Manager ===
Contributors: web357, yiannistaos
Tags: cookie consent, gdpr, cookies, privacy, cookie notice
Donate link: https://www.paypal.me/web357
Requires at least: 5.3
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

A complete, GDPR-ready cookie consent solution for WordPress with customizable banner, cookie categories, script blocking, and consent logging.

== Description ==

The [Web357 Cookie Consent Manager WordPress plugin](https://www.web357.com/cookie-consent-manager-wordpress-plugin?utm_source=wp_plugin_repo&utm_medium=wp_listing&utm_campaign=wp_repo_link&utm_content=wp_repo_link_to_plugin_page) is a complete, GDPR-ready cookie consent solution for WordPress, designed to help you comply with modern privacy regulations while giving visitors full control over their cookie preferences.

Display a fully customizable cookie notification bar, organize cookies into categories, block third-party scripts until consent is granted, and provide visitors with a dedicated Cookie Manager where they can review and update their consent choices at any time.

Whether you're running a personal blog, business website, online store, or managing client websites, Web357 Cookie Consent Manager makes cookie compliance simple without compromising performance, flexibility, or user experience.

== Key Features ==

= Fully Customizable Cookie Banner =

Create a cookie notification bar that perfectly matches your website's design and branding.

Features include:

* Seven flexible banner positions
* Fully customizable colors
* Individual button styling
* Typography settings
* Animation effects
* Responsive design
* Auto-hide options

= Cookie Manager & Cookie Categories =

Give visitors complete control over their cookie preferences.

Allow visitors to manage consent for individual cookie categories through an intuitive Cookie Manager while keeping essential cookies protected.

Features include:

* Cookie Manager modal
* Granular consent by cookie category
* Required, Analytics, Marketing & Social Media categories
* Unlimited custom cookie categories
* Lock required cookies
* Floating preference button

= Script Blocking =

Prevent third-party scripts from loading until visitors grant consent.

Supported integrations include:

* Google Analytics
* Google Tag Manager
* Google Ads
* Meta (Facebook) Pixel
* Hotjar
* YouTube embeds
* Custom JavaScript

Powerful controls include:

* Assign scripts to cookie categories
* Script placement (Head, Body Top or Body Bottom)
* Configurable loading behavior
* Language-specific scripts
* Individual enable/disable controls

= Google Consent Mode v2 Ready =

Help implement Google's latest consent requirements by loading analytics and advertising technologies only after visitors have granted consent.

Build a privacy-first website while supporting Google Consent Mode v2 and Google's latest consent requirements.

= Geo Targeting =

Display the cookie notification bar only where it's required.

Powered by MaxMind GeoIP2, you can:

* Include or exclude continents
* Include or exclude countries
* Display the banner only in GDPR-affected regions

Perfect for international websites with location-specific compliance requirements.

= Consent Logs =

Maintain a complete history of visitor consent decisions for GDPR compliance and auditing.

Features include:

* Accept & Decline logs
* Consent date and time
* Optional IP address logging
* Easy log management
* Export functionality

= Multilingual Support =

Deliver a localized cookie consent experience for international visitors.

Customize:

* Cookie notification messages
* Button labels
* Cookie Manager texts
* Confirmation messages

Compatible with multilingual WordPress websites, including WPML, Polylang, Multisite, and similar translation solutions.

= Developer-Friendly Customization =

Designed for developers, agencies, and advanced users who need complete flexibility.

Features include:

* Custom CSS support
* Custom JavaScript integration
* Shortcode functionality
* Developer testing tools
* Clean, readable source code

= Easy Administration =

Manage every aspect of your cookie consent solution from one modern administration dashboard.

Configure every aspect of your cookie consent solution through a clean, intuitive interface designed for both beginners and professionals.

== Why Choose Web357? ==

* Complete GDPR-ready cookie consent solution
* Google Consent Mode v2 ready
* Lightweight and performance-friendly
* No coding required
* Developer-friendly architecture
* Modern Cookie Manager
* Regular updates and long-term support
* Actively developed and trusted by thousands of WordPress and Joomla! websites since 2014

== Installation ==

The plugin is simple to install:

1. Download the file `web357-cookie-consent-manager.zip`.
2. Unzip it.
3. Upload `web357-cookie-consent-manager` directory to your `/wp-content/plugins` directory.
4. Go to the plugin management page and enable the plugin.
5. Configure the options from the `Web357 Cookie Consent Manager` settings page.

== Frequently Asked Questions ==

= Which WordPress versions are supported? =

The plugin supports WordPress 6.x and WordPress 7.x. Older versions (WordPress 4 and 5) were supported in earlier releases of the plugin but are no longer actively maintained.

= Is this plugin GDPR compliant? =

The plugin provides the tools you need to comply with GDPR cookie consent requirements: cookie blocking, granular category consent, consent logging, and more. However, GDPR compliance depends on how you configure the plugin and your overall data processing practices. Consult a legal professional for advice specific to your situation.

= Can I use this on multiple sites? =

License terms vary by plan. Check your license details in your web357.com account to see how many sites your license covers.

= Does it work with multilingual sites? =

Yes. The plugin automatically detects all content languages installed on your WordPress site. You can customize every user-facing text string separately for each language in the Texts for Languages section.

= Does it work with page caching? =

Yes. The notification bar is rendered via JavaScript on the client side, so it works correctly with WordPress's built-in page cache and third-party caching plugins.

== Source Code ==

The PHP source code of this plugin is fully readable in the distributed plugin files.

The administration interface is built as a modern React/TypeScript single-page application and compiled into a single JavaScript bundle (`public/js/admin-view.js`). The bundle is shipped in a readable, unobfuscated format, allowing developers to review its implementation directly from the plugin package.

== External Services ==

This plugin does not require or connect to any third-party external service.

All plugin settings, cookie categories, consent preferences, and consent logs are stored locally in your WordPress database.

The optional Geo Targeting feature uses the MaxMind GeoIP2 database only when configured by the site administrator. No visitor consent data is transmitted to external services by the plugin itself.

== Screenshots ==

1. **Frontend cookie banner** — the cookie notification bar displayed at the bottom of the website, with Accept, Decline, and More Info buttons.
2. **Cookie Banner — Base Settings** — choose the banner position, enable the close icon, set the display duration and animation speed, and preview changes in real time.
3. **Cookie Banner — Styling** — customise the banner background, border, message text, links, font size, and button colours.
4. **Button Colours** — configure the normal and hover colours separately for the Accept, Decline, Cancel, Settings, More Info, and Save Settings buttons.
5. **Cookie Manager — Categories of Cookies** — create and manage cookie categories, edit their names and descriptions, define their default consent state, and enable or disable each category.
6. **Texts for Languages** — customise the cookie message and button labels for every available website language, and choose which buttons should be displayed.
7. **Consent Logs** — review visitor consent activity, including the date, IP address, consent status, accepted cookie categories, and country, with options to filter or export the records as CSV.

== Changelog ==

= 25-Jul-2026 : v1.0.1 =
* Updated plugin codebase to align with current WordPress Plugin Directory guidelines and best practices.
* Fix: The Cookies Manager floating icon image now loads correctly on the frontend.
* Fix: The consent logs table is much faster on sites with thousands of records (optimized pagination).
* Fix: The Cookies Manager floating button now properly respects its on/off setting and saved state.
* Fix: Several small UI and translation issues across the settings panel were polished.
* New: The cookies info table (shortcode output) is now loaded with AJAX for a smoother page load.
* Change: Updated the "Read changelog" link to the correct documentation URL.
* Misc: Added missing copyright headers to source files.
* Misc: Internal release & CI workflow improvements (no user-facing impact).

= 25-May-2026 : v1.0.0 =
* First release
