=== Wapulse Chat ===
Contributors: habibnoori
Tags: whatsapp, chat, click to chat, floating button, customer support
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a lightweight click-to-chat button for WhatsApp conversations on your WordPress website.

== Description ==

Wapulse Chat is a simple and lightweight WordPress plugin that lets you add a customizable click-to-chat button for WhatsApp conversations on your website.

The plugin is designed for website owners, service providers, agencies, stores, consultants, and businesses that want to make it easier for visitors to start a WhatsApp conversation directly from the website.

With Wapulse Chat, you can add a floating chat button, set your WhatsApp number, customize the default message, choose the button position, adjust the button color, and use a shortcode to place the chat button anywhere on your website.

This first version focuses on clean basic functionality, performance, and ease of use. It does not require any WhatsApp API setup, third-party account, or complicated configuration.

Wapulse Chat is intentionally built as a privacy-conscious, single-purpose click-to-chat utility. It does not collect visitor data, does not load external scripts, and gives site owners simple control over frontend visibility for mobile and desktop visitors.

= Key Features =

* Add a floating click-to-chat button to your website.
* Set your WhatsApp number from the admin settings page.
* Add a custom default message.
* Customize the button text.
* Choose button position: bottom right, bottom left, bottom center, top right, top left, or top center.
* Change the button color.
* Choose rounded or square button shape.
* Choose text plus icon or icon-only display.
* Select small, medium, or large button size.
* Show or hide the button label.
* Enable or disable the floating button.
* Display a WhatsApp SVG icon with the button.
* Use shortcode support to place the button manually.
* Lightweight frontend styling.
* No API setup required.

= Shortcode =

You can display the WhatsApp chat button anywhere using:

`[wapulse_chat]`

You can also customize the text and message:

`[wapulse_chat text="Get Quote on WhatsApp" message="Hello, I need more details."]`

Version 1.0.6 also supports optional style attributes:

`[wapulse_chat size="large" shape="square"]`

`[wapulse_chat display="icon-only" label="hide"]`

Available shortcode style attributes:

* `shape`: rounded or square
* `display`: text-icon or icon-only
* `size`: small, medium, or large
* `label`: show or hide
* `color`: any valid hex color, for example #25D366


= How It Works =

Wapulse Chat creates a WhatsApp click-to-chat link using your saved phone number and default message. When a visitor clicks the button, WhatsApp opens with your pre-filled message.

= Important Note =

This plugin is not an official WhatsApp product and is not affiliated with WhatsApp LLC or Meta Platforms, Inc. WhatsApp is a trademark of its respective owner.

== Installation ==

1. Upload the `wapulse-chat` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the Plugins screen in WordPress.
3. Go to Settings > Wapulse Chat.
4. Enter your WhatsApp number with country code and without the plus sign.
5. Add your default message.
6. Choose your button position and color.
7. Save the settings.
8. Visit your website frontend to see the floating WhatsApp chat button.

== Frequently Asked Questions ==

= Do I need the WhatsApp Business API to use this plugin? =

No. Wapulse Chat works with a simple click-to-chat link. You do not need WhatsApp Business API, Meta Cloud API, or Twilio setup for the basic version.

= How should I enter my WhatsApp number? =

Enter your number with the country code and without the plus sign. For example, use `923001234567` instead of `+92 300 1234567`.

= Can I change the default message? =

Yes. You can customize the default message from the Wapulse Chat settings page.

= Can I change the button position? =

Yes. The current version supports bottom right, bottom left, bottom center, top right, top left, and top center positions.

= Can I use the button inside a page or post? =

Yes. Use the `[wapulse_chat]` shortcode anywhere inside a page, post, widget area, or compatible page builder.

= Does this plugin send automated WhatsApp messages? =

No. The basic version only opens WhatsApp with a pre-filled message when the visitor clicks the button.

= Is this plugin affiliated with WhatsApp or Meta? =

No. Wapulse Chat is an independent plugin and is not affiliated with WhatsApp LLC or Meta Platforms, Inc.

== Changelog ==

= 1.0.6 =
* Initial release.
* Added floating WhatsApp click-to-chat button.
* Added admin settings page.
* Added custom WhatsApp number field.
* Added default message field.
* Added button text setting.
* Added button position setting.
* Added button color setting.
* Added enable/disable floating button option.
* Added WhatsApp SVG icon.
* Added shortcode support.
* Added shortcode usage note in the settings area.
* Added a welcome banner after plugin activation.
* Added Explore More and Write Review buttons.
* Added dismiss option for the welcome banner.
* Replaced the welcome banner tick icon with the actual Wapulse Chat logo.
* Improved welcome banner branding and visual consistency.
* Tested compatibility with WordPress 7.0.
* Improved the admin settings screen with a cleaner card-style layout.
* Added a floating button status badge.
* Added a copy shortcode button for easier shortcode usage.
* Improved admin settings organization and usability.
* Added a live button preview to the admin settings screen.
* Fixed welcome banner logo display when the logo image file is missing or unavailable.
* Improved logo fallback handling in the welcome banner and admin settings header.
* Added more floating button positions: bottom center, top right, top left, and top center.
* Added rounded and square button shape options.
* Added text plus icon and icon-only display options.
* Added small, medium, and large button size controls.
* Added label visibility control.
* Added sanitization for new button style settings.
* Updated frontend renderer to support new button position and style classes.
* Updated frontend CSS for new positions, shapes, sizes, and icon-only mode.
* Added shortcode style attributes for shape, display, size, label, and color.
* Updated live admin preview to reflect the new style controls.

== Screenshots ==

1. Wapulse Chat main settings page.
2. Wapulse Chat configuration options for WhatsApp number, default message, and button text.
3. Wapulse Chat configuration options for button position, color, and mobile/desktop visibility.
4. Floating WhatsApp chat button demo displayed on the website frontend.

== Upgrade Notice ==

= 1.0.6 =
Added more button positions, shape options, icon-only display, size controls, label visibility, and shortcode style attributes.