=== Zens AI Customer Support ===
Tags: live chat, customer support, ai chatbot, help desk, support
Requires at least: 6.3
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add Zens AI customer support to WordPress with a privacy-first setup, optional signed user identity, and no theme edits.

== Description ==

[Zens AI](https://zens.ai/) Customer Support connects a WordPress site to the Zens AI support service. It adds the customer support widget without requiring you to paste code into a theme, and it keeps optional identity signing on your server.

The plugin is inactive by default. It contacts Zens AI only after an administrator enters a Zens AI Site ID and explicitly enables the connection.

= Features =

* Add the Zens AI support widget sitewide.
* Show or hide the floating chat launcher.
* Let anonymous visitors choose whether to leave an email for follow-up.
* Optionally identify logged-in WordPress users with an HMAC-signed profile.
* Keep the signing secret in `wp-config.php` instead of the WordPress database.
* Keep session recording disabled by default.
* Add suggested Zens AI wording to the WordPress Privacy Policy Guide.
* Follow the active WordPress locale in plugin settings and the page language in the customer support widget.
* Remove all plugin settings when the plugin is deleted.

You need a Zens AI account and a Site ID to use this plugin. Zens AI is a hosted software service; the service may offer free and paid plans independently of this plugin.

== External service ==

This plugin connects to the Zens AI service at `https://zens.ai` to provide customer support chat, visitor context, and the optional features selected by a site administrator.

No request is made to Zens AI merely by installing or activating the plugin. Requests begin only after an administrator saves a Site ID and enables Zens AI.

When enabled, the service may receive:

* Page URL and title, referrer, browser language, and UTM source.
* Anonymous visitor and browser-session identifiers stored in the visitor's browser.
* Presence, pageview, and chat activity.
* Chat messages and attachments submitted by the visitor.
* An email address the visitor chooses to provide for follow-up.
* If signed identity is enabled: the logged-in user's stable WordPress identifier, display name, email address, and registration date.
* If session recording is enabled: visitor interactions and visible page content captured for support purposes.

Zens AI uses this information to deliver the support service selected by the site administrator. Review the service documents before enabling the connection:

* Zens AI Privacy Policy: https://zens.ai/privacy
* Zens AI Terms of Service: https://zens.ai/terms
* Zens AI Integration Guide: https://zens.ai/docs/getting-started/customer-integration

Site owners are responsible for providing any notices and obtaining any consent required for their site, visitors, and jurisdiction.

== Installation ==

1. Upload the `zens-ai-customer-support` folder to `/wp-content/plugins/`, or install the plugin through the WordPress Plugins screen.
2. Activate **Zens AI Customer Support**.
3. In your Zens AI workspace, create a customer site and add your WordPress domain as an allowed origin.
4. In WordPress, go to **Settings → Zens AI**.
5. Paste the public Site ID, review the data notice, select **Enable Zens AI**, and save.
6. Open a public page in a private browser window and send a test message.

= Optional signed identity =

Signed identity connects a logged-in WordPress user to their support conversation. Copy the one-time signing secret from Zens AI and add it above the "stop editing" line in `wp-config.php`:

`define( 'ZENS_AI_SIGNING_SECRET', 'cc_secret_xxxxxxxxxx' );`

Then enable **Signed identity** under **Settings → Zens AI**.

The secret is used only on the WordPress server to create an HMAC-SHA256 signature. It is not stored in the plugin settings or included in the public page.

== Frequently Asked Questions ==

= Does the plugin send data as soon as I activate it? =

No. The connection is disabled by default. The plugin loads the external service only after an administrator adds a Site ID and explicitly enables Zens AI.

= Is the Site ID secret? =

No. The Site ID is a public identifier included in the browser SDK configuration. The signing secret is private and must remain in `wp-config.php`.

= Is session recording enabled automatically? =

No. The WordPress plugin blocks session recording by default. An administrator must enable it in WordPress, and it must also be enabled for the site in Zens AI.

= Can I use chat without sharing WordPress user profiles? =

Yes. Anonymous customer support works without signed identity. Sharing the logged-in user's profile is a separate option and is off by default.

= Where can I update my privacy policy? =

WordPress includes suggested Zens AI wording under **Settings → Privacy → Policy Guide**. Review and adapt that text for the options you enable and your legal requirements.

= Can a developer control where the widget loads? =

Yes. Use the `zens_ai_customer_support_should_load` filter to disable the widget on selected requests. The `zens_ai_customer_support_identity_profile` filter can adjust the signed profile before its final identifier is signed.

== Development ==

Source code and issue tracking are available at https://github.com/ZensHQ/wordpress.

== Changelog ==

= 1.1.0 =

* Added Spanish, Arabic, Portuguese, French, German, Japanese, Korean, Italian, Simplified Chinese, and Traditional Chinese translations alongside English.
* Added right-to-left layout support for Arabic.
* Added bundled WordPress admin translations and automatic widget language detection.

= 1.0.0 =

* Initial release.
* Added privacy-first service opt-in and Site ID configuration.
* Added chat launcher, follow-up email, and session-recording controls.
* Added optional server-signed WordPress user identity.
* Added Privacy Policy Guide content.

== Upgrade Notice ==

= 1.1.0 =

Adds multilingual customer support and WordPress settings in 11 languages, including Arabic right-to-left layout support.

= 1.0.0 =

Initial public release.
