=== Mashshare - Social SEO Share buttons for Facebook Google+ Twitter Pinterest ===
Author URL: https://www.mashshare.net
Plugin URL: https://www.mashshare.net
Contributors: ReneHermi
Donate link: https://www.mashshare.net/buy-me-a-coffee/
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Tags: Mashable, Social Sharing, Social sharing optimization, Share button, share buttons, Facebook Share button, Twitter Share Button, Social Share, Social buttons, social share buttons, Share, Share this, simple social buttons, simple share buttons adder,  Google+, Twitter, Facebook, Digg, Stumble Upon, Linkedin, +1, add to any, AddThis, add this, addtoany, admin, aim, analytics, bookmark, bookmarking, bookmarks, bookmark button, bookmark menu, buddypress, chrome extension, comments, del.icio.us, Diigo, buffer, button, del.icio.us, e-mail, email, email button, Facebook, facebook like, facebook recommend, facebook share, facebook share button, fark, firefox extension, flickr, floating buttons, follow, foursquare, gmail, goo.gl, google, google analytics, google plus, google plus one, google widget, hackernews, Hubspot, hyves, instagram, instapaper, ManageWP, NewsVine, odnoklassniki, pocket, popular, outbrain, PrintFriendly, popular posts, print, Whatsapp, rss, related posts, related content, share links, share bar, sharebar, social analytics, velocity graph, social networking, share and enjoy, sidebar, Vkontakte, technorati, socialize, url shortener, sonico, statistics tumblr, vimeo, yarrp, youtube, recommendations, posterous, orkut, icon, icons, image, images, Like, links, lockerz, page, pages, pin, pin it, pinit, pinterest, plugin, plus 1, plus one, Post, posts, Reddit, save, seo, Share, Shareaholic, sharedaddy, sharethis, sharing, shortcode, sidebar, sociable, social, social bookmarking, social bookmarks, statistics, stats, stumbleupon, svg, technorati, tumblr, tweet, twitter, vector, widget, WPSSO, wpmu
Requires at least: 3.1+
Tested up to: 4.0
Stable tag: 2.1.5

Mashshare social share buttons, a high-performance social sharing and social seo ecosystem for Facebook Twitter Subscribe and more networks 

== Description == 

> Mashshare Share Buttons shows the total share counts of Facebook and Twitter and a big subscribe button at a glance per default.
It puts some beautiful and clean designed Share Buttons on top and end of your posts to get the best most possible social share feedback from your user.
It´s inspired by the Share buttons Mashable.com is using.

Free and premium Add-Ons available for Google Analytics, more Social Networks, responsive design, Velocity Graph, Sticky Share bar, Social Sharing Optimization and much more.

<h3> Mashshare demo </h3>

[Demo link Mashshare Share Buttons](https://www.mashshare.net/?ref=1 "Share-Buttons - Mashable inspired Share Buttons")

This plugin is in active development and will be updated on a regular basis - Please do not rate negative before i tried my best to solve your issue.


= Main Features =

* High Performance - easy to use - Share Buttons for the most common networks
* High Resolution lossless vector font icons
* Show the Total Share count at a glance
* Object and transient caches to provide incredibly fast execution speed
* Shortcodes
* Extensible with many [Add-Ons](https://www.mashshare.net/downloads) (Google Analytics, More Social Networks, Responsive, Velocity Graph and more...)
* Developer friendly with several filters and actions.

= All Features: =

<strong>New Version 2.x</strong>

* Improved performance
* Option to disable share count completely  (no sql queries will be generated any longer)
* Shortcode option to disable share counts
* Check if curl is working on the server
* Option to disable share cache for testing purposes
* Use of sharp and crisp clear font icons instead png icons
* Button 'extra content' for content slider subcribe forms or any other content New: Use a link behind the Subscribe button instead the toggle slider
* Complete rewrite of css for easier modifications
* Improved extension system
* Improved backend, new Add-On page
* Multi language capable, *.po files
* Change color of share counts via setting
* Count up animation for share counts (Does not work for shortcodes and on blog pages)
* HTML5 Tag <aside> wrapped around to tell search engines that the share buttons are not part of the content
* Plus button moves to end of share buttons when activated and does not stay longer in place.
* Drag and drop sort order of services.
* Enable desired services with one click
* Choose which network should be visible all the time This ones will be large sized by default. Other ones are behind the plus sign
* Two different share button styles includes
* Choose border radius of the buttons from settings
* Keep settings when plugin is uninstalled - optional
* Custom CSS field for individual styling of the share buttons

<strong> Add-Ons available for </strong>

* Google / G+
* Whatsapp (Whatsapp button only shown on iOS devices)
* Pinterest
* Digg
* Linkedin
* Reddit
* Stumbleupon
* Vk / VKontakte
* Print
* Delicious
* Buffer
* Weibo
* Pocket
* Xing
* Tumblr
* Mail
* ManageWP
* Meneame
* Odnoklassniki

= High Performance =

Mashshare is *coded well and developed for high performance*. It´s making full use of available persistant and non persistant caching techniques.
Mashshare loads only the Javascript and php object classes it needs at the moment of execution, making it small and fast and easy extensible by third party developer.

<blockquote>
<h4>How proven fast is Mashshare?</h4>

<p>This are a few example metrics from the <a href="https://wordpress.org/plugins/p3-profiler/">P3 (Plugin Performance Profiler)</a> plugin, using <a href="http://wptest.io/">WP Test Data</a>, and the default settings of several popular plugins, 
along with the WordPress Core and Twenty Fourteen theme for reference purposes:

Thanks to [JS Morisset](https://profiles.wordpress.org/jsmoriss/ "Social Sharing benchmark") for the idea of creating a common list of benchmarked plugins</p>

<ul>
        <li><strong>0.0166</strong> secs - <em><strong>Mashshare Share buttons v2.1.2 (no Add-Ons)</strong></em></li>
	<li><strong>0.0174</strong> secs - Facebook v1.5.5</li>
	<li><strong>0.0176</strong> secs - WPSSO Social Sharing Buttons (SSB) v1.0.10 + WPSSO</li>
	<li><strong>0.0181</strong> secs - MailPoet Newsletters (aka Wysija Newsletters) v2.6.11</li>
	<li><strong>0.0258</strong> secs - All in One SEO Pack v2.2.3.1</li>
	<li><strong>0.0293</strong> secs - JetPack by WordPress.com v2.9.2 ()</li>
	<li><strong>0.0342</strong> secs - WP e-Commerce v3.8.13.3 (No Products)</li>
	<li><strong>0.0348</strong> secs - WordPress Social Sharing Optimization (WPSSO) v2.6.8</li>
	<li><strong>0.0416</strong> secs - WordPress SEO by Yoast v1.6.3 </li>
	<li><strong>0.0457</strong> secs - NextGEN Facebook (NGFB) v7.6.1.1</li>
	<li><strong>0.0730</strong> secs - MarketPress Lite - WordPress eCommerce v2.9.5.3 (No Products)</li>
        <li><strong>0.0749</strong> secs - bbPress v2.5.4 (No Forums or Topics)</li>
	<li><strong>0.0800</strong> secs - Easy Digital Downloads v2.1.5 (No Products - no Add-Ons)</li>
	<li><strong>0.0924</strong> secs - <strong>WordPress Twenty Fourteen Theme v1.1</strong></li>
	<li><strong>0.1003</strong> secs - SEO Ultimate v7.6.5.1</li>
	<li><strong>0.1021</strong> secs - WooCommerce v2.2.6 (No Products)</li>
	<li><strong>0.1092</strong> secs - <strong>WordPress Core v4.0.0</strong></li>
	<li><strong>0.1404</strong> secs - BuddyPress v2.1.1 (No Activities)</li>
	<li><strong>0.1404</strong> secs - NextGEN Gallery by Photocrati v2.0.66.29 (No Galleries or Images)</li>
</ul>

<p><small><em>This Benchmarks were executed on Intel i5 2.3Ghz, 8GB DDR3, using an APC opcode/object cache without any DB or file Cache Plugin like W3Total, WordPress v4.0, and P3 v1.5.2 ( Attempt to disable opcode optimizers - Otherwise some plugins can not be tested) and in manual mode to make sure that
for every plugin the same page is loaded. Automatic excecution of P3 would randomly load WordPress pages which is inaccurate for testing on same conditions. All plugins were benchmarked on sepearate instances with no other plugins enabled.
The benchmarks were runned a few times to make sure that any internal plugin caching function is fired. E.g. Mashshare gets only really fast after second load of a page because the sharecount must be returned from external service first and than stored into internal object cache.
This benchmarks give only a vast overview of performance differences and results will vary on other WordPress installations depending on different hardware and software configurations.
</em></small></p>
<strong>Please note:</strong>
For this test the P3 Option 'Attempt to disable opcode optimizers' is enabled (Otherwise some plugin benchmarks returns no benchmark times ). 
So real execution time of every single Plugin is faster (probaby with a similar factor for all benchmarked plugins) but can not be measured exactely with my testing environment.
<p></p>
</blockquote>

**Shortcodes**

* Use `[mashshare]` anywhere in pages or post's text to show the buttons and total count where you like to at a custom position.
Buttons are shown exactly on the place where you use the shortcode in your content.

There are more parameters available:

 `[mashshare shares="false" buttons="true" align="left"]` for buttons without shares, alignment left
 `[mashshare shares="true" buttons="false" align="right"]` for sharecount without buttons, alignment right

* For manual insertion of the Share Buttons in your template files use the following php code where you want to show your Mash share buttons:`do_action('mashshare');`
Configure the Share buttons sharing function in the settings page of the plugin.
* Change the color of Mashshare count with setting option.

**Full SEO third party plugin support**
Mashshare integrates with [All in One SEO Pack](http://wordpress.org/plugins/all-in-one-seo-pack/) and [WordPress SEO by Yoast](http://wordpress.org/plugins/wordpress-seo/).


= How does it work? =

Mashshare makes use of the great webservice sharedcount.com and periodically checks for the total count 
of all your Facebook and Twitter shares and cumulates them. It than shows the total number beside the Share buttons. 
No need to embed dozens of external slow loading scripts into your website. 
 
= How to install and setup? =
Install it via the admin dashboard and to 'Plugins', click 'Add New' and search the plugins for 'Mashshare'. Install the plugin with 'Install Now'.
After installation goto the settings page Settings->Mashshare and make your changes there.


== Frequently Asked Questions ==

> Find here the Frequently Asked Questions. If your question is not answered look at:
https://www.mashshare.net/faq/

<h4>There are no social share buttons visible after updating or installing Mashshare</h4>
This happens ins most cases when you are using the Mashshare Network Add-On which is disabled during update process or when your are updating from a very early Mashshare version 1.x.
Solution: Disable Mashshare Network Add-On and Mashshare. Enable Mashshare THAN the Network Add-On and all Share buttons become visible again. (Activating order is important here)

<h4>Why is the total count not shown immediately after sharing?</h4>
It takes some time for the script to detect the sharing. So wait a few minutes than you see the total calculated clicks. Keep also in mind the caching time you defined in the admin panel.
So when you set the plugin to 5minutes caching time. You have to wait at least for 5minutes until the click count is shown.

<h4>Do i need a Mashshare or sharedcount account?</h4>
No you don´t. There is no account needed for up to 10.000 daily requests. For most websites this is suitable enough as Mashshare make use of exensive caching so 
the requests to sharedount are reduced to a little. If you want to have more often updated share counts you can register at sharecount for a free account and than are able
to use a free api key which increases your daily request limit up to 50.000 which should be fine for very large websites. Within the settings page of Mashshare Share buttons you find the sharedcount register link.

<h4>Does this plugin sends any personal user data to you or to Facebook, Twitter etc.?</h4>

No, there is no personal data send to Facebook, Twitter, Google and other services. There is also no data which goes to my hands that includes any IP or other data. 
The big advantage of using this Mashare Share buttons is the independance in comparision to other plugins which creates steady connections to Facebook and Co. 
So there is no IP based data send to the social networks or to sharedcount. 

<h4>How is sharedcount able to get the total number of shares?</h4>
Sharedcount is using public available API services of the social networks which deliver only the number of shares for a specific webpage. Sharedcount is not able to see who shared anything, only how often.

<h4>Do i have to do manual changes in Javascript or HTML Code?</h4>
There is no need for you to make any manual changes. The plugin does everything for you. But if you are an experienced web-developer you are free to use the php function mashsharer(); in your templates.

<h4>Is there a shortcode for pages and posts?</h4>
Use the shortcode [mashshare] to embed the Share Buttons in pages or posts.

<h4>Why do i get a blank page when i try to activate or uninstall the plugin</h4>
Most times this is a result of some php server limits. Check your logfiles to see which values must be increased.
I can also assist you with such problems, but keep in mind that they are mostly not caused by this plugin.

<h4>When i click on the share buttons, nothing happens and no popup window</h4>
Mostly that is because you are using any third party and outdated theme which is not coded very well by the author and is not using the Wordpress API for embeding external plugin script.
For Mashsharer make sure your website source contains the script /mashsharer/assets/mashsharer.js

So if you have no chance to update or change your theme do some hardcoding and put the following line into the head template of your theme file:
`<script type='text/javascript' src='http://yourwebsite.com/wp-content/plugins/mashsharer/assets/mashsharer.js?ver=1.1'></script>`

<h4>Why is Facebook only sharing the URL and not the title and description of my page?</h4>
Facebook does not longer supports custom titles, descriptions and images in the sharer.php but you can use open graph meta tags to show the desired custom formats. 
So if you theme does not suppport open graph meta tags (you see them in the html header as og: tags) use the Mashshare Add-On:
[Open Graph Social Optimization] (https://www.mashshare.net/downloads/mashshare-open-graph/)

After installation, check with the [Facebook Open graph debugger](https://developers.facebook.com/tools/debug/) how Facebook is seeing your site adn purge the Facebook Open Graph cache if necessary.


== Official Site ==
* https://www.mashshare.net

== Installation ==
1. Download the share button plugin "Mashshare" , unzip and place it in your wp-content/plugins/ folder. You can alternatively upload and install it via the WordPress plugin backend.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Select Plugins->Mashshare

== Screenshots ==

1. Default share buttons (included)
2. Default share buttons with separate available responsive Add-On
3. Add-On Marketplace with free and premium Add-Ons
4. Default Sharebuttons with separate available responsive Add-On
5. Responsive Design + Social-Networks (separate Add-Ons)
6. Default Share buttons + Subscribe Button opened (included)
7. Sticky Sharebar Add-On on mobile device
8. Sticky Sharebar Add-On on desktop device
9. Round circle style (included)
10. Drag and drop setting menue



== Changelog ==

= 2.1.5 =
* Tweak: Cleaner and more attractive Whatsapp svg icon 
* Tweak: No more delay in hiding Whatsapp icon when share buttons not shown on mobile devices (needs network Add-On)
* Tweak: Change some wordings in admin settings
* New: Use small share buttons feature

= 2.1.4 =
* Fix: remove empty characters in html | prevent Wordpress to inject `<br>` and `<p>` codes into buttons code
* Fix: Prevent jQuery error. Put jQuery nearest() library into document.ready

= 2.1.3 = 
* New: Use Mashshare on categories and non singular blogposts 
* New: Use dynamic jQuery tabs in settings backend
* New: Differentiate between multiple subscribe buttons and opens only one toggle window
* New: Spanish translation by Nestor Pool
* Fix: Missing function in mashsb-admin.js
* Fix: height of Whatsapp button
* Fix: Rewrite Purge DB Cache function to delete post_meta objects
* Fix: Delete post_meta on complete uninstall
* Fix: Undefined property ($post-ID) in template-functions
* Fix: Whatsapp icon as icon font
* Fix: Wrong size of large Whatsapp button
* Fix: Priority number ignored


= 2.1.2 =
* Fix: Padding issue Whatsapp icon
* Fix: Delete some deprecated code
* Fix: More values for border radius to create circle like buttons
* Fix: Gradiant style compatible in Firefox
* New: New callback function colorpicker for settings
* New: Performance benchmarks compaired with other plugins published in readme.txt

= 2.1.1 =
* Fix: Some issues where js and css is not loaded on specific post_types and frontpage on third party plugins like event calender
* New: WPMU WordPress Multisite compatible
* New: Some js modifications for compatibility with Twitter Short-URLs Add-On
* New: Gradiant share button style
* New: CDN Compatibility - Embed icon fonts as base64 octled to prevent cross origin issues when website is loaded from CDN

See release notes and complete changelog at:
https://www.mashshare.net/changelog/

== Upgrade Notice ==

= 2.1.5 =
2.1.5 This update brings some new features.. <strong>Note:</strong> Update your Network Add-On to at least version 2.0.8 after updating Mashshare