ryannielson/shareable

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

Installs: 911

Dependents: 0

Stars: 23

Watchers: 5

Forks: 9

Language: PHP

1.0.4 2014-07-07 12:43 UTC

README

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