README.txt

=== Super Web Share - Native Social Sharing Button ===
Contributors: superwebshare
Donate link: https://superwebshare.com/donate
Tags: share button, web share, share, Share API, social share
Requires at least: 3.0.1
Tested up to: 6.5.3
Stable tag: 2.5.1
Requires PHP: 7.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Super Web Share helps you easily add a native share prompt to your website, allowing you to share a page or post in less than a minute.

== Description ==
Super Web Share is a WordPress-based native share plugin that prompts the native share action and helps users easily share a page or post with others.

We developed from the ground up with simplicity and performance in mind to increase your shares. As SuperWebShare only shows the apps installed within the device upon the share prompt, the rate of sharing of posts/pages will be higher than showing all the social icons on a page. Due to this key reason, website developers can skip the usage of other social media icons on their website and make the share more prominent.

The Super Web Share plugin for WordPress helps increase your traffic and engagement with a single quick click to share the website with your friends and social media. Super Web Share works on all supported browsers like Chrome for Android, Edge for Android, Brave for Android, and Opera for Android. It will show the native apps installed on the device once you share the article with others; due to that, users can easily share the page/post with others super easily in just a click. Upon the native share, which prompts up like a native iOS or Android share sheet, users can easily copy the website page link if they want that option.

It takes less than a minute to set up Super Web Share, and we provide a clean uninstall by removing the entire data entry it creates. We also won't save any settings to your database until you manually save the settings. We also provide a fallback native popup if the Native Web Share is not supported within the browser.

Currently, the Super Web Share plugin provides a share button before and after the post/page content and a floating share button where you can set the color, the text of the share buttons, and the position of the floating button; it can also set the pages or posts which you would like to show the share buttons via our Settings page, to easily add the share feature to your websites. As a plugin that focuses on simplicity, we are fully compatible with the AMP plugin, which means you can add the native share to your AMP pages provided by the AMP plugin.

### Social Platforms supported
**1) On Web Sharing API supported devices:** 
You will notice the share prompt (also called as sharesheet) where you can share the page via all applications installed on your device that accept the sharing (mobile - Android and iOS devices, tab, desktop - for Microsoft Edge browser). This means all the social platforms on your website visitor's devices can be selected from the list to share the page in a simple click!
**2) If the device or browser won't support the native share:**
If the website is viewed from a browser or device that won't support native sharing, our fallback modal works. Within the fallback modal, you can select the social platforms you want to show for your website via our settings page (SuperWebShare > Fallback). The social platforms that are interested can be selected. Right now, we are providing social media like Facebook, X (Twitter), LinkedIn, Pinterest, Mastodon, Telegram, Pinterest, and Email. We're expanding with more social platforms.

### Advantages of using Super Web Share
* Fast and lightweight social sharing plugin for your WordPress that won't slow down your site
* Increase the rate of sharing of pages and posts by users
* Developers / Bloggers can easily skip the number of social icons to be used on the page or post
* Fully AMP supported native share plugin
* Support on all content types like Posts, Pages
* Fully compatible with WooCommerce Product pages
* You can hide or show the sharing button based on each post/page and all via the content types

#### Want to test to know how SuperWebShare works on a website? 
* Open [SuperWebShare.com](https://superwebshare.com/?utm_source=wordpress-plugin&utm_medium=wordpress-readme) in a supported device. See [FAQ to know the supported browsers](https://wordpress.org/plugins/super-web-share/#faq)
* You can see a floating button at the bottom right corner
* Tap on it; instantly, you can see the native Web Share prompt with the applications, which you can share on the page.
* Tap on the icon of the application from the prompt and send.
* If the website does not support the Native Share option, you will notice the fallback popup where you can add the social media platforms via our Fallback settings, which we created to make an intuitive share plugin with a copy link option for your website.

#### Requirments for working SuperWebShare?
* The Website should be fully served via a secured origin, i.e., the green padlock should be on the address for a working Super Web Share. 
* Otherwise, by default, our fallback popup will show on browsers where users can share via major social sharing platforms like WhatsApp, Facebook, LinkedIn, and Twitter. It also comes with the Copy link option (on https sites).

#### How to contribute? 
**You can easily contribute to the plugin by translating it into your language**. Click on the link below, choose your language, and translate the strings into Development (trunk).

* **[Translate plugin to your language](https://translate.wordpress.org/projects/wp-plugins/super-web-share/)**
* Do you know coding? Then you can also contribute to this plugin via our [GitHub repository](https://github.com/superwebshare/super-web-share/) to make this the best one.

== Installation ==

* Visit WordPress Admin Dashboard > Plugins > Add New
* Search for 'Super Web Share.'
* Click "Install now" and then "Activate" Super Web Share

Install manually:
1. Upload `super-web-share.zip` zip file to the `/wp-content/plugins/` directory
2. Go to WordPress admin > Plugins
2. Activate the Super Web Share plugin from the Plugins list

== Customize Super Web Share ==
You can easily customize the color, position, and pages on which you would like to show the button before and after the page or post content, the floating share button, and the fallback color via our plugin. To customize, go to Super Web Share from the WordPress admin dashboard.

== Frequently Asked Questions ==

= Which browsers do the Super Web Share plugin work? =

The Web Share plugin works on browsers like Chrome for Android, iOS Safari (from version 12.2), Samsung Internet for Android (version 9.2+), Edge for Android, Brave for Android, Opera for Android, Google Chrome 89 or later on Chrome OS and Windows, and Safari 12 or later on macOS and iOS. Otherwise, our fallback prompt will output the share icons, from which you can select the social platforms from our Fallback settings page.

= Will the floating share and Inline content buttons on the page and post appear on non-supported browsers? =

By default, yes! If the browser doesn't support Web Share API, we show the floating share and inline content share buttons on pages and posts. If you have disabled the fallback within our settings, we won't show the fallback prompt with social share icons and a copy link option.

= Do you support WooCommerce product pages? =

Yes, we do support WooCommerce Product pages. You can select 'Product' within the Floating and Inline settings page, and then the social share button will appear for your WooCommerce product pages. You can also disable or enable the share button by editing the single product pages based on your interest. The one-click social share button for your WooCommerce is ready!

= How do I report bugs and new feature suggestions? =

You can report the bugs and request new features you need to see at our [GitHub repository Discussion page](https://superwebshare.com/ghdcs) 

= How can I contribute to this awesome plugin? =

You can contribute to this Web Share plugin via our [GitHub repository](https://github.com/superwebshare/super-web-share/) 

= Did I need to register or sign up anywhere to use the Super Web Share plugin? =

No, Super Web Share is super easy to set up. Anyone can create a native social sharing experience on their websites without any registrations. If the browser supports the Share API, it will magically prompt native sharing on the supported browsers. 

= Is SuperWebShare plugin GDPR Compliant? =

Yes, SuperWebShare is fully GDPR Compliant. Unlike other social sharing tools, this share plugin does not use any cookies or tracking scripts or store any user data.

= Is Shortcode support available? =

Yes, from v2.3, we do support shortcodes to add floating and inline buttons like you think. You can read more about how to [add shortcodes](https://superwebshare.com/shcd).

== Screenshots ==

1. Demo on how the Super Web Share outputs the native sharing on Android phones
2. Settings page of a Floating button within the  WordPress Admin > Super Web Share
3. Inline sharing button settings page of Super Web Share
4. Fallback settings page
5. Appearance page settings
6. Fallback on the desktop with social media platforms like WhatsApp, Twitter, Facebook, and LinkedIn.

== Changelog ==

= 2.5.1 =
### Release Date: June 8th, 2024

#### Bugfix:
* Fixed an error on the AMP page when the legacy AMP version is selected. Thanks to [mfonabel](https://wordpress.org/support/users/mfonabel/) for reporting this issue.

= 2.5 =
Release Date: May 31st, 2024
Gutenberg block, more customizations, and new features to make a Super Share button for your website. [Read our release post](https://superwebshare.com/2-5-release)

New Features:
* Added option to select the fallback social icons to be shown
* Added fallback icons like Mastodon, Telegram, Pinterest, and Email
* Added option to change the order of fallback social icons
* Added Gutenberg block for floating button
* Added Elementor widget for floating button
* Option to add a custom URL, title, and description for shortcodes
* Tested the code using Plugin Checker and PHPCS

Enhancement:
* Add "noopener" to the fallback social links
* String "Link copied!" can now be translated
* AMP settings will now only show when the supported AMP plugins are installed on the website
* Changed Twitter logo to X

Bugfix:
* Fixed the settings changing to 'disable' for posts when the post status is changed using the Overview

= 2.4 =
Release Date: February 12th, 2023
Sharing with the super power of lightweight and speed! This release is for people who keep optimizing their pages to load more faster. [Read our release post](https://superwebshare.com/v2-4-performance-improvements/)

New Features:
* Compatible with WordPress 6.1
* Fixes the accessibility issues.  (props to @Samot80 and @sudarshankotian for reporting this)
* Minified the CSS and JS files for performance
* Added 'defer' for page performance improvements
* Option to change the Fallback popup's title (props to @aqhvcd11 for suggesting this feature)
* Option to disable native share on desktop
* Option to change the color of text and icon for the fallback
* Option to change the color of text and icon for the share buttons
* WhatsApp now adds the page title when sharing

Enhancement:
* Changed the position of the settings for "Floating position from the button"
* Improved the auto-selection rules of the title from the description when sharing
* Minor CSS optimizations

Bug Fix:
* Fixed the fallback layout 3 not outputing the LinkedIn and WhatsApp icons correctly (props to @dan-nita)
* Appearance preview button color change fixed (props to @arunbasillal)


= 2.3.1 =
Fixed: Accessibility issues

= 2.3 =
Release Date: May 23rd, 2022
Shortcodes! Shortcodes!!! Yes, we are now supporting shortcodes.

New Features:

* Added shortcode support! [Read our release post](https://superwebshare.com/2-3-introducing-shortcodes/)
* Added new option to select the icon for the share button (See Super Web Share > Appearance)
* Added new option to select the styles for the share button
* Added new option to select the size of the share button
* Added new option to enter the Twitter username within the Fallback, so that the fallback Twitter URL will pass the Twitter hander as via.
* Compatible with WordPress 6.0

Enhancement: 
Removed the share button showing the search results page

Bug Fix:
* Fixed the floating button not showing on the Product page

= 2.2 =
Release Date: May 1st, 2022

New Features:

* Added fallback and native share support for the official AMP plugin and AMP for the WordPress plugin. Make sure to enable the Fallback within our settings page to see the fallback social buttons

Enhancements:

* Coding improved a lot for the easily implementation of new features to the plugin quickly on the future release.

Bug Fix:

* Removed the showing of the share button from the Archive pages as the share button within the archives pages won't make any sense.

= 2.1.1 =
Release Date: April 1st, 2022

Bug Fix:
* Removed the Copy Link URL encoding. Thanks to [kscl](https://wordpress.org/support/users/kscl/) for reporting this issue.

= 2.1 =
Release Date: March 31st, 2022

New Features:

* Now, you can select all the post types on your website to decide to show the Super Web Share buttons.
* Added option to enable and disable within all the pages/post types pages via our Metabox. You can now fully control on which page you need to show the Super Web Share button for Floating and Inline buttons.
* Added option to change the color of the fallback popup
* Added the option to change the button text for the Floating button. Thanks to [aga2442](https://wordpress.org/support/users/aga2442/) for the feature request.
* Option to select the layout you prefer for the fallback (see the Fallback tab)
* Option to select the fallback prompt for the Fallback.

Bug Fix:

* The Inline share button, which was showing twice within the WooCommerce products pages, is now fixed, and the position changed from the description tab to the short description section.
* Multilanguage plugin translation issue fixed. Thanks to [aga2442](https://wordpress.org/support/users/aga2442/) for reporting this bug report.

Enhancements:

* Added toggle for the selection of the settings.
* Changed the name 'General' to 'Inline content' for better understanding.
* Optimized the code


= 2.0.1 & 2.0 =
Release Date: January 8th, 2022

Bug Fix:
* Small fix on CSS where the fallback was not loading on some themes

Enhancements:

* Introducing the Fallback feature so that the fallback prompt with the copy link option will be shown if the Share API does not support the browser. You can find out the settings within Super Web Share > Fallback page.

Bugfixes:

* Fixed floating button not showing as round shape within the AMP pages
* Made the plugin lightweight


= 1.4.5 =
Release Date: March 16th, 2021

Enhancements:

* Goodbye jQuery! We're now using JavaScript code, and our small JavaScript file will be loaded once the website gets fully loaded.

Bugfixes:

* Fixed floating button not showing at the left of the page
* Style on AMP pages reduced to load the share more faster


= 1.4.4 =
Release Date: January 19th, 2020

Enhancements:

* Now we're supporting AMP pages
* AMP settings options added to dashboard for enabling native web share button over AMP pages for before and after post content
* AMP settings options added to floating button settings

= 1.4.3 =
Release Date: December 28th, 2019

Bugfixes:

* Fixed a compatibility issue over PHP versions - 5.3, 5.4, 5.5 and 5.6
(Thanks to Gijo)


= 1.4.2 =
Release Date: December 21st, 2019

Enhancements:

* Loading scripts on AMP pages fixed
* Introducing admin notices for better user experience
* Minor improvements over the overall code to load faster

Bugfixes:

* Fixed a php error if none of the tab's value is received to the variable


= 1.4.1 =
Release Date: December 1st, 2019

Enhancements:

* Settings page improved
* SVG icon for share both share buttons - Thanks to Ajith
* Floating share button style changed
* General share button style changed for good user experience


= 1.4 =
Release Date: November 19th, 2019

Enhancements:

* WordPress 5.3 support
* Settings link corrected


= 1.3.1 =
Release Date: April 19th, 2019

Enhancements:

* Inline content Share Button default value set to disabled, once plugin is activated

= 1.3 =
Release Date: April 19th, 2019

Enhancements:

* Introducing tab option to select General settings and Floating settings
* Status option to check whether the website will support SuperWebShare
* Adds Submenu for eay navigation
* Improves the coding structure for future features

Bugfixes:

* Fixes an issue where non-secure loading of Twitter share widget within the Admin dashboard to secured

= 1.2 =
Release Date: March 8th, 2019

Enhancements:

* Adds share button to prompt native share over above and below of the post/page content
* Option to select the color, text on the share button added
* Adds option's to select the pages to display the Inline content share button
* Minor performance improvements to render SuperWebShare faster.
Thanks to Jyothis for reporting the bug.

= 1.1 =
Release Date: December 15th, 2018

Enhancements:

* Adds option to select color via color picker for floating share button
* Adds option's to select pages to display the floating button
* Adds option's to select the position of Floating Share Button (Left/Right)


= 1.0 =
Release Date: October 31st, 2018
Inital Release

Enhancements:

* Initial release with Floating Share Button
* Option to change color of button from Settings page