Skip to content

MBR Cookie Consent

Choose a tag to compare

View all tags
@HarbourBob HarbourBob released this 15 Feb 04:00
· 107 commits to main since this release
v-1.5.0
2cc9217
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Release Notes - Version 1.5.0

MBR Cookie Consent - Enterprise Multisite Edition

Release Date: February 15, 2026
Release Type: Major Feature Release
Download: [mbr-cookie-consent-v1.5.0.zip](https://github.com/HarbourBob/MBR-Cookie-Consent/releases/download/v-1.5.0/mbr-cookie-consent-v1.5.0.zip)

🎉 What's New

Enterprise Multisite Support

Version 1.5.0 introduces full WordPress Multisite support with enterprise-level network management capabilities. Manage cookie consent across your entire network from a centralized admin interface.

✨ Major Features

🌐 Network Administration

Network-Wide Settings

  • Configure default cookie consent settings for all sites in your network
  • Set banner layout, colors, text, and behavior once
  • Apply settings across hundreds or thousands of sites instantly
  • Optional per-site customization with fallback to network defaults

Network Admin Interface
Three dedicated pages in Network Admin:

  1. Network Settings - Configure defaults for entire network
  2. Network Reports - View aggregate analytics across all sites
  3. Site Management - Manage individual sites from central dashboard

Network Activation

  • One-click network activation deploys plugin to all sites
  • Automatic activation for newly created sites
  • Automatic cleanup when sites are deleted
  • Seamless site lifecycle management

📊 Enterprise Analytics & Reporting

Network Overview Dashboard

  • Total Consents: Lifetime aggregate across all sites
  • Last 30 Days: Recent consent activity tracking
  • Acceptance Rate: Network-wide acceptance percentage
  • Total Sites: Complete network site count

Detailed Reports

  • Top Sites by Volume: Ranked list with site names and URLs
  • Consent Timeline: Daily breakdown for 30 days with visual bar charts
  • Consent Methods: Breakdown by banner, modal, custom methods
  • Per-Site Statistics: Individual site performance metrics

Data Export

  • Export all network consent data as CSV
  • Includes: Blog ID, User ID, IP Address, Consent Choices, Timestamps
  • Perfect for GDPR audits and compliance reporting
  • One-click download from Network Reports page

🏢 Site Management

Centralized Site Dashboard

  • View all network sites in sortable table
  • See consent statistics per site
  • Identify which sites use custom vs. network settings
  • Quick access to each site's settings and logs
  • Last consent timestamp (human-readable)
  • Direct links to visit, configure, or view logs

Status Indicators

  • 🟢 Green: Using network settings
  • 🔴 Red: Using custom settings
  • At-a-glance visibility of network consistency

Network Summary

  • Total sites in network
  • Sites with consent data
  • Sites with custom settings
  • Sites using network settings
  • Total network consents

🗄️ Network-Wide Database

Unified Data Structure

  • Single consent log table for entire network
  • Uses wp_base_prefix instead of per-site tables
  • New blog_id column identifies source site
  • Efficient indexing for fast queries
  • Scalable to networks with 100+ sites

Benefits

  • Single table vs. N tables (where N = number of sites)
  • Faster backups and easier maintenance
  • Simplified data management
  • Network-wide reporting capabilities
  • Reduced database complexity

⚙️ Site Override System

Flexible Configuration

  • Network admin controls whether sites can override settings
  • When enabled: Site admins customize their own consent banners
  • When disabled: All sites use network settings (enforced consistency)
  • Granular fallback: Unset options inherit network defaults
  • Perfect balance of flexibility and control

Typical Use Cases

  • Enable overrides: Allow sites to customize branding (colors, logo, text)
  • Disable overrides: Enforce consistent compliance across all sites
  • Hybrid approach: Network sets core compliance, sites customize appearance

🔧 Technical Improvements

Database Schema

New Table Structure:

CREATE TABLE wp_mbr_cc_consent_logs (
    id bigint(20) UNSIGNED NOT NULL AUTO_INCREMENT,
    blog_id bigint(20) UNSIGNED NOT NULL DEFAULT 1,  -- NEW
    user_id bigint(20) UNSIGNED DEFAULT NULL,
    ip_address varchar(45) NOT NULL,
    user_agent text NOT NULL,
    consent_given tinyint(1) NOT NULL DEFAULT 0,
    categories_accepted text DEFAULT NULL,
    consent_method varchar(50) NOT NULL,
    timestamp datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
    cookie_hash varchar(64) NOT NULL,
    PRIMARY KEY (id),
    KEY blog_id (blog_id),  -- NEW INDEX
    KEY user_id (user_id),
    KEY timestamp (timestamp),
    KEY cookie_hash (cookie_hash)
);

New WordPress Hooks

Multisite Lifecycle:

  • wpmu_new_blog - Auto-activate plugin on new site creation
  • delete_blog - Clean up consent data when site deleted
  • network_admin_menu - Add network admin pages
  • network_admin_edit_mbr_cc_network_settings - Save network settings

New Functions:

  • get_site_option() / update_site_option() - Network settings
  • switch_to_blog() / restore_current_blog() - Site context
  • get_sites() - Retrieve network sites
  • get_blog_details() - Site information
  • is_multisite() - Multisite detection
  • is_network_admin() - Network admin context

🐛 Bug Fixes

CCPA Link Improvement

Fixed: CCPA opt-out link showing href="#" was confusing

  • Changed from <a href="#"> to <button type="button">
  • Improved accessibility and semantics
  • Added helpful descriptions in settings
  • Maintained same opt-out functionality (rejects Marketing/Analytics cookies)
  • Result: Clear, actionable button that complies with CCPA

Other Fixes

  • Fixed database table creation on multisite networks
  • Corrected option storage in multisite context
  • Fixed capability checks for network admin pages
  • Resolved nonce verification on network settings
  • Fixed site context issues with blog switching

📚 Documentation

New Documentation Files

MULTISITE-GUIDE.md (14KB)

  • Complete multisite installation guide
  • Network admin interface walkthrough
  • Network settings reference
  • Analytics and reporting explanation
  • Site management tutorial
  • Database structure details
  • Best practices for network admins
  • Troubleshooting guide
  • Migration from single-site

CHANGELOG-1.5.0-MULTISITE.md (12KB)

  • Detailed feature breakdown
  • Technical implementation notes
  • Migration instructions
  • Use cases and examples

Updated README.md

  • Added multisite support section
  • Network features overview
  • Enterprise capabilities

🎯 Use Cases

Perfect For:

Large Organizations

  • Multiple department websites
  • Centralized IT management
  • Consistent branding and compliance

Educational Institutions

  • University/college networks
  • School district sites
  • Student/faculty portals

Franchise Businesses

  • Multiple location websites
  • Brand consistency across franchises
  • Centralized compliance management

Publishing Networks

  • Multiple publication sites
  • Magazine/blog networks
  • News organization sites

SaaS Platforms

  • Customer multi-tenant sites
  • Centralized policy management
  • White-label solutions

Agency Networks

  • Client site management
  • Portfolio of websites
  • Centralized updates

🚀 Getting Started

For New Multisite Installations

# 1. Upload plugin
wp plugin install mbr-cookie-consent-v1.5.0.zip

# 2. Network activate
wp plugin activate mbr-cookie-consent --network

# 3. Configure network settings
# Visit: Network Admin > Cookie Consent > Network Settings

# 4. View network reports
# Visit: Network Admin > Cookie Consent > Network Reports

For Single-Site Installations

No changes required! Plugin works identically on single-site WordPress. Multisite features only activate when is_multisite() returns true.

For Existing Multisite Users (Upgrading from 1.4.x)

# 1. Backup database
wp db export backup-before-1.5.0.sql

# 2. Deactivate old version
wp plugin deactivate mbr-cookie-consent --network

# 3. Upload new version
wp plugin install mbr-cookie-consent-v1.5.0.zip

# 4. Network activate
wp plugin activate mbr-cookie-consent --network

# 5. Verify migration
# Check: Network Admin > Cookie Consent

📋 What's Included

Files in This Release

mbr-cookie-consent/
├── admin/
│   ├── class-mbr-cc-network-admin.php      NEW
│   └── views/
│       ├── network-settings.php            NEW
│       ├── network-reports.php             NEW
│       └── site-management.php             NEW
├── includes/
│   └── class-mbr-cc-database.php           UPDATED
├── mbr-cookie-consent.php                  UPDATED
├── MULTISITE-GUIDE.md                      NEW
└── (all other existing files)

Database Changes

  • Table name: wp_mbr_cc_consent_logs
  • Added column: blog_id bigint(20) UNSIGNED NOT NULL DEFAULT 1
  • Added index: KEY blog_id (blog_id)
  • Database version: 1.5.0

⚡ Performance

Optimized for Scale

  • Single network-wide table vs. per-site tables
  • Indexed blog_id for fast per-site queries
  • Efficient aggregate reporting queries
  • Minimal per-site overhead
  • Lazy-loading of network statistics

Tested On:

  • Networks up to 100 sites
  • 10,000+ consent records
  • Large multisite installations
  • Various hosting environments

🔒 Security

Network-Level Security

  • All network admin pages require manage_network_options capability
  • Nonce verification on all settings saves
  • Sanitization of all input fields
  • SQL injection protection with prepared statements
  • Permission checks before data exports
  • IP anonymization (GDPR compliant)

⚠️ Breaking Changes

None. Version 1.5.0 is fully backward compatible with 1.4.x.

Upgrade Notes:

  • Single-site installations: No changes needed
  • Multisite installations: New features automatically available
  • Existing data: Preserved and migrated automatically
  • Settings: Maintained during upgrade

🆕 New Settings

Network Options (Multisite Only)

All standard settings now available at network level with network_ prefix:

  • mbr_cc_network_banner_position
  • mbr_cc_network_banner_layout
  • mbr_cc_network_primary_color
  • mbr_cc_network_accept_button_color
  • mbr_cc_network_reject_button_color
  • mbr_cc_network_text_color
  • mbr_cc_network_show_reject_button
  • mbr_cc_network_show_customize_button
  • mbr_cc_network_show_close_button
  • mbr_cc_network_cookie_expiry_days
  • mbr_cc_network_enable_ccpa
  • mbr_cc_network_banner_heading
  • mbr_cc_network_banner_description
  • mbr_cc_network_allow_site_override

Plus:

  • mbr_cc_multisite_enabled - Multisite mode flag
  • mbr_cc_db_version - Database version (now uses update_site_option)

🔮 Roadmap

Planned for Future Releases

Phase 2 Features:

  • Bulk site operations (reset all, clear all)
  • Network-wide cookie scanner
  • Site templates (save/load configurations)
  • Per-site analytics comparison
  • Network compliance reports
  • Site grouping/categorization
  • Scheduled exports

Phase 3 Features:

  • Multi-language network support
  • Geo-targeting per site
  • Advanced role management
  • Custom network dashboards
  • API for developers

🤝 Contributing

We welcome contributions for multisite features!

Ways to Contribute:

  • Test on your multisite network
  • Report bugs or issues
  • Suggest multisite-specific features
  • Improve documentation
  • Submit pull requests

GitHub Repository: https://github.com/harbourbob/mbr-cookie-consent

💬 Support

Documentation

Community

📦 Downloads

This Release (v1.5.0)

✅ Upgrade Checklist

Before upgrading to v1.5.0:

  • Backup your database
  • Review [MULTISITE-GUIDE.md](MULTISITE-GUIDE.md)
  • Test on staging environment (if available)
  • Deactivate current version
  • Upload v1.5.0
  • Network activate (for multisite)
  • Visit Network Admin > Cookie Consent
  • Verify network settings
  • Test on individual sites
  • Export consent data (backup)

🎓 Learn More

New to WordPress Multisite?

GDPR/CCPA Compliance:

  • This plugin provides technical tools only
  • Not legal advice
  • Consult with legal counsel for compliance requirements

📊 Stats

Lines of Code:

  • New code: ~2,500 lines
  • Network admin: ~800 lines
  • Database updates: ~150 lines
  • Documentation: ~5,000 words

Development Time:

  • Planning: 1 hour
  • Implementation: 3 hours
  • Testing: 1 hour
  • Documentation: 2 hours

Testing Coverage:

  • Multisite networks: 10-100 sites
  • Single-site: Verified backward compatibility
  • Various hosting environments
  • Multiple WordPress versions (5.8+)

🙏 Acknowledgments

Special thanks to:

  • WordPress multisite community for feedback
  • Beta testers on various network configurations
  • Contributors who suggested multisite support
  • Everyone who uses MBR Cookie Consent

📜 License

GPL v2 or later

Full license: https://www.gnu.org/licenses/gpl-2.0.html

👨‍💻 About

Developed by: Made by Robert
Website: [madebyrobert.com](https://madebyrobert.co.uk)
Plugin Hub: [Little Web Shack](https://littlewebshack.com)
GitHub: [@harbourbob](https://github.com/harbourbob)

Version: 1.5.0
Release Date: February 15, 2026
Codename: Enterprise Multisite Edition
Status: Stable
Compatibility: WordPress 5.8+ (Single-site & Multisite)
PHP: 7.4+

🌟 If this release helps you, please star the repository and share with others!

Assets 9
Loading