WordPress.org

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:
  • screen_name = Twitter user name
  • url = Twitter user URL. If screen_name is empty and this link is valid, screen_name will be set to the user name included in url
  • search = a term to search for
• 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 = any of the options listed on the jQuery.cycle website - default is 'scrollUp'
  • 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' or 'bottom' (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'