=== Rivinci Chat by Rinoova ===
Contributors: rinoova
Tags: chat, chatbot, ai, widget, iframe
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed the Rivinci AI chat widget in your WordPress site via shortcode or a floating button.

== Description ==

**Rivinci Chat by Rinoova** lets you add the [Rivinci](https://rivinci.io) AI assistant (a Rinoova SRL product) to your WordPress site in seconds.

= Main features =

* **Shortcode** `[rivinci_chat]` — embed the widget in any page or post
* **Inline slug override** — `[rivinci_chat slug="another-agent"]` to use different agents per page
* **Floating chat button** — optional, shown fixed at the bottom-right corner on every page
* **Customizable color** — choose the button color with a color picker
* **WordPress user integration** — optionally sends the logged-in user ID to the agent via `postMessage`
* **No external dependencies** — pure PHP, no additional JavaScript libraries

= Getting started =

1. Install and activate the plugin
2. Go to **Rivinci Chat** in the WordPress admin sidebar
3. Enter the **Agent Slug** provided by Rivinci
4. Add `[rivinci_chat]` to a page or enable the floating button
5. Save and view the frontend

= Shortcode =

Basic usage:
`[rivinci_chat]`

With a custom slug for that specific page:
`[rivinci_chat slug="my-agent"]`

= Requirements =

* A Rivinci account with at least one configured agent — [rivinci.io](https://rivinci.io)

== Installation ==

1. Upload the `rivinci-chat` folder to `/wp-content/plugins/`
   or install directly via **wp-admin → Plugins → Add New → Upload Plugin**
2. Activate the plugin from the **Plugins** screen in WordPress
3. Go to **Rivinci Chat** in the admin sidebar and enter your agent slug
4. Add `[rivinci_chat]` to a page or enable the floating button from settings

== Frequently Asked Questions ==

= Where do I find my agent slug? =

Log in to your account at [rivinci.io](https://rivinci.io) and copy the slug from the agent URL or its settings card.

= Can I use different agents on different pages? =

Yes, use the inline shortcode parameter: `[rivinci_chat slug="specific-agent"]`

= Will the floating button show on pages that already use the shortcode? =

Yes, they are independent. If you do not want the widget to appear twice, use only one of the two methods.

= Does postMessage work for non-logged-in users? =

The "Pass WordPress user" option only sends the message when the user is logged in (ID > 0). Nothing is sent for anonymous visitors.

= Does the plugin work with page builders (Elementor, Divi, etc.)? =

Yes, insert `[rivinci_chat]` via the shortcode block available in any page builder.

= Do I need to update my privacy and cookie policy? =

Yes. The chat widget loads in a cross-origin iframe, so cookie-scanner plugins (Complianz, CookieYes, Iubenda…) cannot detect the entries it uses. Open **Rivinci Chat** in the admin sidebar: the settings page includes a "Privacy & cookies" box with ready-to-paste Privacy Policy and Cookie Policy templates. You remain responsible for the legal compliance of your website.

== Screenshots ==

1. Settings page — agent slug, user options, floating button toggle and color picker
2. `[rivinci_chat]` shortcode embedded in a page
3. Floating chat button with popup open on the frontend

== Changelog ==

= 1.0.3 =
* Added a Privacy & cookie compliance reminder in the settings page, with ready-to-paste Privacy Policy and Cookie Policy templates (localStorage entries included)
* The localStorage keys in the templates are pre-filled with the configured agent slug
* Added Italian (it_IT) translations for the new strings; refreshed the .pot template

= 1.0.2 =
* Added onboarding guide in settings page with setup instructions
* Added shortcode usage hint in settings page

= 1.0.1 =
* Added Italian (it_IT) translation

= 1.0.0 =
* Initial public release
* `[rivinci_chat]` shortcode with optional `slug` parameter
* Floating button with 380x600px popup
* Color picker for button color
* Optional WordPress user ID integration via postMessage

== Upgrade Notice ==

= 1.0.0 =
First release — no migration needed.
