# Smart Contact Buttons
**Contributors:** hostuis
**Tags:** contact, buttons, whatsapp, phone, email, floating, responsive, mobile
**Requires at least:** 5.0
**Tested up to:** 6.6
**Requires PHP:** 7.4
**Stable tag:** 2.0.0
**License:** GPLv2 or later
**License URI:** https://www.gnu.org/licenses/gpl-2.0.html
Professional floating contact buttons with modern animations. Supports WhatsApp, Phone, SMS, Email, Telegram, Messenger, and more.
## Description
Smart Contact Buttons adds beautiful, responsive floating contact buttons to your WordPress website. Perfect for increasing customer engagement and conversion rates with a modern, professional design.
### ✨ Key Features
* **???? 100% Responsive** - Works perfectly on desktop, tablet, and mobile devices
* **???? Modern Animations** - 6 built-in animations (Fade In, Slide In, Bounce, Pulse, Zoom In)
* **???? Multiple Platforms** - WhatsApp, Phone, SMS, Email, Telegram, Messenger, Tawk.to, Viber, Skype
* **⚡ Performance Optimized** - Lightweight, native JavaScript (no jQuery dependency)
* **♿ Accessibility Ready** - WCAG 2.1 compliant with keyboard navigation
* **???? Translation Ready** - Full internationalization support
* **???? Security Focused** - All outputs properly escaped and sanitized
* **???? Touch Friendly** - Optimized for mobile touch interactions
* **????️ Clean Code** - Object-oriented architecture following WordPress standards
### ???? Supported Contact Methods
* **WhatsApp** - Direct chat with pre-filled messages
* **Phone** - Click-to-call functionality
* **SMS** - Text messaging with custom messages
* **Email** - Mailto links with custom subjects
* **Telegram** - Direct messaging
* **Facebook Messenger** - Page messaging
* **Tawk.to** - Live chat integration
* **Viber** - Cross-platform messaging
* **Skype** - Voice and video calls
### ???? Customization Options
* **Position** - Left or right side positioning
* **Size** - Small, medium, or large button sizes
* **Animations** - 6 smooth animation effects
* **Colors** - Professional color schemes for each platform
* **Custom CSS** - Add your own styling
* **Device Visibility** - Control display on desktop, tablet, mobile
## Installation
### Automatic Installation
1. Go to `Plugins > Add New` in your WordPress admin
2. Search for "Smart Contact Buttons"
3. Install and activate the plugin
4. Go to `Settings > Contact Buttons` to configure
### Manual Installation
1. Download the plugin files
2. Upload the `smart-contact-buttons` folder to `/wp-content/plugins/`
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Go to `Settings > Contact Buttons` to configure
## Configuration
After activation, go to **Settings > Contact Buttons** in your WordPress admin to:
1. **Enable the plugin** - Toggle buttons on/off
2. **Configure contact methods** - Add your phone numbers, email, social handles
3. **Customize appearance** - Choose position, size, and animations
4. **Set device visibility** - Control where buttons appear
5. **Add custom CSS** - Further customize the design
### WhatsApp Setup
1. Enable WhatsApp in the settings
2. Add your phone number in international format (e.g., +1234567890)
3. Optionally add a default message
### Phone Setup
1. Enable Phone in the settings
2. Add your phone number in any format
3. Users can click to call directly
### Email Setup
1. Enable Email in the settings
2. Add your email address
3. Optionally add a default subject line
## Frequently Asked Questions
### How do I add my WhatsApp number?
Go to Settings > Contact Buttons, enable WhatsApp, and add your number in international format starting with + (e.g., +1234567890).
### Can I customize the button colors?
The plugin uses professional color schemes for each platform. You can add custom CSS in the settings panel for further customization.
### Is the plugin mobile-friendly?
Yes! The plugin is designed mobile-first and is fully responsive. It works perfectly on all devices and screen sizes.
### Does it work with all themes?
Yes, the plugin is designed to work with any properly coded WordPress theme. The buttons use high z-index values to appear above other content.
### Can I disable buttons on mobile?
Yes, you can control device visibility in the settings. You can show/hide buttons on desktop, tablet, and mobile independently.
### Is it accessible?
Yes, the plugin follows WCAG 2.1 accessibility guidelines with proper ARIA labels, keyboard navigation, and screen reader support.
### Does it affect site performance?
No, the plugin is optimized for performance with minimal CSS and vanilla JavaScript. It only loads when buttons are enabled.
## Screenshots
1. **Admin Settings Panel** - Easy-to-use configuration interface
2. **Mobile View** - Responsive design on mobile devices
3. **Desktop View** - Professional appearance on desktop
4. **Animation Preview** - Smooth entrance animations
5. **Multiple Buttons** - Various contact methods displayed
## Changelog
### 2.0.0 (2025-06-12)
* **Major Release** - Complete rewrite with modern architecture
* **New:** Object-oriented code structure following WordPress standards
* **New:** 9 contact methods supported (WhatsApp, Phone, SMS, Email, Telegram, Messenger, Tawk.to, Viber, Skype)
* **New:** 6 animation options (Fade In, Slide In, Bounce, Pulse, Zoom In, None)
* **New:** Mobile-first responsive design
* **New:** Accessibility compliance (WCAG 2.1)
* **New:** Translation ready with POT file
* **New:** Advanced admin interface with live preview
* **New:** Custom CSS support
* **New:** Device visibility controls
* **New:** Performance optimizations
* **New:** Security enhancements
* **New:** Touch-friendly mobile interactions
* **Improved:** Code quality and maintainability
* **Improved:** User experience and interface
* **Fixed:** Various compatibility issues
### 1.0.0
* Initial release
## Upgrade Notice
### 2.0.0
Major update with new features and improved code. Please backup your site before upgrading. Settings will be preserved but you may want to review them after update.
## Support
* **Documentation:** [Plugin Documentation](https://hostuis.com/smart-contact-buttons/docs)
* **Support Forum:** [Get Help](https://hostuis.com/support)
* **Contact:** [Contact Us](https://hostuis.com/contact)
## About Hostuis Group LLC
Hostuis Group LLC is a leading software development company specializing in WordPress solutions, web hosting, and digital marketing services.
**Website:** [https://hostuis.com](https://hostuis.com)
**Email:** support@hostuis.com
