=== Accelvia Connect - Floating CTA ===
Contributors: musfiqurrahman
Tags: whatsapp, floating button, sticky button, call button, contact button
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add floating CTAs with Lottie animations, business hour rules, smart scroll triggers, dynamic transparency, and automatic GA4 tracking.

== Description ==

https://youtu.be/alAcXX6xINA

The **Accelvia Connect - Floating CTA** plugin is a feature-rich solution for adding interactive, conversion-focused floating buttons to WordPress websites. Below is a comprehensive feature list based on the plugin's codebase and documentation:

### 1. Multiple Floating Buttons
* **Stacked Interface:** Create and manage multiple buttons that stack vertically.
* **Drag & Drop Reordering:** Easily change the order of buttons via the admin interface to control their stack sequence on the front end.
* **Dynamic Management:** Add or remove buttons with a single click.

### 2. Supported Button Types
* **WhatsApp:** Direct integration with pre-filled message support.
* **Phone / Call:** Automatic tel: link formatting for one-click calling.
* **Email:** Automatic mailto: link formatting.
* **Telegram:** Support for usernames (@user) or direct t.me links.
* **Discord:** Integration for server invite links.
* **Custom Link:** Support for any external or internal URL.

### 3. Advanced Customization & Visuals
* **Custom Icons:** Upload your own PNG or SVG icons per button.
* **Lottie Animations:** Integration with [LottieFiles](https://lottiefiles.com/). Paste a .lottie or .json URL to replace static icons with high-quality animations.
* **Notification Badges:** Add a "1" or custom text badge to buttons to draw attention (e.g., mimicking a new message).
* **Greeting Bubbles:** Add persistent text bubbles next to buttons (e.g., "Chat with us!" or "Need help?").
* **Hover Animations:** Choose from several CSS animations: **Bounce, Pulse, Shake, Spin,** or None.
* **Tooltip Labels:** Custom action labels that appear as tooltips on hover.
* **Icon Sizing:** Global control over button size (ranging from 30px to 120px).

### 4. Smart Display & Visibility Rules
* **Business Hours:** Limit button visibility to specific days of the week and custom time ranges (synced with your WordPress timezone).
* **Page-Specific Targeting:**
  * Show everywhere.
  * Show on Homepage only.
  * Filter by Page IDs (Include or Exclude specific pages).
* **Display Triggers:**
  * **Immediate:** Show as soon as the page loads.
  * **Time Delay:** Show after a specified number of seconds.
  * **Scroll Trigger:** Show only after the user scrolls a certain percentage (e.g., 25%) down the page.
* **Device Visibility:** Toggle visibility for individual buttons specifically for **Mobile** or **Desktop**.

### 5. Positioning & Layout
* **Flexible Alignment:** Position the button stack on the **Left** or **Right** side of the screen.
* **Vertical Alignment:** Pin the stack to the **Top, Middle,** or **Bottom**.
* **Precision Offsets:** Fine-tune Horizontal and Vertical spacing (in pixels) for perfect placement.

### 6. Analytics & Tracking
* **GA4 Integration:** Toggle button click tracking for Google Analytics 4.
* **Meta Pixel:** Toggle click event tracking for the Meta (Facebook) Pixel.
* **Automatic Events:** No manual coding required; the plugin detects the tracking scripts and sends events automatically.

### 7. Developer & Performance Features
* **Custom CSS Entry:** Built-in CSS editor for global or button-specific styling.
* **Individual CSS Classes:** Assign custom classes to each button for granular styling.
* **Performance Optimized:** Clean, lightweight code with minimal dependencies to ensure fast page loads.
* **Translation Ready:** Fully internationalized and ready for localization.

Perfect for businesses, agencies, freelancers, and ecommerce websites.


== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/accelvia-connect-floating-cta` directory, or install the plugin through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Navigate to Settings -> Accelvia Connect to configure the plugin.

= Third-Party Libraries =
* **DotLottie Player** (MIT License): Used for Lottie animation rendering. Source code: https://github.com/LottieFiles/dotlottie-web

== Frequently Asked Questions ==

= Does this plugin slow down my website? =

No. The plugin is lightweight and only loads minimal CSS and JavaScript.

= Can I add multiple buttons? =

Yes. You can create and stack multiple floating buttons.

= Is this plugin mobile friendly? =

Yes. The buttons are fully responsive.

== Changelog ==

= 1.0.0 =
* Initial release.
* Multiple stacked floating buttons with WhatsApp, Call, Email, Telegram, Discord, and Custom Link integrations.
* Advanced CSS animations (Bounce, Pulse, Shake, Spin, Fade).
* Smart Visibility: Show only on homepage or include/exclude specific pages.
* Display Triggers: Show immediately, after time delay, or after scroll percentage.
* Business Hours: Conditional display based on operating hours and days.
* Auto-Tracking: Built-in 1-click integration for GA4 and Meta Pixel tracking.
* Performance: Lightweight code and conditional loading of DotLottie player.
* Transparency: Background opacity controls for Custom Link buttons.
* Notification badges and greeting text bubbles for higher engagement.