=== Ginnobot AI Chatbot ===
Contributors: ginnobot
Donate link: https://ginnobot.ai/
Tags: ai chatbot, chatbot, customer support, live chat, lead capture
Requires at least: 5.5
Tested up to: 7.0
Stable tag: 1.0.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your WordPress website to the Ginnobot AI Chatbot service using your Chatbot Key.

== Description ==

**Ginnobot AI Chatbot** allows WordPress website owners to integrate the Ginnobot AI chatbot service into their websites.

After installing the plugin, enter your Chatbot Key in the plugin settings. The plugin loads the hosted chatbot widget on your website.

The chatbot can be trained using documents, website URLs, FAQs, and other supported content available in your Ginnobot account.

> For more information, visit https://ginnobot.ai.

---

### Features

* Connects a WordPress website to the Ginnobot AI chatbot service
* Supports chatbot training using documents, URLs, and FAQs
* Allows chatbot positioning on the website
* Provides lead capture functionality
* Includes configurable settings in the WordPress admin area
---

### Perfect for

| Business type | Use case |
|---|---|
| E-commerce | Product questions, order tracking, return policy |
| SaaS | Onboarding, feature explanations, troubleshooting |
| Healthcare | Appointment FAQs, clinic info, service info |
| Real estate | Property listings, viewing requests, mortgage FAQs |
| Education | Course info, admissions, enrollment guidance |
| Restaurants | Menu, reservations, hours, allergen info |
| Law firms | Service overview, appointment booking |
| Any business | 24/7 customer support, lead generation |

---

### How it works

1. **Create** a chatbot in your [Ginnobot dashboard](https://ginnobot.ai/dashboard)
2. **Train** it — upload PDFs, add website URLs, paste text or FAQs
3. **Copy** the Chatbot Key (starts with `cn_live_...`)
4. **Paste** the key in the plugin settings and save
5. Your chatbot is **live** on every page of your WordPress site

---

### Service information

This plugin connects to the **Ginnobot API** (ginnobot.ai) to load the chat widget and process AI conversations. The following external requests are made:

* `https://ginnobot.ai/chatbot/widget.js` — loads the chat UI (only when a chatbot key is configured)
* `https://ginnobot.ai/api/v1/chat/*` — processes messages when a visitor sends one

No data is sent to external servers unless a visitor opens and interacts with the chatbot widget. By using this plugin you agree to the [Ginnobot Terms of Service](https://ginnobot.ai/terms) and [Privacy Policy](https://ginnobot.ai/privacy).

---

### Requirements

* Free Ginnobot account — [sign up here](https://ginnobot.ai/signup)
* WordPress 5.5+
* PHP 7.4+
* A chatbot key from your dashboard

== Installation ==

= Automatic (recommended) =

1. In your WordPress admin, go to **Plugins → Add New**
2. Search for **Ginnobot AI Chatbot**
3. Click **Install Now**, then **Activate**
4. Go to **Ginnobot** in the left admin menu
5. Paste your Chatbot Key and click **Save Settings**

= Manual =

1. Download the `.zip` file from the WordPress plugin directory
2. In your WordPress admin, go to **Plugins → Add New → Upload Plugin**
3. Upload the zip, click **Install Now**, then **Activate**
4. Go to **Ginnobot** in the left admin menu
5. Paste your Chatbot Key and click **Save Settings**

= Getting your Chatbot Key =

1. Go to [ginnobot.ai](https://ginnobot.ai) and sign up (free)
2. Create a new chatbot and train it with your content
3. Open the chatbot, go to **Deploy** tab
4. Copy the key — it looks like `cn_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
5. Paste it in the plugin settings

== Frequently Asked Questions ==

= Do I need a Ginnobot account? =

Yes, a free account is required. Sign up at [ginnobot.ai](https://ginnobot.ai) — no credit card needed.

= Will this slow down my website? =

The widget script is loaded asynchronously in the footer to minimize its impact on page loading.

= Can I train the chatbot on my own content? =

Yes. You can train the chatbot by uploading PDFs, adding website URLs, pasting FAQs, or connecting your knowledge base from your Ginnobot dashboard.

= Does it work with Elementor, Divi, and other page builders? =

Yes. The plugin injects a floating widget that works alongside any theme or page builder.

= Can I hide the chatbot on specific pages? =

Yes. In the plugin settings there is an "Exclude from Pages" field where you can enter comma-separated page/post IDs.

= Can I hide the chatbot on mobile devices? =

Yes. Enable the "Hide on Mobile" toggle in the settings.

= Is the chatbot GDPR compliant? =

Ginnobot is designed with privacy in mind. No data is collected from visitors until they interact with the chatbot. See our full [Privacy Policy](https://ginnobot.ai/privacy).

= What languages does the chatbot support? =

The AI automatically responds in the visitor's language. The admin settings panel supports full WordPress i18n/l10n.

= Can I use multiple chatbots on different pages? =

The plugin uses one chatbot key globally. For page-specific bots, use the exclude list and load the embed code manually on individual pages.

= Where is my data stored? =

Conversation data is stored securely on Ginnobot's servers. See our [Privacy Policy](https://ginnobot.ai/privacy) for full details.

== Screenshots ==

1. **Admin settings panel** — clean, two-step setup
2. **Chatbot widget on a live site** — floating button, branded header
3. **Conversation in action** — AI answering a product question
4. **Ginnobot dashboard** — train your bot, monitor analytics

== Changelog ==

= 1.0.1 - 2026-08-04 =
* Updated plugin documentation to use neutral descriptive language for WordPress.org review.

= 1.0.0 - 2026-07-29 =
* Initial Ginnobot AI Chatbot release.
* Loads the hosted Ginnobot widget from ginnobot.ai.
* Adds Chatbot Key, widget position, mobile visibility, excluded pages, and cookie consent settings.
