Plugin Directory

Test out the new Plugin Directory and let us know what you think.
!This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Twitter Tracker

Track Twitter search results, a Twitter hashtag, or a Twitter profile using sidebar widgets.

Other notes

The plugin puts "Twitter Tracker" fields in the post and page screens, you can enter a specific query into this metabox and this will override the query entered on the widget editor... this means you can have individual Twitter search queries in the widget for each of your posts and pages. If you enter nothing in those fields then the widget will use the Twitter search query on the widget editor screen. (Developers, you can add this metabox to custom post types although you will need to use the tt_post_types_with_override filter to get the metabox fields to save... check out the code.)

The HTML output is fairly well classed, but if you need to adapt it you can. Create a directory in your theme called "view", and a directory within that one called "category-images-ii". Then copy the template files view/twitter-tracker/widget-content.php and view/twitter-tracker/widget-error.php from the plugin directory into your theme directory and amend as you need. If these files exist in these directories in your theme they will override the ones in the plugin directory. This is good because it means that when you update the plugin you can simply overwrite the old plugin directory as you haven't changed any files in it. All hail John Godley for the code which allows this magic to happen.

Filters and actions

These notes mainly for developers:


filters – Use this to change the Twitter Avatar URLs provided to the template. The Twitter Tracker Avatar Cache partner plugin uses these filters to provide cookie stripping caching for these avatars.

(NOTE: The tt_avatar_bigger_url filter no longer exists, as I cannot find a way to access larger icons with the Twitter API.)


filter – Add or remove post types which can override the search query in a search widget.


filter – WARNING – incorrect use of this filter could make your website vulnerable to cross-site scripting attacks; if in doubt, do not use it. Amend the HTML elements and attributes allowed in the preamble and HTML after values. This filter passes a second param specifying the context the allowed HTML is for.


filter – The default cache for each widget is 300 seconds. Hook this filter to change this, but do not lower it too much on busy sites as you'll run out of API accesses and your site will be slower.


filter – The string displayed in the search widget when no tweets are found. The second parameter passed is the search string being used, and the third parameter is an array of other variables relating to this widget and search request.


Provenance and plans

Plugin initially produced on behalf of WordCamp UK, 2009. Initial version 2 development funded by SamFry Ltd.

Any issues: contact me.

Development for this plugin is hosted on Github, feel free to fork and submit issues there.

= Installation:


  1. Download twitter-tracker.zip
  2. Unzip
  3. Upload twitter-tracker directory to your /wp-content/plugins directory
  4. Go to the plugin management page and enable the plugin
  5. Now go through the authorisation steps below


  1. From your admin area, choose "Plugins" then "Add New"
  2. Search for "Twitter Tracker"
  3. Select "Install Now"
  4. Give yourself a pat on the back
  5. Now go through the authorisation steps below

= Authorisation:


  1. Go to "Settings" > "Twitter Tracker Auth"
  2. Click on "Authorise with Twitter" and follow the prompts

Requires: 3.1.0 or higher
Compatible up to: 3.5.2
Last Updated: 3 years ago
Active Installs: 3,000+


4.7 out of 5 stars


Got something to say? Need help?


Not enough data

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

100,1,1 100,1,1
100,1,1 0,1,0 100,1,1
100,1,1 100,2,2