thartl/shared-counts

WordPress plugin that leverages SharedCount.com API to quickly retrieve, cache, and display various social sharing counts.

Shared Counts

Contributors: jaredatch, billerickson
Tags: sharing, share buttons, social buttons, share counts, social, facebook, linkedin, pinterest, stumbleupon, twitter
Requires at least: 4.6
Tested up to: 4.9
Stable tag: 1.2.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Shared Counts adds social sharing buttons that look great and keep your site loading fast.

We provide a one-click option to retrieve both HTTP and HTTPS share counts, ensuring you don't lose your share counts when upgrading your website to HTTPS.

GDPR Compliant: Unlike other social sharing tools, this plugin does not use cookies, tracking scripts, or store any user data.

We include many styling options, and you can automatically insert the buttons before and/or after the post content. You can also use the [shared_counts] shortcode to insert them inside the content.

Shared Counts was created with site performance in mind, even at large scale. It is used on several large websites that get tens of millions of page views each month. Our unique and creative caching methods have a minimal affect on site overhead. Leveraging the SharedCount.com API, we can retrieve (almost) all share counts in a single request.

Additionally, Shared Counts was built to be developer friendly! We provide very liberal usage of hooks and filters. Everything is customizable and the possibilities are near limitless. Unlike other plugins all data (counts) are stored and cached in post_meta which makes it easy to access for extending (e.g. fetch top 10 most shared posts on your site).

Add On Plugins

• Shared Counts - Pinterest Image - Upload a separate image for Pinterest sharing
• Shared Counts - Cache Status - Build and check the status of the Shared Counts cache

Included Buttons

• Facebook
• Pinterest
• Yummly
• Twitter (using the third-party NewShareCounts.com API)
• StumbleUpon
• Email sharing (with reCAPTCHA support to prevent abuse)
• Share count totals
• Print*
• LinkedIn*
• Google+*

• denotes button/service does not support share count tracking.

Style Options

Fancy

Slim

Classic

Block

Bar

Rounded

Buttons

Icons

Installation

1. Download the plugin from GitHub. or from WordPress.org.
2. Activate plugin.
3. Go to Settings > Shared Counts to configure.

We recommend you sign up for a free account at SharedCount.com, which lets you receive share counts from all services (except Twitter) with a single API query. Alternatively, you can select "Native" as the count source and select which services you'd like to query. If you select all 5 native service queries, then you will have 5 separate API queries every time share counts are updated.

If you would like to include Twitter share counts, you can sign up for a free account at NewShareCounts.com.

If you use the Email share button, we recommend you enable Google's reCAPTCHA to prevent spam. Sign up here (free) to get your Site Key and Secret Key.

Customization

For details on this please see the wiki.

Bugs

If you find an bug or problem, please let us know by creating an issue.

Contributions

Contributions are welcome!

1. Open an Issue on GitHub.
2. Fork Shared Counts on GitHub.
3. Create a new branch off of develop; branch name should be issue/### to reference the issue.
4. When committing, reference your issue and provide notes/feedback.
5. Send us a Pull Request with your bug fixes and/or new features.

This Repo

Master branch is always stable and contains latest releases. Development occurs in the develop branch while large features/changes are contained in dedicated branches. For reporting bugs or contributing, see more additional information below.