WordPress.org

Ready to get started?Download WordPress

Plugin Directory

ThinkTwit

Outputs tweets from any Twitter users, hashtag or keyword through the Widget interface. Can be called via shortcode or PHP function call and supports

Obtaining a Twitter authentication key

  1. Go to https://dev.twitter.com/apps/new

  2. Login using your standard Twitter credentials

  3. Complete the form:

  • Name: ThinkTwit - [site name]
  • Description: ThinkTwit plugin
  • Website: [url of your website]
  • Callback URL: [url of your website]
  1. Make a note of your "Consumer key" and "Consumer secret"

Installing plugin

  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

  3. Ensure the images directory exists in the thinktwit folder with 777 permissions

  4. Navigate to Settings->ThinkTwit from the WordPress Dashboard

  5. Enter the "Consumer key" and "Consumer secret" obtained earlier and save your settings

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 
  widget_id=x 
  usernames="xxx yyy" 
  hashtags="xxx" 
  username_suffix="xxx" 
  limit=x (int)
  max_days=x (int: 1 to 7)
  update_frequency=x (int: -1 live (uncached), 0 live (cached, otherwise enter an integer for the number of hours between updates)
  show_username=none|name|username 
  show_avatar=1|0 
  show_published=1|0 
  show_follow=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(
    'widget_id'          => 0,
    'usernames'          => "stephenpickett",
    'hashtags'           => "thinktwit",
    'username_suffix'    => " said: ",
    'limit'              => 5,
    'max_days'           => 7,
    'update_frequency'   => 0,
    'show_username'      => "name",
    'show_avatar'        => 1,
    'show_published'     => 1,
    'show_follow'        => 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); ?>

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

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

hashtags: string - The list of hashtags 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_username: 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.

show_follow: boolean - Indicates whether or not to show a "Follow @username" link for each username.

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.

Requires: 2.8.6 or higher
Compatible up to: 3.9.2
Last Updated: 2014-4-16
Downloads: 8,056

Ratings

3 stars
3.7 out of 5 stars

Support

1 of 1 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,2,2 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,2,2 100,1,1
100,2,2
100,1,1 100,1,1
100,1,1 100,2,2
100,1,1 100,1,1 67,3,2
100,1,1
100,1,1 100,1,1
33,3,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,1,1 100,1,1
100,1,1
100,1,1
100,1,1 0,1,0
100,1,1