1// jquery.tweet.js - See http://tweet.seaofclouds.com/ or https://github.com/seaofclouds/tweet for more info 2// Copyright (c) 2008-2012 Todd Matthews & Steve Purcell 3(function (factory) { 4 if (typeof define === 'function' && define.amd) { 5 define(['jquery'], factory); 6 } // AMD support for RequireJS etc. 7 else { 8 factory(jQuery); 9 } 10}(function ($) { 11 $.fn.tweet = function (o) { 12 var s = $.extend({ 13 username: null, // [string or array] required unless using the 'query' option; one or more twitter screen names (use 'list' option for multiple names, where possible) 14 list: null, // [string] optional name of list belonging to username 15 favorites: false, // [boolean] display the user's favorites instead of his tweets 16 query: null, // [string] optional search query (see also: http://search.twitter.com/operators) 17 avatar_size: null, // [integer] height and width of avatar if displayed (48px max) 18 count: 3, // [integer] how many tweets to display? 19 fetch: null, // [integer] how many tweets to fetch via the API (set this higher than 'count' if using the 'filter' option) 20 page: 1, // [integer] which page of results to fetch (if count != fetch, you'll get unexpected results) 21 retweets: true, // [boolean] whether to fetch (official) retweets (not supported in all display modes) 22 intro_text: null, // [string] do you want text BEFORE your your tweets? 23 outro_text: null, // [string] do you want text AFTER your tweets? 24 join_text: null, // [string] optional text in between date and tweet, try setting to "auto" 25 auto_join_text_default: " I said, ", // [string] auto text for non verb: "I said" bullocks 26 auto_join_text_ed: " I ", // [string] auto text for past tense: "I" surfed 27 auto_join_text_ing: " I am ", // [string] auto tense for present tense: "I was" surfing 28 auto_join_text_reply: " I replied to ", // [string] auto tense for replies: "I replied to" @someone "with" 29 auto_join_text_url: " I was looking at ", // [string] auto tense for urls: "I was looking at" http:... 30 loading_text: null, // [string] optional loading text, displayed while tweets load 31 refresh_interval: null, // [integer] optional number of seconds after which to reload tweets 32 twitter_url: "twitter.com", // [string] custom twitter url, if any (apigee, etc.) 33 twitter_api_url: "api.twitter.com", // [string] custom twitter api url, if any (apigee, etc.) 34 twitter_search_url: "search.twitter.com", // [string] custom twitter search url, if any (apigee, etc.) 35 template: "{avatar}{time}{join} {text}", // [string or function] template used to construct each tweet <li> - see code for available vars 36 li_class: "", //list style 37 comparator: function (tweet1, tweet2) { // [function] comparator used to sort tweets (see Array.sort) 38 return tweet2.tweet_time - tweet1.tweet_time; 39 }, 40 filter: function (tweet) { // [function] whether or not to include a particular tweet (be sure to also set 'fetch') 41 return true; 42 } 43 // You can attach callbacks to the following events using jQuery's standard .bind() mechanism: 44 // "loaded" -- triggered when tweets have been fetched and rendered 45 }, o); 46 47 // See http://daringfireball.net/2010/07/improved_regex_for_matching_urls 48 var url_regexp = /\b((?:https?:\/\/|www\d{0,3}[.]|[a-z0-9.\-]+[.][a-z]{2,4}\/)(?:[^\s()<>]+|\(([^\s()<>]+|(\([^\s()<>]+\)))*\))+(?:\(([^\s()<>]+|(\([^\s()<>]+\)))*\)|[^\s`!()\[\]{};:'".,<>?«»ââââ]))/gi; 49 50 // Expand values inside simple string templates with {placeholders} 51 function t(template, info) { 52 if (typeof template === "string") { 53 var result = template; 54 for (var key in info) { 55 var val = info[key]; 56 result = result.split('{' + key + '}').join(val === null ? '' : val); 57 } 58 return result; 59 } else { 60 return template(info); 61 } 62 } 63 64 // Export the t function for use when passing a function as the 'template' option 65 $.extend({tweet: {t: t}}); 66 67 function replacer(regex, replacement) { 68 return function () { 69 var returning = []; 70 this.each(function () { 71 returning.push(this.replace(regex, replacement)); 72 }); 73 return $(returning); 74 }; 75 } 76 77 function escapeHTML(s) { 78 return s.replace(/</g, "<").replace(/>/g, "^>"); 79 } 80 81 $.fn.extend({ 82 linkUser: replacer(/(^|[\W])@(\w+)/gi, "$1<span class=\"at\">@</span><a href=\"http://" + s.twitter_url + "/$2\">$2</a>"),
83 // Support various latin1 (\u00**) and arabic (\u06**) alphanumeric chars 84 linkHash: replacer(/(?:^| )[\#]+([\w\u00c0-\u00d6\u00d8-\u00f6\u00f8-\u00ff\u0600-\u06ff]+)/gi, ' <a href="https://twitter.com/search?q=%23$1&lang=all' + ((s.username && s.username.length === 1 && !s.list) ? '&from=' + s.username.join("%2BOR%2B") : '') + '" class="tweet_hashtag">#$1</a>'), 85 makeHeart: replacer(/(<)+[3]/gi, "<tt class='heart'>♥</tt>") 86 }); 87 88 function linkURLs(text, entities) { 89 return text.replace(url_regexp, function (match) { 90 var url = (/^[a-z]+:/i).test(match) ? match : "http://" + match; 91 var text = match; 92 for (var i = 0; i < entities.length; ++i) { 93 var entity = entities[i]; 94 if (entity.url === url && entity.expanded_url) { 95 url = entity.expanded_url; 96 text = entity.display_url; 97 break; 98 } 99 } 100 return "<a href=\"" + escapeHTML(url) + "\">" + escapeHTML(text) + "</a>"; 101 }); 102 } 103 104 function parse_date(date_str) { 105 // The non-search twitter APIs return inconsistently-formatted dates, which Date.parse 106 // cannot handle in IE. We therefore perform the following transformation: 107 // "Wed Apr 29 08:53:31 +0000 2009" => "Wed, Apr 29 2009 08:53:31 +0000" 108 return Date.parse(date_str.replace(/^([a-z]{3})( [a-z]{3} \d\d?)(.*)( \d{4})$/i, '$1,$2$4$3')); 109 } 110 111 function extract_relative_time(date) { 112 var toInt = function (val) { 113 return parseInt(val, 10); 114 }; 115 var relative_to = new Date(); 116 var delta = toInt((relative_to.getTime() - date) / 1000); 117 if (delta < 1) { 118 delta = 0; 119 } 120 return { 121 days: toInt(delta / 86400), 122 hours: toInt(delta / 3600), 123 minutes: toInt(delta / 60), 124 seconds: toInt(delta) 125 }; 126 } 127 128 function format_relative_time(time_ago) { 129 if (time_ago.days > 2) { 130 return 'about ' + time_ago.days + ' days ago'; 131 } 132 if (time_ago.hours > 24) { 133 return 'about a day ago'; 134 } 135 if (time_ago.hours > 2) { 136 return 'about ' + time_ago.hours + ' hours ago'; 137 } 138 if (time_ago.minutes > 45) { 139 return 'about an hour ago'; 140 } 141 if (time_ago.minutes > 2) { 142 return 'about ' + time_ago.minutes + ' minutes ago'; 143 } 144 if (time_ago.seconds > 1) { 145 return 'about ' + time_ago.seconds + ' seconds ago'; 146 } 147 return 'just now'; 148 } 149 150 function build_auto_join_text(text) { 151 if (text.match(/^(@([A-Za-z0-9-_]+)) .*/i)) { 152 return s.auto_join_text_reply; 153 } else if (text.match(url_regexp)) { 154 return s.auto_join_text_url; 155 } else if (text.match(/^((\w+ed)|just) .*/im)) { 156 return s.auto_join_text_ed; 157 } else if (text.match(/^(\w*ing) .*/i)) { 158 return s.auto_join_text_ing; 159 } else { 160 return s.auto_join_text_default; 161 } 162 } 163 164 function build_api_url() { 165 return s.twitter_api_url; 166 } 167 168 function extract_avatar_url(item, secure) { 169 if (secure) { 170 return ('user' in item) ? item.user.profile_image_url_https : extract_avatar_url(item, false).replace(/^http:\/\/[a-z0-9]{1,3}\.twimg\.com\//, "https://s3.amazonaws.com/twitter_production/"); 171 } else { 172 return item.profile_image_url || item.user.profile_image_url; 173 } 174 } 175 176 // Convert twitter API objects into data available for 177 // constructing each tweet <li> using a template 178 function extract_template_data(item) { 179 var o = {}; 180 o.item = item; 181 o.source = item.source; 182 o.screen_name = item.from_user || item.user.screen_name; 183 // The actual user name is not returned by all Twitter APIs, so please do not 184 // file an issue if it is empty: 185 o.name = item.from_user_name || item.user.name; 186 o.retweet = typeof(item.retweeted_status) != 'undefined'; 187 188 o.tweet_time = parse_date(item.created_at); 189 o.join_text = s.join_text === "auto" ? build_auto_join_text(item.text) : s.join_text; 190 o.tweet_id = item.id_str; 191 o.twitter_base = "http://" + s.twitter_url + "/"; 192 o.user_url = o.twitter_base + o.screen_name; 193 o.tweet_url = o.user_url + "/status/" + o.tweet_id; 194 o.reply_url = o.twitter_base + "intent/tweet?in_reply_to=" + o.tweet_id; 195 o.retweet_url = o.twitter_base + "intent/retweet?tweet_id=" + o.tweet_id; 196 o.favorite_url = o.twitter_base + "intent/favorite?tweet_id=" + o.tweet_id; 197 o.retweeted_screen_name = o.retweet && item.retweeted_status.user.screen_name; 198 o.tweet_relative_time = format_relative_time(extract_relative_time(o.tweet_time)); 199 o.entities = item.entities ? (item.entities.urls || []).concat(item.entities.media || []) : []; 200 o.tweet_raw_text = o.retweet ? ('RT @' + o.retweeted_screen_name + ' ' + item.retweeted_status.text) : item.text; // avoid '...' in long retweets 201 o.tweet_text = $([linkURLs(o.tweet_raw_text, o.entities)]).linkUser().linkHash()[0]; 202 o.retweeted_tweet_text = $([linkURLs(item.text, o.entities)]).linkUser().linkHash()[0]; 203 o.tweet_text_fancy = $([o.tweet_text]).makeHeart()[0]; 204 205 o.avatar_size = s.avatar_size; 206 o.avatar_url = extract_avatar_url(o.retweet ? item.retweeted_status : item, (document.location.protocol === 'https:')); 207 o.avatar_screen_name = o.retweet ? o.retweeted_screen_name : o.screen_name; 208 o.avatar_profile_url = o.twitter_base + o.avatar_screen_name; 209
210 // Default spans, and pre-formatted blocks for common layouts 211 o.user = t('<a class="tweet_user" href="{user_url}">@{screen_name}</a>', o); 212 o.join = s.join_text ? t('<span class="tweet_join">{join_text}</span>', o) : ''; 213 o.avatar = o.avatar_size ? t('<a class="tweet_avatar" href="{avatar_profile_url}"><img src="{avatar_url}" height="{avatar_size}" width="{avatar_size}" alt="{avatar_screen_name}\'s avatar" title="{avatar_screen_name}\'s avatar" border="0"/></a>', o) : ''; 214 o.time = t('<span class="tweet_time"><a href="{tweet_url}" title="view tweet on twitter">{tweet_relative_time}</a></span>', o); 215 o.text = t('<span class="tweet_text">{tweet_text_fancy}</span>', o); 216 o.retweeted_text = t('<span class="tweet_text">{retweeted_tweet_text}</span>', o); 217 o.reply_action = t('<a class="tweet_action tweet_reply" href="{reply_url}">reply</a>', o); 218 o.retweet_action = t('<a class="tweet_action tweet_retweet" href="{retweet_url}">retweet</a>', o); 219 o.favorite_action = t('<a class="tweet_action tweet_favorite" href="{favorite_url}">favorite</a>', o); 220 return o; 221 } 222 223 function render_tweets(widget, tweets) { 224 var list = $('<ul class="tweet_list list-unstyled">'); 225 list.append($.map(tweets,function (o) { 226 return "<li" + (s.li_class ? ' class="' + s.li_class + '"' : '') + ">" + t(s.template, o) + "</li>"; 227 }).join('')).children('li:first').addClass('tweet_first').end().children('li:odd').addClass('tweet_even').end().children('li:even').addClass('tweet_odd'); 228 229 $(widget).append(list); 230 if (s.intro_text) { 231 list.before('<p class="tweet_intro">' + s.intro_text + '</p>'); 232 } 233 if (s.outro_text) { 234 list.after('<p class="tweet_outro">' + s.outro_text + '</p>'); 235 } 236 237 $(widget).trigger("loaded").trigger((tweets.length === 0 ? "empty" : "full")); 238 if (s.refresh_interval) { 239 window.setTimeout(function () { 240 $(widget).trigger("tweet:load"); 241 }, 1000 * s.refresh_interval); 242 } 243 } 244 245 function load(widget) { 246 var loading = $('<p class="loading">' + s.loading_text + '</p>'); 247 if (s.loading_text) { 248 $(widget).not(":has(.tweet_list)").empty().append(loading); 249 } 250 $.getJSON(build_api_url(), function (data) { 251 var tweets = $.map(data.results || data, extract_template_data); 252 tweets = $.grep(tweets, s.filter).sort(s.comparator).slice(0, s.count); 253 $(widget).trigger("tweet:retrieved", [tweets]); 254 }); 255 } 256 257 return this.each(function (i, widget) { 258 if (s.username && typeof(s.username) === "string") { 259 s.username = [s.username]; 260 } 261 262 $(widget).unbind("tweet:render").unbind("tweet:retrieved").unbind("tweet:load").bind({ 263 "tweet:load": function () { 264 load(widget); 265 }, 266 "tweet:retrieved": function (ev, tweets) { 267 $(widget).trigger("tweet:render", [tweets]); 268 }, 269 "tweet:render": function (ev, tweets) { 270 render_tweets($(widget), tweets); 271 } 272 }).trigger("tweet:load"); 273 }); 274 }; 275}));
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.