=== Helprspace Contact Bubble ===
Contributors: khalidpro
Tags: whatsapp, live chat, chat button, messenger, instagram
Requires at least: 5.0
Tested up to: 7.1
Requires PHP: 7.0
Stable tag: 1.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight floating chat bubble button. Visitors reach you on WhatsApp, Telegram, Messenger, Instagram and 12 more channels. Zero external requests.

== Description ==

**Helprspace Contact Bubble** adds a clean, fast floating contact button to your website. Visitors tap it, pick their favourite app - WhatsApp, Telegram, Facebook Messenger, Instagram and more - and start a conversation with you in one tap.

A small, focused plugin: its own CSS and JavaScript are loaded the standard WordPress way (no third-party libraries, no external requests, no tracking).

= 16 channels included =

* WhatsApp
* Telegram
* Facebook Messenger
* Instagram
* Discord
* Slack
* Microsoft Teams
* Skype
* Viber
* WeChat
* LINE
* Signal
* Email
* Phone call
* SMS
* Custom link - point a button at any URL: booking page, contact form, help desk

= Features =

* Up to 5 channels, each with its own colour and custom label
* Greeting message at the top of the menu
* Bottom-right or bottom-left position
* Main button colour picker
* Device targeting - show any channel on desktop only, mobile only, or both
* Test mode - preview the widget on a single private page before going live
* Works with any theme and page builder (Elementor, Divi, Gutenberg, Bricks and more)
* Compatible with all caching plugins (WP Rocket, LiteSpeed Cache, W3 Total Cache)
* Fully responsive and keyboard accessible
* Clean uninstall - deletes its own settings, leaves nothing behind

= Privacy =

This plugin sets no cookies, loads nothing from third-party servers and collects no visitor data. When a visitor clicks a channel button, they are taken to that channel using its official public link format (for example wa.me for WhatsApp or t.me for Telegram) - exactly like clicking a normal link.

= Helprspace Contact Bubble Pro =

Need more? Pro turns the button into a mini support desk:

* **FAQ layer** - answer common questions before the chat starts
* **Smart Answers** - visitors type a question, the widget finds the answer from your knowledge base. Works offline, no AI keys, no monthly costs
* Business hours with offline message
* Show or hide the widget on specific pages
* Pre-filled messages for WhatsApp, SMS and Email
* Unlimited channels
* Click analytics, team agents and proactive triggers

[Learn more about Pro](https://helprspace.com/floating-chat-bubble-button)

== Installation ==

1. Go to Plugins > Add New and search for "Helprspace Contact Bubble".
2. Install and activate the plugin.
3. Open the new **Chat Bubble** menu in your admin sidebar.
4. Click **+ Add channel**, pick a channel, enter your contact detail and save.
5. Visit your site - the chat button is live.

== Frequently Asked Questions ==

= Does this plugin slow my site down? =

No. It only loads its own small CSS and JS file, and only on pages where the widget actually appears - no external scripts, no jQuery dependency on the front end.

= Do I need a WhatsApp Business account or any API key? =

No. Every channel uses the official public link format of each app (wa.me, t.me, m.me and so on). No accounts, keys or monthly fees.

= Does it work with caching plugins? =

Yes. Assets are loaded the standard WordPress way, so cached pages always include the widget correctly.

= Can I show different channels on mobile and desktop? =

Yes. Each channel has Desktop and Mobile tick boxes.

= How do I test the widget before showing it to visitors? =

Enter a page ID in the Test mode field. The widget then appears only on that page until you clear the field.

= Is it GDPR compliant? =

The plugin sets no cookies, collects no data and connects to no third-party servers. Clicking a channel simply opens that channel's standard link.

== Screenshots ==

1. The floating chat button expanded, showing channel options.
2. The settings page with channels, appearance and display options.

== Changelog ==

= 1.3.0 =
* Renamed to Helprspace Contact Bubble for a distinct, non-generic identity.

= 1.2.0 =
* Renamed to Helprspace Contact Bubble.
* Assets are now registered and loaded through wp_enqueue_style() / wp_enqueue_script() instead of printed inline.
* All function/class/constant/option/hook names now use a unique plugin-specific prefix.

= 1.0.0 =
* Initial release: 16 channel types, per-channel colours, labels and device targeting, greeting message, position and colour settings, test mode.

== Upgrade Notice ==

= 1.3.0 =
Renamed to Helprspace Contact Bubble. No settings are lost when you update.
