Boastful is the best tweetback library.

Lovingly crafted by Zach Holman. (@holman).

So what's a tweetback?

Once upon a time there were trackbacks. If you wrote a blog post, and I thought it was interesting so I blogged about your blog post, trackbacks were the way for my blog to let your blog know I'm talking about it. Usually, your blog software would then link to mine as a way of telling your own readers "hey, here's some more people talking about this topic".

A few services have started to do the same for Twitter- a "tweetback", if you will. Write your blog post, and then these services would search Twitter for whoever would link or discuss it.

Here's the main problems with that approach:

• The content usually sucks. I've seen a lot of systems — Disqus, for one — simply print out the tweet verbatim and try to integrate it into your regular blog comments. This assumes that each and every tweet offers some compelling unique viewpoint. It doesn't. Usually you end up with a bunch of tweetbacks coming in saying "RT @someone RT @someoneelse RT @originaldude Hey a blog post http://example.com".
• Most only search Twitter. Twitter search is cool, quick, and painless, but it doesn't offer full archival access, so older tweets might not show up. It's nice to have a full list.
• URL shorteners are confusing. You shouldn't just search for your main blog post URL; very few on Twitter actually do the whole thing, since characters are money, people. You'd have to search for every short URL that translates to your main post URL.

Luckily, this tiny jQuery plugin tries to solve all those:

• Avatars only. James Cameron's dream: only avatars. The full content is available through a tooltip, but really you shouldn't expect the tweet content to contribute much anyway.
• Uses Topsy. Topsy handles both the archival problem and the URL shortener problem. They crawl Twitter for who's linking to who, translating short URLs to full URLs as they go.

You end up with little heads on the footer of your blog, which acts as nifty encouragement to get others to tweet and promote your content. People love seeing their face.

Example

I hate readmes without a pretty picture to explain everything. Here's a current snapshot of the footer from my blog. Feel free to style away, you mad little CSS scientist you.

Installing

Feel free to browse example.html for a basic example. Otherwise, the general steps:

1. Rock your jQuery, like:
   <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.1/jquery.min.js"></script>
2. Deviously load up jquery.boastful:
   <script type="text/javascript" src="jquery.boastful.js"></script>
3. Lock and load into your $(document).ready():

   $(document).ready(function() {
   $('#boastful').boastful();
   });

4. Tell it where to go:
   <div id="boastful"></div>
5. Style accordingly. For a starting point, check out boastful.css.
6. High-five your girlfriend.

Optional options

In your .boastful() call, you can pass in some options. Here's a list:

• location: the URL to search Twitter for (default: location.href, the current page)
• empty_message: message to display if no tweets found, HTML allowed (default: No one's mentioned this page on Twitter yet. <a href="http://twitter.com?status=page_url_here>You could be the first</a>.)
• limit: maximum to show per page (default: 50, which is also the maximum)

Found an issue?

Fork it and fix it. Or file an issue. Or ping me on twitter (I'm @holman). Or high-five your girlfriend some more.

Thanks for checking out boastful; hope you enjoy it!