WP Manifestindependent plugin directory
manifest / social / floatchat-button

FloatChat – Chat Button

customizable floating WhatsApp chat button to your WordPress site with position control, animations, and device visibility.

by joynall · github.com/joynalabed5/floatchat-button

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/joynalabed5/floatchat-button/archive/refs/heads/main.zip

Readme

=== FloatChat – Chat Button === Contributors: joynall Tags: whatsapp,support, chat, button, floating button Requires at least: 5.8 Tested up to: 6.9 Stable tag: 1.0.0 Requires PHP: 7.4 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a customizable floating WhatsApp chat button to your WordPress site with position control, animations, and device visibility.

== Description ==

FloatChat – Chat Button lets you add a beautiful, fully customizable floating WhatsApp chat button to your WordPress website - no coding required.

= Key Features =

  • One-click toggle - Enable or disable the button without touching code.
  • Phone number with auto-format validation - Enter any number with country code; the plugin validates it live in the admin.
  • Pre-filled message - Set a default greeting that opens in the chat interface automatically.
  • Two button styles - Icon Only (circular) or Icon + Text (pill shape), each with an optional hover tooltip.
  • Flexible position - Bottom Right or Bottom Left, with separate side and bottom padding controls for Desktop and Mobile.
  • Three URL modes:
    • wa.me - Opens the native app (recommended).
    • web.whatsapp.com - Opens WhatsApp in the browser.
    • Custom URL - Use your own link.
  • Open in New Tab or Popup window.
  • Device visibility - Show or hide the button on Desktop, Tablet, and Mobile independently.
  • Page scope - Display globally on all pages, or restrict to specific pages.
  • Animations - None, Fade In, Pulse (glowing ring), Bounce, or Shake.
  • Custom brand colors - Pick any background and icon color with the WP color picker.
  • Fully accessible - proper ARIA labels, focus states, and prefers-reduced-motion support.
  • Translation-ready - full i18n/l10n support with .pot file included.

== Installation ==

  1. Upload the floatchat-button folder to the /wp-content/plugins/ directory, or install directly from the WordPress Plugin Directory.
  2. Activate the plugin through the Plugins screen in WordPress.
  3. Open FloatChat from the WordPress admin menu to configure the plugin.
  4. Enter your chat provider number

== Frequently Asked Questions ==

= Which country code format should I use? =

Enter the full number with the + sign and country code, for example +8801712345678 for Bangladesh or +14155552671 for a US number. Spaces and dashes are automatically stripped.

= What is the difference between app link and web link? =

An app link is the deep-link that opens directly on mobile (app) and on desktop (app or web fallback). A web link always opens in the browser.

= Can I use a custom channel URL instead of WhatsApp? =

Yes. Choose Custom URL as the URL type and paste any URL, including custom communication channel links.

= Is the button accessible? =

Yes. The button includes proper aria-label attributes, keyboard focus styles, and respects the prefers-reduced-motion media query.

= Is this plugin GDPR-friendly? =

The plugin does not store, collect, or transmit any personal data. Clicking the button directly links users to external servers if using those link formats.

= Does this plugin require a WhatsApp account? = Yes, you need a valid WhatsApp number to receive messages.

== Changelog ==

= 1.0.0 =

  • Initial release.

== Upgrade Notice ==

= 1.0.0 = Initial release.

Read the full README on GitHub →