=== Voizual ===
Contributors: voizual
Tags: ai, assistant, video, chat, voice
Requires at least: 6.3
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Give your website a voice with your Voizual AI video agent.

== Description ==
Connect your Voizual account, choose an agent, and show it on every page. Choose the agent's language, match the page language, or set a fixed language. Let Voizual control the starting mode and corner, or override them here.

Requires an account at https://voizual.com and a ready agent. Create and manage agents in Voizual. The plugin reads account details, agents, available languages and public embed configuration using a server-side API key. It never sends the key to visitors. Your site's address is sent to Voizual when checking embed configuration.

External service: the widget loads https://voizual.com/embed.js and connects visitors to Voizual when they interact with the agent. Review the privacy information and terms available at https://voizual.com before enabling it, and update your own site's visitor disclosures as appropriate. The plugin adds no analytics or customer tracking of its own.

== Installation ==
1. In WordPress, open Plugins > Add New Plugin > Upload Plugin.
2. Upload voizual-wordpress-1.0.0.zip, install and activate.
3. Click Settings under Voizual in the Plugins list (or open Settings > Voizual).
4. Create a key in Voizual > Settings > API keys and paste it into the connection form.
5. Choose a ready agent, choose the widget options, and save.
6. Add your site's domain in Voizual, in the agent's Share > Website. Open your website to check it.

== Frequently Asked Questions ==
= Does it call the API on every page view? =
No. Pages use the saved widget configuration. Settings saves and the daily WordPress scheduled task refresh it. Failed requests keep the last saved widget.

= Can I change my API key? =
Disconnect from Settings > Voizual, then connect with your new key. Disconnect also removes the widget from your pages. Revoke unused keys in Voizual.

= What happens when an agent is turned off or made private? =
Voizual controls access immediately. The next successful daily refresh also stops this plugin from rendering a widget that is no longer ready.

= Do I need HTTPS? =
Yes for voice calls: browsers require HTTPS for microphone access. An HTTP site can use text only; the plugin displays the API's warning.

= What about caching and scheduled tasks? =
Clear your page/CDN cache after saving or disconnecting. WP-Cron runs with site traffic; configure a real system cron for reliable daily refresh on low-traffic sites. Deactivation stops the scheduled event. Uninstall removes settings and the saved key.

= Does it work on multisite? =
Each site has its own connection and scheduled refresh. Uninstall removes the plugin's data from all sites. For large networks, test your rollout on staging first.

== Changelog ==
= 1.0.0 =
Initial release: secure account connection, agent selection, widget settings, daily refresh and branded setup screen.
