=== ThemeVix Direct Chat Button ===
Contributors: themevix, motaleb
Tags: woocommerce, chat button, click to chat, customer support, messaging
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add instant chat button to your WooCommerce store. Let customers contact you with pre-filled product messages.

== Description ==

**ThemeVix Direct Chat Button** adds a WhatsApp click-to-chat button to your WooCommerce store, allowing customers to contact you directly with pre-filled product information.

*This plugin is not affiliated with, endorsed by, or sponsored by WhatsApp LLC or Meta Platforms, Inc. WhatsApp is a trademark of WhatsApp LLC.*

= Features =

All of the following features are included and fully functional in this plugin:

* **Click-to-Chat Button** - Add a chat button to your product and cart pages
* **Pre-filled Messages** - Automatically include product name, price, and URL in the message
* **Multiple Button Positions** - Place the button before/after add to cart, after summary, or after meta
* **Customizable Design** - Choose from multiple button styles, sizes, colors, animations, and hover effects
* **Product / Category Exclusions** - Hide the button on selected products or categories
* **Quick Reply Templates** - Offer ready-made messages on product pages
* **RTL Support** - Right-to-left layout option
* **GDPR Consent** - Optional consent checkbox before chat links open
* **Privacy Notice** - Optional privacy policy notice under the button
* **Shortcode Support** - Use `[tv_direct_chat]` shortcode anywhere on your site
* **Gutenberg Block** - Native WordPress block editor support
* **Mobile Responsive** - Looks great on all devices
* **WooCommerce Integration** - Seamlessly integrates with WooCommerce product and cart pages
* **Message Placeholders** - Dynamic content insertion for product information

A separate add-on (hosted on our website, not WordPress.org) can add extras such as a floating chat widget, multi-agent support, lead capture, analytics, and WooCommerce automation.

[Learn more about the add-on](https://themevix.com/themevix-direct-chat-button/)

= Message Placeholders =

Available placeholders:
* `{product_name}` - Product name
* `{product_price}` - Product price
* `{product_url}` - Product URL
* `{shop_name}` - Your shop name
* `{product_sku}` - Product SKU

= Shortcode Usage =

Basic usage:
`[tv_direct_chat]`

With custom attributes:
`[tv_direct_chat phone="+1234567890" text="Contact Us" message="Hi, I need help!"]`

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/themevix-direct-chat-button` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to **TV Direct Chat** in your WordPress admin sidebar to configure the plugin.
4. Enter your chat phone number with country code (e.g., +1234567890).
5. Customize the button text, style, and position as needed.

== Frequently Asked Questions ==

= What format should I use for the phone number? =

Enter your chat phone number with country code, without spaces or dashes. For example: +1234567890

= Can I use this without WooCommerce? =

This plugin is designed specifically for WooCommerce. However, you can use the shortcode `[tv_direct_chat]` on any page.

= How do I change the button position? =

Go to **TV Direct Chat** in your WordPress admin sidebar and select your preferred position from the "Button Position" dropdown.

= Can I customize the pre-filled message? =

Yes! Go to the plugin settings and customize the "Pre-filled Message" field. You can use placeholders like {product_name} and {product_price}.

= Does this work with variable products? =

Yes, the button works with all WooCommerce product types including variable products.

= Does this track or store my personal data? =

This plugin does not collect usage analytics, tracking data, or telemetry. Button settings are stored only in your WordPress database. When a visitor clicks the chat button, their browser opens WhatsApp (`wa.me`) with the phone number and pre-filled message you configured — see the External Services section below.

= Is this plugin GDPR compliant? =

Yes. This plugin includes a built-in GDPR consent checkbox feature. When enabled, users must check a consent box before chat links open (including quick-reply template links). You can customise the consent text and link it to your Privacy Policy page. The plugin does not collect or store visitor personal data in WordPress.

= What's the difference between this plugin and the premium add-on? =

This plugin includes a product/cart chat button, GDPR consent, exclusion rules, quick-reply templates, RTL support, and animation/hover effects. An optional add-on (sold separately, not hosted on WordPress.org) adds a floating chat widget, multi-agent support, lead capture, analytics, WooCommerce automation, and related extras.

= Do I need a WhatsApp account? =

Yes. This plugin creates click-to-chat links that open WhatsApp. You need an active WhatsApp account (personal or business) associated with the phone number you configure in the plugin settings. A WhatsApp Business account is recommended for professional use.

== Screenshots ==

1. Plugin settings page — configure phone number, button text, style, and colors.
2. Chat button displayed on a WooCommerce product page.


== Changelog ==

= 1.0.0 =
* Initial release
* Click-to-chat button
* Product and cart page integration
* Pre-filled message with placeholders
* Multiple button styles and sizes
* Shortcode support
* Gutenberg block support
* Color customization
* Mobile responsive design
* GDPR compliance

== Upgrade Notice ==

= 1.0.0 =
Initial release of ThemeVix Direct Chat Button with essential WooCommerce chat integration features.

== External Services ==

This plugin generates click-to-chat links that direct users to WhatsApp via the `wa.me` short-link service operated by Meta Platforms, Inc.

**What data is sent and when:**
Data is transmitted only when a visitor actively clicks the chat button. At that point, the browser opens a URL in the following form:

`https://wa.me/<phone_number>?text=<pre-filled_message>`

The phone number is the one you configure in the plugin settings. The pre-filled message may include product name, price, URL, shop name, and SKU — all sourced from your own WooCommerce store. No data is transmitted automatically or in the background.

**Third-party service information:**

* WhatsApp (wa.me): https://www.whatsapp.com/
* WhatsApp Terms of Service: https://www.whatsapp.com/legal/terms-of-service
* WhatsApp Privacy Policy: https://www.whatsapp.com/legal/privacy-policy-eea