Description
bKlug Floating Contact Button puts a WhatsApp chat on every page of your WordPress site, with no theme editing and no code. Set your number in the settings and the button appears. Fill in one number to send visitors straight into a chat, or add several and let them choose who to reach. Want the conversation to start with context? Switch on the ask-a-question bar and the visitor’s question rides into WhatsApp as the very first message, so you never open with “hi”.
Key features
- 💬 Floating WhatsApp button: One-tap chat, bottom-left or bottom-right. Icon only, or icon plus a label you choose. Show it everywhere, or pick pages by type or address.
- ✍️ Ask-a-question bar: A centered bar visitors type into. Their question becomes the first WhatsApp message, so the chat starts with context. On a computer they scan a QR code to continue on their phone; on a phone WhatsApp opens straight away.
- 👥 Up to five contacts, with a picker: Give sales, support, or each store its own number, name, note, and pre-filled message. Two or more numbers open a clean contact picker so visitors choose who to message.
- 💡 Suggested questions: Offer up to three one-tap question chips to get the conversation moving.
- 🕒 Business hours: Show a live “available now” or “away” note with a status dot. Set each day’s hours, or start from a template.
- 👋 Auto-open nudge: Optionally open the contact picker after a visitor has been idle for a set time, so the nudge lands in a pause rather than mid-read. Choose how often, and on which devices.
- 🎨 Full styling control: Colours for the button, the WhatsApp mark, the contact cards, and the bar, with ready-made presets, plus size and spacing. Give phones their own size and corner, add a pulse or hover zoom, and show or hide per device.
- 🔒 Fast and private: Lightweight, framework-free JavaScript that loads only on pages where the button appears. No account required, and no visitor data leaves your site.
Nothing is answered on your site and no conversation is stored. Every conversation happens in WhatsApp, where your customers already are, and it starts with everything you need to reply. A free tool from bKlug.
Available in English, German, French, Italian, Spanish, and Portuguese.
This plugin bundles qrcode-generator by Kazuhiko Arase (MIT licensed) to draw QR codes in the browser. No QR service is contacted and the code is generated entirely on the visitor’s device.
This plugin uses WhatsApp’s standard wa.me links. WhatsApp is a trademark of its respective owner, and this plugin is not affiliated with or endorsed by WhatsApp or Meta.
Privacy
The plugin sets no cookies and sends nothing anywhere. It uses one browser storage key, ww_auto_open_seen, only if you switch on auto-open with a frequency other than “Every page view”. It stays on the visitor’s device and identifies nobody.
Installation
- Upload the
bklug-floating-contact-buttonfolder to/wp-content/plugins/, or install the plugin through the Plugins screen in WordPress. - Activate the plugin through the “Plugins” screen.
- Go to Settings → bKlug Contact Button.
- Enter at least one WhatsApp number (including the country code) and save.
- Visit the front end of your site and the floating button appears.
FAQ
Do I need a WhatsApp Business account?
No. The button opens a standard WhatsApp chat to whatever number you enter. A personal or Business number both work.
Why doesn’t the button show up?
The button only appears once at least one WhatsApp number is set in Settings → bKlug Contact Button. Also check that “Show on desktop” / “Show on mobile” are enabled for the device you are testing, and that Where the button shows includes the page you are looking at.
What number format should I use?
Include the country code, for example +1 555 123 1234. Spaces, dashes, and the plus sign are fine. The plugin strips them automatically.
Do not use a national format. WhatsApp reads the digits as an international number, so a number entered as (11) 98765-4321 or 011 98765-4321 will open a chat with whoever those digits belong to somewhere else in the world. The settings screen warns you if a number looks like it is missing its country code.
Can I show more than one number?
Yes. Fill in up to five contacts. With two or more, the button opens a contact picker so visitors choose who to message.
Does it slow down my site?
No. The CSS and JavaScript are small, framework-free, and only load on pages where the button is displayed. The QR code generator is a separate file that is only downloaded if a visitor actually submits a question, so ordinary page views never pay for it.
Does the ask-a-question bar answer questions on my site?
No. It collects the question and carries it into WhatsApp as the first message, so you answer in WhatsApp as usual. The wording under the field says so, and you can edit it in the settings.
Can I show the button only on some pages?
Yes. Under Where the button shows, show it on every page, only on the pages you pick, or everywhere except those. Pick by page type, by address, or both. Add one address per line, and end one with * to include everything under it, such as /blog/*. Pages the button is left out of load none of its files.
Does it work with WooCommerce?
Yes, with no setup. With WooCommerce active you can also choose product pages, shop and category pages, and the cart and checkout as page types.
Does the page list work with plain permalinks?
Page types work on every site. Addresses need pretty permalinks: on plain permalinks a line can only reach the home page, and the settings screen tells you so. The exception is /*, which means every address. A home page link with a query, such as /?page_id=2 or /?utm_source=fb, is not kept, so choose page types instead.
Can phones get their own size and position?
Yes. Switch on the phone layout to give phones their own button size, corner, and spacing.
How often does auto-open appear?
You choose: every page view, once per visit, once a day, or once per visitor. You can also limit it to computers or phones. Auto-open needs two or more numbers.
Does it still work outside my business hours?
Yes. Nothing is hidden outside business hours. Only the note changes. Questions still reach WhatsApp and wait for you there.
Screenshots






Changelog
1.2.0
- New: choose where the button appears. Show it on every page, only on the pages you pick, or everywhere except those, by page type, by address, or both. WooCommerce product, shop, and cart pages are included. A page the button is left out of loads none of its files.
- New: an opt-in phone layout gives phones their own button size, corner, and spacing.
- New: an opt-in pulse that draws the eye to a round button, and an opt-in zoom on hover.
- New: choose how often auto-open appears (every page view, once per visit, once a day, or once per visitor) and on which devices. Sites already using auto-open keep every page view until you change it.
- New: colour presets, opening-hours templates, and one-click auto-open delays.
- New: German and Italian, and every new setting is translated into all six languages.
- New: the settings screen warns when the page rule leaves the button on no page, and when a list of addresses cannot work on plain permalinks.
- New: after your first save with a number, the settings page asks once for a review. It appears nowhere else and sends nothing.
- Improved: pasted phone numbers are cleaned of invisible characters, and Arabic and Persian digits become plain digits.
- Improved: the ask-a-question bar now closes as one smooth movement.
- Fixed: with one number the button is now a real WhatsApp link from the first moment, so a theme script can no longer leave it dead.
- Fixed: the button stays hidden until the script has set it up, including when an optimiser moves the script into the page head.
- The plugin now requires PHP 7.4.
- Behind the scenes: the code is reorganised into smaller files. This changes nothing on your site.
1.1.5
- Fixed: the auto-open setting is now hidden unless two or more WhatsApp numbers are set, matching the behavior 1.1.4 gave the button itself. Since 1.1.4 the button correctly never opened on its own with a single number, but the setting stayed on screen and could still be switched on and saved, where it did nothing.
- Fixed: the auto-open help text said that with a single number the menu would show just that one number. That has not been true since 1.1.4. It now says the menu needs at least two numbers. Updated in all four translations.
1.1.4
- Fixed: with a single WhatsApp number set, the button no longer opens a contact card on its own. One number is now always a one-tap direct link to WhatsApp that stays still until the visitor taps it. Auto-open now applies only when two or more numbers are set. This reverses the single-number auto-open behavior introduced in 1.1.1.
1.1.3
- Listing update only: refreshed the description and added new screenshots of the ask-a-question bar. No changes to the plugin code.
1.1.2
- Fixed: a question that had already been sent stayed in the box after closing, so the collapsed bar showed it back to the visitor and the send button beside it would send the same question again. A question you have not sent yet is still kept, so closing the bar by accident does not lose what you were typing.
- Fixed: closing the ask-a-question bar left a white card, with its shadow, painted around the collapsed bar for a moment.
- The ask-a-question bar now resizes smoothly between all of its screens, in both directions: opening, sending, showing and hiding the QR code, and closing. Previously each screen appeared at its new size in a single frame. Respects the “reduce motion” accessibility setting.
1.1.1
- Fixed: the close button on the ask-a-question bar did not close it. Pressing it reopened the bar in the same click, so the bar could only be dismissed by clicking elsewhere on the page or pressing Escape.
- Fixed: auto-open did nothing when only one WhatsApp number was set, and the setting was hidden in that case. Switching it on now gives the single number a contact card to open, and the setting is offered for any round button.
- The auto-open delay is now labelled “Idle time before it opens”, which is what it has always measured: scrolling or moving the mouse restarts it, so the nudge lands in a pause rather than mid-read.
- Contacts no longer arrive pre-filled. Contact 1 and 2 used to ship with a display name and subheading already written in, so filling in only a number published wording you never chose. The examples now live in the help text under each field.
1.1.0
- New “Ask-a-question bar” button display: a centered bar visitors type a question into. The question is carried into WhatsApp as the first message.
- On desktop the bar shows a QR code to scan with a phone; on mobile it deep-links straight into WhatsApp.
- Added up to three suggested questions, shown as tappable chips.
- The bar centres itself at the bottom of the screen; round buttons keep their corner.
- Choose separately what phones get: the bar, or a round button.
- Business hours accept a named time zone or a manual UTC offset.
- Bundles qrcode-generator 2.0.4 by Kazuhiko Arase (MIT), loaded on demand only when a visitor submits a question.
1.0.0
- Initial release.
