=== Bublly ===
Contributors: bublly
Tags: live chat, customer support, chat widget, helpdesk, support chat
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add the Bublly live chat widget to your WordPress site in seconds.

== Description ==

Bublly is a customer support platform that lets your team handle live chat,
tickets, and helpdesk conversations in one place.

This plugin embeds the Bublly chat widget on every page of your WordPress
site automatically. Visitors can start a chat and your team responds from
the Bublly dashboard.

**A free Bublly account is required.** Sign up at https://bublly.com

**Features:**

* One-click widget activation
* Works on all pages automatically
* Zero performance impact (script loads asynchronously)
* Compatible with cookie consent plugins via the `bublly_should_load_widget` filter

== Installation ==

1. Upload the `bublly` folder to `/wp-content/plugins/`
2. Activate the plugin in **WP Admin &rarr; Plugins**
3. Go to **Settings &rarr; Bublly**
4. Paste your API key from desk.bublly.com and check **Enable Widget**
5. Visit any page on your site &mdash; the chat widget will appear

== Frequently Asked Questions ==

= Where do I find my API key? =

Log in to desk.bublly.com, go to Settings &rarr; Widget, and copy the API key shown there.

= Is the API key visible in my page source? =

Yes. This is intentional &mdash; it is a publish key designed to be public, similar to
how Google Analytics tracking IDs work. It cannot be used to access your private data.

= My site has a Content Security Policy (CSP). What do I need to add? =

Add `widget.bublly.com` to your `script-src` allowlist. Without this, the widget
script will be blocked by the browser.

= Does this plugin work with cookie consent plugins like CookieBot or Complianz? =

Yes. The plugin exposes a `bublly_should_load_widget` filter. Cookie consent plugins
can hook into this to delay the widget until the visitor gives consent:

`add_filter( 'bublly_should_load_widget', function() { return has_consent_for_marketing(); } );`

= The widget is not appearing on my site. What should I check? =

1. Confirm **Enable Widget** is checked in Settings &rarr; Bublly
2. Confirm the API key field is not empty
3. Check your browser console for script-blocking errors (CSP or ad blockers)
4. Confirm widget.bublly.com is reachable from your browser

== Screenshots ==

1. The Bublly settings page in WordPress admin.

== Changelog ==

= 1.0.0 =
* Initial release.

== External Services ==

This plugin loads a JavaScript file from `widget.bublly.com` when the widget
is enabled. This connects your site visitors to the Bublly live chat service.
No data is sent to Bublly servers from PHP &mdash; all communication happens in the
visitor's browser via the widget script.

* Service: Bublly live chat
* URL loaded: https://widget.bublly.com/bublly-widget.js
* When: Only on front-end pages when the plugin is enabled and an API key is set
* Privacy Policy: https://bublly.com/privacy
* Terms of Service: https://bublly.com/terms
