scott-t-11 / social-warfare-pro Goto Github PK

=== Social Warfare ===
Contributors: holas84, dustinwstout, webinator, warfareplugins, nutsandboltsmedia
Tags: addthis, addtoany, analytics, bitly, buffer, button, click to tweet, digg, email, emailbutton, facebook, facebookbutton, facebooklike, facebookshare, flipboard, floatingbuttons, floatingsharebuttons, followbuttons, frameblocker, framebuster, google+1, googleanalyticsintegration, googleplus, googleplusone, googleplusshare, hackernews, iframeblocker, iframebuster, likebutton, linkshortening, linkedin, mobilesharebar, mobilesharing, opengraph, pin, pinbutton, pinit, pinterest, pinterestsave, pinterestshare, plusone, pocket, reddit, richpins, share, sharebutton, sharebuttonsplugin, sharecountrecovery, sharecounts, sharefacebook, shareimage, sharenow, sharethis, sharebar, shareholic, sharify, sharingbuttons, social, socialbookmark, socialbuttons, socialicons, socialmedia, socialmediashare, socialmediasharing, socialmediawidget, socialplugin, socialshare, socialsharebuttons, socialsharing, socialize, stumbleupon, sumome, tumblr, tweet, tweetbutton, tweetcount, twitter, twitterbutton, twittercards, twittercounts, utm, utmtracking, whatsapp, yumbutton, yummly
Requires at least: 3.5.1
Tested up to: 4.7
Stable tag: 2.3.0
License: GNU General Public License v2.0 or later

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

== Description ==

Social Warfare helps you get your content shared the way you want it to be shared. Get more shares and drive more traffic now with the best sharing plugin for WordPress!

= WordPress Sharing Plugin =
Did you know that <em>how</em> your content is shared is more important than <em>if</em> it's shared? Why? Because if it's shared in a way that doesn't drive traffic back to your site, it's worthless. What if you could make sure that every time your content is shared, it's shared in the most optimal way? That's where <a href="http://warfareplugins.com" rel="friend" title="Social Warfare">Social Warfare</a> can help. Social Warfare helps you customize how your content is shared and get more out of every single share that takes place on your website.

> <strong>Social Warfare</strong><br>
> Social Warfare is a premium WordPress plugin that has a limited set of free features. To access premium features and support you will need an active Social Warfare license. <a href="http://warfareplugins.com/" rel="friend" title="Social Warfare Plans">Click here to purchase your license.</a>

= Free Social Sharing Options =
Social Warfare is a lightning fast and highly customizable social share plugin with loads of features that make it the most effective sharing plugin on the market.

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

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

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

* Facebook
* Twitter
* Google+
* Pinterest
* LinkedIn

You can also choose where you want the 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.

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

= 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's they've received? Social Warfare allows you to do just that.

You can even choose to display most popular posts on a specific social network!

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 Share Buttons Anywhere =
If you want to place buttons in the middle of an article, you can with our shortcode. How about adding share buttons in a page that actually share out a different page altogether (like a "Thank You" page with share buttons that share the "Subscribe" page)? You can do that as well!

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

= Content Protection =
We've built our highly demanded <a href="https://wordpress.org/plugins/frame-buster/" rel="friend" title="Frame Buster">Frame Buster</a> 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.

> <strong>Social Warfare</strong><br>
> Social Warfare is a premium WordPress plugin that has a limited set of free features. To access premium features and support you will need an active Social Warfare license. <a href="http://warfareplugins.com/" rel="friend" title="Social Warfare Plans">Click here to purchase your license.</a>

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

* StumbleUpon
* Reddit
* Tumblr
* Yummly
* WhatsApp
* Pocket
* Buffer
* Hacker News
* Flipboard
* Email

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

= 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 because how things are shared when I’m not there to do it is important!"<br>
> 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. It 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 <strong>custom Pinterest image</strong> 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 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 <strong>plus</strong> the ability to choose custom colors for your buttons. The design combinations are <em>unlimited</em>.

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 <strong>losing all your social share counts?</strong>

We've built a tool right into Social Warfare called <a href="https://warfareplugins.com/support/recover-social-share-counts-after-changing-permalink-settings/" rel="friend" title="Share Recovery">Share Recovery</a> 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 sharing plugin available for WordPress. You get all these premium features while still benefitting form 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 premium license. How can I get one? =

You can sign up for an Social Warfare premium license by <a href="https://warfareplugins.com/" rel="friend" title="Social Warfare Plans and Pricing">visiting our website</a> 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 <a href="https://warfareplugins.com/support" rel="friend" title="Warfare Plugins Support">Support Articles</a> to help you address most questions and troubleshooting. If you wish to recieve email support, you will need a Premium license.

== Screenshots ==


== Notes ==

= Testimonial =

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

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

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

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

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

== Changelog ==

= 2.2.3 (22 FEB 2017) =

*Maintenance:*

* Fixed a misnamed function that was causing a "Call to undefined function" error when using the shortcode that specifically names which network buttons to show. For example, this was fine: [social_warfare], while this would throw the error: [social_warfare buttons="Twitter,Facebook,Google Plus,Pinterest,Total"]. This update fixes it so that it no longer throws any errors.

= 2.2.2 (21 FEB 2017) =

*Maintenance:*

* Changed the widget titles from h3's to h4's to be more consistent with how other widgets work in WordPress plugins and themes.
* Removed the Pinterest character counter. Pinterest has now fixed the bug that was causing descriptions in shares to get truncated which means that once again we no longer need to count characters. In fact, longer descriptions are usually better over there so have fun!
* Add a "no_pin" class to the pin it hover button. If you add the class "no_pin" to an image, it will not get a pin hover button attached to it.
* Fixed the pin hover button. We refactored a couple of pieces of the javascript that control the hover button so it should work properly under most circumstances.
* Fixed the Really Simple SSL compatibility issue. You should now be able to use share recovery without Really Simple SSL forcing the recovery URL to be https when trying to recover from HTTP.
* Removed a description on the admin settings page that was written on there twice. Now it's only written on there once.
* Updated the information returned by the Facebook share count function.
* Renamed recursive_array_search to swp_recursive_array_search to avoid conflicts with other plugins that may have a function with the same name.
* Renamed isMobile to swp_isMobil to avoid conflicts with other plugins that may have a function with the same name.
* Fixed the Pin it hover button on legacy cache mode.
* Fixed the missing share counts on the all posts admin screen.

= 2.2.1 (05 JAN 2017) =

*Maintenance:*

* Fixed the WhatsApp button.
* Fixed some invalid integer warnings that appeared in PHP 7.1
* Made it so the social shares columns only display on pages and posts admin pages.
* Fixed a conflict with Yoast open graph tags on the archives pages.
* Fixed a conflict with lazyload plugin and the pinterest image hover button.
* Fixed a padding issue on the button counts for mobile.
* Fixed the screen options tab from bumping into the header menu on our admin options page.
* Fixed an issue with button outlines.

= 2.2.0 (29 NOV 2016) =

*Important:*

* Social Warfare has been developed into a core free plugin with the ability to install addons for additional functionality. If you are a a premium user, you'll need to <a href="https://warfareplugins.com/updates/social-warfare-pro/social-warfare-pro.zip" target="_blank">download</a> and install the Social Warfare - Pro addon to immediately regain access to all premium features. Additional addons are currently under development and will be released in the near future.

*Maintenance:*

* Refactored all of the Open Graph and Twitter Card output logic.
* Broke the meta tags into two filters. One creates the values. The second compiles them into HTML for output. This can allow people to hook in and change specific values on the fly via an add_filter() call.
* Refactored all of the cache functions.
* Added a function to clean out meta fields that are no longer used or needed.
* Added a check for invalid responses from Facebook's API
* Adjusted the default logic and fallback color system for the side custom color option.
* Refactored the Pinterest image logic.
* Add an undefined check for swpPinit to avoid JS notices in the admin area.
* Fixed an undefined index notice.
* Removed all non-public post types from the display locations settings.
* Added a homepage specific location setting.
* Added a function to make the plugin not duplicate share counts when duplicating a post via the Duplicate Post plugin.
* Consolidated some functions and files for more consistent organization.
* Fixed Google Click/Event Tracking
* Modify the hover pin so it's not created until after all images have finished loading.
* Fixed the raw share text from sometimes showing up in excerpts.
* Make the buttons not output on posts embedded into other posts (like embedded recipes).
* Patch to prevent buttons from being added to a post more than once.
* Remove the "active" index to prevent certain notices.
* Fixed custom color outlines on hover.
* Fixed an issue with double dividers on the admin options page.
* Fixed an issue that would sometimes cause Facebook counts to disappear.
* Fixed the http/https share recovery for pages.

= 2.1.3 (4 NOV 2016) =

*Maintenance:*

* Updated how the registration check determines if it's been 30 days since the last check.
* Fixed an alignment issue with the pin hover button for Internet Explorer.
* Updated how the facebook cache rebuild works when the plugin is set to the legacy cache rebuild method.

= 2.1.2 (2 NOV 2016) =

*Maintenance:*

* Fixed the "New Post" bug.
* Improved registration logic.
* Improved the cache rebuild logic.
* Fixed a CSS alignment bug for IE.
* Adjusted the debounce frequency for scroll events.
* Modified how the floating bars hide and reveal.
* Added compatibility for Grid plugin.
* Make all the link filters return modified arrays. This allows for multiple hooks to be added.
* Added the share recovery feature to the Facebook counts.
* Make the Facebook share recovery detect and filter out exact matches.
* Updated the alignment of the button icons and labels.

= 2.1.1 (26 OCT 2016) =

The 2.1.0 update fixed a ton of issues, but it also introduced a few bugs as well. We've been getting your reports and working as quickly as possible around the clock to get these fixed. This should fix almost everything that has been reported so far.

*Maintenance:*

* Fixed the share count issue. We had reports that share counts were not updating on some of the sites.
* Added versioning to the admin scripts and styles. This will prevent users from having to clear browser cache when the files are modified in an update.
* Added a counter to the Pinterest description field as we've discovered that Pinterest cuts off descriptions around 140 characters on share buttons.
* Changed the hover detection method to avoid conflicts across different versions of jQuery for when users are manually declaring a version of jQuery different from what is bundled into WordPress core.
* Added a CSS rule for the aligncenter class so the hover Pinit function will keep centered images centered.
* Fixed a minor Javascript error in the cache rebuild process.

= 2.1.0 (24 OCT 2016) =

This update has been an intensely focused effort to eliminate bugs and maximize the compatibility of our plugin with all other plugins and themes. We also want to give a big shout out to Rob Neu for helping us audit through the code and make many of these improvements.

*New:*

* Added an option to move the side floating buttons to the horizontal bottom floating position when the screen is too small to display the side floating buttons properly (like on mobile).
* Added a separate custom color option for the side floating buttons.
* Added nofollow to all the button links.
* Added an alt and title tag to the popular posts widget thumbnails.

*Maintenance:*

* Overhauled / Improved the registration logic.
* Refactored the options page settings.
* Deprecated some unused functions .
* Added a helper function for getting the site URL.
* Cleaned up the share cache rebuild process.
* Moved the mobile detection to the client side to avoid caching collisions with the showing/hiding of the WhatsApp button.
* Removed all custom jQuery functions to avoid collisions.
* Added translation functions to the admin options page. Translations can now be added for that.
* Cleaned up some alignment issues with the side floating buttons.
* Fixed the layout of the button version of the side floating buttons.
* Changed the sizing of the buttons from JS to FlexBox.
* Changed all scale properties from JS to pure CSS.
* Minified all the admin scripts and CSS.
* Removed the fade in effect from the buttons. They are now properly sized from the start so there's no need to keep them hidden while sizing logic is adjusting them. Instead they can now be visible from page load.
* Renamed the meta box classes to avoid collisions with other plugins or themes that use the same meta box class.
* Added throttles and debounces to some of the JS events.
* Improved the JS and layout of the Image Hover Pin Button.
* Moved all asset files to a single location.
* Improved script and style loading.
* Encapsulated JS within and anonymous function to improve compatibility with other plugins and themes.
* Removed the outerHTML function.
* Cleaned up options page and click to tweet assets.

= 2.0.7 (10 OCT 2016) =

Made some more major updates in response to Facebook's API changes. We've tested this on a dozen sites and we're experiencing a 100% success rate with the fix so far. If you're experiencing inaccurate share counts, install this update, ensure that the Cache Method is set to Advanced Page Caching on the Advanced Tab of the Social Warfare option page, then wait a few hours. Within a few hours (24 at the very, very latest) all of your Facebook shares counts should be 100% fully recovered.

= 2.0.6 (21 SEP 2016) =

*New:*

* Made some major updates in response to Facebook's API changes. Hopefully all the shares will count accurately once again.
* Added cross domain share recovery
* Updated the way Bitly functions shorten the URL's. Custom domain short links should now be fully supported.
* Added a metabox priority filter hook for folks who want to change the order of the metaboxes on the post editor screen.

*Fixes:*

* Fixed a couple minor PHP notices
* Made some updates to the registration function

= 2.0.5 (22 Aug 2016) =

*New:*

* Updated to Facebook’s new share API
* Shortcode parameters for buttons=“” now supports spaces
* Better detection of content location for some themes
* Floating buttons now ignore shortcode (to avoid wonky behavior)
* Updated floating position settings to apply to both side and horizontal instances
* Added Greek translation

*Fixes:*

* Cleaned up some outdated javascript
* URL encoding fixed for special characters in Pin button descriptions
* Fixed OG width/height output from showing when no image was uploaded
* Fixed a bug with the scale/resizing feature
* Got rid of a few minor notices
* Fixed a hover bug
* Fixed alignment issue with side floating share buttons (Thanks Peg!)

= 2.0.4 (9 August 2016) =

*Added:*

* Image Hover Pin Button applies to linked images.
* Added minimum dimensions for Image Hover Pin Button.
* Pinterest image and Twitter handles now included in cache rebuild process.
* Social shares column to Pages tab in WordPress.
* Changing Pin button to "Save" and added Pin icon on hover.
* Yummly Category and Tags function now operational.
* PHP7 compatibility.

*Bugs:*

* Button ordering on floating buttons now able to sort dynamically again.
* Image Hover Pin Button image alignment fix.
* Cleaned out false PHP error and undefined index notices.
* Image Hover Pin Button no longer hinders image saving.
* WPML compatibility.
* Abracadabra and your invisible buttons have reappeared!
* Extra whitespace issue being seen by some sites resolved.