=== VoxelEon-wp ===
Contributors: globaleliteconcern
Tags: chat, live chat, ai chatbot, customer support, front desk
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add the VoxelEon AI chat widget to your site and answer visitors from your VoxelEon inbox. Connect in one click, no code.

== Description ==

VoxelEon gives your website an AI front desk that answers visitors, captures leads and hands conversations to your team.

This plugin connects your WordPress site to your VoxelEon account and shows the chat widget:

* One-click connect. Log in or sign up on VoxelEon, choose or create a website inbox, approve, and you are back in WordPress with the widget live.
* Show or hide the widget by page, post type, URL pattern, user role or screen size.
* Identify logged-in users to VoxelEon securely: the identity hash is created on your server, so the secret never reaches the browser.
* Respects the WP Consent API (Complianz, CookieYes, Cookiebot and other consent plugins that support it).
* A "VoxelEon chat button" block and the `[voxeleon_button text="Chat with us"]` shortcode to open the chat from anywhere on a page.
* Form leads: submissions from Contact Form 7, WPForms, Gravity Forms, Elementor Pro forms, Fluent Forms and Ninja Forms arrive in your VoxelEon inbox as contacts with a conversation, sent in the background with automatic retries.
* WooCommerce: product and cart context for the agent, a daily and on-save product catalog sync so the AI can answer product questions, and (on a VoxelEon Business plan) AI order lookups that only answer when the customer's email or phone matches the order. HPOS compatible.
* Works with WP Rocket, LiteSpeed Cache, Autoptimize, SG Optimizer and Perfmatters ("delay JavaScript" settings leave the widget alone).

You need a VoxelEon account. Plans and pricing are on https://voxeleon.com.

== External services ==

This plugin connects to the VoxelEon service (https://app.voxeleon.com), which provides the chat widget and the inbox. Without it the plugin does nothing.

**What is sent, and when**

* When you press "Connect to VoxelEon": your site address and the WordPress admin return address are sent to VoxelEon to start the connection. VoxelEon returns a website token, a secret connection key and, for identity checks, a secret signing key. These are stored in your WordPress database; the secrets are encrypted.
* When the settings screen is opened: a request with your connection key asks VoxelEon for the connection status (the inbox name and when the widget was last seen). The answer is cached for one minute.
* On every public page view where the widget is shown: the visitor's browser loads the chat widget script from https://app.voxeleon.com/packs/js/voxeleon-sdk.js and opens a chat session with VoxelEon. Visitor browser data (such as IP address, browser and page address) is processed by VoxelEon to run the chat. If "Identify logged-in users" is on, a logged-in user's name and email are sent with a signed identity so VoxelEon can recognise them. If "Tell the agent which page the visitor is on" is on, the page title, post type and address are sent.
* When a visitor submits a supported form and "Send form submissions to VoxelEon as leads" is on: the submitted name, email, phone, message and other fields, the form name and the page address are sent to VoxelEon in the background.
* With WooCommerce active and "Share your WooCommerce products" on: your published products (name, price, stock, link, short description, category; up to 500) are sent daily and when a product changes.
* With WooCommerce active, VoxelEon's servers may call your site's REST API (voxeleon/v1) to look up an order or search products for a customer conversation. Each call is signed with a secret issued at connect time and unsigned or replayed calls are refused. An order is returned only when the email or phone supplied matches the order.
* When you press "Disconnect" or delete the plugin: a request with your connection key tells VoxelEon to forget this site.
* The Site Health test sends a plain request to https://app.voxeleon.com/api to check that it is reachable.

Service provided by Global Elite Concern Ltd: [Terms of Service](https://voxeleon.com/terms) and [Privacy Policy](https://voxeleon.com/privacy).

== Screenshots ==

1. The VoxelEon screen before connecting: one button to log in or sign up and connect.
2. Connected: account, inbox and a live "Widget detected" status.
3. Display rules, form leads and consent options.

== Installation ==

1. Upload the plugin, or install it from Plugins, Add New, then activate it.
2. Open VoxelEon in the admin menu and press **Connect to VoxelEon**.
3. Log in or sign up, choose a website inbox, and approve. You are returned to WordPress with the widget live.

If your server blocks outbound requests, use "Advanced: paste a website token" on the VoxelEon screen.

== Frequently Asked Questions ==

= Where do conversations appear? =

In your VoxelEon inbox at https://app.voxeleon.com.

= The status says "Not detected yet" =

Visit your public site once. If you use a caching plugin, clear its cache.

= How do I remove everything? =

Press Disconnect, then delete the plugin. All plugin data is removed and VoxelEon is told the site is gone.

= Can I use my own VoxelEon installation? =

Yes. Add `define( 'VOXELEON_BASE_URL', 'https://chat.example.com' );` to wp-config.php.

== Changelog ==

= 1.0.0 =
* First release: one-click connect, widget embed, display rules, secure user identity, consent support, chat button block and shortcode.

= 1.1.1 =
* Escaping and nonce fixes from the official Plugin Check, screenshots, and assets for the plugin directory.

= 1.1.0 =
* Form leads for six form plugins, WooCommerce context, product catalog sync and AI order lookup and product search (signed REST API), HPOS compatibility.

== Upgrade Notice ==

= 1.1.1 =
Maintenance release.

= 1.1.0 =
Adds form leads and WooCommerce support. Reconnect once to enable signed order lookups (Settings screen, Disconnect then Connect).

= 1.0.0 =
First release.
