=== TalkToHim Fast Chat ===
Contributors:      davelabs
Tags:              chat link, messaging, contact, communication, quick chat
Requires at least: 6.0
Tested up to:      7.0
Requires PHP:      7.4
Stable tag:        1.1.0
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Create fast WhatsApp chat links and add a floating WhatsApp contact widget to your WordPress site.

== Description ==

**TalkToHim Fast Chat** lets you and your site visitors quickly open WhatsApp chat links to any phone number without saving it to your contacts first.

The plugin generates public `wa.me` links compatible with WhatsApp Web, Desktop and mobile apps.

In addition to the built-in chat link generator, the plugin includes a customizable floating WhatsApp widget that allows visitors to contact the site owner directly from any page of the website.

This plugin is designed as a lightweight utility tool for fast and direct communication.

= Features =

* **Admin tool** — accessible from the WordPress sidebar, always one click away.
* **Shortcode** `[talktohim_fast_chat]` — embed the tool on any page, post or widget area.
* **30+ country prefixes** — with flag emojis and full country names.
* **Pre-filled message** — optionally set a default message for the chat input.
* **Recent numbers** — the last 10 used numbers are stored locally for quick re-use (admin only).
* **Floating WhatsApp widget** — add a site-wide chat button so visitors can contact the site owner directly.
* **Dedicated widget settings page** — manage the floating widget independently from the main tool settings.
* **Customizable widget color** — choose the widget color to match your site's branding.
* **Widget position control** — display the widget on the bottom left or bottom right corner.
* **Flexible display modes** — show icon only or icon with text.
* **Desktop and mobile visibility controls** — choose where the widget is displayed.
* **Dynamic message placeholders** — automatically include page information inside the WhatsApp message.
* **Focused admin UI** — simple and fast interface for quick use.
* **No external API calls** — the plugin generates standard chat links and does not connect to external APIs.
* **Accessible** — semantic HTML, labels and keyboard navigation support.

= Floating Widget =

TalkToHim Fast Chat can display a floating WhatsApp contact button on the front end of your website.

Go to **TalkToHim → Floating Widget** to configure:

* phone number and country prefix
* pre-filled message
* button label
* widget color
* bottom left or bottom right position
* icon-only or icon-and-text display
* desktop and mobile visibility

The widget generates a public `wa.me` link and does not connect to external APIs.

= Dynamic Placeholders =

The floating widget supports dynamic placeholders inside the pre-filled message:

* `{site_name}` — current website name
* `{page_title}` — current page title
* `{page_url}` — current page URL

Example:

`Hello! I'm contacting you from {page_title} on {site_name}.`

= Shortcode Usage =

Basic usage:

`[talktohim_fast_chat]`

With custom prefix and message:

`[talktohim_fast_chat prefix="39" message="Hello! I found your number on the website."]`

= Privacy =

TalkToHim Fast Chat does not collect, store or transmit any personal data to the plugin author's servers.

Phone numbers entered in the admin tool are stored only in the browser's `localStorage` on the current device.

The shortcode does not use cookies or local storage.

When a user clicks a generated chat link or the floating widget, the browser opens the public chat URL with the number and optional message configured by the site owner or entered by the user.

== Installation ==

1. Upload the `talktohim-fast-chat` folder to the `/wp-content/plugins/` directory, or install via the WordPress plugin screen.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Click **TalkToHim** in the admin menu to start using the tool.
4. Visit **TalkToHim → Floating Widget** to configure the front-end WhatsApp contact button.
5. Optionally visit **TalkToHim → Settings** to configure default tool options.

== Frequently Asked Questions ==

= Do I need WhatsApp? =

Yes. You need WhatsApp installed on your device or access to WhatsApp Web/Desktop.

= Does it work on mobile? =

Yes. On mobile devices the link opens the WhatsApp app directly if installed. On desktop it opens WhatsApp Web or the desktop app when available.

= Can I use it without saving the contact? =

Yes. No contact needs to be saved on your device.

= Can visitors use it too? =

Yes. Use the `[talktohim_fast_chat]` shortcode on any page or post, or enable the Floating Widget to allow visitors to contact you directly from any page of your website.

= Can I customize the floating widget? =

Yes. You can configure the phone number, message, color, position, label, display mode and device visibility.

= Is any data sent to your servers? =

No. The plugin author does not operate any backend servers for this plugin.

== Screenshots ==

1. Admin tool page with phone number input.
2. Floating Widget settings page.
3. Main Settings page.
4. Front-end shortcode usage.
5. Floating WhatsApp widget on the front end.

== Changelog ==

= 1.1.0 =
* Added a dedicated Floating Widget admin page.
* Added a floating WhatsApp contact widget for site-wide visitor communication.
* Added customizable widget color with green as the default.
* Added configurable phone number, message, label, position and display mode.
* Added mobile and desktop visibility controls.
* Added support for dynamic placeholders in widget messages.

= 1.0.1 =
* Improved wording and descriptions for better clarity.
* Added clearer references to WhatsApp compatibility.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.1.0 =

Adds a new Floating WhatsApp Widget with customizable colors, positioning and visitor contact options.

= 1.0.0 =

Initial release.