WP Manifestindependent plugin directory
manifest / social / customizable-simple-click2chat-button

Customizable Simple Click2Chat Button

Lightweight WordPress plugin that adds a customizable floating WhatsApp chat button to your site. Fully themeable colors (bubble, handset, ring), flexible positioning, pre-filled message, per-device visibility, and live admin preview. Zero JavaScript on the frontend, inline SVG, no external requests. Translation-ready. GPLv2 licensed.

by Viola Niccolai · github.com/unsitofattobene/customizable-simple-click2chat-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/unsitofattobene/customizable-simple-click2chat-button/archive/refs/heads/main.zip
Readme github.com/unsitofattobene/customizable-simple-click2chat-button ↗

A lightweight, performance-first WordPress plugin that adds a fully customizable floating WhatsApp chat button to your website — letting visitors reach you with a single click.

No JavaScript. No external requests. No bloat.

✨ Features

  • 🎨 Fully customizable colors — bubble, handset, and ring can each be styled independently
  • 💬 Pre-filled message — define the text that appears in the user's chat
  • 📍 Flexible positioning — top/bottom, left/right, with pixel-perfect offset
  • 📐 Adjustable icon size
  • 📱 Per-device visibility — show or hide on desktop, tablet, or mobile
  • 👀 Live preview in the admin panel, with a dark-background toggle
  • ⚡ Zero JavaScript on the frontend — pure HTML + CSS, inline SVG
  • 🌍 Translation-ready — Italian translation included
  • 🧹 Smart cache handling — auto-purges cache on save (WP Rocket, LiteSpeed, WP Super Cache, W3 Total Cache, WP Fastest Cache, Autoptimize, SG Optimizer)

📦 Installation

From this repository

  1. Download the latest .zip from the Releases page
  2. In your WordPress admin, go to Plugins → Add New → Upload Plugin
  3. Select the downloaded .zip and click Install Now
  4. Activate the plugin
  5. Go to Click2Chat in the admin menu and configure it

Manual installation

  1. Upload the plugin folder to /wp-content/plugins/
  2. Activate it from the Plugins menu in WordPress
  3. Configure under Click2Chat

⚙️ Configuration

  1. Enter the international prefix (default: 39 for Italy) and your local phone number in the two separate fields
  2. Write your pre-filled message (optional)
  3. Choose colors, position, size, and device visibility
  4. Save — cache is purged automatically

❓ FAQ

How do I enter the phone number? Starting from version 1.3 the number is split in two fields. In "International prefix" enter only the country code without the + sign (default: 39 for Italy). In "Phone number" enter the local number without the international prefix. Use digits only, no spaces or dashes.

I'm upgrading from a previous version, will my number still work? Yes. On the first admin visit after the update the plugin automatically splits the existing combined number into prefix + local number using the standard E.164 country codes. Open the settings page to double-check the result.

Can I customize the message that appears in the chat? Yes, in the "Pre-filled message" field you can write the text that will be automatically inserted into the visitor's chat.

Does the plugin slow down my site? No. The plugin loads no JavaScript on the frontend, makes no additional HTTP requests, and uses an inline SVG. The performance impact is virtually zero.

📋 Requirements

  • WordPress 5.2 or higher
  • PHP 7.2 or higher
  • Tested up to WordPress 7.1

📝 Changelog

1.4

  • Added the option to display a help message beside the WhatsApp button after a configurable delay.
  • Clicking the message or button opens a dialog window that simulates a live chat and encourages visitors to start a conversation.
  • Both new features can be customized with the desired colors and messages.
  • "Tested up to" bumped to WordPress 7.1.

1.3

  • Phone number input split into two separate fields: international prefix and local number
  • Both fields are now mandatory; spaces, dashes and any non-digit characters are stripped automatically on save
  • "+" sign automatically displayed before the international prefix (Italian +39 set as default with a visible "default" label)
  • Automatic one-time migration of existing combined numbers using the standard E.164 country code list
  • "Tested up to" bumped to WordPress 7.0
  • Italian translation updated

1.2

  • Removed deprecated load_plugin_textdomain() call (translations are now loaded automatically by WordPress)

1.1

  • Added "Customize" action link in the plugins list for quick access
  • Automatic page cache purge on settings save
  • Cache warning notice below the save button
  • Fixed shadow not showing in admin preview on page load
  • Changed default shadow color to #787878
  • Added dark background toggle in admin preview
  • Added notice about phone number requirement
  • Added Italian translations for all new strings

1.0

  • Initial release

📄 License

Released under the GPLv2 or later license.

👤 Author

Made with ❤️ by Niccolai Viola