manifest / social / whatsapp-chat-plugin

WhatsApp Chat Widget

WhatsApp chat widget to your wordpress website with auto-popup functionality and agent information.

by Muhammad Ahsan · github.com/ahsantahseen/whatsapp-chat-plugin

★ 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/ahsantahseen/whatsapp-chat-plugin/archive/refs/heads/main.zip

Readme github.com/ahsantahseen/whatsapp-chat-plugin ↗

A professional WordPress plugin that adds a customizable WhatsApp chat widget to your website with auto-popup functionality and agent information.

Features

Easy Integration - Simple shortcode: [whatsapp_chat]
Customizable - Configure agent name, phone, avatar, and welcome message
Auto-Popup - Automatically opens chat after a set delay
Responsive - Mobile-friendly design
Settings Page - Admin settings page for default configuration
Instance Overrides - Override defaults per shortcode usage
Global Toggle - Option to show a single widget on every page

Installation

Upload the plugin folder to /wp-content/plugins/
Activate the plugin from WordPress admin panel
Go to Settings → WhatsApp Chat to configure defaults

Usage

Basic Usage

[whatsapp_chat]

With Custom Parameters

[whatsapp_chat
    name="John Doe"
    phone="1234567890"
    avatar="https://example.com/avatar.jpg"
    subtitle="Available 9-5"
    message="Hi! How can we help?"
    delay="5"
]

Available Shortcode Attributes

Attribute	Description	Example
`phone`	WhatsApp number with country code (no +)	`phone="85212345678"`
`name`	Agent name displayed	`name="John Doe"`
`avatar`	Avatar image URL	`avatar="https://example.com/avatar.jpg"`
`subtitle`	Subtitle below agent name	`subtitle="Typically replies in minutes"`
`message`	Welcome message (HTML allowed)	`message="Hello! How can we help?"`
`delay`	Auto-open delay in seconds (0 to disable)	`delay="8"`
`default_msg`	Default user message if left empty	`default_msg="Hi, I need help"`

File Structure

whatsapp-chat-widget/
├── whatsapp-chat-widget.php      # Main plugin file
├── includes/
│   ├── class-whatsapp-chat-widget.php
│   ├── class-settings.php
│   └── class-widget-renderer.php
├── templates/
│   ├── settings-page.php
│   └── widget-markup.php
└── assets/
    ├── css/
    │   └── widget.css
    └── js/
        └── widget.js

Settings

Configure these in the WordPress admin:

WhatsApp Number - Your WhatsApp business number
Agent Name - Name displayed in the chat header
Avatar URL - Profile picture URL
Subtitle - Status text (e.g., "Usually replies in 10 minutes")
Welcome Message - Initial message shown in the chat
Auto-Open Delay - Seconds before chat auto-opens (0 = disabled)
Show on All Pages - Inject a single widget globally via the footer
Default User Message - Message sent if user doesn't type anything

Requirements

WordPress 5.0+
PHP 7.2+

License

GPL v2 or later