=== Bikram Cookie Consent Banner ===
Contributors: bikram_sth
Tags: cookie consent, gdpr, cookies, privacy, consent management
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The lightweight GDPR cookie consent banner. 100% free, with an under-10kb (about 3kb gzipped) front-end footprint.

== Description ==

Bikram Cookie Consent Banner is a lightweight cookie consent banner for WordPress. It lets visitors accept or customize cookie categories (Necessary, Analytics, Marketing, Preferences), only loads Google Analytics / Facebook Pixel after the relevant consent is given, and can optionally log consent events for compliance record-keeping.

**Features**

* Five banner styles (minimal bar, floating card, glassmorphism, dark mode, full-screen overlay)
* Per-category consent (Analytics, Marketing, Preferences), with Necessary always on
* Google Analytics and Facebook Pixel are only injected after the visitor consents to the relevant category
* Optional consent logging to your database, viewable from the admin area
* Built-in cookie policy text generator
* Settings export/import (handy for agencies deploying the same configuration across client sites)
* Optional EU/UK-only geo-targeting, resolved entirely server-side from CDN/host headers (no third-party lookup) so the banner only shows where it's legally required
* `[bikrco_cookie_button]` shortcode to let visitors reopen their cookie preferences at any time
* No upsells, no premium tier — the whole plugin is free

= External services =

This plugin can connect to the following third-party services:

**Google Analytics (optional, off by default)**
If you enter a Google Analytics Measurement ID and the visitor consents to Analytics cookies, this plugin loads the Google Analytics tracking script (`https://www.googletagmanager.com/gtag/js`) and sends standard Google Analytics data to Google. See Google's privacy policy: https://policies.google.com/privacy

**Facebook Pixel (optional, off by default)**
If you enter a Facebook Pixel ID and the visitor consents to Marketing cookies, this plugin loads the Facebook Pixel script (`https://connect.facebook.net`) and sends standard Facebook Pixel data to Meta. See Meta's privacy policy: https://www.facebook.com/privacy/policy/

No data is sent to any of these services unless you configure the corresponding feature, and unless the visitor has given the relevant consent. The optional "Geo-targeting (EU/UK only)" setting does not call any external service: it reads a country header your host or CDN (e.g. Cloudflare's `CF-IPCountry`) may already attach to the request, entirely server-side. If no such header is present, the banner is shown to everyone.

== Installation ==

1. Upload the `bikram-cookie-consent-banner` folder to `/wp-content/plugins/`, or install it directly from Plugins → Add New.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Go to Cookie Consent → Settings to configure your banner text, style, and cookie categories.
4. (Optional) Add your Google Analytics ID and/or Facebook Pixel ID if you use those services.
5. (Optional) Enable geo-targeting if you only want the banner shown to EU/UK visitors — this only works if your host or CDN attaches a country header to requests (e.g. Cloudflare); otherwise the banner is shown to everyone by default.

== Frequently Asked Questions ==

= Does this plugin block cookies automatically? =

Bikram Cookie Consent Banner controls whether the Google Analytics and Facebook Pixel scripts it manages are loaded, based on visitor consent. It does not scan your site for other cookies/scripts set by themes or other plugins; for full compliance, review all cookies your site sets.

= Where are consent logs stored? =

In a table in your own WordPress database (`{prefix}bikrco_logs`), only if consent logging is enabled in Settings. Logs are not sent anywhere off your site.

= What happens to my data if I uninstall the plugin? =

Uninstalling the plugin (not just deactivating it) removes all of its settings and the consent log table.

= Is this plugin free? =

Yes, 100% free with no premium tier or upsells.

= Will this slow down my site? =

The front-end banner ships as a single small CSS file and a dependency-free (no jQuery) JS file — under 10kb combined, about 3kb gzipped — only loaded for visitors who haven't consented yet. Once a choice is saved, neither file loads again on that visit. (The rest of the plugin, including the admin screens and consent logger, is server-side PHP and never reaches the front end at all.)

= Is this plugin translation-ready? =

Yes. All visible strings use WordPress's standard translation functions and the `bikram-cookie-consent-banner` text domain, so it can be translated via WordPress.org's translation platform or a plugin like Loco Translate.

= I found a bug or have a feature request — where do I report it? =

Please use this plugin's Support forum here on WordPress.org. Include your WordPress version, PHP version, and steps to reproduce if it's a bug.

== Screenshots ==

1. Minimal Bottom Bar — the default banner template
2. Floating Card template
3. Glassmorphism template
4. Dark Mode template
5. Full Screen Overlay template
6. Settings — banner style, cookie categories, and Analytics/Pixel integration
7. Admin menu, cookie duration, and export/import settings
8. Built-in cookie policy generator
9. Consent logs table

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
