WordPress.org

1. Unpack the zip file and upload the thinktwit folder to the /wp-content/plugins/ directory, or download through the Plugins menu in WordPress

2. Activate the plugin through the Plugins menu in WordPress

Updates are automatic. Click on Upgrade Automatically if prompted from the admin menu. If you ever have to manually upgrade, simply replace the files with those from the new version.

Configuring widget

1. Go to Appearance and then Widgets and drag ThinkTwit to your sidebar

2. Fill in the options as required and then save

Configuring shortcode

ThinkTwit can be used in any page or post, or anywhere else configured to use shortcodes, using the following syntax:

[thinktwit 
  unique_id=x 
  usernames="xxx yyy" 
  username_suffix="xxx" 
  limit=x (int)
  max-days=x (int: 1 to 7)
  update_frequency=x (int: -1 live (cached), 0 live (cached, otherwise enter an integer for the number of hours between updates)
  show_author=none|name|username 
  show_avatar=1|0 
  show_published=1|0 
  links_new_window=1|0 
  no_cache=1|0 
  use_curl=1|0 
  debug=1|0 
  time_this_happened="xxx" 
  time_less_min="xxx" 
  time_min="xxx" 
  time_more_mins="xxx" 
  time_1_hour="xxx" 
  time_2_hours="xxx" 
  time_precise_hours="xxx" 
  time_1_day="xxx" 
  time_2_days="xxx" 
  time_many_days="xxx" 
  time_no_recent="xxx"
 ]

Configuring Output Anywhere

ThinkTwit can be called within templates and other areas where you can use PHP using the following syntax:

<?php $args = array(
    'unique_id'          => 0,
    'usernames'          => "stephenpickett",
    'username_suffix'    => " said: ",
    'limit'              => 5,
    'max_days'           => 7,
    'update_frequency'   => 0,
    'show_author'      => "name",
    'show_avatar'        => 1,
    'show_published'     => 1,
    'links_new_window'   => 1,
    'no_cache'           => 0,
    'use_curl'           => 0,
    'debug'              => 0,
    'time_this_happened' => "This happened ",
    'time_less_min'      => "less than a minute ago",
    'time_min'           => "about a minute ago",
    'time_more_mins'     => " minutes ago",
    'time_1_hour'        => "about an hour ago",
    'time_2_hours'       => "a couple of hours ago",
    'time_precise_hours' => "about =x= hours ago",
    'time_1_day'         => "a day ago",
    'time_2_days'        => "almost 2 days ago",
    'time_many_days'     => " days ago",
    'time_no_recent'     => "There have been no recent tweets");

    echo ThinkTwit::output_anywhere($args); ?>

unique_id: integer - You should give this a unique id for caching or styling.

usernames: string - The list of Twitter usernames to output tweets for.

username_suffix: string - The text that should appear after a username e.g. " said: ".

limit: int - The maximum number of tweets to display.

max_days: int - The maximum age in days of the tweets to be displayed.

update_frequency: int - Minus 1 indicates live (uncached), 0 indicates live (cached), and anything else indicates the number of hours between getting updates from Twitter.

show_author: string - None indicates no username should be shown, name indicates the user's full name should be shown and username indicates the user's username should be shown.

show_avatar: boolean - Indicates whether the Twitter user's avatar should be displayed - 1 for true and 0 for false.

show_published: boolean - Indicates whether the time the tweet was made should be displayed e.g. "This happened a day ago" - 1 for true and 0 for false.

links_new_window: boolean - Indicates whether links should be opened in a new window - 1 for true and 0 for false.

no_cache: boolean - Indicates whether or not to use no-caching - 1 for true and 0 for false.

use_curl: boolean - Indicates whether or not to use CURL - 1 for true and 0 for false.

debug: boolean - Indicates whether to turn on debugging mode - 1 for true and 0 for false.

time_this_happened: string - Time prefix (default: "This happened").

time_less_min: string - Time less than 1 minute (default: "less than a minute ago").

time_min: string - Time approximately 1 minute ago (default: "about a minute ago").

time_more_mins: string - Time more than 1 minute ago (default: " minutes ago").

time_1_hour: string - Time approximately 1 hour ago (default: "about an hour ago").

time_2_hours: string - Time approximately 2 hours ago (default: "a couple of hours ago").

time_precise_hours: string - Time more than 2 hours ago (default: "about =x= hours ago"). NOTE: =x= should be used to insert the number of hours.

time_1_day: string - Time approximately 1 day ago (default: "a day ago").

time_2_days: string - Time approximately 2 days ago (default: "almost 2 days ago").

time_many_days: string - Time more than 2 days ago (default: " days ago").

time_no_recent: string - Output when there are no tweets to display (default: "There have been no recent tweets").

NOTE: You can leave out any parameter to use the default, but be aware to change the unique id if you are using Output Anywhere in more than one place.