=== Mignuti Chatbot — GDPR-first AI Chatbot ===
Contributors: mignutimedia
Tags: ai, chatbot, gdpr, support, lead generation
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed a GDPR-first, EU-hosted AI chatbot on your WordPress site in 60 seconds. Multilingual, cookie-consent aware, lightweight.

== Description ==

Mignuti Chatbot adds an embeddable AI chatbot to your WordPress site. It answers
visitor questions from your own content (PDFs, FAQ pages, crawled URLs) and is
built for agencies and small businesses in Europe.

After installing this plugin you connect it to a Mignuti Chatbot project — no
code, no theme editing.

**Why Mignuti Chatbot**

* **EU-hosted (Frankfurt)** — real GDPR compliance, not just a cookie popup.
* **Consent-aware** — in GDPR-safe mode the widget stays dormant until your cookie
  banner (Usercentrics, Cookiebot, Klaro, …) grants consent.
* **Multilingual** — understands German, English, French, Italian, Dutch, Spanish
  and more, and answers in the visitor's language.
* **AI-Act transparency** — an unblockable "you are chatting with an AI" notice is
  built into the widget.
* **Lightweight** — a small widget bundle loaded asynchronously; it does not block
  your page render.
* **Works with WooCommerce** — show the chatbot on product pages and optionally hide
  it on the cart and checkout with one checkbox.
* **One-click on/off** — hide or show the chatbot on your whole site from the plugin
  settings, without disconnecting your project.
* **Page targeting** — show the chatbot everywhere, only on selected pages, or
  everywhere except selected pages. Optionally hide it for logged-in users.
* **Consent-plugin bridge** — pick your cookie banner (Borlabs Cookie, Complianz,
  Cookiebot, Usercentrics, Real Cookie Banner) and the chatbot loads automatically
  once the visitor consents — no code required.
* **Built-in connection test** — one click checks the widget CDN, the API, your key,
  and whether this domain is allowed for your project.

You need a Mignuti Chatbot account. A free tier is available at
[app.mignuti.com](https://app.mignuti.com).

== Installation ==

1. Install the plugin through **Plugins → Add New**, or upload the ZIP via
   **Plugins → Add New → Upload Plugin**, then activate it.
2. Go to **Settings → Mignuti Chatbot** and click **Connect with Mignuti**.
3. Sign in (or create a free account), pick the project you want, and confirm. The
   plugin sets your Project ID, Secret and domain automatically and returns you to
   WordPress — the chatbot is live.

That's it. If you prefer, you can still enter the Project ID and Secret by hand
under "Enter details manually".

== Frequently Asked Questions ==

= Do I need a Mignuti Chatbot account? =

Yes. This plugin connects your WordPress site to a Mignuti Chatbot project. You can
start on the free tier at https://app.mignuti.com.

= Is it GDPR compliant? =

The service is hosted in the EU (Frankfurt). In GDPR-safe consent mode the widget
loads no scripts and sends no data until the visitor consents through your cookie
banner. Data export and deletion are self-service from the Mignuti Chatbot admin.

= How does the consent integration work? =

Set the consent mode to "Wait for consent (GDPR-safe)". Then have your cookie
banner call `window.MignutiChatbot.setConsent('granted')` when the visitor accepts,
and `window.MignutiChatbot.setConsent('denied')` when they decline or withdraw.

= Is it safe that the Secret appears in my page source? =

Yes. The public Project ID is bound to the domains you allow in the Mignuti Chatbot
admin, and every chat session is authorized by a short-lived token. The embed
exposes no reusable secret. You can rotate the key any time from the admin.

= Does it work with WooCommerce? =

Yes. The widget loads on your front-end pages, and you can hide it on the cart and
checkout with a single checkbox under Display & visibility.

= Can I temporarily switch the chatbot off? =

Yes. On the **Mignuti Chatbot** settings page, use **Hide chatbot** to remove the
widget from your site with one click — your project stays connected and your
settings are kept. Click **Show chatbot** to bring it back.

= Can I show the chatbot only on some pages? =

Yes. Under **Display & visibility** choose "Only on selected pages" or "Everywhere
except selected pages" and enter the page/post IDs (comma-separated). You can also
hide it for logged-in users and, on WooCommerce sites, on the cart and checkout.

= How do I connect it to my cookie banner? =

Under **Display & visibility → Consent plugin**, pick your consent tool (Borlabs
Cookie, Complianz, Cookiebot, Usercentrics or Real Cookie Banner) while the consent
mode is "Wait for consent (GDPR-safe)". The chatbot then loads automatically once
the visitor accepts your banner. If your tool is not listed, keep "None" and call
`window.MignutiChatbot.setConsent('granted')` from your banner instead.

= The chatbot does not appear — what can I check? =

Use the **Test connection** button on the settings page. It reports whether the
widget CDN and API are reachable, whether your key is valid, and whether this domain
is allowed for your project. If you use a caching plugin, clear its cache after
connecting or changing settings.

== External services ==

This plugin connects your site to the Mignuti Chatbot service in order to load and
run the chat widget. This is required for the plugin to work.

* **Widget loader** — the script `https://widget.mignuti.com/v1.js` is loaded on
  your front-end pages. It reads the Project ID, Secret, consent mode and optional
  accent color that you configure in the plugin settings.
* **Chat backend** — when a visitor opens the chat, the widget communicates with
  the Mignuti Chatbot API (operated on EU infrastructure) to authorize a session
  and generate answers. Message content the visitor types is processed to produce
  a reply.

No data is sent before the widget loads, and in GDPR-safe consent mode the widget
does not load until consent is granted.

Service provider: Mignuti.
Terms of Service: https://chatbot.mignuti.com/rechtliches/agb
Privacy Policy: https://chatbot.mignuti.com/rechtliches/datenschutz

== Screenshots ==

1. The chat widget open on a WordPress site.
2. The plugin settings page under Settings → Mignuti Chatbot.

== Changelog ==

= 1.0.0 =
* Initial public release.

== Upgrade Notice ==

= 1.0.0 =
Initial public release of the Mignuti Chatbot plugin.
