WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Rotating Tweets (Twitter widget and shortcode)

Twitter widget and shortcode to show your latest tweets one at a time an animated rotation

Installation

  1. Upload the contents of rotatingtweets.zip to the /wp-content/plugins/ directory or use the WordPress installer
  2. Activate the plugin through the 'Plugins' menu in WordPress
  3. Go to the My applications page on the Twitter website to set up your website as a new Twitter 'application'. You may need to log-in using your Twitter user name and password.
  4. If you don't already have a suitable 'application' to use for your website, set one up on the Create an Application page. It's normally best to use the name, description and website URL of the website where you plan to use Rotating Tweets. You don't need a Callback URL.
  5. After clicking Create your Twitter application, on the following page, click on Create my access token.
  6. Copy the Consumer key, Consumer secret, Access token and Access token secret from your Twitter application page into the Rotating Tweets settings page. Hit save. If there is a problem, you will see an error message.
  7. Place a shortcode such [rotatingtweets screen_name='mpntod'] in your post or page, or use a widget

Set-up

Options include:

  1. Going to the Widgets menu on the admin page and adding the Rotating Tweets widget. Options include the name of the Twitter account to show, whether to show retweets and the speed of rotation.
  2. Using the basic Rotating Tweets shortcode, for example [rotatingtweets screen_name='mpntod']
  3. Using a more complicated Rotating Tweets shortcode, for example [rotatingtweets screen_name='mpntod' include_rts='1' tweet_count='7' timeout='3000']

Shortcode variables

Possible variables for the shortcode include:

  • Required settings - at least one of the following three settings is required for the short-code to function:
  • Twitter options
    • include_rts = '0' or '1' - include retweets - default is '0'
    • exclude_replies = '0' or '1' - exclude replies - default is '0'
    • tweet_count = number of tweets to show - default is 5
    • get_favorites = '0' or '1' - show someone's favorites rather than their timeline - default is '0'
    • list = 'list-slug' - the 'slug' used by someone's list (something like my-list)
    • offset = ''number'' - default is '0' - enables you to start on a later tweet - '1' starts on the 2nd tweet, '2' starts on the 3rd tweet, etc.
  • Display options

    • official_format = '1', '2' or 'custom' - show one of the two official formats or a custom format if you have written your own rotatingtweets_display_override() function - default is '0'
    • timeout = time that each tweet is shown in milliseconds - default is '4000' (i.e. 4 seconds)
    • speed = time it takes to change from one tweet to the next in milliseconds - default is '1000' (i.e. 1 second)
    • links_in_new_window = '0' or '1' - show links in a new tab or window - default is '0'
    • rotation_type = If you are using version 1 of the JavaScript, you can use any of the options listed on the jQuery.cycle website - default is 'scrollUp'. If you are using version 2 of the JavaScript, then the options are 'scrollUp','scrollDown','scrollHorz','scrollLeft','scrollRight','toss','scrollVert','fade' and 'carousel'
      • carousel_horizontal = 0 or 1 - if you've chosen 'carousel' as a rotation type, allow horizontal scrolling - default is 0
      • carousel_count = ''number'' - if you've chosen 'carousel' as a rotation type, set the number of slides to appear in the carousel - default is 3 for vertical carousel and enough to fill the width of the page for horizontal carousel
      • carousel_responsive = 0 or 1 - if you've chosen a 'horizontal carousel' as a rotation type, makes the carousel responsive to the size of the page - default is 0
    • url_length = sets the length that the URL of links should be trimmed to... - optional
    • show_tco_link = '0' or '1' allows you to show Twitter's t.co link instead of the original link - optional
    • show_meta_timestamp = '0' or '1' - show the time and date of each tweet - default is '1'
    • show_meta_screen_name = '0' or '1' - show who posted each tweet - default is '1'
    • show_meta_via = '0' or '1' - show how each tweet was posted - default is '1'
    • show_meta_reply_retweet_favorite = '0' or '1' - show 'reply', 'retweet' and 'favorite' buttons - default is '0'
    • no_rotate = '0' or '1' - switch off rotation - default is '0'
    • show_meta_prev_next = '0' or '1' - show 'next', 'prev' links - default is '0'
      • prev = content for the prev button (default 'prev')
      • next = content for the next button (default 'next')
      • middot = content for the space between the buttons (default ' · ')
      • np_pos = position for 'next' and 'prev' buttons - 'top', 'bottom', 'insidebottom' or 'tweets' (default 'top')
    • show_media = '0' or '1' - experimental option that shows images with the tweet - default is '0'
    • screen_name_plural = '0' or '1' - experimental option that allows you to have a plural possessive in the default display format (e.g. British Lions' Twitter) - default is '0'
    • tweet_length = maximum number of characters to show in tweet - default is '0' which allows whole tweet to be shown
    • no_emoji = '0' or '1' - experimental option that removes emoji from the feed - default is '0'
  • Twitter follow button

    • show_follow = '0' or '1' - show follow button - default is '0'
    • no_show_count = '0' or '1' - remove the follower count from the Twitter follow button - default is '0'
    • no_show_screen_name = '0' or '1' - remove the screen name from the Twitter follow button - default is '0'

Requires: 2.6 or higher
Compatible up to: 3.9.2
Last Updated: 2014-8-2
Downloads: 161,458

Ratings

4 stars
4.8 out of 5 stars

Support

9 of 11 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1
100,1,1 100,1,1
100,1,1 100,1,1 100,1,1 100,1,1
100,1,1 100,1,1 100,1,1 100,2,2 100,1,1
100,5,5
100,1,1 100,3,3
100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,3,3 100,1,1 100,2,2 100,2,2 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,2,2
100,1,1 100,1,1
100,1,1
100,2,2 100,1,1
100,1,1 100,1,1
100,3,3
100,1,1 100,3,3 100,1,1
100,1,1
0,1,0
100,1,1 100,2,2 100,1,1