WhatsApp Chat Button with QR Code

A floating WhatsApp button for WordPress with a branded chat panel, a click to chat link and a scannable QR code. No page builder required.

Features

• Floating button, bottom left or bottom right, with adjustable size and spacing
• Chat panel with logo, title, status line, greeting bubble and call to action
• QR code support, shown on desktop only by default
• Six colour controls, so the widget can match any brand
• Optional ripple animation and automatic panel opening once per visit
• Display rules: all pages, front page only, or exclude specific page IDs
• Vanilla JS on the front end, no jQuery, assets loaded only when the button renders
• Keyboard accessible, Escape to close, reduced motion respected
• Translation ready

Installation

Download a release zip and upload it under Plugins → Add New → Upload Plugin, or clone this repository into wp-content/plugins/.

Then open Settings → WhatsApp Button and add your link, logo and QR code.

Developer notes

Filter the display logic:

add_filter( 'wcbq_should_display', function ( $display, $settings ) {
    if ( is_page( 'checkout' ) ) {
        return false;
    }

    return $display;
}, 10, 2 );

All settings live in a single option, wcbq_settings.

Requirements

• WordPress 6.5 or newer
• PHP 7.4 or newer

License

GPL-2.0-or-later. See LICENSE.

Author

Afaz Alif — LinkedIn