=== Alvoru AI Chatbot ===
Contributors: yousrii
Tags: chatbot, ai, customer service, livechat, widget
Requires at least: 5.6
Tested up to: 7.0
Stable tag: 1.1.3
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a smart AI chatbot to your WordPress website. Your customers get help 24/7 in Dutch, English and German.

== Description ==

**Alvoru AI Chatbot** places a professional AI assistant on your website that answers your customers directly and automatically — day and night, seven days a week.

The chatbot is trained on your own business information and answers questions about your products, services, opening hours, prices and more. Your customers get a relevant answer right away, without you having to do anything.

= What does this plugin do? =

The plugin adds one small JavaScript tag to every page of your WordPress website. As soon as your Client ID is filled in, the Alvoru AI chat widget appears in the bottom-right corner of the screen. Visitors can ask questions directly and get an immediate answer from the AI.

= Why Alvoru? =

* **Available 24/7** — Your AI assistant never sleeps. Even on Sunday at 3 a.m., visitors get an instant answer.
* **Multilingual** — The chatbot speaks fluent Dutch, English and German.
* **No technical knowledge required** — Installation takes about two minutes. Just enter your Client ID and save.
* **Trained on your own content** — You enter your own information in the customer portal. The AI learns from your business details, FAQ and products.
* **GDPR compliant** — Alvoru processes data in accordance with the GDPR. All data is stored on European servers.
* **No setup costs** — No one-time fees, no technical installation, get started right away.
* **14-day satisfaction guarantee** — Not satisfied? You get your money back, no questions asked.

= How it works =

1. Create an account at [alvoru.com](https://alvoru.com/signup)
2. Log in to your customer portal at [portaal.alvoru.com](https://portaal.alvoru.com/portaal)
3. Enter your business information so the AI gets to know your company
4. Copy your unique Client ID from the portal
5. Paste the Client ID into the settings of this plugin
6. Done — the chatbot is live on your website!

= Who is Alvoru for? =

Alvoru is built for small and medium-sized businesses. Whether you run a webshop, a restaurant, a hair salon or a legal practice — any business owner who wants to improve customer service without extra staff benefits from Alvoru.

= Technical details =

The plugin loads the chat widget script over a secure HTTPS connection from alvoru.com. Your Client ID is passed as a data attribute. The plugin itself does not set any cookies. The chat widget communicates with the Alvoru servers to process messages.

= Privacy =

When a visitor uses the chatbot, the messages are processed by the Alvoru servers and by the Anthropic API (Claude AI). See the Alvoru privacy policy: [https://alvoru.com/privacy](https://alvoru.com/privacy)

== Installation ==

= Automatically via WordPress =

1. In your WordPress admin, go to **Plugins → Add New Plugin**
2. Search for **Alvoru AI Chatbot**
3. Click **Install Now** and then **Activate**
4. Go to **Settings → Alvoru Chatbot**
5. Enter your Client ID (found in your [customer portal](https://portaal.alvoru.com/portaal))
6. Click **Save Changes**

= Manually via FTP =

1. Download the plugin ZIP from WordPress.org
2. Extract the ZIP file
3. Upload the `alvoru-chatbot` folder to `/wp-content/plugins/`
4. Activate the plugin via **Plugins** in WordPress
5. Go to **Settings → Alvoru Chatbot** and enter your Client ID

= Don't have an Alvoru account yet? =

Create a free account at [alvoru.com/signup](https://alvoru.com/signup). Your chatbot is live within minutes.

== Frequently Asked Questions ==

= Do I need an Alvoru account? =

Yes, you need an Alvoru account to use the chatbot. You can create an account at [alvoru.com/signup](https://alvoru.com/signup). After signing up, you receive your personal Client ID.

= Where do I find my Client ID? =

Log in to your customer portal at [portaal.alvoru.com](https://portaal.alvoru.com/portaal). Your Client ID is shown in your account overview. Copy this ID and paste it into the plugin settings under **Settings → Alvoru Chatbot**.

= Does the chatbot slow down my website? =

No. The script is loaded asynchronously (the `async` attribute) and does not block your page load time. The impact on your Core Web Vitals is minimal.

= Which languages does the AI speak? =

The Alvoru AI speaks fluent **Dutch**, **English** and **German**. The AI automatically detects the visitor's language and replies in the same language.

= Can I customize the chatbot for my business? =

Yes. Through your customer portal you can enter your business information, frequently asked questions and product information. The AI uses this information to give relevant answers. You can also customize the name and appearance of the chat widget.

= Is the plugin GDPR compliant? =

Yes. Alvoru processes all data in accordance with the General Data Protection Regulation (GDPR). Data is stored on European servers (Hetzner, Germany). See our full privacy policy at [alvoru.com/privacy](https://alvoru.com/privacy).

= What happens if I remove the plugin? =

When you remove the plugin, all local settings (your Client ID) are automatically deleted from the WordPress database. Data on the Alvoru servers is not removed automatically — contact us at info@alvoru.com to delete your account.

= How much does Alvoru cost? =

See the current pricing at [alvoru.com](https://alvoru.com). There is a 14-day trial period with a satisfaction guarantee.

== Screenshots ==

1. The Alvoru AI chat widget on a WordPress website — visitors see the chat in the bottom-right corner.
2. The plugin settings page — enter your Client ID in 4 simple steps to activate the chatbot.
3. The Alvoru customer portal — here you find your Client ID and manage the content of your AI chatbot.

== Changelog ==

= 1.1.3 =
* The widget script now uses the WordPress 6.3 'async' loading strategy via wp_enqueue_script().
* The data-client-id attribute is now added by filtering the script tag generated by WordPress, instead of building the tag manually.

= 1.1.2 =
* The Client ID setting is now registered on the init hook, so the one-click installation via the REST API sets the Client ID correctly.

= 1.1.1 =
* The widget script is now loaded via wp_enqueue_script() instead of a direct echo.
* readme and plugin headers translated to English.

= 1.1.0 =
* Improved onboarding experience: clear 4-step UI on the settings page
* Added: "Create an account on Alvoru" button for new users
* Added: "Open your portal" button for direct access to the customer portal
* Added: activation redirect to the settings page after first install
* Added: green/yellow status indicator showing whether the chatbot is active
* Added: uninstall.php removes the Client ID option when the plugin is deleted
* Added: version number as query parameter on the script tag for better cache control

= 1.0.4 =
* Initial public release
* Adds the chat widget script tag to all pages via wp_footer
* Settings page with Client ID input field
* Sanitization and escaping in line with WordPress coding standards
* Admin notice when the Client ID has not been set yet

== Upgrade Notice ==

= 1.1.3 =
Recommended update: the widget script now uses the official WordPress async loading strategy and the script tag is handled fully through the WordPress enqueue system.

= 1.1.1 =
Recommended update: the widget script is now loaded via wp_enqueue_script() and the documentation is in English.

== External Services ==

This plugin relies on an external service: **Alvoru** (https://alvoru.com).

**What is loaded?**
On every page view on your website, the plugin loads the following JavaScript file:

`https://alvoru.com/chat-widget.js`

This file contains the chat widget that is shown to your visitors. When this script is loaded, a connection is made to the Alvoru servers.

**When is the connection made?**
Only when you have set a valid Client ID in the plugin settings. Without a Client ID, nothing is loaded.

**Which data is shared?**

* Your Client ID (as a data attribute on the script tag)
* The IP address and browser details of your website visitors (through loading the script)
* Messages that visitors type into the chat widget

**Third-party processing:**
The chat messages are processed by the Anthropic API (Claude AI). See the Anthropic privacy policy: https://www.anthropic.com/privacy

**Links to the Alvoru policies:**

* Terms of Service: https://alvoru.com/algemene-voorwaarden
* Privacy Policy: https://alvoru.com/privacy
* Data Processing Agreement: https://alvoru.com/verwerkersovereenkomst
