=== Sharezel – Social Share Buttons ===
Contributors: estiakahamed
Tags: share, social share, floating share, share buttons, social media
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

A lightweight, customizable floating/bar/inline social share menu for your posts and pages. No analytics, no visitor tracking.

== Description ==

Sharezel adds a clean, animated share menu to your posts and pages so readers can share your content on Facebook, WhatsApp, X (Twitter), Telegram, LinkedIn, Pinterest, email, or copy the link — all with a single click.

**Key features:**

* Three display styles: floating popup button, floating bar, or inline (below content)
* 8 built-in platforms, individually toggled on or off
* Choose which post types the menu appears on
* Circle, rounded, or square icon shapes
* Custom accent color with the native WordPress color picker
* Optional text labels next to icons
* `[sharezel_share_menu]` shortcode for manual placement anywhere
* 100% inline SVG icons — no icon fonts, no external image requests
* No analytics, no visitor tracking, no data sent anywhere by the plugin itself
* Translation-ready
* Clean uninstall — removes its single settings option, nothing left behind

**Privacy note:** This plugin does not collect, store, or transmit any visitor data itself. When a reader clicks a share icon, their browser opens that platform's own official share dialog directly — see "External services" below for exactly what that involves.

== External services ==

This plugin does not run any background requests, analytics, or tracking of its own. However, several of the share buttons are simple links that open each platform's own public share dialog directly in the visitor's browser when they are clicked. No data is sent by the plugin or its author — the visitor's browser communicates directly with the platform they chose to share to, the same as clicking a normal link to that site. Only the current page's URL and title are included in that link, and only when the visitor deliberately clicks the corresponding icon.

* **Facebook** — opens Facebook's share dialog. Used when a visitor clicks the Facebook icon. [Terms](https://www.facebook.com/legal/terms), [Privacy Policy](https://www.facebook.com/policy.php)
* **WhatsApp** (Meta) — opens WhatsApp's click-to-chat page. Used when a visitor clicks the WhatsApp icon. [Terms](https://www.whatsapp.com/legal/terms-of-service), [Privacy Policy](https://www.whatsapp.com/legal/privacy-policy)
* **X (Twitter)** — opens X's tweet-composer page. Used when a visitor clicks the X icon. [Terms](https://twitter.com/en/tos), [Privacy Policy](https://twitter.com/en/privacy)
* **Telegram** — opens Telegram's share page. Used when a visitor clicks the Telegram icon. [Terms](https://telegram.org/tos), [Privacy Policy](https://telegram.org/privacy)
* **LinkedIn** — opens LinkedIn's share dialog. Used when a visitor clicks the LinkedIn icon. [Terms](https://www.linkedin.com/legal/user-agreement), [Privacy Policy](https://www.linkedin.com/legal/privacy-policy)
* **Pinterest** — opens Pinterest's pin-creation dialog. Used when a visitor clicks the Pinterest icon. [Terms](https://policy.pinterest.com/en/terms-of-service), [Privacy Policy](https://policy.pinterest.com/en/privacy-policy)

The **Email** icon only opens the visitor's own local email client via a standard `mailto:` link — no external service is involved. The **Copy Link** button only uses the browser's built-in clipboard API — no external service is involved either.

== Installation ==

= A) Install from within WordPress (recommended) =

1. In your WordPress dashboard, go to **Plugins > Add New Plugin**.
2. Search for **"Sharezel"**.
3. Click **Install Now**, then **Activate**.
4. Go to **Settings > Sharezel** to choose your platforms, style, and colors.

= B) Upload the ZIP manually =

1. Download the plugin ZIP file.
2. In your dashboard, go to **Plugins > Add New Plugin > Upload Plugin**.
3. Choose the ZIP file and click **Install Now**.
4. Click **Activate Plugin**.
5. Go to **Settings > Sharezel** to configure it.

= C) Upload via FTP/SFTP =

1. Unzip the plugin package on your computer.
2. Upload the resulting `sharezel-social-share-buttons` folder to `/wp-content/plugins/` on your server.
3. In your dashboard, go to **Plugins**, find "Sharezel – Social Share Buttons", and click **Activate**.
4. Go to **Settings > Sharezel** to configure it.

= After activation =

The plugin works immediately with sensible defaults (a floating popup button near the top-right of the screen, showing 9 platforms) — you don't have to configure anything to start sharing. Visit **Settings > Sharezel** any time to adjust:

* **Show on** — which public post types display the menu (Posts, Pages, or any custom post type).
* **Platforms** — tick the networks you want; untick any you don't. Order follows the list top-to-bottom.
* **Menu style** — Floating popup button, Floating bar, or Inline (below the content).
* **Position** — Left/Right for floating styles, Top/Bottom for the bar style.
* **Icon shape** — Circle, rounded square, or square.
* **Toggle button color** — pick any accent color with the built-in WordPress color picker.
* **Show text labels** — adds the platform name next to each icon (floating bar always shows icons only, by design).
* **Vertical offset (px)** — fine-tune the distance from the top of the screen for floating styles.

Click **Save Changes** and the menu updates on your site immediately — no cache to clear beyond your usual page cache, if you use one.

You can also drop the menu manually into any post, page, or widget using the shortcode `[sharezel_share_menu]`, regardless of the global style setting (it always renders inline where you place it).

== Frequently Asked Questions ==

= Does this plugin track visitors or send data anywhere? =

The plugin itself does not run analytics or tracking. Share icons are plain links to each platform's own official share dialog — see the "External services" section above for exactly what that involves and links to each platform's terms and privacy policy.

= Can I place the menu manually inside a specific post? =

Yes — use the `[sharezel_share_menu]` shortcode anywhere in your content, widgets, or template files (with `do_shortcode()`).

= Can I control which post types show the menu? =

Yes, under Settings > Sharezel > "Show on" you can enable it per public post type (posts, pages, or any custom post type).

= Will it slow down my site? =

No. CSS and JS are only enqueued on pages where the menu actually renders, and everything is dependency-free vanilla JS.

== Screenshots ==

1. Floating popup share menu, open, on a single blog post.
2. Settings > Sharezel admin page — platforms, style, position, color, and labels.
3. Floating bar style, centered at the bottom of the screen.
4. Inline style with text labels, placed directly below the post content.

== Changelog ==

= 1.0.1 =
* Fix: unticking every platform, or every post type, and saving is now respected (previously reverted to defaults); an empty selection now correctly shows no menu.
* Fix: Position dropdown now only offers combinations that are actually valid for the selected style (Left/Right for floating, Top/Bottom for the bar), with the field hidden for the inline style; invalid/old saved combinations are normalized automatically.
* Fix: Copy Link now retries with a fallback method if the clipboard permission is denied, and shows an error message if copying truly fails, instead of always claiming success.
* Fix: Removed the Messenger share button — its link required a Meta App ID that the plugin never had a valid value for.
* Improvement: Floating menu now returns keyboard focus to the toggle button when closed via Escape or an outside click, and the toggle/list now use `aria-controls` for a clearer accessible relationship.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.1 =
Bug-fix release: platform/post-type selections can now be intentionally empty, position options are validated per style, Copy Link has a reliable fallback, and the Messenger button (which needed an app ID this plugin never had) has been removed.

= 1.0.0 =
Initial release.
