=== Rotating Tweets widget and shortcode === Contributors: mpntod Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=9XCNM4QSVHYT8 Tags: shortcode,widget,twitter,rotating,rotate,rotator,tweet,tweets Requires at least: 2.6 Tested up to: 3.4 Stable tag: 0.44 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Replaces a shortcode such as [rotatingtweets screen_name='your_twitter_name'], or a widget, with a rotating tweets display == Description == * Replaces a [shortcode](http://codex.wordpress.org/Shortcode) such as `[rotatingtweets screen_name='your_twitter_name']`, or a [widget](http://codex.wordpress.org/WordPress_Widgets), with a rotating display of your most recent tweets * Space efficient - instead of showing all your tweets at once, shows one at a time and then smoothly replaces it with the next one. After showing all your tweets, loops back to the beginning again. * Customisable - you decide whose tweets to show, how many to show, whether to include retweets and replies, and whether to show a follow button. You can also decide how quickly the tweets rotate. * Replaces [t.co](http://t.co) links with the original link * Caches the most recent data from Twitter to avoid problems with rate limiting * Uses [jQuery](http://jquery.com/) and [jQuery.Cycle](http://jquery.malsup.com/cycle/) to produce a nice smooth result. If you'd like to see what it looks like in action, you can [see the plug-in working here](http://www.martintod.org.uk/2012/05/29/new-twitter-plugin-to-show-tweets-in-rotation/). == Installation == 1. Upload the contents of `rotatingtweets.zip` to the `/wp-content/plugins/` directory or use the Wordpress installer 1. Activate the plugin through the 'Plugins' menu in WordPress 1. Place a shortcode such `[rotatingtweets screen_name='mpntod']` in your post or page, or use a widget Possible variables for the shortcode include: * `screen_name` = Twitter user name - required * `include_rts` = `'0'` or `'1'` - include retweets - optional - default is `'0'` * `exclude_replies` = `'0'` or `'1'` - exclude replies - optional - default is `'0'` * `tweet_count` = number of tweets to show - optional - default is `5` * `show_follow` = `'0'` or `'1'` - show follow button - optional - default is `'0'` * `timeout` = time that each tweet is shown in milliseconds - optional - default is `'4000'` (i.e. 4 seconds) But you may just decide to use the 'Rotating Tweets' widget! == Frequently Asked Questions == = How often does the plug-in call Twitter = In most cases, each use (or "instance") of this plug-in gets data from Twitter every 2 minutes. The exception is when two or more instances share the same settings (screen name etc.), in which case they share the same data rather than each calling it separately. == Upgrade notice == = 0.44 = Includes fix for the major bug causing crashes when Twitter goes down. Also improved error checking if Twitter has returned an empty value. == Changelog == = 0.44 = Removes follow button if Twitter has returned an empty value = 0.43 = Improved error checking if Twitter has returned an empty value = 0.42 = Fixed major bug causing crashes when Twitter goes down = 0.40 = Added ability to alter speed of rotation = 0.30 = Fixes bug - problem with `get_object_vars()` on line 193 = 0.29 = Better handling of retweets. No longer cuts off the end of the text on longer RTs. = 0.28 = Properly fixes flaw in how flags are handled. = 0.27 = Fixed flaw in how flags are handled. = 0.26 = Stops display and cacheing of non-existent twitter feeds = 0.25 = Stops display and cacheing of faulty twitter feeds = 0.21 = Replaced a missing `` in the follow-button code (with thanks to [jacobp](http://wordpress.org/support/profile/jacobp) for spotting it and suggesting a fix) = 0.2 = Fixed a problem with cacheing = 0.1 = First published version == Screenshots == 1. This animation is slightly faster than the default setting, but gives a sense of what you get: 2. You can add rotating tweets to a post like this: 3. Or add them via a widget: