=== Reval Chatbot ===
Contributors: reval
Tags: chatbot, ai, chat, support, rag
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add your Reval AI chatbot to WordPress. Paste your chatbot key and a floating chat widget, grounded in your own knowledge, appears on your site.

== Description ==

Reval is a "chatbot trained on your own knowledge" service. Add your knowledge (crawled
website, uploaded documents or pasted text) in the Reval dashboard, and this plugin puts the
matching chat widget on your WordPress site with a single setting.

The plugin injects the same lightweight loader script that Reval generates for you, so:

* **You only paste your chatbot key.** No code, no theme edits.
* **Appearance is managed in Reval.** Colours, position, right-to-left layout, welcome message,
  avatar and suggested questions all come from your dashboard — change them there and they update
  everywhere.
* **The widget is isolated.** The chat UI runs inside an iframe, so it never clashes with your
  theme's styles or scripts.
* **You control where it shows.** Display it on every page, or only on chosen post types, the
  front page or the blog index. Optionally hide it from logged-in users or administrators.

The admin interface is available in English and Persian (فارسی) and is fully right-to-left aware.

When WooCommerce is active, Reval can also connect through a one-time approval link and keep
products, prices, stock, images and deletions synchronized with the chatbot automatically.

== Installation ==

1. Upload the `reval-chatbot` folder to `/wp-content/plugins/`, or install the ZIP via
   **Plugins → Add New → Upload Plugin**.
2. Activate the plugin through the **Plugins** screen.
3. Go to **Settings → Reval Chatbot**.
4. Paste your chatbot key (it starts with `pk_`; find it on your chatbot's Install page in the
   Reval dashboard) and save.
5. Visit your site — the chat button appears in the corner.

== Frequently Asked Questions ==

= Where do I find my chatbot key? =

In the Reval dashboard, open your chatbot and go to the Install page. The key starts with `pk_`.

= The widget does not appear on my site. What should I check? =

First, confirm a key is saved and your display rules include the page you are viewing. Also make
sure you registered this site's domain on the Reval website — a chatbot only loads on the domains
you have added there.

= Can I change the colours or position here? =

No. Appearance is intentionally managed in the Reval dashboard so it stays consistent across
every place your widget is embedded. Change it there and it updates on your WordPress site
automatically.

= Does the widget affect my theme's design? =

No. The chat interface runs inside an isolated iframe, so it cannot inherit or override your
theme's CSS.

== Changelog ==

= 1.2.1 =
* Updated the production service origin to revalai.ir.
* Added visible WooCommerce connection and synchronization notices.
* Limited catalogue synchronization to published WooCommerce products.

= 1.2.0 =
* Added conversational checkout with explicit customer confirmation.
* Creates idempotent WooCommerce orders and returns the secure payment link.
* Calculates the cheapest available shipping method for the supplied address.

= 1.1.0 =
* Added secure one-click WooCommerce catalogue pairing.
* Added background full-catalogue sync and automatic product update/delete sync.

= 1.0.0 =
* Initial release: connect a Reval chatbot with a single key, with display rules and a
  bilingual (English/Persian) right-to-left aware admin screen.
