handlebars-helper-twitter

Add {{tweet}} and {{follow}} buttons using Handlebars helpers.

{{tweet}} and {{follow}}

Twitter handlebars helpers, for adding {{tweet}} and {{follow}} buttons to your web projects.

See dev.twitter.com for more information.

Use npm to install the package: npm i handlebars-helper-twitter.

In your project's Gruntfile, to register the helper add handlebars-helper-twitter to the helpers property in the Assemble task or target options:

grunt.initConfig({
  assemble: {
    options: {
      // the 'handlebars-helper-twitter' npm module must also be listed in 
      // devDependencies for assemble to automatically resolve the helper 
      helpers: ['handlebars-helper-twitter', 'foo/*.js']
    },
    files: {
      'dist/': ['src/templates/*.hbs']
    }
  }
});

First, visit dev.twitter to copy/paste the necessary script into your templates. It looks like this (you probably shouldn't use this one, get the latest directly from twitter)

<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="https://platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> 

Now that the helper is registered, and the necessary script is in your templates, you may begin using it in your templates.

{{follow user="upstage" repo="upstage" type="star"}}
{{tweet url="http://assemble.io" via="assemblejs" related="jonschlinkert:Assemble core team"}}

The following hash options may be passed to the helper, in the form of foo="value":

Type: String Default: http://assemble.io

URL of the page to share.

Type: String Default: assemblejs

Screen name of the user to attribute the Tweet to.

Type: String Default: jonschlinkert:Assemble core team

Related accounts. Example:

{{tweet url="http://assemble.io" via="assemblejs" related="jonschlinkert:Assemble core team"}}

Type: String Default: assemblejs

The Twitter username. Example: jonschlinkert.

Type: String Default: #0069D6

Hex value to use for the link color.

Type: String Default: true

Whether or not to show the number of followers.

Jon Schlinkert

  • [github/Jon Schlinkert](http://github.com/Jon Schlinkert)
  • [twitter/Jon Schlinkert](http://twitter.com/Jon Schlinkert)

Licensed under the MIT License Copyright (c) Jon Schlinkert, contributors.