JavaScripting

The definitive source of the best
JavaScript libraries, frameworks, and plugins.

  • ×

    Tweet

    Github

    put twitter on your website with tweet, an unobtrusive javascript plugin for jquery
    Filed under  › 

    • 🔾33%Overall
    • ★827
    • ⏳47.8 days
    • 🕩219
    • 👥3

    Tweet!

    Put twitter on your website with tweet!, an unobtrusive javascript plugin for jquery.

    Important note about Twitter's API changes in 2013

    Twitter has discontinued its unauthenticated v1.0 API, so this widget has stopped working as of 2013-06-11.

    Twitter wants your only option for on-page widgets to be their own Embedded Timelines, but there are workarounds which involve installing server-side code to support this widget. Please see this discussion for more details.

    Demos & examples

    See tweet.seaofclouds.com, or the bundled index.html file.

    Source

    Download tarball

    Features

    • small size and fast download time
    • will not slow down or pause your page while tweets are loading
    • display up to 100 tweets, as permitted by the twitter search api
    • display tweets from a twitter search, or from your own feed
    • optional verb tense matching, for human readable tweets
    • optionally display your avatar
    • optionally display tweets from multiple accounts!
    • automatic linking of @replies to users’ twitter page
    • automatic linking of URLs
    • automatic linking of #hashtags, to a twitter search of all your tags
    • converts <3 to a css styleable ♥ (we ♥ hearts)
    • customize the style with your own stylesheet or with other jquery plugins
    • customize the layout with a user-defined template function
    • supports RequireJS and other AMD-compatible javascript loaders
    • available on cdnjs

    Usage

    1. Get JQuery. In these examples, we use Google's AJAX Libraries API.

    1. include jQuery and jquery.tweet.js files in your template's <head>.

       <script language="javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.4/jquery.min.js" type="text/javascript"></script>
 <script language="javascript" src="/tweet/jquery.tweet.js" type="text/javascript"></script>

    2. Also in <head>, Initialize tweet! on page load with your Username and other options

       <script type='text/javascript'>
     jQuery(function($){
         $(".tweet").tweet({
             join_text: "auto",
             avatar_size: 32,
             count: 3,
             loading_text: "loading tweets..."
         });
     });
 </script>

    3. In <body>, include a placeholder for your tweets. They'll get loaded in via JSON. How fancy!

       <div class="tweet"></div>

    4. Style with our stylesheet in <head>, or modify as you like!

       <link href="jquery.tweet.css" media="all" rel="stylesheet" type="text/css"/>

    Contribute

    Bring your code slinging skills to Github and help us develop new features for tweet!

    Github project page

    git clone git://github.com/seaofclouds/tweet.git

    Report bugs at http://github.com/seaofclouds/tweet/issues

    Licensed under the MIT

    License text

    Show All