=== Oravio — AI Widget ===
Contributors: dorubulubasa
Tags: ai chatbot, ai widget, customer support, chat, artificial intelligence
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add an AI assistant to your WordPress site in 30 seconds. It answers visitor questions automatically, 24/7.

== Description ==

**Oravio** is an embeddable AI widget that automatically answers your visitors' questions, based on the content of your site.

= How does it work? =

1. Automatically indexes the pages of your site
2. Uses RAG (Retrieval Augmented Generation) for accurate answers
3. Semantic cache for fast responses and lower costs

= Features =

* Install in 30 seconds — just enter your license key
* Circle or pill (with text) widget
* Configurable position: bottom right or bottom left
* Full white label: title, accent color, logo, placeholder
* Answers based on your own site content
* Semantic cache — instant answers for frequent questions
* Analytics dashboard with requests, tokens, and cache hit rate
* Free Basic plan forever — no credit card required

= Available plans =

* **Basic** — Free forever, 500 requests/month, 1 domain
* **Pro** — EUR 29/month, 30,000 requests/month, 5 domains
* **Business** — EUR 99/month, 150,000 requests/month, 50 domains
* **Enterprise** — custom quote

= Useful links =

* [Official site](https://ludoprogramming.com/en)
* [Oravio Dashboard](https://ludoprogramming.com/en/ace/dashboard)
* [Documentation](https://ludoprogramming.com/en/documentation)
* [Pricing](https://ludoprogramming.com/en/pricing)

= External services =

Oravio is a SaaS service (provided by LudoProgramming). To work, the plugin communicates with the Oravio servers. What data is sent and when:

* **On activation / free account creation:** sends the site domain, the administrator email address, and the site name to `https://ludoprogramming.com/api/wp/onboard`, in order to automatically create a free Basic account and license.
* **On license verification:** sends the license key to `https://ludoprogramming.com/api/wp`.
* **The chat widget:** loads the script from `https://ludoprogrammingaceengine-dwb8bdexfnbzdvd2.northeurope-01.azurewebsites.net/api/ace.js` and sends visitor questions to the Oravio engine to generate answers.
* **WooCommerce connector (optional, only if you enable it):** the plugin exposes an endpoint that only Oravio calls to check the status of an order (by order number + email). Identity is validated locally, in WordPress — Oravio never receives WooCommerce keys.

By using the plugin you agree to the service's Terms of Use and Privacy Policy:

* Terms of Use: https://ludoprogramming.com/terms
* Privacy Policy: https://ludoprogramming.com/privacy

== Installation ==

= Automatic installation (recommended) =

1. In your WordPress dashboard, go to **Plugins → Add New**
2. Search for **Oravio AI Widget**
3. Click **Install Now** and then **Activate**
4. Go to **Settings → Oravio AI** and enter your license key

= Manual installation =

1. Download the plugin `.zip` file
2. In your WordPress dashboard, go to **Plugins → Add New → Upload Plugin**
3. Select the `.zip` file and click **Install Now**
4. Activate the plugin
5. Go to **Settings → Oravio AI** and enter your license key

= Getting a license key =

1. Register for free at [ludoprogramming.com](https://ludoprogramming.com/en/ace/dashboard)
2. The Basic plan is free forever — no credit card required
3. Create a license for your domain
4. Copy the license key (format: LIC-XXXX...)

== Frequently Asked Questions ==

= Is it free? =

Yes! The Basic plan is free forever and includes 500 requests/month and 1 domain — no credit card required.

= What does the widget do with my site content? =

Oravio automatically indexes the pages of your site and uses this information to accurately answer visitor questions. The content is used solely to generate answers and is not shared with other users.

= Does it work with any WordPress theme? =

Yes. The plugin enqueues a single `<script>` in the site footer, compatible with any WordPress theme.

= How do I get a license key? =

Register for free at [ludoprogramming.com](https://ludoprogramming.com/en/ace/dashboard). The Basic plan does not require a credit card.

= Can I customize the look of the widget? =

Yes. From the plugin settings you can configure: the style (circle or pill), the position, the title, the accent color, the logo, and the input placeholder.

= Does it work with WooCommerce? =

Yes. If you have WooCommerce active, a section appears in the settings where you generate a "connector secret". With it, the Oravio assistant can check order status directly in your store (by order number + email). The customer's identity is validated locally, in WordPress.

== Screenshots ==

1. The plugin settings in the WordPress dashboard
2. The AI widget active on a WordPress site
3. The Oravio dashboard with analytics

== Changelog ==

= 2.1.2 =
* Admin CSS/JS now enqueued via admin_enqueue_scripts (wp_add_inline_style / wp_add_inline_script / wp_localize_script) instead of inline tags
* readme: corrected Contributors to the plugin owner account

= 2.1.1 =
* Compliance with WordPress Plugin Check: unslash inputs before sanitization, escape all output, nonce verification on license removal, wp_safe_redirect, wp_parse_url
* The widget script is now registered via wp_enqueue_script() instead of a raw footer tag
* Admin UI and readme fully in English
* Tested up to WordPress 7.0

= 2.1.0 =
* Oravio for WooCommerce: REST endpoint `oravio/v1/order-status` lets the assistant check order status
* New "Connector secret" field in settings (shown only when WooCommerce is active), with generator
* Identity (order number + email) is validated in WordPress — Oravio never receives WooCommerce keys
* readme: dedicated "External services" disclosure section

= 2.0.0 =
* Full rebranding AceEngine → Oravio
* Settings page renamed (Settings → Oravio AI)
* Text domain: oravio-ai-widget
* Stability and security improvements

= 1.0.0 =
* Initial release
* License key + automatic script injection
* White label: title, accent color, logo, placeholder
* Position toggle: bottom right / bottom left
* Widget style: circle / pill

== Upgrade Notice ==

= 2.1.1 =
Compliance and quality update (WordPress Plugin Check). Recommended for everyone.

= 2.0.0 =
Rebranding to Oravio. Settings move under Settings → Oravio AI; re-enter your license key if needed.

= 1.0.0 =
Initial release of the plugin.
