Social Warfare - Pro #5 in Social & Sharing

=== WordPress Social Sharing Plugin - Social Warfare === Contributors: holas84, webinator, warfareplugins, cdegraff1, goqflash, andbalashov Tags: sharing buttons, social media share, floating share buttons, facebook share, google plus share, linkedin share, pin it, pinterest save, mix button, tweet button, twitter share, click to tweet, social sharing buttons, social share, social sharing, social media sharing, wordpress social sharing plugin, social sharing plugin, share buttons, share counts Requires at least: 4.5.0 Tested up to: 6.7.2 Stable tag: 4.5.6 Requires PHP: 5.6 License: GNU General Public License v2.0 or later

The most beautiful, responsive, lightning fast social share buttons built to boost shares and drive more traffic without slowing down your site.

== Description ==

Get more social shares which can lead to more website traffic with the best WordPress social sharing plugin! Built by a group of social media marketing experts and world class developers who are obsessed with performance. Learn more at Warfare Plugins.

= WordPress Sharing Plugin = Most WordPress social sharing plugins slow down your site, are not attractive, and don't work the way you would hope. Social Warfare’s share buttons are both lightning fast and beautiful.

Not only will it never slow down your website like other sharing plugins, we give you the most attractive share buttons available that look great no matter what screen size or resolution.

Social Warfare has boosted social shares by 300% without slowing down my blog.
Eddie Gear - Professional Blogger

You can choose from the top social networks sharing buttons, including:

• Facebook
• Twitter
• Google+
• Pinterest
• LinkedIn
• Mix
• Mastodon

You can also choose where you want the share buttons to show up. Choose from the following placement options:

• Above the post content
• Below the post content
• Both above and below the post content
• None (or) Manual placement

We also give you the ability to have floating share buttons follow your readers down the screen when static (non-floating) buttons are not in view. This way the reader will always have easy access to your share buttons, no matter where they scroll on your page.

"This is by far the best looking social sharing plugin I have seen on the net!"
David Foster, Online Personality

= Social Proof = Proudly display how many times your content has been shared-- even tweet counts (with a Social Warfare - Pro license)! Social Proof is a powerful psychological tool that has been proven to influence even more shares.

We use the social network API endpoints to ensure that the most accurate share counts are always displayed.

= Popular Posts Widget based on Social Share Counts = Wouldn't you love to show what your most popular posts are based on the number of social shares they've received? Social Warfare allows you to do just that.

You can even choose to display most your popular posts based on which social network they were popular on!

Social Warfare's Popular Posts widget allows you to display and customize the look with:

• Post thumbnail images
• Image and text size
• Custom visual themes
• Custom date range

= Click to Tweet Quotes = A simple and effective way to create tweetable quotes right inside your posts or pages. This has proven to increase the average number of tweets per article dramatically.

= Use Shortcodes to Manually Place Social Share Buttons Anywhere = If you want to place buttons in the middle of an article, you can with our [social_warfare] shortcode.

What if you wanted to add share buttons to a page but actually have them share out a different page altogether (like being able to share your “Sign-up” page from your “Thank You” page)? Social Warfare allows you to do this!

If you're experienced with PHP, you can also hook Social Warfare into your theme templates for hyper customization.

= Content Protection = We've built our highly demanded Frame Buster right into Social Warfare so that you are protected from content hijackers seeking to place their advertisements on top of your content without your permission.

Social Warfare is by far the best social sharing plugin I’ve ever used. I recommend it to all of my clients.
Andrew Wilder, Marketing Consultant

= Premium Social Sharing Options = Social Warfare - Pro license holders also get access to the following social network share buttons:

• Reddit
• Tumblr
• Yummly
• WhatsApp
• Pocket
• Buffer
• Hacker News
• Flipboard
• Email

In addition to the extra social networks, you can also reactivate, track and display Twitter tweet counts!

= Pin All the Images = Enabling the Image Hover Pin Button will place a "Pin" button over top of every image inside of your content when a reader hovers their mouse over it. This makes every image on your page highly sharable to Pinterest!

= Powerful Share Customization =

"I use Social Warfare - Pro because how things are shared when I’m not there to do it is important!"
Peg Fitzpatrick, author of The Art and Science of Social Media

Social Warfare is among the pioneers of customizing how your content is shared, particularly with Pinterest. The Social Warfare - Pro add-on allows you to decide exactly which image, title and description appears when your content is shared on sites like Facebook and Google+. This also applies to any other networks that use Open Graph data for social shares.

On top of that, you can upload a custom Pinterest image and write a custom description so that when someone clicks the pin button, the exact image you've chosen shows up with exactly the description you've written. No more hoping that your readers choose the best image and write an optimal description for you!

In addition to that, you can also write a custom tweet for when someone clicks on the Twitter button. The exact tweet you wrote will be displayed in the Twitter share box and Social Warfare will automatically add the link to your content and your @username to the end of it.

These capabilities are what professional social media marketers and bloggers have been waiting for.

= Social Warfare - Pro Sharing Options, Custom Design and Placements = Customize which sharing networks you display, how your buttons look and where they show up.

You can choose from 6 different button shapes, 8 different color themes plus the ability to choose custom colors for your buttons. The design combinations are unlimited.

You will also get 6 different Click to Tweet styles and an option to create your own style via your theme's CSS.

= Minimum Social Proof = If you would prefer to only show counts after a certain minimum number of shares has been met (to avoid "negative social proof"), you can do that as well. Or if you'd rather just have no counts showing at all, just turn them off altogether.

= Share Recovery: Your Lost Share Counts Returned! = Have you ever changed permalink structures, domain prefixes, connection protocols (http-https) or just flat out changed domains and ended up losing all your social share counts?

We've built a tool right into Social Warfare called Share Recovery which allows you to get back your lost share counts if you've ever had to modify your permalink settings.

= Social Authorship, Twitter Cards, Rich Pins and More = It nice to have your stuff shared on social media, it's even nicer when you get mentioned in the social share! With Social Warfare you can ensure that your authorship is always in place, including:

• Facebook author and publisher attribution
• Facebook app link (advanced users)
• Twitter publisher and author attribution
• "via @username" added to the ends of tweets
• "via @username" added to the ends of pin descriptions

You can also activate Twitter Cards (Large Image Cards) so that tweets sent from your site are always media rich and much more likely to get engagement.

Our plugin also ensures that your site is Rich Pin ready so that your Pins look as good as possible.

= Link Shortening, Analytics Campaign and Button-click Tracking = Shorten shared links automatically using your own Bitly credentials so you can track how many clicks are occurring on your links.

Additionally, if you're a Google Analytics user, you can set up Analytics tracking so that each shared link contains a networks specific UTM tracking code. This way you can track all inbound links that come as a direct result of Social Warfare shares.

You can also activate Event Tracking so that you can also see in Google Analytics exactly how many times your buttons are clicked.

It is without question that Social Warfare is the most powerful social sharing plugin available for WordPress. You get all these premium features while still benefitting from a super-fast, light-weight code base.

== Installation ==

This section describes how to install the plugin.

1. Upload the social-warfare directory to your /wp-content/plugins/ directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Visit the 'Social Warfare' menu item in your admin sidebar

== Frequently Asked Questions ==

= I downloaded this plugin but don't have an Social Warfare - Pro license. How can I get one? =

You can sign up for an Social Warfare premium license by visiting our website and choosing the package that best suits your needs.

= How do I use the shortcodes? =

Shortcodes are used like so: [social_warfare]. If you would like to specify a different share URL than the page you are placing the buttons on, you can use this format: [social_warfare post_id="3"] where 3 is the ID number of the post or page you want to have shared.

= Something isn't working as expected. How can I get support? =

We have a growing archive of Support Articles to help you address most questions and troubleshooting. If you wish to receive email support, you will need a Pro license.

== Screenshots ==

== Notes ==

= Testimonial =

I use Social Warfare - Pro because how things are shared when I’m not there to do it is important!
Peg Fitzpatrick, Social Media Strategist

Social Warfare is by far the best social-sharing-button plugin I’ve ever used. I recommend it to all of my clients.
Andrew Wilder, Consultant

It's a beautiful, super lightweight, and highly customizable plugin. I love everything about it!
Rebekah Radice, Social Media Strategist

"This is BY FAR the best looking social sharing plugin I have seen on the net!"
David Foster, Online Personality

I use Social Warfare because it's the only sharing plugin that can be customized to blend seamlessly with my branding.
Andrea Beltrami, Visual Marketer

Social Warfare has boosted social shares by 300% without slowing down my blog.
Eddie Gear - Professional Blogger

After installing Social Warfare I straight away saw an increase in social shares and traffic.
Robert Ryan, Professional Web Designer

== Changelog == = 4.5.6 (13 Mar 2025) =

• Added Dependabot for automated dependency updates.
• Security Improvement: Integrated CodeQL scanning for JavaScript/TypeScript vulnerabilities.
• Renamed internal classes for consistency.
• Upgraded @wordpress/scripts to ^30.12.0 for improved Gutenberg compatibility.

= 4.5.5 (28 Feb 2025) =

• Replaced strip_tags() with wp_strip_all_tags() and added esc_html() for improved security.
• Enhanced file upload UI with real-time progress bars and better error handling.
• Refactored JavaScript for better performance and maintainability.
• Deleted unused JavaScript modules and outdated CSS classes.
• Ensured compatibility with the latest WordPress version.

= 4.4.6.3 (5 Apr 2024) =

• Changed the visibility of $key property from private to public to allow external access and manipulation, enhancing the flexibility for class interactions.
• Changed the visibility of $user_options property from private to public, enabling direct access to user options pulled from the database. This adjustment aims to streamline processes that require external manipulation of user options.

= 4.4.6.2 (3 Apr 2024) =

• Implemented stricter attribute sanitization in SWP_Buttons_Panel_Shortcode class to enhance security and mitigate the risk of cross-site scripting (XSS) attacks through shortcode attributes. This update introduces a more rigorous sanitization process for all attributes passed through the shortcode handling mechanism. The sanitize_attributes method now applies basic sanitization using sanitize_text_field, followed by a secondary sanitization step using a regex pattern to remove any remaining special characters that could be used in malicious injections.
  • Enhanced sanitize_attributes method in SWP_Buttons_Panel_Shortcode class
  • Added regex pattern to remove special characters from attribute values after initial sanitization

= 4.4.6.1 (21 Mar 2024) =

• Updated autoloader class names, improving naming conventions and autoload efficiency for better performance and maintainability. Issue #903 (https://github.com/warfare-plugins/social-warfare/issues/903)
• Refactored the image display in the meta box template and associated JavaScript file, enhancing the UI/UX and fixing display issues f