=== Mignuti Chatbot ===
Contributors: mignutimedia, eduardditler
Tags: ai, chatbot, gdpr, support, lead generation
Requires at least: 6.0
Tested up to: 7.1
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 AI chatbot hosted in Germany 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**

* **Hosted in Germany** — database, files and application run on our own server
  in Germany. Answers are generated by a language model at Anthropic (USA) under
  EU standard contractual clauses, with personal data masked before it is sent;
  an EU-only model mode is available per chatbot.
* **Consent-aware** — in GDPR-safe mode the widget stays dormant until your cookie
  banner (Borlabs Cookie, Complianz, Cookiebot, Usercentrics, Real Cookie Banner, or
  any tool via a one-line call) 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. Mignuti Chatbot is a paid service for
businesses: every account starts with a free 7-day trial, paid plans start at
9 EUR per month (see https://chatbot.mignuti.com/en/pricing). Sign up 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. Every
account starts with a free 7-day trial; after that a paid plan is required (from
9 EUR per month, see https://chatbot.mignuti.com/en/pricing). Sign up at
https://app.mignuti.com.

= Is it GDPR compliant? =

The platform runs on our own server in Germany. Answers come from a language
model at Anthropic (USA) under EU standard contractual clauses; personal data in
messages is masked before it is sent, and you can switch a chatbot to an EU-only
model. In GDPR-safe consent mode the widget script is fetched from our CDN but
opens no session, writes no storage and sends no message content until the visitor
consents through your cookie banner. Visitors can delete their own conversation
from the widget; data export and deletion for the whole site are self-service in
the Mignuti Chatbot admin. A data processing agreement (Art. 28 GDPR) is concluded
when you sign up: https://chatbot.mignuti.com/en/legal/dpa

= 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 (operated by Mignuti
Media — Eduard Ditler, Germany) in order to load and run the chat widget. The
service is required for the plugin to work.

**On your front-end pages (visitors)**

* **Widget loader** — the script `https://widget.mignuti.com/v1.js` is loaded
  asynchronously on the pages you select. It reads the Project ID, Secret, consent
  mode and optional accent color from the plugin settings. Fetching the script is an
  ordinary HTTP request to our CDN (Cloudflare); no session is opened by it.
* **Chat sessions** — when the visitor has consented (or you chose "Load
  immediately"), the widget calls `https://api.chatbot.mignuti.com` to open a
  short-lived session and to send and receive messages. Data sent: the visitor's
  messages, the page path, the browser language, a random session ID and the
  visitor's IP address (stored only as a salted hash for rate limiting). Message
  content is processed to generate a reply; personal data is masked before the
  language model is called. Conversations are anonymised after 90 days.

**In the WordPress admin (site owner only)**

* **Connect with Mignuti** — redirects you to `https://app.mignuti.com` to sign in
  and pick a project; the plugin then calls `https://api.chatbot.mignuti.com` once,
  server-to-server, to exchange a one-time code for your Project ID and Secret.
  Data sent: the one-time code and your site's origin (scheme and host).
* **Test connection** — sends your Project ID, Secret and site origin to the API
  and fetches the widget script from the CDN to report whether everything is
  reachable and this domain is allowed.

Nothing is sent from the front end before the widget script loads, and in GDPR-safe
consent mode no session is opened until consent is granted.

Service provider: Mignuti Media — Eduard Ditler, Lahnstein, Germany.
Terms of Service: https://chatbot.mignuti.com/en/legal/terms (German original: https://chatbot.mignuti.com/rechtliches/agb)
Privacy Policy: https://chatbot.mignuti.com/en/legal/privacy (German original: https://chatbot.mignuti.com/rechtliches/datenschutz)
Data Processing Agreement: https://chatbot.mignuti.com/en/legal/dpa

== 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.
