jTweetsAnywhere

jQuery Twitter Widget with @Anywhere support

June 13th, 2013

jTweetsAnywhere stopped working since Twitter moved from API Version 1.0 to 1.1 and now turned off V1.0.

Due to personal reasons I was not able to work on my open source projects for the last 5 months. Therefor I couldn't update the plugin in time nor answer all your emails and requests. I really apologize for this.

I will try to supply a new release within the next weeks.

Since Twitter now requires applications to authenticate ALL requests with OAuth 1.0a or Application-only authentication the next version of jTweetsAnywhere will consist of the well-known client-side (updated) JavaScript and a server-side component (written in PHP). That means for all users of the plugin that you have to update the client-side script and supply the PHP script on your server.

Thanks for your understanding,
Thomas

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
serhanbuy

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

@serhanbuy

thepinto

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

@thepinto

ajconsultingme

"Fantastic Thomas!! love it"

@ajconsultingme

aymericlamboley

"jTweetsAnywhere is an awesome jquery plugin for twitter"

@aymericlamboley

websitemagazine

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

@websitemagazine

joeyignorant

"#jTweetsAnywhere best twitter jquery plugin ive seen"

@joeyignorant

twthosting

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

@twthosting

neilcamm

"jTweetsAnywhere by @tbillenstein is bad ass!"

@neilcamm

lizziebowgirl

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

@lizziebowgirl

nrambeck

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

@nrambeck

aqlong

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

@aqlong

atl

"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

twEPICy

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

@twEPICy

lazymanc

"thanks for the excellent #jTweetsAnywhere"

@lazymanc

the_Jasser

"Awesome customizable jquery Twitter widget from jTweetsAnywhere"

@the_Jasser

jlmurgas

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

@jlmurgas

jamieflournoy

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

@jamieflournoy

ecagriffiths

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

@ecagriffiths

conishiwa

"#jTweetsAnywhere j'adore ce site !"

@conishiwa

olamalu

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

@olamalu

denie72

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

@denie72

FormThis

"#jTweetsAnywhere is awesome"

@FormThis

beacrea

"Great realtime jquery twitter pull"

@beacrea

govindarajan78

"#jTweetsAnywhere this is cool"

@govindarajan78

ipankvision

"#jTweetsAnywhere wow, its so amazing"

@ipankvision

N8Friedrichsen

"#jTweetsAnywhere is amazing"

@N8Friedrichsen

ruudgreven

"jTweetsAnywhere is very nice!"

@ruudgreven

EvokeArtDesign

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

@EvokeArtDesign

philsniff

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

@philsniff

JamesisaPayne

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

@JamesisaPayne

guillaumepiot

"A great way to include Tweets on your webpages"

@guillaumepiot

rothkj1022

"Thanks, #jTweetsAnywhere is awesome"

@rothkj1022

JADDL_Commish

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

@JADDL_Commish

aboxcreative

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

@aboxcreative

shauntrennery

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

@shauntrennery

LingoLWL

"Thanks for the great script!"

@LingoLWL

wjdennen

"jTweetsAnywhere is pretty awesome."

@wjdennen

JonnyMcAwesome

"#jTweetsAnywhere this is cool"

@JonnyMcAwesome

lembit

"thanks, jTweetsAnywhere is a great jQuery plugin."

@lembit

html5_newbie

"#jTweetsAnywhere This Plugin is great"

@html5_newbie

Gabizouari

"amazing jtweet libs"

@Gabizouari

Hamtaro

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

@Hamtaro

circa3000

"Nice work!"

@circa3000

AldoForce

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

@AldoForce

thadbloom

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

@thadbloom

kokmok

"Hi, nice plugin #jTweetsAnywhere :)"

@kokmok

mikehibm_eng

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

@mikehibm_eng

aamiraarfi

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

@aamiraarfi

weboptimum

"Great twitter integration...."

@weboptimum

cajebo

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

@cajebo

lancelarsen

"Working with jTweetsAnywhere library - Awesome plugin!"

@lancelarsen

ppalavilli

"like this #jTweetsAnywhere"

@ppalavilli

GilFredy

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

@GilFredy

Current Release: V1.3.1
 
 
 

Features

Feature 1
Feature 2
Feature 3
Feature 4
  • 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.

 
Current Release: V1.3.1
 

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

<head>
<script type="text/javascript" src="jquery-1.7.1.min.js"></script>
<script type="text/javascript" src="jquery.jtweetsanywhere-1.3.1.min.js"></script>
<script type="text/javascript" src="jtweetsanywhere-de-1.3.1.min.js"></script>
<script type="text/javascript" src="http://platform.twitter.com/anywhere.js?id=APIKey&v=1"></script>
<link rel="stylesheet" type="text/css" href="jquery.jtweetsanywhere-1.3.1.css" />
</head>

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.

 

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.

 

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
 
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
 
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
 
 
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.

JavaScript Array pop