shareable 1.0.0 → 1.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 19c19e220407ca941b623e9fa1193f404741adbc
-  data.tar.gz: 214c19f7a01b047c536a5b26bf32676161e0988e
+  metadata.gz: ba9650886c5ad7975604cc704ec816335c2062ea
+  data.tar.gz: e3a2669c4cd0da49b4205fda5055fec31123d60e
 SHA512:
-  metadata.gz: 91f23d8a1f33e77d7421c9bbbe91c617bce9361bbc07918cdb5c49e04bf8f0cd5f6ff06607a17ed7e9c773bb67286837f5968b6e0cce7eb5de3e1267acb2d938
-  data.tar.gz: 01b71ab520dcb4575d26f567013eb370060bf8ec6e99fe4f89ae98724da890d834f7b61339b82158478a131a2f9ac76829c35cdc4be34f63a44505426df49bbd
+  metadata.gz: 836391912e90847d1dc1cb4f559674cf532580715359eb496ee19e6da00d3ce5e16cafbdb5177a75ec005b9b0cb135ed6df3a1b9abb6f1c33cfb8fd60a0b9eb8
+  data.tar.gz: 12ac8624003365973b03b43fdab6eb7e7624ec16bd518512f3ac5c8acac2f479fe7b4339962bba48e22fe2a48d7eccdf5d8af97571df86d4e7353c4e48840001

data/.gitignore

@@ -3,4 +3,5 @@
 .idea
 Gemfile.lock
 gemfiles/*.lock
-doc
+doc
+.DS_Store

data/README.md

@@ -1,12 +1,19 @@
 Shareable
 =========
-A simple and unobtrusive gem for adding social link sharing to your Rails app. Supported social sites include:
+<img src="https://cloud.githubusercontent.com/assets/28847/3418917/8883ea2e-fe51-11e3-81f4-368f184b9a49.png" title="Shareable makes social media buttons." /><br/>
+A gem for adding social buttons to your Rails app. Shareable runs with zero configuration and offers a wide range of customization features. Rendering javascript buttons and static links is easy. One method call can generate all the sharing buttons you want. The available social media sites include:
   - Facebook
   - Twitter
   - Pinterest
   - Reddit
   - Linkedin
   - Google Plus
+  - Tumblr<sup>*</sup>
+  - StumbleUpon<sup>*</sup>
+
+<sub>*Tumblr and StumbleUpon buttons aren't rendered by default. Set a [configuration](https://github.com/hermango/shareable#configuration) option to show these buttons.</sub>
+
+The shareable gem supports Rails 3 and 4. 
 
 Install
 --------
@@ -21,47 +28,64 @@ Then run the bundle command:
 Usage
 ------
 ### Views
-To add shareable in views use any of the following methods:
-+ render_shareable
+
+For the simplest way of using shareable, add this helper method to your views:
+
+```no-highlight
+<%= render_shareable %>
+```
+
+That's it! You can customize the look and content of each button with more options. Keep reading to find out how.
+
+You can also render each social media button separately by calling the following methods:
 + facebook_button
 + twitter_button
 + pinterest_button
 + linkedin_button
 + reddit_button
 + google_plus_button
++ tumblr_button
++ stumble_upon_button
+
+#### Static Links
 
-For the easiest way to use shareable, add this helper method to your view:
+Shareable generates javascript buttons by default. To render plain html links instead, set the configuration option *static_link* to boolean value **true** in your app's local 'shareable.rb' configuration file. You can also pass *static_link* to the render_shareable method like so:
 
 ```no-highlight
-<%= render_shareable %>
+<%= render_shareable :static_link => true %>
 ```
 
+#### Tumblr and StumbleUpon Buttons
+
+By default the display of Tumblr and StumbleUpon buttons is disabled. Enable either button by including the name of the button you want to add (**tumblr** or **stumble_upon**) to the configuration option *names* (found in your local 'shareable.rb' configuration file). [See Configuration](https://github.com/hermango/shareable#configuration) for more information. 
+
+
 ### Advanced Usage
 Pass hash values to the render_shareable method to overwrite options locally:
 ```no-highlight
-<%= render_shareable :url=> 'http://github.com/hermango/', :facebook=> {:send=> 'true', :url=> 'http://demo.com'} %>
+<%= render_shareable :url=> 'http://github.com/hermango/', :facebook=> {:send=> 'true', :url=> 'http://demo.dev'} %>
 ```
 
 To render only certain buttons:
 ```no-highlight
-<%= render_shareable :buttons=> ['twitter', 'facebook'] %>
+<%= render_shareable :buttons=> ['twitter', 'facebook', 'tumblr'] %>
 ```
 
 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.:
+The helper method for each social link is the site name joined with an underscore to the word 'button'. E.g.:
 
 ```no-highlight
 <%= 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.
+To override the default code 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
 
 #### Facebook compatibility with Internet Explorer
-Add an XML namespace fb='http://ogp.me/ns/fb#' to the <html> tag of your view. Eg: 
+Add an XML namespace fb='http://ogp.me/ns/fb#' to the html tag of your view. Eg: 
 ```no-highlight
 <html xmlns:fb="http://ogp.me/ns/fb#">
 ```
@@ -75,7 +99,7 @@ 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}
+#___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;}
@@ -84,18 +108,23 @@ nav.share iframe {max-height:20px; border:0; margin-top:0; padding-top:0;} /* if
 *+html .fb-like{display:inline}/* ie7 inline block fix*/
 ```
 
+If you use the default configuration options of Shareable and styling above, the output should appear as:
+<img src="https://cloud.githubusercontent.com/assets/28847/3418917/8883ea2e-fe51-11e3-81f4-368f184b9a49.png" alt="horizontal row of evenly aligned social media buttons." />
+
 Configuration
 ------------
-Use shareable's default configuration settings or add your own initializer named 'shareable.rb' to your app's 'config/initializers' directory.
+Use shareable's [default configuration settings](https://github.com/hermango/shareable/blob/master/lib/shareable/config.rb) 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.
+A generator is available for generating the default configuration file into your project's 'config/initializers' directory.
+Run the following generator command, then edit the generated file as preferred.
 
 rails g shareable:config
 
-To Do:
----------
-- Add Tests.
-- More buttons.
+Shareable expects string values for nearly all configuration options. Any values passed as configuration options not enclosed in quotation marks will cause errors! Four configuration options are exceptions to this rule. The configuration option *names* (also called *buttons* when passed to the helper method) expects an array of strings. The other three configuration options expect boolean values and are the following:
+ * static_link
+ * button_only
+ * turbolinks
+
+---
 
-This project is based on Akira Matsuda's Kaminari project and uses the MIT-LICENSE. Suggestions, bug reports, criticism and all contributions welcome.
+This project was inspired by Akira Matsuda's Kaminari project and uses the MIT-LICENSE. Suggestions, bug reports, criticism and all contributions welcome.

data/app/views/shareable/_facebook.html.erb

@@ -3,9 +3,10 @@
     <%= render "shareable/partials/link", :options => options.merge(:url=>"https://www.facebook.com/sharer.php?u=#{options[:url]}") %>
   <% end %>
 <% else %>
-  <% unless options[:button_only] %>
+<div id="fb-root"></div>
+  <% if !options[:button_only] && !options[:turbolinks] %>
     <%= output_once :facebook do %>
-      <%= render "shareable/partials/scripts/facebook", :app_id => options[:app_id] %> 
+      <%= render "shareable/partials/scripts/facebook", :app_id => options[:app_id] %>
     <% end %>
   <% end %>
   <%= render :layout => "shareable/partials/button_wrapper", locals: {:options => options} do %>
@@ -13,4 +14,27 @@
   <%= html_attributes(options.slice(:url, :send, :layout, :show_faces, :width, :action, :font, :colorscheme, :ref, :share, :kid_directed_site), :data => true) %>
 ></div>
   <% end %>
+  <% if options[:turbolinks] && !options[:button_only] %>
+    <%= output_once :facebook do %>
+<script>
+  if (typeof window.facebookLoaded == 'undefined') {
+    var facebookLoaded = false;
+  }
+  var __loadFacebook = function() {
+    if (facebookLoaded !== true) {
+      $('head').append("<script><%= raw(render 'shareable/partials/scripts/head/facebook', :app_id=>options[:app_id]) %><\/script>");
+    }
+  };
+  if (typeof $.turbo == 'undefined') {
+    $(function() {
+      return __loadFacebook();
+    });
+  }
+  //for jquery.turbolinks
+  else {
+    __loadFacebook();  
+  }
+</script>
+    <% end %>
+  <% end %>
 <% end %>

data/app/views/shareable/_linkedin.html.erb

@@ -1,14 +1,41 @@
 <% if options[:static_link] %>
   <%= render :layout => "shareable/partials/button_wrapper", locals: {:options => options} do %>
-    <%= render "shareable/partials/link", :options => options.merge(:url=>"http://www.linkedin.com/shareArticle?url=#{options[:url]}&title=#{options[:title]}&summary=#{options[:description]}") %>
+    <%= render "shareable/partials/link", :options => options.merge(:url=>"https://www.linkedin.com/shareArticle?url=#{options[:url]}&title=#{options[:title]}&summary=#{options[:description]}") %>
   <% end %>
 <% else %>
-  <% unless options[:button_only] %>
-    <%= render "shareable/partials/scripts/linkedin" %> 
+  <% if !options[:button_only] && !options[:turbolinks] %>
+    <%= output_once :linkedin do %>
+      <%= render "shareable/partials/scripts/linkedin" %>
+    <% end %> 
   <% end %>
   <%= render :layout => "shareable/partials/button_wrapper", locals: {:options => options} do %>
 <script type="IN/Share"
   <%= html_attributes(options.slice(:url, :counter, :onerror, :onsuccess, :showzero), :data => true) %>
 ></script>
   <% end %>
+  <% if options[:turbolinks] && !options[:button_only] %>
+    <%= output_once :linkedin do %>
+<script type="text/javascript">
+  if (typeof window.linkedinLoaded == 'undefined') {
+    var linkedinLoaded = false;
+  }
+  var __loadLinkedin = function() {
+    if (linkedinLoaded !== true) {
+      $('head').append("<script><%= raw(render 'shareable/partials/scripts/head/linkedin') %><\/script>");
+    }
+  };
+  if (typeof $.turbo == 'undefined') {
+    $(function() {
+      return __loadLinkedin();
+    });
+  }
+  //for jquery.turbolinks
+  else {
+    if (linkedinLoaded !== true) {
+    __loadLinkedin();  
+    }
+  }
+</script>
+    <% end %>
+  <% end %>
 <% end %>

data/app/views/shareable/_pinterest.html.erb

@@ -1,17 +1,35 @@
 <% if options[:static_link] %>
   <%= render :layout => "shareable/partials/button_wrapper", locals: {:options => options} do %>
-    <%= render "shareable/partials/link", :options => options.merge(:url=>"http://pinterest.com/pin/create/button/?url=#{options[:url]}&description=#{options[:description]}&media=#{options[:media]}") %>
+    <%= render "shareable/partials/link", :options => options.merge(:url=>"https://pinterest.com/pin/create/button/?url=#{options[:url]}&description=#{options[:description]}&media=#{options[:media]}") %>
   <% end %>
 <% else %>
   <%= render :layout => "shareable/partials/button_wrapper", locals: {:options => options} do %>
 <a data-pin-config="<%= options[:pin_config] %>"
    href="//pinterest.com/pin/create/button/?url=<%= options[:url] %><%= raw('&media=' + options[:media]) unless options[:media].blank? %><%= raw('&description=' + options[:description]) unless options[:description].blank? %>"
-   data-pin-do="<%= options[:pin_do] %>" >
+   data-pin-do="<%= options[:pin_do] %>" data-pin-shape="<%= options[:pin_shape] %>" data-pin-height="<%= options[:pin_height] %>" data-pin-color="<%= options[:pin_color] %>" >
   <img src="//assets.pinterest.com/images/pidgets/pin_it_button.png" title="<%= options[:title]%>" alt="<%= options[:alt] %>" /></a>
   <% end %>
   <% unless options[:button_only] %>
     <%= output_once :pinterest do %>
-      <%= render "shareable/partials/scripts/pinterest" %> 
+      <% if options[:turbolinks] %>
+<script>
+  var Pinterest;
+  Pinterest = {
+    load: function() {
+      delete window["PIN_" + ~~((new Date).getTime() / 864e5)];
+      return $.getScript("//assets.pinterest.com/js/pinit.js");
+    }
+  };
+  $(function() {
+    return Pinterest.load();
+  });
+  $(document).on('page:load', function() {
+    return Pinterest.load();
+  });
+</script>
+      <% else %>
+        <%= render "shareable/partials/scripts/pinterest" %> 
+      <% end %>
     <% end %>
   <% end %>
 <% end %>

data/app/views/shareable/_reddit.html.erb

@@ -1,7 +1,8 @@
 <%= render :layout => "shareable/partials/button_wrapper", locals: {:options => options} do %>
   <% if options[:static_link] %>
-  <%= render "shareable/partials/link", :options => options.merge(:url=>"http://www.reddit.com/submit?url=#{options[:url]}&title=#{options[:title]}") %>
+  <%= render "shareable/partials/link", :options => options.merge(:url=>"https://ssl.reddit.com/submit?url=#{options[:url]}&title=#{options[:title]}") %>
   <% else %>
+    <% if !options[:turbolinks] %>
 <script type="text/javascript">
     reddit_url='<%= options[:url] %>';
     reddit_target='<%= options[:target]%>';
@@ -10,10 +11,22 @@
     reddit_bordercolor='<%= options[:bordercolor] %>';
     reddit_newwindow='<%= options[:newwindow] %>';
 </script>
-    <% unless options[:button_only] %>
+      <% unless options[:button_only] %>
 <script type="text/javascript"
-src="<%= raw((options[:btnsrc].blank? ? ('//www.reddit.com/static/button/button' + options[:type] + '.js?i=' + options[:points]) : options[:btnsrc]) + '&styled=' + options[:styled]) %>">
+src="<%= raw(options[:btnsrc].blank? ? ('//www.reddit.com/static/button/button' + options[:type] + '.js') : ('//www.reddit.com/buttonlite.js?i=' + options[:points] + '&styled=' + options[:styled])) %>">
 </script>
+      <% end %>
+    <% else #if turbolinks is enabled then use this iframe hack %>
+    <%# TODO: move to reddit tag class %>
+      <% unless options[:type].blank? || options[:button_only] %>
+        <% width, height = case options[:type] %>
+         <% when '1' then ['120', '22'] %>
+         <% when '2' then ['51', '69'] %>
+         <% when '3' then ['69', '52'] %>
+         <% else ['0', '0'] %>
+        <% end %>
+<iframe src="//www.reddit.com/static/button/button<%= options[:type] %>.html?width=<%= width %>&url=<%= url_encode(options[:url]) %>&target=<%= options[:target]%>&title=<%= url_encode(options[:title]) %>&bgcolor=<%= options[:color] %>&bordercolor=<%= options[:bordercolor] %>&newwindow=<%= options[:newwindow] %>" height="<%= height %>" width="<%= width %>" scrolling="no" frameborder="0"></iframe>
+      <% end %>
     <% end %>
   <% end %>
 <% end %>

data/app/views/shareable/_tumblr.html.erb

@@ -4,8 +4,8 @@
   <% end %>
 <% else %>
   <%= render :layout => "shareable/partials/button_wrapper", locals: {:options => options} do %>
-<a href="http://www.tumblr.com/share/link?url=<%= options[:url] %>&name=<%= options[:title] %>&description=<%= options[:description] %>" title="Share on Tumblr" 
-style="display:inline-block; text-indent:-9999px; overflow:hidden; width:<%= options[:width] %>px; height:20px; background:url('http://platform.tumblr.com/v1/<%= options[:background] %>') top left no-repeat transparent;">Share on Tumblr</a>
+<a href="https://www.tumblr.com/share/link?url=<%= options[:url] %>&name=<%= options[:title] %>&description=<%= options[:description] %>" title="Share on Tumblr" 
+style="display:inline-block; text-indent:-9999px; overflow:hidden; width:<%= options[:width] %>px; height:20px; background:url('https://platform.tumblr.com/v1/share_<%= options[:background] %>.png') top left no-repeat transparent; vertical-align:top;" class="tumblr-button">Share on Tumblr</a>
   <% end %>
   <% unless options[:button_only] %>
     <%= output_once :tumblr do %>

data/app/views/shareable/_twitter.html.erb

@@ -3,17 +3,17 @@
     <%= render "shareable/partials/link", :options => options.merge(:url=>"https://twitter.com/intent/tweet?url=#{options[:url]}&text=#{options[:text]}&hashtags=#{options[:hashtags]}") %>
   <% end %>
 <% else %>
-  <% if tl = (defined?(Turbolinks) && !(options[:button_only])) %>
+  <% if (options[:turbolinks] && !options[:button_only]) %>
     <%= output_once :twitter do %>
 <script src="//platform.twitter.com/widgets.js"></script>
     <% end %>
   <% end %>
   <%= render :layout => "shareable/partials/button_wrapper", locals: {:options => options} do %>
-<a href="http://twitter.com/share" class="twitter-share-button"
+<a href="https://twitter.com/share" class="twitter-share-button"
   <%= html_attributes(options.slice(:url, :via, :text, :related, :count, :lang, :counturl, :hashtags, :size, :dnt), :data => true) %>
 >Tweet</a>
   <% end %>
-  <% unless tl %>
+  <% unless (options[:button_only] || options[:turbolinks]) %>
     <%= output_once :twitter do %>
       <%= render "shareable/partials/scripts/twitter" %> 
     <% end %>

data/app/views/shareable/partials/scripts/_facebook.html.erb

@@ -1,9 +1,9 @@
-<div id="fb-root"></div>
-<script>(function(d, s, id) {
+<script>
+(function(d, s, id) {
   var js, fjs = d.getElementsByTagName(s)[0];
   if (d.getElementById(id)) return;
   js = d.createElement(s); js.id = id;
-  js.src = "//connect.facebook.net/en_US/all.js#xfbml=1<%= raw('&appId=' + app_id) unless app_id.empty? %>";
+  js.src = "//connect.facebook.net/en_US/all.js#xfbml=1<%= raw('&appId=' + app_id.to_s) if defined?(app_id) %>&status=0&version=v2.0";
   fjs.parentNode.insertBefore(js, fjs);
 }(document, 'script', 'facebook-jssdk'));
 </script>

data/app/views/shareable/partials/scripts/_google_plus.html.erb

@@ -4,4 +4,4 @@
     po.src = 'https://apis.google.com/js/plusone.js';
     var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s);
   })();
-  </script>
+</script>

data/app/views/shareable/partials/scripts/_tumblr.html.erb

@@ -1 +1 @@
-<script src="http://platform.tumblr.com/v1/share.js"></script>
+<script src="//platform.tumblr.com/v1/share.js"></script>

data/app/views/shareable/partials/scripts/head/_facebook.html.erb

@@ -0,0 +1,38 @@
+var bindFacebookEvents, fb_events_bound, fb_root, initializeFacebookSDK, loadFacebookSDK, restoreFacebookRoot, saveFacebookRoot; \
+fb_root = null; \
+fb_events_bound = false; \
+$(function() { \
+  loadFacebookSDK(); \
+  if (!fb_events_bound) { \
+    return bindFacebookEvents(); \
+  } \
+}); \
+bindFacebookEvents = function() { \
+  $(document).on('page:fetch', saveFacebookRoot).on('page:change', restoreFacebookRoot).on('page:load', function() { \
+    return typeof FB !== 'undefined' && FB !== null ? FB.XFBML.parse() : void 0; \
+  }); \
+  return fb_events_bound = true; \
+}; \
+saveFacebookRoot = function() { \
+  return fb_root = $('#fb-root').detach(); \
+}; \
+restoreFacebookRoot = function() { \
+  if ($('#fb-root').length > 0) { \
+    return $('#fb-root').replaceWith(fb_root); \
+  } else { \
+    return $('body').append(fb_root); \
+  } \
+}; \
+loadFacebookSDK = function() { \
+  window.fbAsyncInit = initializeFacebookSDK; \
+  return $.getScript('//connect.facebook.net/en_US/all.js', function() { facebookLoaded = true; }); \
+}; \
+initializeFacebookSDK = function() { \
+  return FB.init({ \
+    appId: '<%= app_id.to_s if defined?(app_id) %>', \
+    status: true, \
+    cookie: true, \
+    version: 'v2.0', \
+    xfbml: true \
+  }); \
+};

data/app/views/shareable/partials/scripts/head/_linkedin.html.erb

@@ -0,0 +1,14 @@
+var loadLinkedIn; \
+$(function() { \
+  if(linkedinLoaded !== true) { \
+    loadLinkedIn(); \
+    return $(document).on('page:load', loadLinkedIn); \
+  } \
+}); \
+loadLinkedIn = function() { \
+  delete IN; \
+  $.getScript('//platform.linkedin.com/in.js', function() {linkedinLoaded = true;}); \
+  return { \
+    lang: 'en_US' \
+  }; \
+};

data/lib/generators/shareable/templates/shareable_config.rb

@@ -1,93 +1,99 @@
 Shareable.configure do |config|
 
-  # valid names are:
-  # twitter facebook pinterest reddit google_plus linkedin tumblr stumble_upon
+  ## configuration "names" determines which social buttons are rendered. The order the buttons are
+  ## displayed in is decided by the same order as listed here.
+  ## Valid names are: twitter facebook linkedin pinterest google_plus reddit tumblr stumble_upon
   #config.names = %w[ twitter facebook linkedin pinterest google_plus reddit tumblr stumble_upon ]
 
-  #config.button_only=false # omit initializing javacript. Only button code is rendered.
-  #config.static_link=false # renders non-javascript html links.
+  #config.static_link=false # renders html links instead of javascript buttons.
+  #config.button_only=false # omit initializing javacript code. Only button code is rendered.
+  #config.turbolinks=false # set to true to enable turbolinks fixes. Requires jquery to work!
 
-  ##############
-  #facebook
-  ##############
-  #config.app_id=''
+  ###############
+  ##facebook
+  ###############
+  #config.app_id='' # required if using facebook button!
   #config.send= 'false'
-  #config.layout=''
-  #config.show_faces=''
-  #config.action=''
+  #config.layout='' # 'standard', 'button_count', 'button' or 'box_count'. '' defaults to 'standard'.
+  #config.show_faces='' # 'true' or 'false'. '' defaults to 'false'. Don't set to 'true', if kid_directed_site is also 'true'.
+  #config.action='' # 'like' or 'recommend'. '' defaults to 'like'.
   #config.font=''
-  #config.colorscheme=''
+  #config.colorscheme='' # 'light' or 'dark'. '' defaults to 'light'.
   #config.ref=''
-  #config.share=''
-  #config.kid_directed_site=''
+  #config.share='' # 'true' or 'false'. '' defaults to 'false'.
+  #config.kid_directed_site='' # 'true' or 'false'. '' defaults to 'false'. Facebook assumes your site is not kid friendly.
 
-  ##############
-  #google_plus
-  ##############
-  #config.annotation='bubble'
-  #config.align=''
-  #config.expand_to=''
-  #config.callback=''
+  ###############
+  ##google_plus
+  ###############
+  #config.annotation='bubble' # 'none', 'bubble' or 'inline'. '' defaults to 'bubble'.
+  #config.align='' # 'left' or 'right'. '' defaults to 'left'.
+  #config.expand_to='' # comma separated list of 'top', 'right', 'bottom' and 'left'.
+  #config.callback='' 
   #config.onstartinteraction=''
   #config.onendinteraction=''
-  #config.recommendations='false'
+  #config.recommendations='false' # 'true' or 'false'. '' defaults to 'true'.
 
-  ##############
-  #linkedin
-  ##############
-  #config.counter = 'right'
-  #config.onsuccess = ''
+  ###############
+  ##linkedin
+  ###############
+  #config.counter = 'right' # 'right', 'top' or ''. '' hides counter.
+  #config.onsuccess = '' # name of a javascript function to fire if url is successfully shared.
   #config.onerror = ''
-  #config.showzero = 'true'
+  #config.showzero = 'true' # 'true' or 'false'.
 
-  ##############
-  #pinterest
-  ##############
-  #config.pin_config = 'none'
-  #config.pin_do = 'buttonPin'
-  #config.alt='' # alternate text for image tag
+  ###############
+  ##pinterest
+  ###############
+  #config.pin_config = 'beside' # 'beside', 'above' or 'none'.
+  #config.pin_do = 'buttonPin' # 'buttonPin' or 'buttonBookmark'.
+  #config.pin_shape='' # 'round' or ''.
+  #config.pin_height='' # '28' or ''. '28' is for large button.
+  #config.pin_color='' # 'red', 'white' or 'gray'. '' defaults to 'gray'.
+  #config.alt='' # alternate text for image tag.
   #config.media=''
 
-  ##############
-  #reddit
-  ##############
-  #config.target=''
+  ###############
+  ##reddit
+  ###############
+  #config.target='' # subreddit name, eg: 'rails'
   #config.color=''
   #config.bordercolor=''
-  #config.styled='off'
+  #config.styled='off' # 'off' or ''. Only used when btnsrc is not blank.
   #config.newwindow='1'
   #config.btnsrc='' # alternate reddit button url, eg: 'http://www.reddit.com/buttonlite.js?i=1'
-  #config.type= '1' # button type, eg: 1 to n
-  #config.points = '1' # points style, eg: 0 to 5
+  #config.type= '1' # '1' to '3'.
+  #config.points = '1' # '0' to '5'. Only used when btnsrc is not blank.
 
-  ##############
-  #twitter
-  ##############
-  #config.via='tweetbutton'
-  #config.text=''
-  #config.related=''
-  #config.count='horizontal'
+  ###############
+  ##twitter
+  ###############
+  #config.via='' # screen name of the user to attribute the tweet to.
+  #config.text='' # default tweet text. If blank, defaults to value of config.title.
+  #config.related='' # related accounts
+  #config.count='horizontal' # 'none', 'horizontal' or 'vertical'. '' defaults to 'horizontal'.
   #config.lang='en'
-  #config.counturl=''
-  #config.hashtags=''
-  #config.size='medium'
-  #config.dnt=''
+  #config.counturl='' # url to which your shared url resolves
+  #config.hashtags='' # comma separated hashtags appended to tweet text
+  #config.dnt='' # 'true' or 'false'. 'true' tailors content and suggestions for twitter users.
 
-  ##############
-  #stumble_upon
-  ##############
-  #config.badge_layout='1'
+  ###############
+  ##stumble_upon
+  ###############
+  #config.badge_layout='1' # '1' to '6'.
 
-  ##############
-  #tumblr
-  ##############
-  #config.background='share_1.png'
-
-  ##############
-  #shared configuration options
-  ##############
-  #config.width='80' # used by facebook and tumblr
-  #config.title= '' # used by linkedin, pinterest, reddit, stumbleupon and tumblr
-  #config.description='' # used by linkedin and tumblr
+  ###############
+  ##tumblr
+  ###############
+  #config.background='1' # '1' to '4'. Or '1T', '2T', '3T' or '4T'.
 
+  ###############
+  ##shared configuration options
+  ###############
+  #config.width='80' # used by facebook, google_plus and tumblr.
+  #config.title= '' # used by linkedin, pinterest, reddit, stumbleupon and tumblr.
+  #config.description='' # used by linkedin and tumblr.
+  #config.size='medium' # used by twitter and google_plus.
+  ## google_plus config.size can be 'small', 'medium', 'standard' and 'tall'. Default is 'standard'. Shareable uses 'medium'.
+  ## twitter config.size can be 'medium' or 'large'. Default is medium'.
 end

data/lib/shareable/config.rb

@@ -15,101 +15,107 @@ module Shareable
   class Configuration #:nodoc:
     include ActiveSupport::Configurable
     config_accessor :names, :url, :send, :layout, :show_faces, :title, :alt, :target, :app_id,
-                    :width, :action, :font, :colorscheme, :ref, :annotation, :align, :expand_to, :callback,
-                    :onstartinteraction, :onendinteraction, :pin_config, :pin_do, :media, :color,
+                    :width, :action, :font, :colorscheme, :ref, :annotation, :align, :expand_to, :callback, :color,
+                    :onstartinteraction, :onendinteraction, :pin_config, :pin_do, :pin_shape, :pin_height, :pin_color, :media,
                     :bordercolor, :btnsrc, :via, :text, :related, :count, :lang, :counturl, :hashtags, :size, :dnt,
                     :type, :styled, :newwindow, :description, :counter, :onsuccess, :onerror, :showzero,
                     :recommendations, :points, :badge_layout, :background, :share, :kid_directed_site,
-                    :button_only, :static_link
+                    :button_only, :static_link, :turbolinks
   end
 
   configure do |config|
     config.names = %w[ twitter facebook linkedin pinterest google_plus reddit ]
 
-    config.button_only=false # omit initializing javacript. Only button code is rendered.
-    config.static_link=false # renders non-javascript html links.
+    config.static_link=false # renders html links instead of javascript buttons.
+    config.button_only=false # omit initializing javacript code. Only button code is rendered.
+    config.turbolinks=false # set to true to enable turbolinks fixes. Requires jquery to work!
 
     ##############
     #facebook
     ##############
-    config.app_id = ''
+    config.app_id = '' # required if using facebook button!
     config.send= 'false'
-    config.layout='button_count'
-    config.show_faces=''
-    config.action=''
+    config.layout='button_count' # 'standard', 'button_count', 'button' or 'box_count'. '' defaults to 'standard'.
+    config.show_faces='' # 'true' or 'false'. '' defaults to 'false'. Don't set to 'true', if kid_directed_site is also 'true'.
+    config.action='' # 'like' or 'recommend'. '' defaults to 'like'.
     config.font=''
-    config.colorscheme=''
+    config.colorscheme='' # 'light' or 'dark'. '' defaults to 'light'.
     config.ref=''
-    config.share=''
-    config.kid_directed_site=''
+    config.share='' # 'true' or 'false'. '' defaults to 'false'.
+    config.kid_directed_site='' # 'true' or 'false'. '' defaults to 'false'. Facebook assumes your site is not kid friendly.
 
     ##############
     #google_plus
     ##############
-    config.annotation='bubble'
-    config.recommendations='false'
-    config.align=''
-    config.expand_to=''
+    config.annotation='bubble' # 'none', 'bubble' or 'inline'. '' defaults to 'bubble'.
+    config.align='' # 'left' or 'right'. '' defaults to 'left'.
+    config.expand_to='' # comma separated list of 'top', 'right', 'bottom' and 'left'.
     config.callback=''
     config.onstartinteraction=''
     config.onendinteraction=''
+    config.recommendations='false' # 'true' or 'false'. '' defaults to 'true'.
 
     ##############
     #linkedin
     ##############
-    config.counter = 'right'
-    config.onsuccess = '' 
+    config.counter = 'right' # 'right', 'top' or ''. '' hides counter.
+    config.onsuccess = '' # name of a javascript function to fire if url is successfully shared.
     config.onerror = ''
-    config.showzero = 'true'
+    config.showzero = 'true' # 'true' or 'false'.
 
     ##############
     #pinterest
     ##############
-    config.pin_config = 'beside'
-    config.pin_do = 'buttonPin'
-    config.alt='' # alternate text for image tag
+    config.pin_config = 'beside' # 'beside', 'above' or 'none'.
+    config.pin_do = 'buttonPin' # 'buttonPin' or 'buttonBookmark'.
+    config.pin_shape='' # 'round' or ''.
+    config.pin_height='' # '28' or ''. '28' is for large button.
+    config.pin_color='' # 'red', 'white' or 'gray'. '' defaults to 'gray'.
+    config.alt='' # alternate text for image tag.
     config.media=''
 
     ##############
     #reddit 
     ##############
-    config.target=''
+    config.target='' # subreddit name, eg: 'rails'
     config.color=''
     config.bordercolor=''
-    config.styled='off'
+    config.styled='off' # 'off' or ''. Only used when btnsrc is not blank.
     config.newwindow='1'
     config.btnsrc='' # alternate reddit button url, eg: 'http://www.reddit.com/buttonlite.js?i=1'
-    config.type= '1' # button type, eg: 1 to n
-    config.points = '1' # points style, eg: 0 to 5
+    config.type= '1' # '1' to '3'.
+    config.points = '1' # '0' to '5'. Only used when btnsrc is not blank.
 
     ##############
     #twitter
     ##############
-    config.via='tweetbutton'
-    config.text=''
-    config.related=''
-    config.count='horizontal'
+    config.via='' # screen name of the user to attribute the tweet to.
+    config.text='' # default tweet text. If blank, defaults to value of config.title.
+    config.related='' # related accounts
+    config.count='horizontal' # 'none', 'horizontal' or 'vertical'. '' defaults to 'horizontal'.
     config.lang='en'
-    config.counturl=''
-    config.hashtags=''
-    config.size='medium'
-    config.dnt=''
+    config.counturl='' # url to which your shared url resolves
+    config.hashtags='' # comma separated hashtags appended to tweet text
+    config.dnt='' # 'true' or 'false'. 'true' tailors content and suggestions for twitter users.
 
     ##############
     #stumble_upon
     ##############
-    config.badge_layout='1'
+    config.badge_layout='1' # '1' to '6'.
 
     ##############
     #tumblr
     ##############
-    config.background='share_1.png'
+    config.background='1' # '1' to '4'. Or '1T', '2T', '3T' or '4T'.
 
     ##############
     #shared configuration options
     ##############
-    config.width='80' # used by facebook and tumblr
-    config.title= '' # used by linkedin, pinterest, reddit, stumbleupon and tumblr
-    config.description='' # used by linkedin and tumblr
+    config.width='80' # used by facebook, google_plus and tumblr.
+    config.title= '' # used by linkedin, pinterest, reddit, stumbleupon and tumblr.
+    config.description='' # used by linkedin and tumblr.
+    config.size='medium' # used by twitter and google_plus.
+    # google_plus config.size can be 'small', 'medium', 'standard' and 'tall'. Default is 'standard'. Shareable uses 'medium'.
+    # twitter config.size can be 'medium' or 'large'. Default is medium'.
   end
 end

data/lib/shareable/helpers/social_buttons.rb

@@ -16,7 +16,7 @@ module Shareable
       :facebook => [ :app_id, :send, :layout, :show_faces, :width, :action, :font, :colorscheme, :ref, :share, :kid_directed_site ],
       :google_plus => [ :annotation, :recommendations, :align, :expand_to, :callback, :onstartinteraction, :onendinteraction, :size, :width ],
       :linkedin => [ :counter, :onsuccess, :onerror, :showzero, :title, :description ],
-      :pinterest => [ :pin_config, :pin_do, :title, :alt, :media, :description ],
+      :pinterest => [ :pin_config, :pin_do, :title, :alt, :media, :description, :pin_shape, :pin_height, :pin_color ],
       :reddit => [ :title, :target, :color, :bordercolor, :type, :styled, :newwindow, :btnsrc, :points ],
       :stumble_upon => [ :badge_layout, :title ],
       :tumblr => [ :title, :description, :width, :background ],

data/lib/shareable/version.rb

@@ -1,3 +1,3 @@
 module Shareable
-  VERSION = "1.0.0"
+  VERSION = "1.1.3"
 end

data/shareable.gemspec

@@ -9,21 +9,16 @@ Gem::Specification.new do |s|
   s.version     = Shareable::VERSION
   s.authors     = ["Hermango"]
   s.homepage    = "http://github.com/hermango/shareable"
-  s.summary     = "Simple and unobtrusive gem for adding social links to your Rails app."
-  s.description = "Add social sharing links to a view in your Rails app with one method call. The configuration options for each social link are customizable. Please see read me doc for more details."
+  s.summary     = "Simple and unobtrusive gem for adding social links to your Rails app. Rails 3 and 4 supported."
+  s.description = "Add social sharing functionality to your Rails app with one method call. Shareable allows you the choice of displaying javascript buttons or static links. Configuration options for each social site are ready-to-use and entirely customizable. Please see readme for more details."
   s.require_paths = ['lib']
   s.licenses    = ['MIT']
   s.files       = `git ls-files`.split($/)
 
   #s.test_files = Dir["test/**/*"]
 
-  s.add_dependency 'activesupport', ['>= 3.0.0']
-  s.add_dependency 'actionpack', ['>= 3.0.0']
-
-  s.add_development_dependency 'bundler', ['>= 1.0.0']
-  s.add_development_dependency 'tzinfo', ['>= 0']
-  s.add_development_dependency 'rspec', ['>= 0']
-  s.add_development_dependency 'rr', ['>= 0']
-  s.add_development_dependency 'capybara', ['>= 1.0']
+  s.add_dependency 'activesupport', '>= 3.0.0'
+  s.add_dependency 'actionpack', '>= 3.0.0'
 
+  s.add_development_dependency 'bundler', '>= 1.0.0'
 end

metadata

@@ -1,123 +1,67 @@
 --- !ruby/object:Gem::Specification
 name: shareable
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.3
 platform: ruby
 authors:
 - Hermango
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-06-03 00:00:00.000000000 Z
+date: 2014-07-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.0.0
 - !ruby/object:Gem::Dependency
   name: actionpack
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.0.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.0
-- !ruby/object:Gem::Dependency
-  name: tzinfo
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rr
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: capybara
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '1.0'
-description: Add social sharing links to a view in your Rails app with one method
-  call. The configuration options for each social link are customizable. Please see
-  read me doc for more details.
+description: Add social sharing functionality to your Rails app with one method call.
+  Shareable allows you the choice of displaying javascript buttons or static links.
+  Configuration options for each social site are ready-to-use and entirely customizable.
+  Please see readme for more details.
 email: 
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .DS_Store
-- .gitignore
+- ".gitignore"
 - Gemfile
 - MIT-LICENSE
 - README.md
@@ -140,6 +84,8 @@ files:
 - app/views/shareable/partials/scripts/_stumble_upon.html.erb
 - app/views/shareable/partials/scripts/_tumblr.html.erb
 - app/views/shareable/partials/scripts/_twitter.html.erb
+- app/views/shareable/partials/scripts/head/_facebook.html.erb
+- app/views/shareable/partials/scripts/head/_linkedin.html.erb
 - lib/generators/shareable/config_generator.rb
 - lib/generators/shareable/templates/shareable_config.rb
 - lib/shareable.rb
@@ -162,18 +108,19 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.14
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
-summary: Simple and unobtrusive gem for adding social links to your Rails app.
+summary: Simple and unobtrusive gem for adding social links to your Rails app. Rails
+  3 and 4 supported.
 test_files: []