PN Cookies Manager

Description

PN Cookies Manager is a lightweight, privacy-focused WordPress plugin that helps your website comply with GDPR, CCPA, LGPD and ePrivacy Directive regulations.

Display a fully customizable cookie consent banner, register the cookies your site uses, and let visitors manage their preferences with granular category-based controls.

Cookie Consent Banner

• Fully customizable banner with three layout options: full-width bar, compact box, and floating card.
• Position the banner at the top, bottom, or center of the screen.
• Horizontal alignment control (left, center, right) for box and floating layouts.
• Three action buttons always visible: Accept All, Reject All, and Cookie Settings.
• Background overlay option to focus user attention on the banner.
• Configurable border radius for buttons and banner corners.
• Responsive design that adapts to mobile and tablet screens.
• Smooth open/close animations.
• Re-open floating button so visitors can change their preferences at any time.

Cookie Preferences Panel

• Slide-in settings panel with cookie categories: Necessary, Functional, Analytics, Performance, and Advertising.
• Toggle switches per category (Necessary is always on and cannot be disabled).
• Expandable sections showing the registered cookies for each category with name, duration, and description.
• Accept All and Save Preferences buttons within the panel.

Cookie Registry

• Register the cookies your site uses organized by category.
• Define cookie name, duration, and description for each entry.
• Quick-add preset buttons for common cookies: WordPress defaults, Google Analytics (GA4), Google Ads, Google Merchant, Facebook Pixel, and more.
• « Add all » button to insert all presets for a category at once.
• Smart merge system: new cookies are added to existing registry without deleting previously registered cookies.
• Case-insensitive duplicate detection prevents accidental cookie duplication.

Cookie Scanner

• Automated cookie discovery tool that scans your website pages.
• Select multiple pages to scan simultaneously (pages, posts, custom post types).
• Batch processing with progress indicator showing current page being scanned.
• Automatic categorization of discovered cookies (Necessary, Functional, Analytics, Performance, Advertising).
• One-click import of scanned cookies directly into the Cookie Registry.
• Scan history with ability to view, export (CSV), and delete previous scans.
• Smart import prevents duplicate entries when adding scanned cookies to registry.

Interactive Tutorial

• Step-by-step guided tutorial for first-time users.
• Contextual help highlighting key features and settings.
• Shows on first activation to help users get started quickly.
• Can be dismissed and won’t show again once completed.

Customizable Design

• Full color control: background, text, accept button, reject button, and settings button colors.
• All colors applied via CSS custom properties for consistent theming.
• Admin preview button to see how the banner will look before publishing.

Preventive Script & Iframe Blocking

• Block third-party scripts and iframes from loading before the user gives consent.
• Configurable URL patterns per category (analytics, advertising, performance, functional) with sensible defaults.
• Re-enable scripts and restore iframes automatically after consent is granted.
• MutationObserver intercepts dynamically injected scripts that match blocking patterns.
• Automatic deletion of known tracking cookies (GA, Facebook, HotJar, Clarity, etc.) when a user revokes consent.

Google Consent Mode v2

• Built-in Google Consent Mode v2 integration with Basic and Advanced mode selector.
• Advanced mode: tags load with denied state and update on consent (default). Basic mode: tags are completely blocked until consent.
• Regional consent defaults based on user geolocation (Cloudflare, Vercel, GeoIP headers) with EU/EEA country list.
• Three regional modes: Strict (all denied), Mixed (EU denied, rest granted), Lenient (all granted).
• Outputs default consent state in the page head before any Google tag scripts load.
• Automatically updates consent signals (ad_storage, ad_user_data, ad_personalization, analytics_storage, functionality_storage, personalization_storage) when visitors change their preferences.
• Works with Google Analytics 4, Google Ads, and Google Tag Manager.

Global Privacy Control (GPC)

• Detect the browser GPC signal (navigator.globalPrivacyControl) and automatically apply opt-out consent.
• When GPC is active on a new visitor, analytics and advertising are denied without showing the banner.
• Respects explicit user choices: if a consent cookie already exists, GPC does not override it.
• Configurable toggle in Privacy & Compliance settings.

WP Consent API Integration

• Automatically syncs consent state with the WP Consent API plugin when active.
• Maps plugin categories to WP Consent API types (functional→preferences, analytics→statistics, performance→statistics-anonymous, advertising→marketing).

Individual Consent Proof Logging

• Privacy-safe individual consent records for compliance proof with hashed IP and user agent.
• Each record includes consent hash, policy version, categories, consent type, region, and GPC signal.
• Policy version hash based on banner message and total registered cookie count.
• Export consent log to CSV from the Analytics admin page.
• Configurable retention period with purge function (default 730 days).

Privacy & Compliance

• Configurable consent cookie duration (1-395 days) following GDPR/CNIL/EDPB guidelines (max 13 months recommended).
• Secure flag on consent cookie when site is served over HTTPS.
• Privacy Policy link option in the banner.
• Consent stored in a browser cookie (no server-side tracking).
• SSRF protection in the cookie scanner: URL validation, private IP rejection, SSL verification, and redirect blocking.
• All banner texts are translatable by default; custom text overrides are also supported.

Accessibility

• Full ARIA support: aria-labelledby, aria-describedby, aria-expanded, aria-controls, and role attributes on all interactive elements.
• Focus management: saves and restores focus when opening/closing banner and settings panel.
• Focus trap in the settings panel to prevent tabbing outside the dialog.
• Keyboard navigation: Enter/Space to toggle category sections.
• :focus-visible outline styles on all interactive elements.
• Respects prefers-reduced-motion to disable animations.
• Respects prefers-contrast for enhanced high contrast mode.

Translations

• Fully translation-ready with complete .pot file.
• All default texts (button labels, category names, descriptions) are translatable via standard WordPress i18n.
• Spanish (es_ES) translation included.
• Compatible with translation plugins like Loco Translate and Polylang.

Lightweight & Developer Friendly

• No external dependencies for the front-end banner (jQuery only).
• Deferred script loading for minimal performance impact.
• Clean CSS class naming convention (pn-cookies-manager-*) for easy custom styling.
• Hooks and filters for developer extensibility.