hpoom

TweetPeep is a jQuery plugin to allow people to have an area in their page wallpapered with twitter profile images of people who are talking about a common subject or word. The plugin is in it’s early stages but already allows you to have either a small area of profile images or a whole background like fixoutlook.org. There is no animation at this stage but I do plan to add this later along with some other features.

Download

You can download version 0.2 from here

How To Use It

To use the plugin you just need to call TweetPeep on the element you want to display profile image in, I have only tried DIV’s so far but other elements should work too. You will need to pass the parameter search to the plugin passing it the word you want to search twitter for. The element it is then called on will display image of people talking about that word or topic (see the example).

Supported Params are:

• search – Word to search twitter for, profile image of people using this word will be displayed. Also used to pass user name to search for when type is $.tweetPeep.friends
• type (optional) – Either $.tweetPeep.search or $.tweetPeep.friends defaults to $.tweetPeep.search. This effects how the search param is used.
• numToFetch (optional) – Default behavour is to try and guess how many images are needed, you can pass this number if you need to force a different number of images to be fetched.
• toolTips (optional) – Defaults to true, this is used if you do not want titles containing the post text to be set on the images.

Example Code

Search Example:

<script type="text/javascript">

  $( function() {

    $( '#tweetPeepDemo' ).tweetPeep( { search: 'jQuery' } );

  } );

</script>

Friends List Example:

<script type="text/javascript">

  $( function() {

    $( '#tweetPeepDemo' ).tweetPeep( { type: $.tweetPeep.friends, search: 'hpoom' } );

  } );

</script>

Demo

A full screen demo can now be found here

ToDo

• Check the tooptip title implementation works with all the major tooltip plugins for jQuery
• Check plugin will work fullscreen as a background like on fixoutlook.org
• Support fetching friends images by passing in a username instead of a search word
• Support animation to show tweet images changing as new tweets are made
• Allow default profile images to be not shown
• Allow duplicates to be not shown

Version History

• 18/08/09 – 0.2 Added support for fetching friends images
• 17/07/09 – 0.1 First release