=== Chirpvo – Chat Button ===
Contributors: ravimareedu
Tags: click to whatsapp, whatsapp button, whatsapp widget, woocommerce whatsapp, ai chat
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Floating WhatsApp button with pre-filled messages, 8 icons, display rules, WooCommerce buttons and a shortcode. No API keys required.

== Description ==

The Tech Pad **Chirpvo – Chat Button** plugin adds a floating WhatsApp button to your WordPress site — with every option the popular WhatsApp button plugins give you, in one free plugin:

* **Your number, your message** — set the WhatsApp number (with country code) and a pre-filled first message so visitors know exactly what to say.
* **8 ready-made icons** — WhatsApp logo, bubble, headset and more, or upload your own image/GIF.
* **Any position** — bottom-right, bottom-left, bottom-centre, side-centre, top corners or fully custom offsets. Separate position and size for **desktop and mobile**.
* **Animations** — pulse, bounce, shake or ring to draw attention.
* **Display rules** — show on the whole site or only on chosen pages, hide on specific post types, limit to desktop/mobile, show only to logged-in users or guests, delay by time or scroll, and business-hours scheduling.
* **WooCommerce integration** — a WhatsApp button on product pages (floating, after "Add to cart" or after product meta), on shop and archive pages, and even on every product card — with dynamic **{PRODUCT_NAME}**, **{PRODUCT_PRICE}** and **{PRODUCT_URL}** variables.
* **Dynamic variables** — {SITE_TITLE}, {SITE_URL}, {PAGE_TITLE} and {PAGE_URL} anywhere in the pre-filled message.
* **Shortcode** — drop an inline button anywhere with `[techpad_ai_whatsapp]`.
* **Google Analytics** — optional dataLayer event on every click (off by default).
* **Zero setup friction** — no API keys, no accounts, no sign-up. Enter your number and save.

Replies come straight back to your phone. When you're ready for a shared team inbox, automations, AI Copilot and campaigns on WhatsApp, connect your number to **The Tech Pad** — this button and every Tech Pad connector work together. The Tech Pad is an optional, separate service; your free button keeps working exactly as it does today whether you connect or not. See [thetechpad.com](https://thetechpad.com/) for the service terms and privacy policy.

== Installation ==

1. Upload the `chirpvo-chat-button` folder to `/wp-content/plugins/`, or install the zip via **Plugins → Add New → Upload Plugin**.
2. Activate the plugin.
3. Go to **The Tech Pad → Chirpvo Chat Button**.
4. Enter your WhatsApp number (country code + number, digits only, e.g. `919876543210`).
5. Pick an icon, position and animation, then **Save settings**.
6. Use the **Preview button** link to see the button on your site.

That's it — the button appears on your site immediately.

== Frequently Asked Questions ==

= Does this need an API key or account? =

No. The button opens a normal WhatsApp chat (wa.me) with your number — no API, no account, no cost per message. Connecting the number to The Tech Pad for AI replies is entirely optional and never required for the button to work.

= Does the plugin track visitors or send my data anywhere? =

No. The plugin itself sends nothing to any server. The optional "Google Analytics tracking" checkbox in the General tab is **off by default**; when a site owner enables it, a single dataLayer event (ttpctw_click) is pushed into the site's own Google Tag Manager/analytics container on button clicks. The only other outbound request is the wa.me link a visitor opens when they click the button themselves.

= How do I add the country code? =

Type the full international number without +, spaces or dashes. Example: India `919876543210`, UK `447911123456`, US `12025550179`.

= Can I show the button only on some pages? =

Yes. Under **Display rules** choose "Only on the pages listed below" and enter page URLs or IDs (one per line). You can also hide the button on specific post types, limit it to desktop or mobile, and schedule business hours.

= Does it work with WooCommerce? =

Yes. Enable the WooCommerce tab options to add buttons on product pages (with product name, price and URL in the message), shop/archive pages and product cards.

= Can I change the icon? =

Yes — pick from 8 ready-made icons or upload your own image/GIF. Change the button background and icon colours with the colour pickers.

= Can I add the button inside a page, not floating? =

Yes — use the shortcode `[techpad_ai_whatsapp]` (options: `number`, `message`, `size`, `icon`, `label`, `color`) anywhere in your content.

= Can visitors get instant AI answers? =

Yes. Keep the free button exactly as it is, or connect the number to The Tech Pad — the AI answers 24/7 in your customer's language, from your site and product knowledge, with a shared team inbox and human takeover. Free to start, no credit card. The Tech Pad is an optional separate service ([thetechpad.com](https://thetechpad.com/)).

== Screenshots ==

1. Enter your WhatsApp number and pre-filled message on the General tab.
2. Pick one of eight ready-made icons or upload your own image.
3. Choose position, size and colours — separately for desktop and mobile.
4. Display rules: pages, post types, devices, visitors and business hours.
5. WooCommerce options for product pages, shop archives and product cards.
6. The floating button on your site, with its tooltip label.
7. Inline WhatsApp button on a product page, after "Add to cart".
8. The same button on mobile — smaller size, thumb-friendly position.

== Changelog ==

= 1.1.7 =
* Fix: saving one tab no longer resets the others. Each tab is its own
  form, so saving "Position & size" (or any tab) used to write the
  defaults for every setting it does not show — the button switched itself
  off and the WhatsApp number was blanked. A tab now keeps the values it
  does not edit.
* Nothing else changed: same settings, same storage, no migration.

= 1.1.6 =
* Fix: the button's display-delay and scroll rules (and the Google Analytics
  click event) now work. Its script ran before the button existed in the page
  and stopped early, so those settings were silently ignored. The script now
  waits for the page and loads deferred.
* Nothing else changed: same settings, same storage, no migration.

= 1.1.5 =
* Fix: the settings screen under The Tech Pad opens again. On a site where
  this plugin was the first Tech Pad plugin installed, its menu row opened
  the shared page instead of this plugin's own screen, so the tabs and
  buttons answered "Sorry, you are not allowed to access this page".
  The row is labelled **Chirpvo Chat Button** and opens the plugin's screen;
  the first row of the menu is **The Tech Pad**, a short list of every
  Tech Pad plugin you have installed.

= 1.1.4 =
* The settings screen now lives where the rest of the family lives:
  **The Tech Pad → Chirpvo Chat Button** (it used to be under
  Settings). Old bookmarks and links from support still work.
* The button is no longer shown until a WhatsApp number (or a group
  invite) is set, because until then it had nowhere to point. The
  settings page now says so plainly.

= 1.1.3 =
* Fix for WordPress.org Plugin Check: the notice shown in the admin
  when another Tech Pad chat plugin is already displaying the button
  used a text domain that did not belong to this plugin. It now uses
  this plugin's own text domain. The wording, the button and every
  setting are unchanged.

= 1.1.2 =
* One floating WhatsApp button per page, always: if you also run one of
  our chat plugins (Chatvio – AI Webchat, or the WooCommerce edition), the
  floating buttons no longer stack — the real chat widget takes
  priority, and this plugin says so in plain words on its settings page.
  The buttons you place inside content (WooCommerce product and card
  buttons, the [techpad_ai_whatsapp] shortcode) are never affected.
* Tested up to WordPress 7.1.
* Version number constant synced with the plugin header (both 1.1.2).

= 1.1.1 =
* Readme brought to WordPress.org directory standard: contributor credit, shorter tag list and short description, screenshot list and upgrade notice.

= 1.1.0 =
* New **Upgrade to AI** tab on the settings page: connect the number to The Tech Pad for instant AI replies, a shared team inbox, automations and campaigns — the free button keeps working exactly as before.

= 1.0.0 =
* Initial release. Floating WhatsApp button with number, pre-filled message, 8 icons, custom icon upload, colours, shapes, desktop/mobile positions, animations, display rules, business hours, WooCommerce product/archive/card buttons, shortcode, GA tracking and custom CSS.

== Upgrade Notice ==

= 1.1.7 =
Fix: saving a settings tab no longer switches the button off or blanks
your number. No settings change.

= 1.1.6 =
Fix: the button's delay/scroll rules and analytics now apply (its script
ran before the button existed). No settings change.

= 1.1.5 =
Fix: the settings screen under The Tech Pad is reachable again (its tabs
and buttons work). No settings change.

= 1.1.4 =
The settings screen moved to The Tech Pad menu. The button stays
hidden until a number is set. No settings change.

= 1.1.3 =
Fix for Plugin Check: one admin notice used the wrong text domain.
No settings or behaviour change.

= 1.1.2 =
One floating button per page when several Tech Pad chat plugins are
active. Buttons you place inside content are never affected. No settings
change.

= 1.1.0 =
New "Upgrade to AI" tab links your free button to The Tech Pad for optional 24/7 AI replies and a shared inbox. The free button keeps working exactly as before — no account or API key is required.
