=== Vantus Widget ===
Contributors: vantus
Tags: chat, ai, assistant, chatbot, support
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.3.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add an AI-powered chat assistant to your WordPress site. Connects to the Vantus AI service with your API key — no coding required.

== Description ==

Vantus Widget adds an intelligent, AI-powered chat assistant to your WordPress site. Install the plugin, paste your Vantus API key, choose where the widget should appear, and you are done — no coding required.

The plugin is a lightweight configuration bridge: it loads the Vantus chat widget script from the Vantus CDN and tells it which API key to use and where to appear. The conversation itself is handled by the Vantus AI service.

= Features =

* AI-powered chat assistant on your pages and posts
* Simple setup: paste your API key in **Vantus AI**, its own entry in the admin menu
* Choose where the widget appears (home page and/or specific post types)
* Global on/off switch
* Lightweight: the widget loads asynchronously from a CDN with a `defer` attribute, so it does not block page rendering
* Automatically excluded from WP Rocket and LiteSpeed Cache JS optimization to avoid breakage

== External services ==

This plugin connects to the **Vantus AI** service, operated by Vantus. The connection is required for the chat assistant to function.

What is loaded and sent, and when:

* **Widget script and version manifest** — On front-end page views where the widget is enabled, the plugin loads the widget JavaScript from `https://cdn.vantus.io/chat-widget.latest.js` and reads the version manifest at `https://cdn.vantus.io/manifest.json`. No personal visitor data is sent in these requests.
* **Chat messages** — When a visitor interacts with the widget, the messages they type are sent to the Vantus AI backend (associated with your API key) to generate a response.
* **Contact details, when the visitor provides them** — The assistant can collect a visitor's name, email address, phone number and company to capture a sales lead or open a support ticket. This only happens when the visitor fills in one of those forms inside the chat. Those details are sent to, and stored by, the Vantus AI service under your account, so that you can see and answer them from your Vantus dashboard.

The plugin itself does not collect or store personal data in your WordPress database beyond your API key and display settings. Everything described above is handled by the Vantus AI service, not by your WordPress installation.

**You are the data controller for your visitors' data; Vantus processes it on your behalf.** If your site is subject to GDPR or a similar regime, name Vantus as a processor in your own privacy policy and make sure your policy covers the chat assistant.

* Terms of Service: https://vantus.io/terminos-y-condiciones
* Privacy Policy: https://vantus.io/aviso-de-privacidad

== Installation ==

1. Upload the `vantus-widget` folder to `/wp-content/plugins/`, or install the plugin through the **Plugins → Add New** screen in WordPress.
2. Activate the plugin through the **Plugins** menu.
3. Go to **Vantus AI** in the admin menu and enter your API key.
4. Choose where the widget should appear and save.

== Frequently Asked Questions ==

= Where do I get an API key? =

Sign up at [vantus.io](https://vantus.io) to get your API key. It has the format `vx_live_` followed by 48 hexadecimal characters.

= Can I disable the widget on specific pages? =

Yes. In **Vantus AI**, use the Visibility checkboxes to choose the post types (and the home page) where the widget should appear. You can also turn it off everywhere with the Global Disable switch.

= Does this slow down my site? =

No. The widget loads asynchronously from a CDN with a `defer` attribute and does not block page rendering. It is also excluded from WP Rocket and LiteSpeed JS optimization to avoid conflicts.

= Is it compatible with my theme? =

Yes. The widget renders independently of your theme's CSS.

= What data is sent to Vantus? =

See the **External services** section above. In short: the widget script is loaded from the Vantus CDN, and chat messages typed by visitors are sent to the Vantus AI backend to generate replies. If a visitor fills in a lead or support-ticket form inside the chat, the contact details they enter (name, email, phone, company) are sent and stored under your Vantus account as well.

= Do I need to update my privacy policy? =

If your site is subject to GDPR or a similar regime, yes. You are the data controller for your visitors' data and Vantus is a processor acting on your behalf, so your own privacy policy should mention the chat assistant and name Vantus as a processor.

== Screenshots ==

1. The Vantus AI settings page: API key, global disable and visibility controls.
2. The Vantus chat assistant widget open on a live site.

== Changelog ==

= 1.3.4 =
* Changed: the Author URI now points to the official Vantus profile on WordPress.org.

= 1.3.3 =
* Changed: the widget now appears on the home page by default. It was excluded, so a fresh install showed nothing on the page most people check first.
* Changed: Vantus AI now has its own entry in the admin menu, with the Vantus mark, instead of living under Settings.
* Changed: translations are now managed through WordPress.org language packs instead of bundled files.
* Fixed: the widget appeared on a blog-index home page when "Posts" was checked but "Home page" was not. Post-type visibility now applies to singular views only, so each checkbox means what its label says.

Earlier releases are listed in changelog.txt.

== Upgrade Notice ==

= 1.3.4 =
The Author URI now points to the official Vantus profile on WordPress.org.
