=== MadnessChat Button ===
Contributors: madnesscode1
Tags: whatsapp, chat, button, contact, widget
Requires at least: 5.6
Tested up to: 6.8
Requires PHP: 7.3
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a customizable WhatsApp chat button to WordPress — 4 styles, 6 animations, responsive, GDPR-ready. Increase conversions instantly.

== Description ==

**Add a WhatsApp button to WordPress in 2 minutes — no coding required!**

This plugin helps you add a **WhatsApp floating button**, **WhatsApp contact widget**, or **WhatsApp chat icon** to your WordPress website without any technical knowledge. Perfect for increasing customer engagement, improving conversion rates, and providing instant support.

### 🚀 Why Choose MadnessChat Button?

* **⚡ Quick Setup**: Get your WhatsApp button live in under 2 minutes
* **📱 Mobile-First**: Fully responsive and optimized for all devices
* **🎨 Highly Customizable**: 4 button styles, 6 animations, 5 hover effects
* **🔒 Privacy-Focused**: GDPR compliant with optional consent features
* **⚙️ Zero Performance Impact**: Lightweight code that doesn't slow down your site
* **💯 100% Free**: All core features included, no hidden costs
* **🌍 Universal Compatibility**: Works with any WordPress theme and page builder

**MadnessChat Button** is the easiest way to add WhatsApp chat functionality to your WordPress website. Whether you run a blog, online store, portfolio, or business website, this plugin helps you connect with visitors instantly.

### ✨ Basic Features

**Easy Setup**
* Single WhatsApp number
* Customizable pre-configured message
* Setup in less than 2 minutes

**Button Customization**
* 4 different styles (circle, square, pill, with text)
* 6 animations to grab attention
* 5 hover effects
* Icon selector
* Screen positioning

**Responsive Configuration**
* Different sizes per device (mobile, tablet, laptop, desktop)
* Separate configuration for each device type
* Automatic adaptation

**Visibility Control**
* Show/hide by device (mobile, desktop)
* Page selector (home, posts, pages)
* Basic triggers (delay, scroll, time on page)

**Privacy**
* Basic GDPR compliance
* Optional consent before opening WhatsApp
* Google Analytics integration (optional)

### 🎯 Perfect For

* **E-commerce Stores**: Increase sales with instant customer support (WooCommerce compatible)
* **Small Businesses**: Provide quick customer service without expensive chat software
* **Local Businesses**: Handle reservations, quotes, and inquiries directly via WhatsApp
* **Freelancers & Agencies**: Let clients contact you instantly for project inquiries
* **Blogs & Content Sites**: Build stronger relationships with your audience
* **Service Providers**: Offer immediate consultation and booking options
* **Restaurants & Cafes**: Take orders and reservations via WhatsApp
* **Real Estate**: Allow property inquiries and viewings scheduling

### 🔄 Need More Features?

**Pro Version**
* Multiple agents with automatic rotation
* A/B Testing to optimize conversions
* Advanced analytics with dashboard
* Contextual messages per page
* Smart template system
* Priority support

Interested in the Pro version? Contact us at madnesscode1@gmail.com

== Installation ==

### Automatic Installation

1. Go to Plugins > Add New in your WordPress dashboard
2. Search for "MadnessChat Button"
3. Click "Install Now"
4. Activate the plugin

### Manual Installation

1. Download the plugin ZIP file
2. Go to Plugins > Add New > Upload Plugin
3. Select the ZIP file and click "Install Now"
4. Activate the plugin

### Initial Configuration

1. Go to **Chat Button** in the administration menu
2. Configure your WhatsApp number
3. Customize the design and messages
4. Done! The button will appear on your site

== Frequently Asked Questions ==

= How do I add a WhatsApp button to WordPress? =

Simply install and activate the plugin, then go to **Chat Button** in your WordPress admin menu. Enter your WhatsApp number, customize the design, and you're done! The button will appear on your site automatically.

= Does it work with any WordPress theme? =

Yes! It's compatible with all WordPress themes including popular ones like Astra, GeneratePress, OceanWP, and custom themes. The button uses absolute positioning and won't interfere with your theme's design.

= Can I customize the WhatsApp button appearance? =

Absolutely! You can customize colors, choose from 4 button styles (circle, square, pill, with text), select from 6 animations, and apply 5 different hover effects. You can also set different sizes for mobile, tablet, and desktop devices.

= Does it work on mobile devices? =

Yes, it's fully responsive and optimized for mobile devices. You can configure different sizes and positions specifically for mobile, tablet, and desktop to ensure the best user experience on all devices.

= Is it GDPR compliant? =

Yes! The plugin includes GDPR compliance features with optional consent prompts before opening WhatsApp. You can enable privacy controls to comply with data protection regulations.

= Does it affect my site's loading speed? =

No! The plugin is lightweight and optimized for performance. It uses asynchronous loading techniques and won't slow down your website. It's designed to have zero impact on page load times.

= Can I use multiple WhatsApp numbers? =

The free version supports one WhatsApp number. If you need multiple agents or automatic number rotation, check out the Pro version which includes multi-agent support.

= Does it work with WooCommerce? =

Yes! The plugin is fully compatible with WooCommerce and all major e-commerce plugins. You can use it to provide customer support for your online store.

= Can I show the button only on specific pages? =

Yes! You can control visibility by device type (mobile/desktop), page type (home, posts, pages), and set triggers like delay, scroll, or time on page.

= Is there technical support available? =

This is a free plugin with community support. For priority email support and advanced features like A/B testing, advanced analytics, and multi-agent support, consider upgrading to the Pro version.

= How do I change the WhatsApp button position? =

Go to the plugin settings and use the position controls to place the button anywhere on your screen (top-left, top-right, bottom-left, bottom-right, or custom positions).

= Can I add a custom message that opens with WhatsApp? =

Yes! You can set a pre-configured message that will automatically appear when users click the button, making it easier for customers to contact you with context.

== Screenshots ==

1. Main configuration panel - Easy setup in 2 minutes
2. Color and style customization - 4 styles, 6 animations, 5 hover effects
3. Responsive configuration by device - Customize sizes for mobile, tablet, desktop
4. Visibility and trigger controls - Show/hide by page, device, or user behavior
5. Privacy and GDPR configuration - Compliance settings and consent options
6. Dashboard with analytics - Track clicks and engagement (basic version)
7. Button preview - See your button design in real-time

== Changelog ==

= 1.0.4 =
* New global toggle to enable or disable the WhatsApp button from the Basic tab.
* Header status now synced with the toggle (shows Active/Inactive correctly).
* Visual improvements in the admin header (better contrast, main title in white, clearer status badge).
* Added a “Report a bug” button directly in the settings footer.
* Updated Pro version copy to show launch price (USD 15).

= 1.0.3 =
* SEO optimization: Updated short description with keywords (WhatsApp button, WhatsApp chat, WhatsApp widget)
* Added SEO paragraph in description section for better WordPress.org search visibility
* Added review call-to-action: Footer message and admin notice after saving settings
* UI improvements: Removed duplicate title, unified style to friendly Spanish (informal tone)
* Removed duplicate preview in Visual Effects section (already shown in sidebar)
* Fixed dashboard statistics: Prevented values from disappearing due to JavaScript conflicts
* Added Analytics field in Privacy tab with clear Basic vs Pro separation
* Optimized data collection: Free version only collects essential data (date, URL), Pro version collects detailed analytics (device, browser, country, IP, etc.)
* Improved dashboard period selector synchronization
* Enhanced user experience with consistent informal Spanish language throughout admin panel

= 1.0.2 =
* Changed all prefixes from "mcnb" to "mcnb" to comply with WordPress naming conventions (minimum 4 characters)
* Fixed security issues: all $_SERVER, $_POST, $_GET inputs are now properly sanitized and validated
* Fixed internationalization: all menu titles and section titles now use English as base language
* Fixed hook names to use proper plugin prefix
* Renamed main plugin file to follow WordPress convention (madnesschat-button.php)
* Improved code security and compliance with WordPress Coding Standards

= 1.0.1 =
Bug fixes and improvements. Fixed privacy settings saving, checkbox persistence, and visual effects preview.

= 1.0.0 =
First version of MadnessChat Button. Free plugin to add a WhatsApp button to your WordPress website.

== Upgrade Notice ==

= 1.0.4 =
UX and admin improvements: new global toggle to enable/disable the button, clearer header status, bug report button, and updated Pro CTA with launch price (USD 15). Recommended update for all users.

= 1.0.3 =
SEO and UX improvements update. Better search visibility, review prompts, improved dashboard stability, and optimized data collection. Free version now collects minimal data for privacy. Recommended update for all users.

= 1.0.2 =
Important WordPress.org compliance update. Prefixes updated to meet naming standards. Enhanced security and code quality. No breaking changes - all functionality remains the same.

= 1.0.1 =
Bug fixes and improvements. Fixed privacy settings saving, checkbox persistence, and visual effects preview. Recommended update for all users.

= 1.0.0 =
First version of MadnessChat Button. Free plugin to add a WhatsApp button to your WordPress website.

== Additional Info ==

**Developed by**: madnesscode1
**Support**: madnesscode1@gmail.com

### System Requirements

* WordPress 5.6 or higher
* PHP 7.3 or higher
* PHP Memory: minimum 64MB

### Compatibility

* ✅ All WordPress themes
* ✅ Page builders (Elementor, Divi, etc.)
* ✅ Cache plugins
* ✅ WPML and translation plugins
* ✅ WooCommerce and e-commerce plugins

### License and Support

This plugin is available under GPL v2 license and is completely free.

For basic support, please review the included documentation. For advanced features and priority support, consider the Pro version.

### Pro Version

Need more features? The Pro version includes:
* Multiple agents with automatic rotation
* A/B Testing to optimize conversions
* Advanced analytics with complete dashboard
* Contextual messages per page
* Smart template system
* Priority email support

Contact us: madnesscode1@gmail.com