=== WP-TwitterSearch ===
Contributors: James Fleeting
Donate link: http://paperkilledrock.com/projects
Tags: twitter, search, widget
Requires at least: 2.6
Tested up to: 2.8
Stable tag: 1.2

Displays the latest results based on a twitter search. Options include setting multiple search terms and limiting tweets shown.

== Description ==

Displays the latest results based on a twitter search. Options include setting multiple search terms and limiting tweets shown. Use the sidebar widget or <code>&lt;?php wp_twittersearch_feed(); ?&gt;</code> in your template.

== Screenshots ==

1. WP-TwitterSearch Options Page

== Installation ==

Installing WP-TwitterSearch is as easy as any other plugin.

1. Upload `WP-TwitterSearch` to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Add the WP-TwitterSearch Widget or place `<?php wp_twittersearch_feed(); ?>` in your template
1. See the TwitterSearch menu for options.

== Frequently Asked Questions ==

= Where is the widget? =

As of v1.1 you can now use the sidebar widget to display the twittersearch feed.

= How do I display my latest tweet? =

There are a ton of great plugins that display your tweets, there was no need to create another. This plugin is for search.twitter.com only. However if you really want to use it to display your latest tweet, put your username as the 'author' and limit it to 1 and provide no search terms.

= Do I have to provide credit when using the plugin? =

Nope, you are free to use it however you like no credit needed. However, if you wish to provide a link back to this plugin there is an option to enable credit. This defaults to no, but if switched to yes a 'powered by' will show up below the plugin on your site. Again, this is default to no.

= Does it work on WordPress version x.x? =

Honestly, I have no clue. I have tested it on version 2.6, 2.7+ and 2.8 beta. I don't have installs of anything before 2.6 so it could work before that. I also don't plan to test or make it work on older versions if it doesn't. For security alone you should always be using the latest version.

= I have another question! =

Good, you can either email me at james.fleeting[at]gmail.com or post in the wordpress forums. I'm always browsing around.

== Future Plans ==

1. Add the remaining search.twitter advanced fields. [planned v1.3]
1. Add option to display users profile picture with tweet [planned v1.3]
1. Add support for wordpress shortcode (used in posts/pages) [planned v1.3]
1. Add support for multiple widgets (setting options in widget pane) [planned v1.4]
1. Along with multiple widgets will be multiple template tags (passing options through them) [planned v1.4]
1. Display results from your username and tags/category from a wordpress post (like a ‘related’ tweets to this post)

== Change Log ==

* v1.2 (5/26/2009) - Added date and source to each tweet.

* v1.1 (5/2/2009) - Added widget support, updated plugin path and added screenshots and icon.

* v1.0 (4/30/2009) - Initial release of the WP-TwitterSearch plugin.