belt/soshare

dev-master / 1.0.x-dev 2014-10-26 16:46 UTC

This package is not auto-updated.

Last update: 2024-07-02 01:16:36 UTC


README

Belt.Soshare

Software License Build Status Coverage Status Quality Score

Shared URLs

Belt.Soshare is an utility library that allows you to easily check the number of shares an URL has for a given social network (or all social networks).

Supported networks:

  • Twitter
  • Facebook
  • LinkedIn
  • reddit
  • Pinterest
  • StumbleUpon

Installation

Via Composer.

$ composer require belt/soshare

Usage

Usage is really simple (as usual).

use Belt\Soshare;
use Belt\Soshare\Reddit;
use Belt\Soshare\Twitter;
use Belt\Soshare\Facebook;
use Belt\Soshare\LinkedIn;
use Belt\Soshare\Pinterest;
use Belt\Soshare\StumbleUpon;

$soshare = new Soshare();
$soshare->addNetwork(new Reddit());
$soshare->addNetwork(new Twitter());
$soshare->addNetwork(new Facebook());
$soshare->addNetwork(new LinkedIn());
$soshare->addNetwork(new Pinterest());
$soshare->addNetwork(new StumbleUpon());

$soshare->getShares('http://apple.com');
$soshare->getShares('http://apple.com', ['twitter']); // Only get shares on Twitter
$soshare->getShares('http://apple.com', ['facebook', 'reddit']); // Only get shares on Facebook and Reddit

$soshare->getSharesByNetwork('http://apple.com'); // Get the shares seperated by network
// => [ 'twitter' => 32, 'facebook' => 1337, ... ]

Contributing

Please see CONTRIBUTING.

Credits

This library is based on social-shares for Ruby. If you're building something in Ruby and you need functionality like this, I recommend you check this library out!

License

Please see LICENSE.