=== Click to Chat by Virtualcode ===
Contributors: virtualcode, webbyvivek
Tags: whatsapp, click to chat, chat widget, floating button, customer support
Requires at least: 5.9
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 2.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a customizable floating WhatsApp chat button with page targeting, business hours, device rules, tooltips, and click tracking.

== Description ==

Click to Chat by Virtualcode helps visitors start a WhatsApp conversation from any page of your WordPress site.

The plugin adds a lightweight floating chat button that can be customized from a modern WordPress admin interface. You can set your WhatsApp number, prefilled message, device visibility, page targeting rules, business hours, button colors, icon sizing, tooltip text, link behavior, and more.

It is built for service businesses, agencies, consultants, stores, marketplaces, appointment-based businesses, and WooCommerce sites that want a quick path from browsing to conversation without requiring the WhatsApp Business API.

= Feature highlights =

* Floating WhatsApp click-to-chat button
* WhatsApp number and prefilled message settings
* Device visibility controls for all devices, desktop only, or mobile only
* New tab or same tab link behavior
* Custom accessibility label for screen readers
* Left or right button position
* Bottom and side gap controls
* Button color and text color controls
* Icon-only or icon-with-text display
* Button text, text size, and icon size controls
* Button shape options: pill, rounded rectangle, or square
* Optional tooltip above the chat button
* Custom z-index control for sites with sticky headers or other floating widgets
* Page targeting for entire site, selected pages, or excluded pages
* Delayed display after page load
* Business days and business hours visibility
* Analytics-friendly click tracking for gtag or Classic Analytics when available
* Lightweight frontend output with no WhatsApp API dependency
* Works with most themes, builders, and WooCommerce stores

= Modern admin experience =

The settings area is organized into three focused tabs:

* General: phone number, message, device visibility, link target, and accessibility label
* Appearance: position, spacing, color, shape, sizing, tooltip, and z-index
* Advanced: page targeting, delayed display, analytics events, and business hours

== External services ==

This plugin uses WhatsApp Click to Chat links so visitors can start a WhatsApp conversation.

When a visitor clicks the chat button, the plugin opens an external WhatsApp `wa.me` link. The link may include the WhatsApp phone number and the prefilled message configured by the site owner.

This service is provided by WhatsApp.

Terms of Service: https://www.whatsapp.com/legal/terms-of-service
Privacy Policy: https://www.whatsapp.com/legal/privacy-policy

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`, or install it from the WordPress Plugins screen.
2. Activate the plugin from the Plugins screen in WordPress.
3. Go to **Click to Chat** in the WordPress admin menu.
4. Enter your WhatsApp number with country code.
5. Add an optional prefilled message.
6. Configure appearance, page targeting, delay, and business hours as needed.
7. Save changes and check the frontend of your site.

== Frequently Asked Questions ==

= Does this plugin require the WhatsApp API? =

No. It uses standard WhatsApp Click to Chat links. You only need a valid WhatsApp number with country code.

= Can I use a WhatsApp Business number? =

Yes. You can use a regular WhatsApp number or a WhatsApp Business number.

= Can I customize the button design? =

Yes. You can adjust position, spacing, background color, text color, icon size, text size, button shape, button text, tooltip text, and z-index.

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

Yes. Use the Advanced tab to show the button across the entire site, include selected pages, or exclude selected pages.

= Can I show the button only during business hours? =

Yes. Enable business hours visibility and choose the days, start time, and end time. Overnight schedules such as 22:00 to 06:00 are supported.

= Can I delay when the button appears? =

Yes. Set the delay in seconds from the Advanced tab. Use 0 to display it immediately.

= Can I show the button only on mobile or desktop? =

Yes. Device visibility can be set to all devices, desktop only, or mobile only.

= Does it support analytics tracking? =

Yes. When analytics events are enabled, button clicks are sent to `gtag` or Classic Analytics if those scripts are already present on your site. The plugin does not install analytics scripts by itself.

= Will this slow down my website? =

The frontend output is intentionally lightweight. It loads one small CSS file and one small JavaScript file only when the widget should display.

= Does it work with WooCommerce? =

Yes. The button works on WooCommerce stores and standard WordPress sites.

== Screenshots ==

1. General settings tab for WhatsApp number, prefilled message, device visibility, link behaviour, and accessibility label.
2. Appearance settings tab for button colors, shape, sizing, position, tooltip, and z-index.
3. Advanced settings tab for page targeting, delayed display, analytics events, and business hours.

== Changelog ==

= 2.0.0 =
* Changed the public plugin display name to Click to Chat by Virtualcode while preserving the plugin slug, folder name, option names, and identifiers.
* Redesigned the admin settings interface with modern cards, status summary, responsive layout, and cleaner controls.
* Fixed invalid nested settings forms in tab partials.
* Added configurable link target for opening WhatsApp in a new tab or the same tab.
* Added custom accessibility label support.
* Added button shape options.
* Added optional tooltip support.
* Added z-index control.
* Added analytics click tracking toggle.
* Improved admin JavaScript state handling and removed production console logging.
* Updated documentation, screenshots copy, installation instructions, and FAQs.

= 1.0.0 =
* Initial release.
* Floating WhatsApp chat button.
* Page targeting.
* Delay popup.
* Business hours visibility.
* Custom styles and sizes.
* Device visibility control.
