A simple and unobtrusive gem for adding social link sharing to your Rails app. Supported social sites include:
- Google Plus
- EdCast
Put this line in your Gemfile:
gem 'shareable'
Then run the bundle command:
bundle
To add shareable in views use any of the following methods:
- render_shareable
- facebook_button
- twitter_button
- pinterest_button
- linkedin_button
- reddit_button
- google_plus_button
- edcast_button
For the easiest way to use shareable, add this helper method to your view:
<%= render_shareable %>
Pass hash values to the render_shareable method to overwrite options locally:
<%= render_shareable :url=> 'http://github.com/hermango/', :facebook=> {:send=> 'true', :url=> 'http://demo.com'} %>
To render only certain buttons:
<%= render_shareable :buttons=> ['twitter', 'facebook'] %>
Alternatively, omit the render_shareable method entirely and instead add each social link individually. The helper method for each social link, is the site name joined with an underscore to the word 'button'. E.g.:
<%= twitter_button %>
<%= reddit_button :title=> 'Alternate Title' %>
To override the default view for a button, place your own template file in the app/views/shareable/ directory of your app and prepend your filename with an underscore.
E.g.: facebook_button -> app/views/shareable/_facebook.html.erb
Add an XML namespace fb='http://ogp.me/ns/fb#' to the tag of your view. Eg:
<html xmlns:fb="http://ogp.me/ns/fb#">
This is necessary for XFBML to work in earlier versions of Internet Explorer.
For horizontally aligned buttons, try this CSS:
nav.share {display:inline-block;} /* shareable's nav tag */
nav.share div {float:left; overflow:hidden;}
nav.share iframe {max-height:20px; border:0; margin-top:0; padding-top:0;} /* if using medium sized buttons */
#___plusone_0 {max-width:70px; font-size: default; !important}
.twitter-share-button, .twitter-count-horizontal {max-width:80px;}
.fb_iframe_widget span { vertical-align: top; }
.fb_edge_widget_with_comment { vertical-align: top;}
.fb-like{display:inline-block}
* html .fb-like{display:inline}/* ie6 inline block fix*/
*+html .fb-like{display:inline}/* ie7 inline block fix*/
Use shareable's default configuration settings or add your own initializer named 'shareable.rb' to your app's 'config/initializers' directory.
A generator is available for generating the default configuration file into the 'config/initializers' directory. Run the following generator command, then edit the generated file.
rails g shareable:config
- Add Tests.
- More buttons.
This project is based on Akira Matsuda's Kaminari project and uses the MIT-LICENSE. Suggestions, bug reports, criticism and all contributions welcome.