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 - 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
    • 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)
  • Display options
    • official_format = '1' or '2' - show official format - optional - default is '0'
    • timeout = time that each tweet is shown in milliseconds - optional - default is '4000' (i.e. 4 seconds)
    • 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'
    • url_length = sets the length that the URL should be trimmed to...
    • show_meta_timestamp = '0' or '1' - show the time and date of each tweet - optional - default is '1'
    • show_meta_screen_name = '0' or '1' - show who posted each tweet - optional - default is '1'
    • show_meta_via = '0' or '1' - show how each tweet was posted - optional - default is '1'
    • show_meta_reply_retweet_favorite = '0' or '1' - show 'reply', 'retweet' and 'favorite' buttons - optional - 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 - optional - 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' or 'tweets' (default 'top')
  • Twitter follow button
    • show_follow = '0' or '1' - show follow button - optional - default is '0'
    • no_show_count = '0' or '1' - remove the follower count from the Twitter follow button - optional - default is '0'
    • no_show_screen_name = '0' or '1' - remove the screen name from the Twitter follow button - optional - default is '0'

Requires: 2.6 or higher
Compatible up to: 3.9
Last Updated: 2014-4-17
Downloads: 133,313

Ratings

4 stars
4.8 out of 5 stars

Support

17 of 19 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