Assign the right sales contact to each WooCommerce product and let shoppers continue the conversation through WhatsApp, phone, email, quote requests, sharing, or a WhatsApp cart order.
Version 1.0.4WordPress 6.6+PHP 7.4+WooCommerce 9.0+WC tested up to 11.1English + French
1. Overview
WACB is designed for WooCommerce stores where a customer may need to speak with a salesperson before completing a purchase. It is suitable for assisted-sales catalogs, distributors, wholesalers, construction suppliers, property-related catalogs, automotive sellers, electronics stores, and multi-salesperson WooCommerce websites.
Per-product sales contactsAssign a WordPress user to a product and use that profile as the public sales contact.
Conversion actionsDisplay WhatsApp, phone, email, quote, and share actions on product cards and product pages.
WhatsApp cart orderingTurn the current WooCommerce cart into a pre-filled WhatsApp message.
Promotional merchandisingAdd promotional and commercial-status badges without changing the WooCommerce price.
Bulk catalog managementApply selected WACB fields to groups of products after previewing the target set.
Private relationship directoryKeep internal supplier, owner, partner, customer, prospect, salesperson, or service-provider information separate from public product contacts.
Important concept: public sales contacts are WordPress users. Private relationship records are for internal tracking and are not exposed as public product contacts.
2. Requirements & compatibility
Component
Requirement
WordPress
6.6 or newer
PHP
7.4 or newer
WooCommerce
9.0 or newer; plugin metadata declares testing up to WooCommerce 11.1
WooCommerce HPOS
Compatibility declared by the plugin
Cart / Checkout Blocks
Compatibility declared; WhatsApp cart ordering supports the classic cart and modern Cart Block
WACB uses built-in SVG icons and adds no Font Awesome dependency or external icon CDN. Its front-end functionality does not add a WACB-specific jQuery dependency.
3. Installation
Back up your WordPress site before installing or updating production plugins.
In WordPress Admin, go to Plugins → Add Plugin → Upload Plugin.
Select the WACB installable ZIP file supplied with your purchase.
Click Install Now, then Activate.
Make sure WooCommerce is active.
Open WACB Pro → Dashboard.
Do not unzip the installable plugin before uploading it through WordPress. The ZIP already contains the required plugin folder.
4. Quick start
Create or choose sales users. Use existing WordPress users or create the users who should act as public sales contacts.
Complete their WACB profiles. Add WhatsApp, phone, company, role, public email, website, and other public fields as needed.
Allow publishing. A user profile must be allowed for public use before it can power customer-facing contact actions.
Set a default contact. Go to WACB Pro → Buttons & WhatsApp and choose the user used when a product has no specific assignment.
Assign products. Assign a public sales contact product by product or through the bulk tools.
Enable the actions you need. WhatsApp, Call, Email, Request a Quote, Share, single-product block, loop buttons, and optional floating CTA can be configured independently.
Test on the front end. Open a product and confirm each enabled action uses the intended contact details and message.
5. WordPress user sales contacts
WordPress user profiles are the recommended source for customer-facing sales contacts. A WACB-enabled user can hold public information such as:
WhatsApp number
Phone numbers
Company
Job title / role
Public email
Website
Supported social links
Custom WhatsApp message
Publishing permission
If a product inherits its contact information from a user profile, updating that user profile allows the product to use the new information without editing the product individually.
Administrators can manage WACB settings and assignments. Non-admin users can edit only their own WACB profile information.
6. Product assignments
Each WooCommerce product can use a specific public sales contact. If no specific contact is assigned, WACB can fall back to the global/default public contact configured in Buttons & WhatsApp.
Product-level fields can also override inherited public contact information where supported.
Internal source / partner
A product can also be linked to a private relationship record for internal tracking. This is separate from the public sales contact. For example:
Public sales contact: Sales Team
Internal source: Supplier A
The internal relationship is not intended for public display.
7. Buttons & WhatsApp
Go to WACB Pro → Buttons & WhatsApp to control customer-facing actions.
Placement options
Buttons on WooCommerce product cards / loops
Contact block on the single-product page
Optional floating button on the product page
Available actions
WhatsApp
Call
Email
Request a Quote
Share
Labels can be customized from the settings page.
Product message placeholders
Placeholder
Replaced with
{product_name}
Current product name
{price}
Current product price text available to WACB
{product_url}
Product URL
{site_name}
WordPress site name
Example:
Hello, I would like a quote for {product_name} – {product_url}
8. WooCommerce cart order via WhatsApp
The cart-order feature is optional and disabled by default. When enabled, WACB adds a WhatsApp action that converts the current cart into a pre-filled message containing the cart items, quantities, and total.
It supports:
Classic WooCommerce cart
Modern WooCommerce Cart Block
Live quantity / total state from the block cart before the customer opens WhatsApp
Selected product variation attributes in both classic-cart and Cart Block messages when available (for example: Color: Red, Size: L)
Cart message placeholders
Placeholder
Replaced with
{cart_items}
Cart items and quantities
{cart_total}
Current cart total
{site_name}
WordPress site name
You can choose a specific recipient user for cart orders or let the feature use the default sales contact.
9. Promotions & commercial statuses
WACB promotional badges are merchandising labels. They are separate from WooCommerce price calculations.
Per product, you can configure:
Promotion text shown publicly in the promotion badge
Promotion color with the global appearance color as fallback
Promotion style: square, slightly rounded, or pill/rounded
Promotion start date (optional)
Promotion end date (optional)
Separate commercial status text, color and style
Private internal note
When start/end dates are provided, the promotion badge is displayed only inside the configured date window. Promotion badges are merchandising labels and do not modify WooCommerce prices.
Current WACB versions do not apply the old generic _custom_discount field to product prices. Current WACB promotional metadata uses WACB-prefixed keys.
10. Bulk updates
The bulk module is designed to update selected WACB product fields across multiple WooCommerce products.
Filter the products you intend to modify.
Preview the number of products targeted.
Select only the WACB fields you want to replace.
Run the update in manageable batches.
Verify a few products after the operation.
Bulk operations can include public user assignment, supported internal relationship assignment, contact overrides, promotion fields and status fields.
Since version 1.0.4, the bulk updater does not load or store the complete matching product-ID list. It keeps a compact query definition and processes matching products in cursor-based batches of 50, which reduces peak memory use on large catalogs.
Recommendation: make a database backup before large catalog changes and test the operation on a small category first.
11. Private relationship directory
WACB contains a separate administrator-only relationship directory for internal business tracking. Supported relationship types include supplier, owner, partner/referrer, external salesperson, customer, prospect, service provider, and other.
Depending on the relationship type, records can store contact details and business information such as internal owner, source, follow-up information, estimated value, catalog/document links, commercial terms, payment/logistics information, commission details, comments/history, and notes.
These records are not used as public product contacts.
12. Appearance
Go to WACB Pro → Appearance to match WACB controls to your storefront.
WhatsApp CTA color
Phone CTA color
Quote CTA color
Promotion badge color
Promotion badge style: slightly rounded, pill, or square corners
Option to show the sales contact name and company on product pages
WACB includes defensive styling for its icons and buttons to reduce conflicts with themes and dynamic page-builder product modules.
13. Integrations & analytics events
WACB does not install Google Analytics or Meta Pixel. It can emit dataLayer events that an existing analytics/tag-manager setup may listen for.
This keeps tracking scripts under the site owner's control.
Replace 12 with the appropriate WordPress user ID. Adjust limit to control the number of products returned by the user-products shortcode.
15. Languages & translation
English is the source language.
French (fr_FR) translation files are bundled.
A wacb-pro.pot file is included for standard WordPress gettext translation workflows.
Tools such as Loco Translate or Poedit can be used to create additional translations.
The admin interface follows the WordPress locale.
Custom labels and messages that you save in WACB settings are user-entered content and do not automatically translate when the site locale changes.
16. Legacy import, updates & uninstall
Legacy data import
If supported metadata from an earlier/private WACB build is detected, go to WACB Pro → Tools & diagnostics. Legacy import is manual. The import copies supported values into WACB-prefixed metadata and leaves the original metadata unchanged.
Legacy metadata is not automatically used on the storefront.
Updating
Back up the site before updating. The WPBay distribution uses the official WPBay SDK for automatic updates. WACB 1.0.4 also moves the legacy private-contact model migration out of the activation/update request: conversion work is performed in scheduled batches of 100 to reduce activation/update timeout and memory risk on larger stores.
Uninstall
Deactivating WACB does not delete its data. Full WACB data deletion on uninstall is optional and must be explicitly enabled under Tools & diagnostics → Data on uninstall before uninstalling.
17. WPBay License & Automatic Updates
WACB uses the official WPBay SDK for purchase-code activation, license verification, activation-count enforcement, and automatic updates.
After installing and activating WACB, open WACB in the WordPress admin menu.
Enter the WPBay purchase code associated with your order.
WPBay validates the code for the current site and checks the activation allowance associated with the purchased license.
After successful activation, the full WACB administration and storefront features become available.
Invalid or revoked licenses are rechecked periodically by the official WPBay SDK. Automatic WACB updates are delivered through the normal WordPress plugin update interface when available.
Privacy: WACB disables the optional WPBay analytics and feedback modules. The SDK is used for license verification and updates. License requests may send the purchase code, site URL, WACB product identifier and the vendor API key required by WPBay.
Clear your theme/page-builder generated CSS cache if applicable.
Hard-refresh the browser page.
WACB includes defensive frontend asset loading and icon sizing for dynamically rendered product modules, including Divi-style WooCommerce layouts.
WhatsApp button does not appear
Confirm WhatsApp is enabled under Buttons & WhatsApp.
Confirm the selected public sales user has a valid WhatsApp number.
Confirm the user's WACB profile is allowed for publication.
If the product has no assigned contact, confirm a default contact is configured.
Cart WhatsApp button does not appear
Confirm Order cart via WhatsApp is enabled.
Make sure the cart contains at least one product.
Clear page/block caches after changing WACB settings.
A promotion badge appears but the product price does not change
This is expected. WACB promotional badges are sales/merchandising labels and do not automatically change WooCommerce prices.
Changes are not visible after an update
Clear caching/minification plugins, any page-builder CSS cache, the browser cache, and CDN cache if used.
19. Support
For product-specific installation, configuration, compatibility, or bug questions, use the support/contact channel available on the marketplace product page.