=== Shois Chat Button ===
Contributors: shoiswp, freemius
Tags: chat button, whatsapp, telegram, messenger, live chat
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add WhatsApp, Telegram, Messenger, and 10+ chat apps to your site. Features live visual templates, CSS animations, and smart display rules.

== Description ==

**Shois Chat Button – Ultimate WhatsApp Chat Button & Telegram Chat Button for WordPress**

Are you tired of losing potential customers because your contact forms are too slow or boring? In today’s fast-paced world, your visitors don’t want to wait 24 hours for an email reply. They want to talk to you right now.

**Shois Chat Button** is the most powerful, lightweight, and user-friendly way to add a *WhatsApp Chat Button, Telegram Chat Button*, and over 13+ other communication channels to your WordPress site.

Instead of a static "Contact Us" page, give your visitors a beautiful, animated floating chat widget that connects them directly to their favorite messaging apps. It’s built with a modern React-powered interface, ensuring a smooth experience for you and a lightning-fast experience for your visitors.

### Why Your Website Needs a Multi-Platform Chat Widget

Most visitors leave a website because they have one simple question that isn't answered. By providing an instant WhatsApp Chat Button or Messenger link, you remove the friction. You aren't just adding a plugin; you are adding a conversion machine.

Whether you are a solo freelancer or a large support team, Shois Chat Button helps you manage conversations effectively without slowing down your website's performance.

🚀 **Deep Dive: Powerful Free Features**

Unlike other plugins that hide everything behind a paywall, Shois Chat Button offers a robust set of free features designed to help small businesses grow. Here is why Shois is the preferred choice for WordPress users:

**Comprehensive Multi-Platform Connectivity**
Don’t limit your customers to just one app. Our free version allows you to integrate the most popular communication channels seamlessly:
*   **Official WhatsApp Integration:** Add a dedicated WhatsApp Chat Button to your site, allowing users to send messages directly to your number without any friction.
*   **Telegram Chat Button:** Perfect for secure, fast, and encrypted communication with your tech-savvy audience.
*   **Facebook Messenger & Instagram Direct:** Connect with your Meta audience and manage all inquiries in one place.
*   **Support for 13+ Channels:** Including Viber, Line, Phone calls, and more.
*   **Simultaneous Display:** You can show multiple chat platforms within a single, elegant floating widget.

**Live Visual Template Builder (No-Code)**
You don’t need to be a designer or a coder to create a stunning chat widget.
*   **Real-Time Preview:** Our Live Visual Editor lets you see exactly how your button looks on the frontend while you are customizing it in the dashboard.
*   **Instant Updates:** Every change in color, text, or icon is reflected immediately, saving you time and effort.
*   **Modern Admin UI:** Powered by React, the dashboard is fast, responsive, and incredibly easy to navigate.

**Complete Design & Branding Control**
Your chat button should look like it belongs on your website. We give you full creative freedom:
*   **Custom Branding:** Use the built-in color pickers to match the widget with your brand’s primary colors.
*   **Icon Customization:** Choose from multiple icon styles or variations to fit your site’s aesthetic.
*   **Adjustable Positioning:** Decide exactly where the widget appears. You can toggle between Left or Right positioning with ease.
*   **Precision Layouts:** Control margin and padding to ensure the button doesn't overlap with other important site elements.

**Engagement-Focused Call-to-Actions (CTA)**
A button is only good if people click it. We help you boost those clicks:
*   **Custom CTA Text:** Instead of a generic "Chat," you can write personalized messages like "Need help with pricing?" or "Talk to our experts."
*   **Welcome Greetings:** Set up custom greeting messages that appear when a user interacts with the widget, making your business feel more welcoming and human.

**Performance-First Architecture**
As an SEO-focused plugin, Shois Chat Button is built to keep your site lightning-fast:
*   **Lightweight Frontend:** We use optimized code that adds virtually zero weight to your page size.
*   **Deferred Asset Loading:** Essential for SEO! We load the plugin assets in a way that doesn't block your site’s initial rendering, ensuring high Google PageSpeed scores.
*   **REST API Integration:** Using the WordPress REST API for saving settings ensures a modern, secure, and fast administrative experience.

💎 **Unlock Business Growth with Shois PRO**

Upgrade to PRO to access advanced targeting, team management, and deep analytics.

**Multi-Agent & Department Routing (PRO)**
Don't just link to one number. Build a professional support system:
*   **Unlimited Agent Profiles:** Add your entire team with names and professional titles.
*   **Department Routing:** Automatically route "Sales" queries to your sales team and "Technical" queries to support.
*   **Personalized Avatars:** Upload real photos of your team to build instant human trust.
*   **Live Availability Indicators:** Show a "Green Dot" when your agents are online and ready to chat.

**Advanced Micro-Targeting (PRO)**
Show the right button to the right person at the right time:
*   **Page-Specific Widgets:** Show a special WhatsApp button for your "Pricing" page and a different one for "Support."
*   **URL-Based Targeting:** Use wildcard matching to include or exclude specific sections of your site.
*   **Device Visibility:** Choose to show the widget only on Mobile, only on Desktop, or both.
*   **Homepage Control:** Specific rules to show or hide the widget on your landing page.

**Smart Scheduling & Timezone Controls (PRO)**
Stop getting messages at 3:00 AM:
*   **Operating Hours:** Set specific working hours for every day of the week.
*   **Timezone Aware:** The plugin automatically calculates your local time to show or hide the button.
*   **Auto-Hide Feature:** The widget disappears automatically when you are off-duty.

**High-Conversion Animation Engine (PRO)**
Grab your visitor’s attention before they scroll away:
*   **Entry Animations:** Use Slide-in or Fade-in for a premium feel.
*   **Continuous Attention-Seekers:** Make your WhatsApp Chat Button "Pulse," "Bounce," or "Shake" to drive more clicks.
*   **Interactive Hover Effects:** Add smooth transitions when users interact with agent profiles.

**Actionable Analytics Dashboard (PRO)**
Stop guessing and start measuring:
*   **Interaction Tracking:** See total clicks and engagement rates.
*   **Platform Breakdown:** Find out if your users prefer WhatsApp or Telegram.
*   **Performance Metrics:** Track which agents are getting the most engagement.

📂 **Explore Our Other Plugins**

If you love Shois Chat Button, check out our other tools designed to enhance your WordPress experience:
*   **[Uply](https://wordpress.org/plugins/uply-scroll-to-top-and-progress-bar/):** Animated Scroll to Top Button, Progress Bar, and Read Time indicator.
*   **[Login Page Customizer and Designer](https://wordpress.org/plugins/login-page-customizer-and-designer/):** Transform your boring WordPress login page into a branded experience.
*   **[SmartWait Animated Preloader](https://wordpress.org/plugins/smartwait-animated-preloader/):** Beautiful, high-performance preloaders to keep visitors engaged while your site loads.

Ready to boost your sales? Download **Shois Chat Button** now and give your customers the instant support they deserve!

= Platforms Supported =

1. WhatsApp
2. Telegram
3. Facebook Messenger
4. Instagram DM
5. Viber
6. Line
7. Signal
8. Discord
9. Skype
10. Snapchat
11. TikTok
12. WeChat
13. Custom Link

== Installation ==

1. Upload the `shois-chat-button` folder to `/wp-content/plugins/`.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **Shois Chat** in the admin sidebar.
4. Follow the setup wizard to configure your first chat button.

== Frequently Asked Questions ==

= Is the Shois Chat Button plugin completely free to use? =
Yes, the core features of Shois Chat Button, including multi-platform connectivity (WhatsApp, Telegram, Messenger), the Visual Builder, and custom branding options, are available entirely for free to help you grow your business.

= Will adding this chat widget slow down my WordPress website? =
Not at all. Shois Chat Button is built with a lightweight architecture and uses deferred asset loading. This means the plugin assets load only after your main content, ensuring your SEO and PageSpeed scores remain optimal.

= Can I display multiple platforms like WhatsApp and Telegram in a single widget? =
Yes! You can display more than 13 popular communication channels, including WhatsApp, Telegram, and Facebook Messenger, simultaneously within one clean and organized floating widget.

= Do I need any coding skills to customize the chat button? =
No coding is required. The plugin features a React-powered Visual Builder that allows you to customize colors, icons, and positions using a simple point-and-click interface with a live preview of your changes.

= How do I connect my WhatsApp number to the button? =
Simply select WhatsApp in the plugin dashboard, enter your phone number with the country code, and save. You can also add a pre-filled welcome message to make it easier for customers to start a conversation.

= Is the Shois Chat Button widget responsive on mobile devices? =
Yes, the widget is fully responsive and designed to work perfectly across all screen sizes, including smartphones, tablets, and desktops, providing a seamless experience for all your visitors.

= Can I change the position of the chat button on my website? =
Absolutely. You can easily toggle the widget position between the bottom-left and bottom-right of your screen. You also have full control over margins and padding to ensure it fits your layout perfectly.

= Is this plugin compatible with page builders like Elementor or Divi? =
Yes, Shois Chat Button is 100% compatible with all modern WordPress themes and popular page builders like Elementor, Divi, and Gutenberg, without causing any technical conflicts.

= Can I customize the Call-to-Action (CTA) text next to the button? =
Yes, you can write your own personalized text, such as "Need Help?" or "Talk to Us," to encourage more visitors to click the chat button and start a conversation.

= Can I translate the plugin into my local language? =
Yes, the plugin is localization-ready. You can easily translate all the frontend text, labels, and greetings into your preferred language to match your website's primary audience.

== Screenshots ==

1. Admin Dashboard — Overview with KPIs and setup checklist.
2. Template Editor — 3-column live preview editor.
3. Animation Picker — Visual animation selector with live previews.
4. Agent Management — Multi-agent setup with schedules.
5. Frontend Widget — Clean, animated chat button in action.

== Developer Instructions ==

The admin dashboard is built with React and bundled using `@wordpress/scripts` (Webpack).
The original, unminified source code is included in the `admin/src/` directory.

To rebuild the admin assets:

1. Navigate to the `admin/` folder inside the plugin directory.
2. Run `npm install` to install dependencies.
3. Run `npm run build` to compile the production bundle into `admin/build/`.

The frontend widget (`widget/`) uses vanilla JavaScript and CSS — no build step required.

== Changelog ==

= 1.0.0 =
* Initial release.
* 13 messaging platforms supported.
* 4 built-in templates with visual editor.
* 50+ CSS animations across 6 categories.
* Multi-agent support with availability scheduling.
* Display rules engine with PHP and JS evaluation.
* Analytics dashboard.
* WooCommerce integration.
* Full WCAG 2.1 AA accessibility compliance.
