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