README

Magento 2 WhatsApp Integration: Floating Chat Button, Product Inquiry and Category Banner (Hyva + Luma)

Let shoppers reach you on WhatsApp from any page of your store. Panth WhatsApp Integration adds a floating chat button visible on every storefront page, a dedicated inquiry button on product pages with the product name and URL pre-filled, and an assistance banner on category pages. Native templates for Hyva (Alpine.js) and Luma are both included.

Product page: kishansavaliya.com/magento-2-whatsapp.html

Quick Answer

What is Panth WhatsApp Integration? It is a Magento 2 extension that adds a WhatsApp chat button to your storefront so shoppers can contact you in one tap, without filling out a form or sending an email.

What does it add to my store?

• A floating WhatsApp button anchored to every page with configurable position and hover text.
• A product page inquiry button that pre-fills the product name and URL into the WhatsApp message.
• A category page assistance banner with a button so shoppers can ask for help finding a product.
• Advanced styling via custom CSS classes for extra control over appearance.

Which themes are supported? Both Hyva (Alpine.js, no jQuery) and Luma. The right template is picked for you based on the active theme.

What does it need? Magento 2.4.4 to 2.4.8, PHP 8.1 to 8.4, and the free mage2kishan/module-core package.

Need Custom Magento 2 Development?

Get a free quote for your project in 24 hours for custom modules, Hyva themes, performance work, M1 to M2 migrations, and Adobe Commerce Cloud.

Visit our website: kishansavaliya.com  |  Get a quote: kishansavaliya.com/get-quote

Table of Contents

• Who Is It For
• Key Features
• Compatibility
• Installation
• Configuration
• How It Works
• FAQ
• Support
• About Panth Infotech
• Quick Links

Who Is It For

• B2B and wholesale stores where customers want to ask about bulk pricing or custom orders before buying.
• High-ticket product stores (jewellery, furniture, electronics) where shoppers prefer a conversation before committing.
• Fashion and apparel stores where shoppers ask about sizing, availability, or fit.
• Regional stores in India, LATAM, MENA, and SEA where WhatsApp is the main support channel for customers.
• Any Magento 2 merchant who wants to turn browser traffic into direct conversations without extra software.

Key Features

Floating WhatsApp Button (All Pages)

• Always-visible chat button anchored to every page of the storefront.
• Configurable position from four options: bottom-left, bottom-right, top-left, top-right.
• Optional hover text (e.g. "Chat with Us") shown next to the icon on hover.
• Pre-filled default message so shoppers land in WhatsApp with a ready-to-send greeting.
• Pulse animation to draw attention to the button on page load.
• Mobile-first and works on both phones and desktop browsers.

Product Page Inquiry Button

• Dedicated WhatsApp button rendered on product detail pages.
• Pre-filled message with the product name and product URL inserted automatically using {product_name} and {product_url} placeholders.
• Configurable button text and button style (default, solid, outline, icon-only, text-only).
• Works for simple, configurable, bundle, grouped, and virtual products.

Category Page Assistance Banner

• WhatsApp inquiry button shown on category and listing pages.
• Configurable button text and pre-filled message template for category context.
• Lets shoppers ask for help finding the right product from within the catalog.

Advanced Styling

• Custom CSS classes field in admin to add Tailwind or your own classes to WhatsApp elements.
• CSS variable theming via theme-config.json so button colors inherit from your Hyva design tokens.
• No theme file edits required for standard setup.

Hyva + Luma Ready

• Native Hyva templates built on Alpine.js, with no jQuery, RequireJS, or Knockout added in.
• Native Luma templates using standard Magento block and phtml patterns.
• Theme is detected automatically through Panth_Core\Helper\Theme so the right template loads every time.
• Works on Magento Open Source, Adobe Commerce, and Adobe Commerce Cloud.

Built to Last

• Clean, MEQP-style code with constructor dependency injection only.
• Per-store-view configuration so multi-country stores can use different numbers, texts, and templates per store.
• Translation ready: every frontend label uses Magento's __() function.
• Zero third-party scripts loaded on the page. The button is a simple server-rendered link.

Compatibility

Installation

Composer Installation (Recommended)

composer require mage2kishan/module-whatsapp
bin/magento module:enable Panth_Core Panth_WhatsApp
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Manual Installation via ZIP

1. Download the latest release from Packagist or from the product page.
2. Extract it to app/code/Panth/WhatsApp/ in your Magento install.
3. Make sure Panth_Core is installed too (required dependency).
4. Run the commands above starting from bin/magento module:enable.

Verify Installation

bin/magento module:status Panth_WhatsApp
# Expected: Module is enabled

After install, open:

Admin -> Stores -> Configuration -> Panth Extensions -> WhatsApp Integration

Configuration

Go to Stores -> Configuration -> Panth Extensions -> WhatsApp Integration.

All settings respect Magento's scope order (default, website, store view), so each store view can have its own number, text, and templates.

How It Works

1. The floating button block is injected into every page via layout XML.
2. On page load, the button renders as a plain <a href="https://wa.me/..."> link with the phone number and pre-filled message URL-encoded. No JavaScript is required for the link to work.
3. On product pages, the product name and URL are resolved server-side by the Block\Product\Button block and inserted into the message template.
4. On category pages, the Block\Category\Banner block renders the inquiry button with its own configurable message.
5. For Hyva themes, Alpine.js handles any animated or interactive behavior. For Luma, standard phtml templates are used.
6. Custom CSS classes from the admin config are added to the button element at render time.

FAQ

Does this use the WhatsApp Business API?

No. The module uses the public wa.me click-to-chat URL, which is free and needs no API key or approval. Shoppers click the button and WhatsApp opens with the pre-filled message ready to send.

Do I need a WhatsApp Business account?

No, any valid WhatsApp number works. A WhatsApp Business account is recommended for commercial use because it supports auto-replies and a business profile, but it is not required.

Can I use a different number for each store view?

Yes. Every setting respects Magento's scope hierarchy, so each store view can have its own phone number, message templates, and button labels.

Does it work with Hyva themes?

Yes. The module ships native Alpine.js templates for Hyva and standard phtml templates for Luma. Theme detection is automatic through Panth_Core.

Will the button slow down my pages?

No. The button is rendered server-side as a plain HTML link. There are no third-party scripts, no external trackers, and no blocking resources loaded on any page.

Can I change the button text shown on the product page?

Yes. The "Button Text" field in the Product Page Settings group lets you set any label, such as "Ask on WhatsApp", "Inquire Now", or any translated string.

Can I control which pages show the floating button?

Yes. Use standard Magento layout XML to remove the panth.whatsapp.float block from specific handles if you want to hide it on certain page types.

Is it translation ready?

Yes. Every frontend label uses Magento's __() function, so it can be translated from a theme or language pack.

Does it work with multi-store setups?

Yes. Settings and message templates are scoped per store view, so you can run different numbers and languages across store views from one Magento install.

Support

Response time: 1-2 business days.

Need Custom Magento Development?

Looking for custom Magento module development, Hyva theme work, store migrations, or performance tuning? Get a free quote in 24 hours:

About Panth Infotech

Built and maintained by Kishan Savaliya (kishansavaliya.com), a Top Rated Plus Magento developer on Upwork with 10+ years of eCommerce experience.

Panth Infotech is a Magento 2 development agency that builds high quality, security focused extensions and themes for both Hyva and Luma storefronts. The extension suite covers SEO, performance, checkout, product presentation, customer engagement, and store management, with each module built to MEQP standards and tested across Magento 2.4.4 to 2.4.8.

Browse the full extension catalog on our Magento extensions page or on Packagist.

Quick Links

Ready to add WhatsApp chat to your Magento 2 store?

SEO Keywords: magento 2 whatsapp, magento 2 whatsapp extension, magento 2 whatsapp integration, magento 2 whatsapp chat button, magento 2 floating whatsapp button, whatsapp product inquiry magento 2, whatsapp click to chat magento, hyva whatsapp, hyva whatsapp extension, luma whatsapp extension, magento 2 whatsapp module, magento 2 click to chat, magento 2 whatsapp button, magento 2 customer chat, magento 2 whatsapp business, wa.me magento, whatsapp contact button magento, magento 2.4.8 whatsapp, php 8.4 magento whatsapp, magento 2 b2b whatsapp, whatsapp lead capture magento, magento 2 product inquiry whatsapp, magento 2 category whatsapp button, panth whatsapp, mage2kishan whatsapp, kishan savaliya magento, top rated plus magento developer, hire magento developer upwork, custom magento development