=== Twitter Tracker === Contributors: simonwheatley, codeforthepeople Donate link: http://www.simonwheatley.co.uk/wordpress/ Tags: twitter, tweet, twitter search, hashtag, summize Requires at least: 2.8.5 Tested up to: 3.3.2 Stable tag: 2.4 Track Twitter search results, a Twitter hashtag, or a Twitter profile using sidebar widgets. == Description == A widget, Twitter Search Tracker, which allows you to specify and display a [Twitter search](http://search.twitter.com/) (or a Twitter hashtag) in your sidebar. Twitter searches are [very flexible](http://search.twitter.com/operators), and you can display anything from Hashtags to individual, or aggregated Twitter streams. Another widget, Twitter Profile Tracker, allows you to show the tweets from a specific user in your sidebar. == 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_allowed_post_types 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](http://urbangiraffe.com/) for the code which allows this magic to happen. Plugin initially produced on behalf of [WordCamp UK, 2009](http://wordcamp.org.uk). Initial version 2 development funded by SamFry Ltd. Is this plugin lacking a feature you want? I'm happy to accept offers of feature sponsorship: [contact me](http://www.simonwheatley.co.uk/contact-me/) and we can discuss your ideas. Any issues: [contact me](http://www.simonwheatley.co.uk/contact-me/). == Installation == The plugin is simple to install: 1. Download `twitter-tracker.zip` 1. Unzip 1. Upload `twitter-tracker` directory to your `/wp-content/plugins` directory 1. Go to the plugin management page and enable the plugin 1. Give yourself a pat on the back == Change Log == = v2.4 = * BUGFIX: Call metaboxes from add_meta_boxes action, as they should be * ENHANCEMENT: Add generic filter tt_cache_duration to control all cache durations * ENHANCEMENT: Add tt_search_cache_duration to control Twitter Search Tracker cache duration, overrides generic cache filter * ENHANCEMENT: Add tt_profile_cache_duration to control Twitter Profile Tracker cache duration, overrides generic cache filter * BUGFIX: Avoid notices by checking if variabless are set before using them when creating widgets in admin area = v2.3 = * SECURITY: Tightened up on the escaping and filtering of content received from Twitter, just in case. * BUGFIX: Don't throw exceptions when we hit an HTTP error (not helpful on production sites) * BUGFIX: Now accessing the non-HTMLified version of the tweets in a search, then adding the links manually as this seems more reliable. * BUGFIX: Fix 'Undefined variable' PHP Notices when WP_DEBUG is set to true. * TWEAK: Set a default for the mandatory hashtag arg for TwitterSearch __construct = v2.2 2011/05/13 = * ENHANCEMENT: Adds a Twitter Profile Tracker widget, which shows the tweets from just one user. * ENHANCEMENT: Specify a "Mandatory Hashtag" to filter out any tweets which don't have a particular hashtag (e.g. "#show_on_front_page") = v2.12 2009/10/27 = * ENHANCEMENT: Adds the ability to enter a local query for each individual page and post, this local query overrides the query entered on the widgets screen * ENHANCEMENT: Use the new (to me) Twitter profile pic API to get the images * BUGFIX: Use the new (to me) Twitter profile pic API to get the images * BUGFIX: May have stomped the -1 year ago problem, where tweets were showing as tweeted -1 years ago. = v2.11 2009/10/27 = * ARGH: Version numbers getting confused, so I'm trying this renumbering to hopefully cut through that confusion. = v2.1 2009/10/13 = * BUGFIX: Default template now doesn't throw a PHP error. Oops! * ENHANCEMENT: Default template now uses Twit name, rather than the "twitter username (actual name)" format * BUGFIX: URL encoded the query, so now works with spaces in the query = v2.01 2009/07/12 = * Now allows the assignment of an individual class to each instance of the widget, good for styling your different Tweet streams to differentiate between them. = v2.00 2009/05/11 = * Now using the all new WordPress 2.8 widget capabilities, soooo much easier. * Various internal massaging. * ENHANCEMENT: You can now hide @ replies. * ENHANCEMENT: You can now add text after the results (e.g. for a link to the Twitter search you are using) = v1.41 2009/04/20 = * ENHANCEMENT: Added a class "preamble" to the P element containing the preamble. * BUGFIX: Slashes no longer breed and multiply in the title, preamble and search. = v1.4 2009/04/20 = * ENHANCEMENT: Added class "twitter-tracker" to the widget. * ENHANCEMENT: Added a description to show in the widget admin page. = v1.3 2009/04/10 = * ENHANCEMENT: Now you can specify the number of Tweets in the widget config. = v1.2 2009/04/10 = * FIX: Bug with time since information, now replaced with an i18n local date. = v0.90b 2009/03/03 = * RELEASE: Version 0.90b == Screenshots == 1. Showing the widget settings 2. Showing the unstyled output (use your own CSS to make this look as you wish)