=== Maya Voice Assistant ===
Contributors: mytechupgrade
Tags: voice assistant, ai, chatbot, accessibility, woocommerce
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed the Maya voice assistant on your WordPress storefront to help customers ask product questions and make purchases through natural conversation.

== Description ==

Maya is an AI-powered voice assistant for e-commerce and storefront sites. With this plugin, you can easily add Maya to your WordPress site in minutes.

**Key Features:**

* **Voice Interactions** — Customers can speak naturally to ask about products, get recommendations, and complete purchases.
* **No Setup Required** — Just enter your Maya Widget ID in the plugin settings and Maya appears on every page.
* **Accessibility Compliant** — Keyboard navigation, screen reader support, and reduced-motion detection (EU Accessibility Act 2025).
* **Multi-Language** — Automatic browser language detection (English, Italian, Romanian, German).
* **Lead Capture** — Collect customer information for follow-up sales engagement.
* **Secure** — Safe iframe-based embedding with no data exposure.

**How It Works:**

1. Get your Maya Widget ID from your [Maya Dashboard](https://maya.mytechupgrade.com).
2. Install and activate this plugin.
3. Go to **Settings → Maya** and paste your Widget ID.
4. Maya appears on all your store pages automatically.

Customers see a voice button in the bottom-right corner of your site. They click to chat with Maya, who:
- Answers product questions in real time.
- Recommends products based on customer intent.
- Collects contact info and leads.
- Guides buyers through checkout.

== Installation ==

1. Download the plugin and extract the folder.
2. Upload the `maya-voice-assistant` folder to `/wp-content/plugins/`.
3. Go to **Plugins** in your WordPress admin and activate "Maya Voice Assistant."
4. Go to **Settings → Maya** and enter your Widget ID.
5. Confirm Maya appears on your storefront.

== Configuration ==

After activation, go to **Settings → Maya** to set:

* **Maya Widget ID** (required) — From your Maya dashboard.
* **Maya App URL** (optional) — Defaults to https://maya.mytechupgrade.com. Change if you're on a custom domain.

== Security ==

* Widget IDs are validated against alphanumeric, hyphen, and underscore characters.
* App URLs are escaped and validated before output.
* The plugin uses WordPress sanitization and escaping best practices.
* No user data is stored locally; all communication goes to Maya's secure API.

== Frequently Asked Questions ==

= Where do I get my Widget ID? =

Log in to [Maya Dashboard](https://maya.mytechupgrade.com), create a website, and copy the Widget ID shown in the embed instructions.

= Does Maya work on mobile? =

Yes! Maya is fully responsive and works on phones, tablets, and desktops.

= Can I customize Maya's position? =

Currently, Maya appears in the bottom-right corner. Custom positioning is available through your Maya dashboard.

= What languages does Maya support? =

Maya supports English, Italian, Romanian, and German. It auto-detects the browser language.

= Is Maya GDPR compliant? =

Maya is designed with privacy in mind. All customer interactions are handled securely. See our [Privacy Policy](https://maya.mytechupgrade.com/privacy) for details.

= Can I use Maya on multiple sites? =

Yes! You can create multiple Widget IDs in your Maya dashboard, one per site.

== Changelog ==

= 1.0.0 =
* Initial release.
* Widget ID and App URL configuration.
* Automatic script injection on all pages.
* Settings link in plugins list.

== Support ==

For support, visit [Maya Help Center](https://maya.mytechupgrade.com/help) or contact hello@maya.mytechupgrade.com.

== External Services ==

This plugin connects to Maya (https://maya.mytechupgrade.com) to:
- Load the Maya voice assistant widget (widget.js) on your website pages

Data processed: website visitor messages, lead capture data (name, email). Audio processed in real-time; not stored by Maya.

Terms of Service: https://maya.mytechupgrade.com/terms
Privacy Policy: https://maya.mytechupgrade.com/privacy
