=== Kookiok — Cookie Consent & GDPR Banner ===
Contributors: kookiok
Tags: cookie consent, gdpr, cookie banner, privacy, consent
Requires at least: 6.5
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

Add the Kookiok GDPR cookie-consent banner to your site by pasting your Domain Group ID. No code required.

== Description ==

Kookiok shows a GDPR-compliant cookie-consent banner on your WordPress site. Install the plugin, paste
your Domain Group ID from the Kookiok dashboard, and the banner goes live — loaded in the correct,
compliant position (the first script in the page head, loaded synchronously), which is exactly what
Kookiok's own installation verifier checks.

* One-field setup — paste your Domain Group ID.
* Correct GDPR script placement, automatically.
* Built-in installation check — confirm the banner is present, first in the page head, and loaded
  synchronously, right from the settings screen.
* Guided first-run setup — a friendly prompt points you to the one setting that matters.
* Embed the cookie declaration table with the `[kookiok_cookie_declaration]` shortcode or the
  "Cookie Declaration" block.
* Lightweight: the consent script handles banner display and cookie blocking; the plugin stays out of
  the way (no heavy script-rewriting engine).
* Translated into English, Czech, and Russian (a translation template is included for adding more).

== External services ==

This plugin connects your site to **Kookiok** (https://kookiok.com), a third-party consent-management
service, to display the cookie-consent banner and the cookie declaration. The banner does not work
without a Kookiok account and a Domain Group ID.

What is sent, and when:

* On every front-end page view, the plugin loads the consent script from
  `https://cdn.kookiok.com/consent.js?id=<your Domain Group ID>`. Your Domain Group ID is included in
  this request.
* The consent script records the visitor's consent choices and sends them to `https://api.kookiok.com`.
* The cookie-declaration block/shortcode loads `https://cdn.kookiok.com/declaration.js?id=<id>`, which
  fetches the cookie list from `https://api.kookiok.com`.

By installing the plugin and entering your Domain Group ID you enable this integration. See the Kookiok
Terms of Service (https://kookiok.com/terms) and Privacy Policy (https://kookiok.com/privacy).

== Installation ==

1. Install and activate the plugin.
2. Go to Settings → Kookiok.
3. Paste your Domain Group ID, click Connect to verify it, then Save.
4. (Optional) Add the `[kookiok_cookie_declaration]` shortcode or the "Cookie Declaration" block to your
   privacy/cookie-policy page.

== Frequently Asked Questions ==

= Where do I find my Domain Group ID? =

In your Kookiok dashboard at https://app.kookiok.com. It is a 36-character ID.

= Does it work with caching / optimization plugins? =

Yes, but exclude `consent.js` / `cdn.kookiok.com` from any "defer / delay / combine JavaScript"
features so the consent script keeps loading first and synchronously.

= Does the plugin store any personal data itself? =

No. The plugin stores only your Domain Group ID and a couple of settings in your WordPress options.
Visitor consent is handled by the Kookiok service.

= Where is the plugin's source code? =

The plugin ships its full, human-readable source. The only compiled asset is the block's
`build/index.js`, minified from `src/edit.js` with @wordpress/scripts (`npm run build`); the
un-minified source is included in the plugin's own `src/` directory.

== Screenshots ==

1. One-field setup — paste your Domain Group ID, and the built-in installation check confirms the banner is placed correctly.
2. The GDPR-ready consent banner on the front end — accept, reject, or fine-tune by category, in the visitor's language.
3. The auto-updating cookie declaration table, embedded on a page with the block or shortcode.
4. The native "Cookie Declaration" Gutenberg block — add it to any page or post, no code required.
5. The first-run setup prompt that guides you to the one setting that matters.
6. See it in action — paste your Domain Group ID, click Connect, and the GDPR consent banner goes live on your site.

== Changelog ==

= 1.0.0 =
* Initial release.
* One-field connection via your Kookiok Domain Group ID, with a "Connect" check.
* GDPR-correct script placement (first in the page head, synchronous).
* Built-in installation self-diagnostic ("Verify installation").
* Guided first-run onboarding notice.
* Cookie declaration via `[kookiok_cookie_declaration]` shortcode and a Gutenberg block.
* Czech and Russian translations included.

== Upgrade Notice ==

= 1.0.0 =
First stable release.
