README

WP Share-This

This library allows for easy implementation of sharing links using the ShareThis. Please note, this library is in no way affiliated with ShareThis or its subsidiaries.

Installation

The easiest method for including this library is via Composer. Simply run the follow command in your project root (assuming that is where your composer.json is located):

composer require clubdeuce/wp-share-this

This library will be autoloaded, assuming you include vendor/autoload.php in your project.

You can also download this library and include it manually.

Usage

• Register service(s): WP_Share_This::register_service( 'twitter' ). The full list of supported services can be found here.
• Initialize the library: WP_Share_This::initialize().
• Render the links: WP_Share_This::the_sharing_links().

Methods

Parameters

The following parameters can be specified for the sharing links on a per-service basis (not all items apply to every service):

Examples:

To register services with unique parameters:

WP_Share_This::register_service( 'twitter', array(
    'username'    => 'myTwitterHandle',
    'share_count' => false,
) );

WP_Share_This::register_service( 'facebook', array(
    'image' => 'https://example.com/image.png',
);

WP_Share_This::register_service( 'email', array(
    'message' => __( 'Look at this really interesting article I found!', 'txt_domain' ),
) );  

To render the links with overrides to the defaults:

WP_Share_This::the_sharing_links( array(
    'share_count' => false,
) );

To render sharing links for a post other than the current global $post item:

WP_Share_This::the_sharing_links( array(
    'post' => get_post( $post_id ),
) );

Filters

This library exposes a number of filters: