jTweetsAnywhere

jQuery Twitter Widget with @Anywhere support

jTweetsAnywhere is a jQuery Twitter Widget that simplifies the integration of Twitter services into your site.
With just a few lines of Javascript you can

$('#tweets').jTweetsAnywhere({
    username: 'tbillenstein',
    count: 5
});

$('#ticker').jTweetsAnywhere({
    searchParams: 'q=nfl',
    count: 10,
    showTweetFeed: {
        autorefresh: {
            mode: 'trigger-insert',
            interval: 60
        },
        paging: {
            mode: 'more'
        },
       	showTimestamp: {
            refreshInterval: 15
        }
    }
});

Display tweets from users' feeds, lists and favorites (new in V1.3)
Show results from a Twitter search
Present auto-refreshing realtime/live tickers
Build pageable tweet feeds
Give your visitors the opportunity to Reply to, Retweet and Favorite your tweets (new in V1.3)
Integrate a customizable TweetBox into your site
Let your visitors follow you directly from your site
Handle secure authentication with Twitter

"jTweetsAnywhere is the best twitter plugin I've seen. very good documented and very easy to customize... Great work and thanks"

@serhanbuy

"@tbillenstein Using jTweetsAnywhere to bring to life a web app supporting my band's new release tomorrow, Thomas. Thanks."

@thepinto

"Fantastic Thomas!! love it"

@ajconsultingme

"jTweetsAnywhere is an awesome jquery plugin for twitter"

@aymericlamboley

"jTweetsAnywhere: An immensly flexible jQuery Twitter widget that enables the integration of Twitter services into your site. (from the magazine's print version)"

@websitemagazine

"#jTweetsAnywhere best twitter jquery plugin ive seen"

@joeyignorant

"dude, your script is awesome. look what we've done with it :D http://twthosting.com"

@twthosting

"jTweetsAnywhere by @tbillenstein is bad ass!"

@neilcamm

"thanks so much! I absolutely love the tweet script!!! And so does my client :)"

@lizziebowgirl

"#jTweetsAnywhere is super-awesome. Thanks for making it."

@nrambeck

"JTweetsAnywhere is really awesome jquery twitter widget, thanks @tbillenstein"

@aqlong

"I'm very impressed: jta hits the right spot as a tool where I can customise things to my liking. So few tweet embedders do."

@atl

"@tbillenstein thanks Thomas. Working with the jTweetsAnywhere library has been so easy. I've litterally learnt OOP by your code :-)"

@twEPICy

"thanks for the excellent #jTweetsAnywhere"

@lazymanc

"Awesome customizable jquery Twitter widget from jTweetsAnywhere"

@the_Jasser

"JTweetsAnywhere is really awesome jquery twitter widget, thanks @tbillenstein"

@jlmurgas

"Very impressed by #jTweetsAnywhere (a jQuery Twitter widget)."

@jamieflournoy

"Definitely prefer jTweetsAnywhere to the jQuery Twitter API. Thanks for your great plugin"

@ecagriffiths

"#jTweetsAnywhere j'adore ce site !"

@conishiwa

"Nice to hear from @tbillenstein who wrote #jTweetsAnywhere who's happy for us to wrap his cool jQuery stuff into Drupal"

@olamalu

"COOL-STUFF: jTweetsAnywhere - a jQuery Twitter Widget"

@denie72

"#jTweetsAnywhere is awesome"

@FormThis

"Great realtime jquery twitter pull"

@beacrea

"#jTweetsAnywhere this is cool"

@govindarajan78

"#jTweetsAnywhere wow, its so amazing"

@ipankvision

"#jTweetsAnywhere is amazing"

@N8Friedrichsen

"jTweetsAnywhere is very nice!"

@ruudgreven

"The jQuery Twitter feed 'jTweetsAnywhere' by @tbillenstein just got even better"

@EvokeArtDesign

"Wow! jTweetsAnywhere, a jQuery Twitter Widget with @Anywhere support - really brilliant!"

@philsniff

"Loving jTweetsAnywhere - it's so easy to set up."

@JamesisaPayne

"A great way to include Tweets on your webpages"

@guillaumepiot

"Thanks, #jTweetsAnywhere is awesome"

@rothkj1022

"Love your jTweetsAnywhere plug-in. Great plug-in, thanks for the help! "

@JADDL_Commish

"Fantastic #Twitter #jquery feed, lets you do all sorts of things"

@aboxcreative

"Great work on your Twitter jQuery plugin. Thank you."

@shauntrennery

"Thanks for the great script!"

@LingoLWL

"jTweetsAnywhere is pretty awesome."

@wjdennen

"#jTweetsAnywhere this is cool"

@JonnyMcAwesome

"thanks, jTweetsAnywhere is a great jQuery plugin."

@lembit

"#jTweetsAnywhere This Plugin is great"

@html5_newbie

"amazing jtweet libs"

@Gabizouari

"Hehe ! Vient juste d'intégrer Twitter à son blog http://bit.ly/dCPwG3 grâce à un plugin jQuery pas mal du tout"

@Hamtaro

"Nice work!"

@circa3000

"Interesting jQuery component to get Tweets into your web page (jTweetsAnywhere)"

@AldoForce

"Sweet jQuery Twitter plugin that @gjhead directed me to today: jTweetsAnywhere"

@thadbloom

"Hi, nice plugin #jTweetsAnywhere :)"

@kokmok

"Now I'm using this to display Twitter time line on my web site. Cool!"

@mikehibm_eng

"Awesome jQuery Plugin #jTweetsAnywhere. Looking forward to use & contribute."

@aamiraarfi

"Great twitter integration...."

@weboptimum

"jQuery Twitter Widget with @Anywhere support, simply, sweet."

@cajebo

"Working with jTweetsAnywhere library - Awesome plugin!"

@lancelarsen

"like this #jTweetsAnywhere"

@ppalavilli

"I just started with #jTweetsAnywhere from @tbillenstein. Awesome Twitter tool for any web page!"

@GilFredy

read them all ...

Demo

Github Repo

Download

Current Release: V1.3.1

Features

Displays tweets from one or more users' feeds
Displays tweets from a user's list
Displays a user's favorite tweets (new in V1.3)
Displays the results of a Twitter search
Supports all Twitter search params
Supports Twitter's @Anywhere features
Has paging support in several variants - including endless-scroll - to display earlier tweets
Has auto-refresh support to build realtime/live tickers with no effort
Can supply Reply, Retweets and Favorite Actions for each tweet by the use of Twitter's Web Intents which makes it possible for users to interact with Twitter content in the context of your site, without leaving the page (new in V1.3)
Can integrate a customizable TweetBox into your site, so your visitors can update their status on the fly
Can add a Twitter "Follow Button" to your site
Can add a "Connect with Twitter" button to your site
Provides secure user authentication
Handles low level user login and signup procedures
Supports native retweets
Can display extended tweet attributes, like timestamp, source, geolocation and in-reply-to info
Can display profile images and usernames in tweet feeds
Automatically detects and marks up links in tweets
Automatically links #hashtags to Twitter search requests
Automatically links @username to Twitter profiles
Automatically shows Hovercards when hovering @username or profile images
Customize the style and layout of the widget with your own stylesheets
Overwrite the generated HTML markup by providing your own decorators
Supply your own visualizers to add UI effects
Write your own tweet filter to customize the tweet feed
Add your own listeners to get notfied on interesting events
Takes care of Twitter's rate limits, mainly in conjunction with the auto-refresh and paging features to avoid getting black-listed and therefor keep your visitors happy
Small code size for fast download
Does not interrupt the loading of your page
I18N: Currently supports english and german languages (new in V1.3)

Usage

1. Download the plugin

The downloadable zip archive contains the Javascript source file in it's original version, a fastloading minified version and a basic CSS file that serves as a sample for tweaking the UI.

Download

Current Release: V1.3.1

2. Include the Javascript and CSS resources in your page's `<head>` section

<head>

</head>

Include the jTweetsAnywhere script (jquery.jtweetsanywhere-1.3.1.min.min.js or jquery.jtweetsanywhere-1.3.1.min.js) and the basic Stylesheet (jquery.jtweetsanywhere-1.3.1.css). The CSS contains all tweakable elements and can be used as a starter for your own customizing.
You will need the jQuery library. jQuery Version 1.7.1 (minified) is recommended. You can also hotlink to one of the hosted versions, e.g.
http://code.jquery.com/jquery-1.7.1.min.js
Twitter's @Anywhere features (like Hovercards, Tweet Box, Follow Button, etc.) are optional. If you don't need them, just skip the next paragraphs and continue with the next section. Keep in mind that you can integrate any kind of tweet feed into your site without the need of @Anywhere.

If you want to use Twitter's @Anywhere features, you must include Twitter's anywhere.js inside your <head> section. In order to start using @Anywhere, you have to register your site (application) and obtain an APIKey (also called Consumer Key) from Twitter. When registering, be sure to select "Read & Write" for the Default Access type.

<script type="text/javascript" src="http://platform.twitter.com/anywhere.js?id=APIKey&v=1"></script>

Read this note for registration details and how to set up a local web server for testing purposes.
jTweetsAnywhere's I18N support is optional. If you want to use it, please include the adequate locale script, e.g.

<script type="text/javascript" src="jtweetsanywhere-de-1.3.1.min.js"></script>

3. Add a placeholder for the widget to your page

<body>
    ...
    <div id="tweetFeed">
    </div>
    ...
</body>

4. Add the Javascript that will populate the placeholder

$(document).ready(function(){
    $('#tweetFeed').jTweetsAnywhere({
        username: 'tbillenstein',
        count: 5,
        showTweetFeed: {
            showProfileImages: true,
            showUserScreenNames: true,
            showUserFullNames: true,
            showActionReply: true,
            showActionRetweet: true,
            showActionFavorite: true
        },
        showTweetBox: {
            label: '<span style="color: #303030">Spread the word ...</span>'
        }
    });
});

5. View the results

6. Find more Samples on the Demo page

The Demo page shows a lot more samples of what can be done with the widget and how it can be tweaked to display the results you expect.

Demo

7. Find the code, unit tests, and all releases on Github

This is the preferred place to submit and discuss feature requests, bugs and issues.

Github Repo

8. Read the relevant Blog posts

In the Blog you can find additional informations, like release notes, etc. Please have a look at those.

Documentation

This section describes all configurable plugin options.

Basic Configuraton Options

username

The user's name who's tweet feed or list feed is displayed. This param is also used when a Twitter "Follow Button" is displayed. Usually this param is a string, but can also be an array of strings. If an array is supplied (and the params 'list' and 'searchParams' are null), a combined feed of all users is displayed.
Default value: tbillenstein
Sample: 'tbillenstein' or ['twitterapi', 'ChromiumDev']
Demo: Some recent tweets and a Follow Button and Tweets from selected users

list

The name of a user's list where the tweet feed is generated from. The special list name 'favorites' can be used to display a user's favorited tweets.
Default value: null
Sample: 'ajaxians'
Demo: My Favorite Tweets, Tweets from a user's list

searchParams

A single search param string or an array of search params, to be used in a Twitter search call. All Twitter Search Params are supported.
Default value: null
Sample: 'q=twitter' or ['q=twitter', 'geocode=48.856667,2.350833,30km']
Demo: Some tweets from around Paris, France ...

count

The number of tweets shown in the tweet feed. If this param is 0, no feed is displayed. For user or list feeds the maximum count is 20, for search results the maximum count is 100.
Unlike in previous releases, since 1.2.0 jTweetsAnywhere is based on a tweets caching algorithm that will always deliver the requested count of tweets accepting that this request can only be fullfilled by calling Twitter more than once.
IMPORTANT: Please always keep in mind, that the use of the Twitter API is rate limited. Non-authenticated users are rated IP-based and you have only 150 calls per hour available. Every retrieval of tweets counts and so does for example hovering over a profile image to show the hovercard. jTweetsAnywhere will always check the remaining count of free API calls before actually calling Twitter to avoid black listing your visitor's IP.
Default value: 0

locale

Identifies the locale for I18N support. The default locale is 'en'. To use this option you have to inlude the adequate locale script, jtweetsanywhere-{language}-{version}.js, e.g. jtweetsanywhere-de-1.3.0.js
Default value: 'en'
Since: 1.3.0
Sample: 'de'
Demo: I18N Support

tweetFilter

Each tweet that is loaded from Twitter will pass the tweetFilter. If the filter returns true, the tweet will be added to the tweets cache otherwise it is ignored. The default tweet filter alsways retruns true but you can supply your own tweet filter to customize the tweet feed.
Default value: defaultTweetFilter
Since: 1.2.0

Widget Parts Configuraton Options

showTweetFeed

A flag (true/false) that specifies whether to display a tweet feed or an object literal representing the configuration options for the tweet feed.

This flag works in conjunction with the count parameter:
- if count equals 0, no feed is displayed, ignoring showTweetFeed
- if count not equals 0 and showTweetFeed equals false, no feed is displayed
- if showTweetFeed is an object literal the configuration options and their default values are:


{
    autoConformToTwitterStyleguide: false,
                                  // Boolean - as the name implies, sets all options to confirm to Twitter's
                                  // styleguide regulations. Implies:
                                  // showTweetFeed: {
                                  //     showUserFullNames: null,   // null means: if usernames are shown, show
                                  //                                // fullnames too
                                  //     showTwitterBird: true,
                                  //     showActionReply: true,
                                  //     showActionRetweet: true,
                                  //     showActionFavorite: true
                                  // }
                                  // Since 1.3.0

    showTwitterBird: true,        // Boolean - show Twitter bird icon beneath the timestamp of a tweet,
                                  // linking to the tweeter's MiniProfile Web Intent
                                  // Since 1.3.0

    showTimestamp: true,          // A flag (true/false) that specifies whether to display a tweet's timestamp
                                  // or an object literal representing the configuration options for the
                                  // timestamp.
                                  // {
                                  //     refreshInterval: 0,    // Time in seconds to be waited until the
                                  //                            // timestamps of the displayed tweets get refreshed
                                  //                            // 0 means no refreshing.
                                  // }
                                  // Since 1.2.0

    showSource: false,            // Boolean - Show info about the source of the tweet.

    showGeoLocation: true,        // Boolean - Show geolocation info and link to Google maps.
                                  // Since 1.2.0

    showInReplyTo: true,          // Boolean - Show link to the "replied to" tweet (if available).
                                  // Since 1.2.0

    showActionReply: false,       // Boolean - Show tweet's 'Reply' action (supplies a link to popup
                                  // the tweet's Reply Web Intent)
                                  // Since 1.3.0

    showActionRetweet: false,     // Boolean - Show tweet's 'Retweet' action (supplies a link to popup
                                  // the tweet's Retweet Web Intent)
                                  // Since 1.3.0

    showActionFavorite: false,    // Boolean - Show tweet's 'Favorite' action (supplies a link to popup
                                  // the tweet's Favorite Web Intent)
                                  // Since 1.3.0

    showProfileImages: null,      // A flag (true/false) that specifies whether to display a profile image in
                                  // tweets. If the param is set to null (the default value), a profile image
                                  // is displayed only if the feed represents a user's list or the result of a
                                  // Twitter search.
                                  // Since 1.2.0

    showUserScreenNames: null,    // A flag (true/false) that specifies whether to display a username in
                                  // tweets. If the param is set to null (the default value), a username
                                  // is displayed only if the feed represents a user's list or the result of a
                                  // Twitter search.
                                  // Since 1.2.0

    showUserFullNames: false,     // A flag (true/false) that specifies whether to display a user's full name
                                  // in tweets. If the param is set to null, a user's full name
                                  // is displayed only if the feed represents a user's list or the result of a
                                  // Twitter search.
                                  // Since 1.2.0

    expandHovercards: false,      // Boolean - Show Hovercards in expanded mode.

    includeRetweets: true,        // Boolean - Include native retweets in a user's tweet feed
                                  // Since 1.2.0

    paging:                       // An object literal representing the configuration options for the
    {                             // paging support, that specifies how more/earlier tweets can be loaded
                                  // by using the supplied UI controls (more/next buttons, scrollbar).
                                  // Since 1.2.0

        mode: "none"              // Accepted values for mode are: "none" | "more" | "prev-next" | "endless-scroll"
                                  // if mode equals "endless-scroll" you have to set the height of the tweet feed
                                  // element (.jta-tweet-list) in your CSS to get a scrollbar! You should also set
                                  // the "overflow" attribute to "auto".
    },

    autorefresh:                  // An object literal representing the configuration options for the
    {                             // autorefresh behaviour.
                                  // Since 1.2.0

                                  // IMPORTANT: Please always keep in mind, that the use of the Twitter API is rate
                                  // limited. Non-authenticated users are rated IP-based and you have only 150
                                  // calls per hour available. Every retrieval of tweets counts and so does for
                                  // example hovering over a profile image to show the hovercard. jTweetsAnywhere will
                                  // always check the remaining count of free API calls before actually calling
                                  // Twitter to avoid black listing your visitor's IP.

                                  // However - choose your settings wisely to keep your visitors happy. A refresh
                                  // interval of 30 seconds on a tweet feed that is updated averaged once per hour
                                  // does not make sense and is a total waste of remaining API calls!

        mode: "none",             // Accepted values for mode are: "none" | "auto-insert" | "trigger-insert"
                                  // "none" (the default value) - disables the autorefresh feature
                                  // "auto-insert" - automatically insert the new tweets on top of the tweet feed
                                  // "trigger-insert" - if new tweets arrived, show or update a button that displays
                                  // the number of new tweets. These new tweets are inserted on top of the tweet
                                  // feed, if the user clicks on the button.

        interval: 60,             // Time in seconds to be waited until the next request for new tweets. Minimum
                                  // value is 30, the default value is 60.

        duration: 3600            // Time in seconds for how long the autorefresh will be active. After
                                  // this period of time, auto-refreshing will stop. A value of -1 means
                                  // autorefresh for ever.
    }
}

Default value: true
Since: 1.1.0
Sample: { expandHovercards: true, showUserScreenNames: true }
Demos: Auto-refreshing Realtime Ticker and More Tweets, Loading More Tweets with Endless Scrolling, Paging Back and Forth, My Favorite Tweets, Extended Tweet Attributes

showTweetBox

A flag (true/false) that specifies whether to display a Twitter "Tweet Box" or an object literal representing the configuration options for the "Tweet Box". The configuration options and their default values are:


{
    counter: true,                // Boolean  - Display a counter in the Tweet Box
                                  //            for counting characters
    width: 515,                   // Number   - The width of the Tweet Box in px
    height: 65,                   // Number   - The height of the Tweet Box in px
    label: "What's happening",    // String   - The text above the Tweet Box
    defaultContent: <none>,       // String   - Pre-populated text in the Tweet Box.
                                  //            Useful for an @mention, a #hashtag,
                                  //            a link, etc.
    onTweet: <none>               // Function - Specify a listener for when a tweet
                                  //            is sent from the Tweet Box. The
                                  //            listener receives two arguments:
                                  //            a plaintext tweet and an HTML tweet
}

Default value: false
Sample: { counter: true, width: 380, height: 65 }
Demo: A customized Tweet Box

showFollowButton

A flag (true/false) that specifies whether to display a Twitter "Follow Button".
Default value: false
Demo: Some recent tweets and a Follow Button

showConnectButton

A flag (true/false) that specifies whether to display a Twitter "Connect Button" or an object literal representing the configuration options for the "Connect Button". The configuration options and their default values are:
```
{
    size: "medium"                // String  - The size of the Connect Button.
                                  //           Valid values are: small, medium,
                                  //           large, xlarge
}
```
Default value: false
Demo: Connect Button and Login Info and Different sizes of the Connect Button

showLoginInfo

A flag (true/false) that specifies whether to display Login Infos.
Default value: false
Demo: Connect Button and Login Info

Decorator Configuration Options

mainDecorator

Defines the sequence of the widget's components.
A decorator is a function that is responsible for constructing a certain element of the widget. Most of the decorators return a HTML string. Exceptions are the mainDecorator, which defines the basic sequence of the widget's components, plus the linkDecorator, the usernameDecorator and the hashtagDecorator which return the string that is supplied as a function param, enriched with HTML tags.
For details, see the implementations of the default decorators. Each default decorator can be overwritten by your own implementation.
Default value: defaultMainDecorator
Demo: Supplying your own Decorator

tweetFeedDecorator

Returns the placeholder for the tweet feed (default is an unordered list).
Default value: defaultTweetFeedDecorator

tweetDecorator

Returns the tweet HTML. The default tweet is made of the optional user's profile image and the tweet body inside a list item element.
Default value: defaultTweetDecorator

tweetProfileImageDecorator

Returns the profile image HTML. The default profile image decorator simply adds a link to the user's Twitter profile.
Default value: defaultTweetProfileImageDecorator

tweetBodyDecorator

Returns the tweet body HTML. The default tweet body contains the tweet text and the tweet's attributes.
Default value: defaultTweetBodyDecorator

tweetTextDecorator

Returns the tweet text HTML. The default tweet text decorator optionally adds the tweet author's screen and full user name and marks links, @usernames, and #hashtags.
Default value: defaultTweetTextDecorator

tweetAttributesDecorator

Returns the tweet attributes HTML. The default tweet attributes section can contain the tweet's timestamp, source (via), geolocation, in-reply-to info and - if it's a retweet - the retweeter.
Default value: defaultTweetAttributesDecorator
Since: 1.1.0

tweetTwitterBirdDecorator

Returns the tweet's Twitter Bird Icon HTML. From Twitter's developer docs:
This Intent provides an unobtrusive way to link names of people, companies, and services to their Twitter accounts. The resultant popup prominently features the account's profile picture, bio, summary statistics, noteworthy followers, recent tweets and an easy-to-use Follow button.
The default tweet Twitter Bird decorator returns a popup link to the tweet's author profile web intent.
Default value: defaultTweetTwitterBirdDecorator
Since: 1.3.0

tweetTimestampDecorator

Returns the tweet's timestamp HTML. The default tweet timestamp decorator does a little bit of Twitter like formatting.
Default value: defaultTweetTimestampDecorator

tweetSourceDecorator

Returns the tweet's source HTML. The default tweet source decorator returns a link to the tweet's source.
Default value: defaultTweetSourceDecorator
Since: 1.1.0

tweetGeoLocationDecorator

Returns the tweet's geolocation info HTML. The default tweet geolocation decorator returns a link to maps.google.com marking the tweet's place.
Default value: defaultTweetGeoLocationDecorator
Since: 1.2.0

tweetInReplyToDecorator

Returns the tweet's in-reply-to info HTML. The default tweet in-reply-to decorator returns a link to the replied to tweet, if the tweet is a reply.
Default value: defaultTweetInReplyToDecorator
Since: 1.2.0

tweetRetweeterDecorator

Returns the tweet's retweeter info HTML. The default tweet retweeter decorator returns a link to the tweet's retweeter if the tweet is a retweet.
Default value: defaultTweetRetweeterDecorator
Since: 1.2.0

tweetActionsDecorator

Returns the HTML for the tweet's action web intents tweetActionReplyDecorator, tweetActionRetweetDecorator and tweetActionFavoriteDecorator.
Default value: defaultTweetActionsDecorator
Since: 1.3.0

tweetActionReplyDecorator

Returns the tweet's action reply web intent HTML. From Twitter's developer docs:
This intent makes it easy for a user to tweet nearly anything from your site with a stylish #newtwitter-inspired Tweet Composer.
The default decorator returns a popup link to the tweet's reply action web intent.
Default value: defaultTweetActionReplyDecorator
Since: 1.3.0

tweetActionRetweetDecorator

Returns the tweet's action retweet web intent HTML. From Twitter's developer docs:
Retweets are a powerful way to enable your users to share your content with their followers.
The default decorator returns a popup link to the tweet's retweet action web intent.
Default value: defaultTweetActionRetweetDecorator
Since: 1.3.0

tweetActionFavoriteDecorator

Returns the tweet's action favorite web intent HTML. From Twitter's developer docs:
Users favorite for a variety of reasons: when they love a Tweet, when they want to save it for later, or to offer a signal of thanks. The favorite intent allows you to provide this Tweet Action and follow up with relevant suggested accounts for the user to follow.
The default decorator returns a popup link to the tweet's favorite action web intent.
Default value: defaultTweetActionFavoriteDecorator
Since: 1.3.0

tweetFeedControlsDecorator

Returns the tweet feed controls HTML if paging is activated. The default tweet feed controls decorator returns a 'prev-button' (via tweetFeedControlsPrevBtnDecorator) and a 'next-button' (via tweetFeedControlsNextBtnDecorator) if paging mode equals 'prev-next' or a 'more-button' (via tweetFeedControlsMoreBtnDecorator) if paging mode equals 'more'.
Default value: defaultTweetFeedControlsDecorator
Since: 1.2.0

tweetFeedControlsPrevBtnDecorator

Returns the tweet feed controls prev button HTML. The default tweet feed controls prev button decorator returns the 'prev-button' markup.
Default value: defaultTweetFeedControlsPrevBtnDecorator
Since: 1.2.0

tweetFeedControlsNextBtnDecorator

Returns the tweet feed controls next button HTML. The default tweet feed controls next button decorator returns the 'next-button' markup.
Default value: defaultTweetFeedControlsNextBtnDecorator
Since: 1.2.0

tweetFeedControlsMoreBtnDecorator

Returns the tweet feed controls more button HTML. The default tweet feed controls more button decorator returns the 'more-button' markup.
Default value: defaultTweetFeedControlsMoreBtnDecorator
Since: 1.2.0

tweetFeedAutorefreshTriggerDecorator

Returns the tweet feed autorefresh trigger HTML. The default tweet feed autorefresh trigger decorator returns the markup generated by the tweetFeedAutorefreshTriggerContentDecorator) inside a list item element.
IMPORTANT: the tweet feed autorefresh trigger will be added to the tweet feed element, so the element types returned by the tweetDecorator and the tweetFeedAutorefreshTriggerDecorator must match.
Default value: defaultTweetFeedAutorefreshTriggerDecorator
Since: 1.2.0

tweetFeedAutorefreshTriggerContentDecorator

Returns the tweet feed autorefresh trigger content HTML. The default tweet feed autorefresh trigger content decorator returns the text 'n new tweets' inside a span element.
Default value: defaultTweetFeedAutorefreshTriggerContentDecorator
Since: 1.2.0

connectButtonDecorator

Returns the default placeholder for the @Anywhere Connect Button.
Default value: defaultConnectButtonDecorator

loginInfoDecorator

Returns the default placeholder for the LoginInfo.
Default value: defaultLoginInfoDecorator

loginInfoContentDecorator

Returns the LoginInfo content HTML. The default markup of the LoginInfo content: the user's profile image, the user's screen_name and a "button" to sign out.
Default value: defaultLoginInfoContentDecorator

followButtonDecorator

Returns the default placeholder for the @Anywhere Follow Button.
Default value: defaultFollowButtonDecorator

tweetBoxDecorator

Returns the default placeholder for the @Anywhere Tweet Box.
Default value: defaultTweetBoxDecorator

linkDecorator

Adds the markup for links in tweets.
Default value: defaultLinkDecorator

usernameDecorator

Adds the markup for @usernames in tweets. if @Anywhere is present the task is left to them.
Default value: defaultUsernameDecorator

hashtagDecorator

Adds the markup for #hashtags in tweets.
Default value: defaultHashtagDecorator

loadingDecorator

Returns the loading indicator HTML. The default loading decorator simply says: 'loading ...'
IMPORTANT: the loading indicator will be added to the tweet feed element, so the element types returned by the tweetDecorator and the loadingDecorator must match.
Default value: defaultLoadingDecorator

errorDecorator

Returns the error message HTML. The default error decorator simply says: 'ERROR: [error message]'
IMPORTANT: the error message will be added to the tweet feed element, so the element types returned by the tweetDecorator and the errorDecorator must match.
Default value: defaultErrorDecorator
Since: 1.1.0

noDataDecorator

Returns the no data message HTML. The default no data decorator simply says: 'No more data'
IMPORTANT: the no data message will be added to the tweet feed element, so the element types returned by the tweetDecorator and the noDataDecorator must match.
Default value: defaultNoDataDecorator
Since: 1.2.0

Formatter Configuraton Options

tweetTimestampFormatter

Formats the tweet's timestamp to be shown in the tweet attributes section.
Formatters are currently used for date format processing only. For details, see the implementation of the default formatters. Each default formatter can be overwritten by your own implementation.
Default value: defaultTweetTimestampFormatter
Since: 1.2.0

tweetTimestampTooltipFormatter

Formats the tweet's timestamp to be shown in the tooltip when hovering over the timestamp link.
Default value: defaultTweetTimestampTooltipFormatter
Since: 1.2.0

Visualizer Configuraton Options

tweetVisualizer

Gets called each time a tweet element should be appended or prepended to the tweet feed element.
A visualizer is a function that is responsible for adding one or more elements to the DOM and thereby making them visible to the user. A visualizer might also be responsible to do the opposite effect: To remove one or more elements from the DOM.
For details, see the implementation of the default visualizers. Each default visualizer can be overwritten by your own implementation.
Default value: defaultTweetVisualizer
Since: 1.2.0

loadingIndicatorVisualizer

Gets called each time data is retrieved from Twitter to visualize the loading indicator. This visualizer is also used to hide the loading indicator.
Default value: defaultLoadingIndicatorVisualizer
Since: 1.2.0

autorefreshTriggerVisualizer

Will be called if the autorefresh trigger should be visualized or hidden.
Default value: defaultAutorefreshTriggerVisualizer
Since: 1.2.0

Event Handler Configuraton Options

onDataRequestHandler

An event handler is a function that gets called whenever the event you are interested in, occurs.
The onDataRequest event handler will be called immediatly before calling Twitter to retrieve new data and gives you the opportunity to deny the call by returning false from the function. The default onDataRequest event handler simply returns true.
This feature might be used in conjunction with the paging feature, especially when using the "endless-scroll" paging mode, to avoid the exhaustion of remaining Twitter API calls, before the rate limit is reached. The stats parameter contains statistical infos and counters that you can examine to base your decision whether to return true or false.
Default value: defaultOnDataRequestHandler
Since: 1.2.0

onRateLimitDataHandler

Is called each time the plugin retrieved the rate limit data from Twitter. The actual rate limit data is contained in the stats object. The default onRateLimitData event handler does nothing.
Default value: defaultOnRateLimitDataHandler
Since: 1.2.0

Changelog

V1.3.1

Bugfix: Fixed an issue with tweets loaded in auto-refreshing mode might have wrong tweet-id. Thanks to Aaron Markie!

V1.3.0

Feature: Added support for I18N ('en' and 'de' resources supplied).
Feature: Added support for Twitter's Web Intents (Reply, Retweet, Favorite tweets).
Feature: Added support for users' favorite tweets.
Feature: Added configuration option locale.
Feature: Added configuration option showTweetFeed.autoConformToTwitterStyleguide (Sets options to confirm to Twitter's styleguide regulations).
Feature: Added configuration option showTweetFeed.showTwitterBird (Show/hide Twitter bird icon beneath the timestamp of a tweet, linking to the tweeter's MiniProfile Web Intent).
Feature: Added configuration option showTweetFeed.showActionReply (Show tweet's 'Reply' action: supplies a link to popup the tweet's Reply Web Intent).
Feature: Added configuration option showTweetFeed.showActionRetweet (Show tweet's 'Retweet' action: supplies a link to popup the tweet's Retweet Web Intent).
Feature: Added configuration option showTweetFeed.showActionFavorite (Show tweet's 'Favorite' action (supplies a link to popup the tweet's Favorite Web Intent).
Feature: Added configuration option tweetDataProvider.
Feature: Added configuration option rateLimitDataProvider.
Feature: Added configuration option tweetTwitterBirdDecorator.
Feature: Added configuration option tweetActionsDecorator.
Feature: Added configuration option tweetActionReplyDecorator.
Feature: Added configuration option tweetActionRetweetDecorator.
Feature: Added configuration option tweetActionFavoriteDecorator.
Bugfix: Fixed an issue with showing duplicate tweets in the feed while using the autorefresh: { mode: 'trigger-insert' } feature. Thanks to Adam Southorn!
Bugfix: Fixed an issue to prevent interference with the standard widgets.js file for the Tweet button. Thanks to Brad Beebe!
Bugfix: Fixed an issue with handling auto linking of @username and email addresses. Thanks to Brad Beebe!
Bugfix: The retweeter's screen name was not displayed correctly.
Test: 100+ Unit tests added, based on QUnit (Javascript Unit Testing Framework).

V1.2.1

Feature: Support for Twitter's change to string representations of tweet IDs (Snowflake). Twitter will switch to their new ID generator using 64bit unsigned integers on 26th November 2010.
You should update jTweetsAnywhere to V1.2.1 before this date.

V1.2.0

Feature: Support for auto-refreshing tweet feeds to build realtime/live tickers.
Feature: Support for several paging modes to show more tweets (mode: 'more' | 'prev-next' | 'endless-scroll').
Feature: Native retweets support.
Feature: Tweet filter support.
Feature: Element visualizer support.
Feature: Event handler support.
Feature: Value formatter support.
Feature: Tweets cache support to minimize rate-limited Twitter API calls.
Feature: Taking care of Twitter's rate limit when loading data from Twitter.
Feature: Added configuration option showTweetFeed.showTimestamp (show/hide/auto-refresh a tweet's timestamp').
Feature: Added configuration option showTweetFeed.showProfileImages (show/hide a user's profile image').
Feature: Added configuration option showTweetFeed.showUserScreenNames (show/hide a user's screen name').
Feature: Added configuration option showTweetFeed.showUserFullNames (show/hide a user's full name.
Feature: Added configuration option showTweetFeed.showGeoLocation (show/hide a tweet's geolocation attribute).
Feature: Added configuration option showTweetFeed.showInReplyTo (show/hide a tweet's in-reply-to attribute).
Feature: Added configuration option tweetUsernameDecorator.
Feature: Added configuration option tweetGeoLocationDecorator.
Feature: Added configuration option tweetInReplyToDecorator.
Feature: Added configuration option tweetRetweeterDecorator.
Feature: Added configuration option tweetFeedControlsDecorator.
Feature: Added configuration option tweetFeedControlsMoreBtnDecorator.
Feature: Added configuration option tweetFeedControlsPrevBtnDecorator.
Feature: Added configuration option tweetFeedControlsNextBtnDecorator.
Feature: Added configuration option tweetFeedAutorefreshTriggerDecorator.
Feature: Added configuration option tweetFeedAutorefreshTriggerContentDecorator.
Feature: Added configuration option noDataDecorator.
Feature: Added configuration option tweetTimestampFormatter.
Feature: Added configuration option tweetTimestampTooltipFormatter.
Feature: Added configuration option tweetVisualizer.
Feature: Added configuration option loadingIndicatorVisualizer.
Feature: Added configuration option autorefreshTriggerVisualizer.
Feature: Added configuration option onDataRequestHandler.
Feature: Added configuration option onRateLimitDataHandler.
Cleanup: tweetProfileImagePresent is deprecated now. Use showTweetFeed.showProfileImages instead.

V1.1.0

Feature: Added the tweet's permalink to it's timestamp.
Feature: Added configuration option showTweetFeed.showSource (show a tweet's source ("via") attribute).
Feature: Added configuration option showTweetFeed.expandHovercards (initially show hovercards expanded).
Feature: Added configuration option tweetAttributesDecorator.
Feature: Added configuration option tweetSourceDecorator.
Feature: Added configuration option errorDecorator.
Cleanup: Removed the generation of the <img> element attributes. [width="48" height="48" border="0"]. in defaultTweetProfileImageDecorator and defaultLoginInfoContentDecorator. Width and height are now controlled in the jTweetsAnywhere CSS.

V1.0.1

Fixed an IE issue with parsing the tweet timestamp.

V1.0.0

Initial release.

License

jTweetsAnywhere is licensed under the MIT license.

Support

In case of questions, suggestions or problems you may have using jTweetsAnywhere, you can contact me.
There are several ways to get in touch.

If you are interested in helping to enhance the plugin's I18N support and can provide translations for additional languages, please let me know.