=== Sticky Social Icons - Floating Social Media, WhatsApp Chat, Click-to-Call & Email Icons ===
Contributors: gutefy
Tags: social icons, floating social icons, whatsapp button, click to call, share buttons
Requires at least: 6.3
Requires PHP: 7.2
Tested up to: 7.0
Stable tag: 1.2.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Floating or inline social icons for any WordPress site: WhatsApp click-to-chat, click-to-call, email, Facebook, Instagram, X, YouTube, TikTok and more.

== Description ==

**Sticky Social Icons** is a lightweight, mobile-friendly social media plugin that lets you add floating sticky social icons to any WordPress site — without writing a single line of code. Visitors get instant access to your WhatsApp, phone, email, and every social channel right from the side of the screen.

Designed for businesses, creators, agencies, and stores, the plugin works out of the box with **Block Themes**, **Classic Themes**, **WooCommerce**, **Elementor**, **Bricks**, **Divi**, **Astra**, **Kadence**, **GeneratePress**, **Hello Theme**, **Hello Elementor**, and every popular page builder.

Configure everything live in the **WordPress Customizer** — change colors, sizes, borders, radius, position, and per-device visibility and see the result update in real time.

= 🚀 Why Sticky Social Icons? =

* **No-code setup** — pick icons, paste URLs, publish. Live Customizer preview means no guessing.
* **Click-to-chat WhatsApp** — paste a number, optionally add a pre-filled message, done.
* **Click-to-call & SMS** — `tel:` and `sms:` links for mobile visitors.
* **Click-to-email** — `mailto:` with optional subject and body pre-fill.
* **Truly responsive** — show or hide on Desktop / Tablet / Mobile independently.
* **Hide on specific pages** — front page, blog, single posts, single pages, archives, search, 404, WooCommerce shop / cart / checkout / single product.
* **Hide for user roles** — keep icons away from logged-out guests, administrators, or any role you choose.
* **SEO and accessibility ready** — every link ships with proper `aria-label` and `rel="noopener noreferrer"`.
* **Lightweight** — zero jQuery on the frontend, no bloated icon font, only the CSS your visitors actually need.

= 🎨 Full Design Control =

* Icon color (normal + hover, per device)
* Icon background color (normal + hover, per device)
* Icon size (normal + hover, per device)
* Icon wrapper / button size (per device)
* Border (4-side, color + style + width, per device)
* Border radius (normal + hover, per device — make pills, circles, squares)
* Vertical gap between icons
* Vertical position (top %)
* Horizontal position (left or right rail)

= 📱 Popular Channels Built In =

Facebook, Facebook Messenger, Facebook (f), WhatsApp, Instagram, X (Twitter), YouTube, LinkedIn, TikTok, Telegram, Pinterest, Snapchat, Reddit, Skype, Tumblr, Discord, GitHub, Vimeo, Twitch, Behance, Dribbble, Email (envelope), Phone, and more — with new icons added in every release.

= 💼 Perfect For =

* Small business and local service websites
* Restaurants, salons, clinics, real estate, automotive
* WooCommerce stores wanting WhatsApp pre-sales chat
* Bloggers and content creators
* Portfolios and agency sites
* Membership and online course sites
* Anyone replacing heavyweight "share & follow" plugins

== Installation ==

= From the WordPress Dashboard =
1. Go to **Plugins → Add New**.
2. Search for **Sticky Social Icons**.
3. Click **Install Now** and then **Activate**.
4. Open **Appearance → Customize → Sticky Social Icons** and add your accounts.

= Manual Installation =
1. Download the plugin ZIP from WordPress.org.
2. Upload the `gf-social-icons` folder to `/wp-content/plugins/`.
3. Activate the plugin via **Plugins** in the WordPress dashboard.
4. Open **Appearance → Customize → Sticky Social Icons**.

== Frequently Asked Questions ==

= How do I add a WhatsApp click-to-chat icon? =
In the Customizer, pick the **WhatsApp** icon, paste your number with country code (digits only — e.g. `15551234567`), open the **Advanced** chevron next to the input, and optionally type a pre-filled message. The plugin builds a `https://wa.me/...` link automatically.

= How do I add a click-to-call (phone) icon? =
Pick the **Phone** icon, paste your number. The icon generates a `tel:` link, opening the dialer on mobile. Toggle "Use SMS instead of call" in the per-row Advanced panel to switch to an `sms:` link.

= Can I add an email icon with pre-filled subject and body? =
Yes. Pick the **Envelope** icon, paste the email address, open Advanced, and fill in Subject and Body. The plugin produces a `mailto:` link with the params encoded.

= How do I hide icons on specific pages? =
Open **Appearance → Customize → Sticky Social Icons → Advanced → Display Rules**. Check any page type (front page, single posts, WooCommerce checkout, etc.) to hide the icons there.

= How do I hide icons from logged-out visitors or administrators? =
In the same **Advanced** section, check any role under **Hide For These User Roles**. Use **Guest** for logged-out visitors.

= How do I show icons on mobile only (or hide on desktop)? =
Use **Device Visibility** in the Advanced section. Uncheck Desktop, Tablet, or Mobile independently.

= Does it work with WooCommerce? =
Yes. There are dedicated hide-on rules for the WooCommerce shop, cart, checkout, and single product pages.

= Does it work with block themes (Twenty Twenty-Four, etc.) and page builders (Elementor, Bricks, Divi)? =
Yes. The plugin injects on `wp_head`, `wp_footer`, or `wp_body_open` (whichever your theme provides). It is theme- and builder-agnostic.

= Does it slow down my site? =
No. There is no jQuery on the frontend, no icon font, and only the CSS your visitors need. SVG icons are inlined so the browser makes zero extra requests.

= Does it track my visitors? =
No. The plugin makes no external requests, sets no cookies, and does not track anything.

== Screenshots ==
1. Floating social icons rail on a typical homepage.
2. Customizer panel — General section with Accounts List, drag-to-reorder, and Open in New Tab.
3. Customizer panel — Design section with Normal/Hover tabs, colors, sizes, border, radius.
4. Customizer panel — Advanced section with Device Visibility and Display Rules.
5. Per-row WhatsApp pre-fill / mailto subject+body / SMS toggle.
6. Per-row WhatsApp pre-fill, mailto subject+body, SMS toggle.

== Changelog ==

= 1.2.0 =
* **New:** Border radius (normal + hover, responsive) — circle, pill, or rounded icons in one click.
* **New:** Smart per-row URL builder for WhatsApp (`wa.me` + pre-filled message), Email (`mailto:` with subject + body), Phone (`tel:` or `sms:`).
* **New:** Advanced visibility rules — hide on front page, blog, single post/page, archives, search, 404, and dedicated WooCommerce shop / cart / checkout / product targets.
* **New:** Hide icons for selected user roles (guest, administrator, subscriber, custom).
* **New:** Per-device on/off checkboxes (Desktop / Tablet / Mobile) — all visible at once, no more switching device tabs.
* **Accessibility:** Every icon link now ships with an `aria-label` and `rel="noopener noreferrer"`.
* **Refactor:** New reusable `Checkbox` Customizer control.
* **Improved:** Customizer UI — consistent capitalized labels, unified heading style, tidier spacing.
* **Improved:** Live Customizer preview now matches frontend rendering for all new style controls.

= 1.1.02 =
* Bug Fix: Fixed a bug related to style generation for better performance.

= 1.1.01 =
* Fixed: Icon Loading Issue in various themes.
* Added: Responsive Control.
* Bug Fix: Fixed a bug related to hover styles for better consistency.

= 1.1.0 =
* Added: Border Control.
* Added: Responsive Control.
* Bug Fix: Fixed a bug related to hover styles for better consistency.

= 1.0.1 =
* Enhancement: Improved the floating style of social icons for better stability.
* Enhancement: Enhanced functionality related to styling.
* Bug Fix: Fixed a bug related to hover styles.
* Added: Icon changing option.
* Introduced: Flexible account adding system.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.2.0 =
Major feature release. Adds click-to-chat WhatsApp/Email/Phone, page-level visibility rules, role-based hiding, border-radius, per-device visibility, and accessibility (aria-label, noopener). Recommended for everyone.
