Share.js (0.0.3)

Trigger the Buffer Share Popup from any specified DOM element

Share.js is a super minimal and easy plug in to make any DOM element trigger a Buffer share. It loads asynchronously to your page and doesn't add any overhead. Share.JS is still early in development, so please be sure to send any issues over to Sunil sunil@bufferapp.com.

##How to use Share.js

1. Include this script in your header

<script src='https://d389zggrogs7qo.cloudfront.net/js/sharejs/0.0.3/share.min.js'></script>

```

2. Add an anchor tag with attribute data-buffer-share and parameters

   ###Example:

   <a data-buffer-share
   data-url='http://blog.bufferapp.com' 
   data-text="The Buffer Blog!" 
   data-preferred-login="twitter" 
   data-partner-source='feedly' 
   data-partner-placement='mini' 
   data-via='sunils34'>Share to Buffer</a>
   

##Optional Parameters:

• data-url: URL to share. If not specified, the url will be the current page
• data-text: Text to share.
• data-preferred-login: <twitter, linkedin, facebook> Preferred service to share to or login from
• data-via: Via (twitter screen_name)
• data-partner-source: Partner name.
• data-partner-placement: Partner specified identifier (ie. mini)

####Native Retweets Share.js supports creating Native Retweets. You'll need to supply four params if you'd like to use this.

• data-retweeted-tweet-id: Numeric Twitter ID of the status. You can find this on the twitter url of a status
• data-retweeted-user-id: The twitter user id who created the status
• data-retweeted-user-name: The user screen name of the twitter user who created the status
• data-retweeted-user-display-name: The display name of the twitter user who created this status

##Creating Buffer Share DOM Elements with Javascript No worries ;-), Buffer will be automatically attached to elements created with javascript after window.onload is called.

#Development Buffer Share.js is open source. While maintained by Buffer, we welcome any improvements you have! Here's how you can get started contributing.

##Building

1. Install grunt.js

$ sudo npm install -g grunt-cli
$ npm install

2. Run grunt after you're satisfied with your changes.

$ grunt

##Contributing When you've made your changes, feel free to submit pull requests. When/if merged, we'll be sure to update the Share.JS version and upload it onto the Buffer CDN.