=== Chatwik Live Chat ===
Contributors: chatwik
Tags: live chat, chat, customer support, chatwik, helpdesk
Requires at least: 6.0
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

Connect your WordPress site to Chatwik live chat with a simple settings page—no manual embed code required.

== Description ==

Chatwik Live Chat adds the official Chatwik widget to your WordPress site. Configure your website token and basic widget options from **Settings → Chatwik** in the WordPress admin.

**Features**

* One-click setup with your Chatwik Website Token
* Enable or disable the widget without removing settings
* Customize bubble position, type, locale, dark mode, and widget style
* Uses the official Chatwik SDK from Chatwik Cloud
* Optionally identify logged-in WordPress (and WooCommerce) users automatically, skipping the pre-chat form
* No tracking or phone-home behavior

**Server-side appearance** (widget color, welcome message, pre-chat form, and more) is configured in your Chatwik dashboard.

== Installation ==

1. Upload the `chatwik-live-chat` folder to the `/wp-content/plugins/` directory, or install the plugin through the WordPress plugins screen.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Go to **Settings → Chatwik**.
4. Copy your **Website Token** from Chatwik → Settings → Inboxes → List (Widget Token column for your Website inbox).
5. Add your WordPress site domain to **Allowed domains** in that inbox’s Configuration tab.
6. Paste the token, enable the widget, and save changes.
7. Visit your site frontend to confirm the chat bubble appears.

== Frequently Asked Questions ==

= Where do I find my Website Token? =

Log in to your Chatwik dashboard, open **Settings → Inboxes → List**, and copy the **Widget Token** from the middle column for your **Website** inbox. The plugin settings page includes a screenshot of this screen.

= Why is the widget not showing on my site? =

Check the following:

* The widget is **enabled** in Settings → Chatwik.
* A valid **Website Token** is saved.
* Your WordPress site domain is listed under **Allowed domains** in the Chatwik Website channel configuration.
* You are viewing the public frontend (not the WordPress admin).

= Can I use a self-hosted Chatwik instance? =

This plugin connects to Chatwik Cloud at `https://app.chatwik.com`. Custom instance URLs are not supported in this version.

= Does this plugin send data to third parties? =

The plugin stores your settings in WordPress and loads the Chatwik widget script from Chatwik Cloud when enabled. It does not send analytics or usage data to Chatwik independently of the widget itself.

= Can I hide the chat bubble until I open it from a button? =

Yes. Enable **Hide message bubble on load** in the settings, then use the Chatwik JavaScript SDK methods to open the widget from your theme or custom code.

= What does "Identify logged-in users" do? =

When enabled, a logged-in WordPress user's name and email are automatically passed to the chat widget, so they don't need to type them into the pre-chat form. If the site runs WooCommerce and the customer has a phone number on file, that's included too. This is off by default and has no effect on WooCommerce or its data if the store doesn't use it — it only reads the current WordPress user's own account fields. It does not currently support inboxes with HMAC identity validation enabled.

== Screenshots ==

1. Chatwik configuration page with setup instructions and status indicator.
2. Chatwik live chat widget on the website frontend.

== Changelog ==

= 1.1.0 =
* Add optional "Identify logged-in users" setting — automatically sends the current WordPress user's name/email (and WooCommerce phone, if available) to the chat widget.

= 1.0.2 =
* Fix screenshot captions on WordPress.org plugin page.

= 1.0.1 =
* Add WordPress.org plugin page assets (icon, banner, screenshots).

= 1.0.0 =
* Initial release.
* Settings page under Settings → Chatwik.
* Frontend embed via official Chatwik SDK.
* Widget customization: position, bubble type, locale, dark mode, and widget style.

== Upgrade Notice ==

= 1.1.0 =
Adds an optional setting to auto-identify logged-in users to the chat widget. Off by default; no action needed to keep current behavior.

= 1.0.2 =
Fixes screenshot caption display on the WordPress.org plugin page. No functional changes.

= 1.0.1 =
Adds WordPress.org plugin page assets. No functional changes.

= 1.0.0 =
Initial release of the Chatwik Live Chat plugin.
