ryannielson/shareable

A Laravel 4 package to make it easy to add social sharing buttons to your application.

1.0.4 2014-07-07 12:43 UTC

Requires

• php: >=5.3.0
• illuminate/support: ~4.1
• illuminate/view: ~4.1

Requires (Dev)

• mockery/mockery: 0.9.*
• phpunit/phpunit: 4.0.*

MIT

• Ryan Nielson

• twitter
• facebook
• social
• laravel
• share
• google plus

README

#shareable

A Laravel 4 package to make it easy to add social sharing buttons to your application.

This Laravel 4 package provides helpers for easily adding social sharing buttons to your views. This package includes support for:

• Facebook
• Google Plus
• Twitter

Installation

Run the following Composer command in your terminal, or simply add 'ryannielson/shareable': '1.0.*' to your composer.json file:

composer require ryannielson/shareable:'1.0.*'

Once complete, you now have to add the the service provider to the providers array in app/config/app.php:

'RyanNielson\Shareable\ShareableServiceProvider'

Finally, add the following entry entry to the aliases array in app/config/app.php:

'Shareable' => 'RyanNielson\Shareable\Facades\Shareable'

That's it!

Usage

Shareable current supports only a few social networks, which are accessed through a similar Shareable facade which should be used in your views. Each of these methods can also be passed an array of options which correspond to the options shown on the respective button creation pages and listed below.

Render all share buttons, specified in the config.php (default all buttons), within a unordered list:

{{ Shareable::all() }}

Facebook

developers.facebook.com/docs/plugins/share-button

{{ Shareable::facebook($options = array()) }}

Option	Type	Default	Possible Options
url	string	''
width	integer	100
type	string	'button_count'	'box_count', 'button_count', 'button', 'icon_link', 'icon', 'link'

Google Plus

developers.google.com/+/web/share

{{ Shareable::googlePlus($options = array()) }}

Option	Type	Default	Possible Options
url	string	''
size	string	'medium'	'small', 'medium', 'large'
lang	string	'en-US'	See developers.google.com/+/web/share/
width	integer	null
annotation	string	'bubble'	'none', 'bubble', vertical-bubble', 'inline'

Twitter

about.twitter.com/resources/buttons#tweet

{{ Shareable::twitter($options = array()) }}

Option	Type	Default	Possible Options
url	string	''
text	string	''
count	boolean	true
via	string	''
recommend	string	''
hashtags	string	''
size	string	''
lang	string	'en'

View and Configuration Changes

Like most Laravel packages, you can edit the configuration and views for this package by running a few commands to put the files into your app's project directory.

Edit configuration: php artisan config:publish ryannielson/shareable

Edit views: php artisan view:publish ryannielson/shareable