=== Botino Chatbot ===
Contributors: botino
Tags: chatbot, ai, customer-support, widget
Requires at least: 5.8
Tested up to: 7.1
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed your Botino AI chatbot on your WordPress site and securely identify signed-in users.

== Description ==

Botino is an AI chatbot platform. This plugin injects the Botino loader on your site and, when enabled, sends a signed identity hash so the chatbot can personalize answers for signed-in WordPress users.

Features:

* One-click embed via the loader.js script
* Optional secure identity verification (HMAC-SHA256)
* Pass user email and display name as locked contact data
* Optionally show the chatbot in wp-admin too
* Full Persian (فارسی) translation with right-to-left support

== Installation ==

1. Upload the plugin folder to /wp-content/plugins/botino-chatbot
2. Activate via the Plugins screen
3. Go to Settings → Botino Chatbot and paste your chatbot ID and identity secret
4. Save changes

== Frequently Asked Questions ==

= Where do I find the chatbot ID? =
In your Botino panel, open the chatbot you want to embed; the chatbot ID is shown in the install instructions.

= Where do I find the identity secret? =
In the chatbot settings, look for "Identity secret" (under Channels → Chat widget → Identity).

== External Services ==

This plugin connects to the **Botino** service to load and display your AI chatbot widget.

= Botino Widget API (api.botinoai.ir) =

* **What it is:** The Botino chatbot platform. This plugin embeds the Botino chat widget on your site by communicating with Botino's servers.
* **What data is sent and when:**
  * On every page load where the chatbot is active, the plugin fetches widget configuration from `https://api.botinoai.ir/api/v1/widget/embed-bootstrap?chatbotId=<your-chatbot-id>`. Only the chatbot ID is sent; no visitor data is included in this server-side request.
  * The Botino loader script (`loader.js`) is then injected into the page. That script communicates with Botino's servers to render the chat widget and handle conversations. If the "Pass logged-in user identity" option is enabled, a signed HMAC-SHA256 hash of the logged-in WordPress user's ID, email, and display name is passed to the widget so Botino can personalise the conversation.
* **Service provider:** Botino (botinoai.ir)
* **Terms of Service:** https://botinoai.ir/terms
* **Privacy Policy:** https://botinoai.ir/privacy

== Changelog ==

= 1.0.0 =
* First production release.
* Added Persian (fa_IR) translation and right-to-left admin support.
* Branded the settings page with the Botino logo.
* Removed the API base URL setting (now fixed to the Botino service).

= 0.1.0 =
* Initial scaffold.
