=== Clients.Help ===
Contributors: clientshelp
Tags: chat, livechat, woocommerce, telegram, support
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Install the Clients.Help widget, answer visitors from WordPress admin, route voice messages, connect Telegram, and pass WooCommerce product context.

== Description ==

Clients.Help turns your WordPress site into a full intake point for chats, voice messages, and booking requests. This plugin connects your site to a Clients.Help workspace and adds:

* The Clients.Help widget on your frontend (with shortcode and Gutenberg block).
* An Admin Inbox so operators can answer visitors without leaving WordPress.
* Voice-message playback and transcript display.
* Shared-bot Telegram connection (no bot token entry required).
* Business page, services & prices, requests, catalog and free setup queue screens.
* WooCommerce integration: widget display rules per page type and product context (product id, name, URL, SKU, price, currency, category, stock status) sent with each conversation.
* Diagnostics page with a downloadable debug log.

All conversation, request and voice data is stored in Clients.Help — WordPress is the operator surface, not the source of truth.

== External services ==

This plugin loads the Clients.Help widget script from `https://clients.help/widget.js` and exchanges data with `https://clients.help/api/plugin/...`.
Data sent to Clients.Help includes:

* visitor messages, optional name/phone/email;
* source URL and referrer;
* WooCommerce product/page context when present;
* voice recordings (if the visitor records one) and transcripts generated by Clients.Help;
* operator replies you compose in WordPress.

See https://clients.help/privacy and https://clients.help/terms.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install via the WordPress admin.
2. Activate it.
3. Open the **Clients.Help** menu in WordPress admin and follow the setup wizard.
4. Paste the connect code from your Clients.Help dashboard.

== Frequently Asked Questions ==

= Where do the messages live? =
On Clients.Help servers. WordPress only stores plugin settings.

= Do I have to enter a Telegram bot token? =
No. Clients.Help operates a shared Telegram bot. You connect by clicking a link.

= Does this break WooCommerce checkout? =
No. The plugin never modifies cart, checkout, payment, or order data.

== Screenshots ==

1. Frontend chat widget rendered on a WooCommerce storefront.
2. Admin Inbox with conversation list and reply pane inside WordPress.
3. Ecommerce settings: WooCommerce display rules and product-context preview.
4. Telegram screen: shared-bot status and link to receive alerts in Telegram.
5. Business Page editor: company info, hours, location and contacts.
6. Catalog: items synced from the connected workspace and WooCommerce.
7. Setup wizard step 1: paste the connect code from your Clients.Help dashboard.
8. Setup wizard step 2: enable the widget and pick where it appears.
9. Services & Prices: visitor-facing services and prices managed in WordPress.
10. Free Setup queue: prospects waiting for a guided onboarding call.
11. Diagnostics: connection check, plugin version, and downloadable debug log.
12. Plugins screen: the Clients.Help row with Deactivate / Setup links.

== Changelog ==

= 1.0.0 =
* First public release.
* Translated into 36 languages (UI strings plus JavaScript admin via JSON translations).
* Setup wizard step labels are now fully translatable.
* Tested up to WordPress 7.0.

= 0.1.1 =
* Inbox polls every 7 s, highlights new conversations, shows unread badge in admin menu, optional sound toggle.
* Telegram screen and wizard "Send test" step hide the test button when the shared bot is not configured and show a customer-friendly notice instead of raw error codes.
* "Services & Prices" screen renamed to "Business Services & Prices" with a clarifying note that these are visitor-facing services, not Clients.Help subscription plans. Delete now opens a confirmation modal. Imported services (e.g. WooCommerce) cannot be deleted from this screen.
* Verified WooCommerce product context end-to-end: product id, name, URL, SKU, price, currency, category and stock status are forwarded with each conversation.
* No backend changes.

= 0.1.0 =
* Initial release: widget injection, admin inbox, voice playback, Telegram screen, business page, services, requests, catalog, free setup queue, WooCommerce integration, diagnostics, EN/RU/UK translations.
