=== 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.6.0
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.

Starting with version 2.2.0, you can manage the essentials **directly from your WordPress dashboard** — no separate account needed: see your plan and monthly usage, add and remove FAQs, and view the leads captured by the widget.

= 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
* In-plugin dashboard (new) — manage your assistant from WP Admin, no separate login:
  * Overview: plan, status and monthly usage at a glance
  * FAQ: add and remove answers that the widget serves instantly and with priority
  * Leads: view the email leads captured by the widget
  * Booking (on booking-enabled plans): define services and working hours, and manage appointments — approve, cancel or delete
  * Design (on design-enabled plans): view all the renders generated by your visitors
  * Overview now shows a monthly analytics summary (AI / FAQ / Cache / off-topic) and your most frequent questions
* 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/home/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.
* **In-plugin dashboard (only when you open it in WP Admin):** sends management requests (view plan/usage, manage FAQs, view leads, on booking-enabled plans configure services/hours and manage appointments, and on design-enabled plans view generated renders) to the Oravio engine at `https://ludoprogrammingaceengine-dwb8bdexfnbzdvd2.northeurope-01.azurewebsites.net/api/manage/*`, authenticated with your license key and a management token stored securely in WordPress.
* **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.6.0 =
* New: enable "require email before chat" (lead capture) directly from the Leads tab — works on any plan

= 2.5.0 =
* New: monthly analytics summary in the dashboard Overview (total questions, breakdown by AI / FAQ / Cache / off-topic, and top questions)

= 2.4.0 =
* New: Design in the in-plugin dashboard (on design-enabled plans) — a gallery of all the renders generated by your visitors

= 2.3.0 =
* New: Booking in the in-plugin dashboard (on booking-enabled plans)
* Define services (name, duration, price) and weekly working hours
* Manage appointments — approve, cancel or delete, grouped by day
* Same server-side signed, allow-listed request model as the rest of the dashboard

= 2.2.0 =
* New: in-plugin dashboard in WP Admin (top-level "Oravio" menu) — manage your assistant without a separate account
* Overview: plan, status and current-month usage
* FAQ: add and remove answers served instantly and with priority by the widget
* Leads: view the email leads captured by the widget
* Management requests are signed server-side (license key + a management token kept in WordPress, never exposed to the browser) and restricted to a fixed allow-list of routes

= 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.
