=== Plugin Name ===
Contributors: jeffsarris
Donate link: http://tweetstimonials.com/
Tags: twitter, testimonials, tweetstimonials
Requires at least: 2.8
Tested up to: 2.9.2
Stable tag: trunk

Add a Tweet-stimonials widget to your Available Widgets and use your Twitter favorites for automatic sidebar testimonials.

== Description ==

Add a Tweet-stimonials widget to your Available Widgets and use your Twitter favorites for automatic sidebar testimonials.

Tweet-stimonials is a Wordpress plugin written by [Jeff Sarris](http://jeffsarris.com/) ([@jeffSARRIS](http://twitter.com/jeffsarris)) and inspired by Laura Roeder’s ([@lkr](http://twitter.com/lkr)) [automatic Twitter testimonial](http://jeffsarris.com/tweet-stimonials-inspiration) concept.

= The Concept =

Be sure to watch [Laura’s original video presentation](http://jeffsarris.com/tweet-stimonials-inspiration) regarding this concept, but the idea is as follows.

Twitter has a built-in function for flagging your favorite tweets; something that, from what I can tell, isn’t used by too many people. Well Laura Roeder presents the idea of using that same function to “favorite” all of those good things that your customers are already saying about you.

By marking these tweets as favorites, you are then able to automatically publish them to your site, making for one of the easiest and fastest ways to publish testimonials. As soon as you mark a new tweet as a favorite, it show up on your site. It’s that easy.

Laura provides excellent step-by-step instruction in her video for connecting this feed to your website, however I wanted a bit more flexibility in styling so I developed this CSS friendly plugin (with Twitter avatars) and called it Tweet-stimonials.

== Installation ==

You will find that the Tweet-stimonials plugin is very straightforward. Nevertheless here are some instructions.

= Download =
* Download the Tweet-stimonials plugin

= Installation =
1. Unzip and upload the entire Tweet-stimonials folder to the /wp-content/plugins/ directory
2. Activate the plugin through the Plugins menu in WordPress

= Setup and Configuration =
1. Navigate to your Appearance -> Widgets menu. You will see the Tweet-stimonials widget listed within your Available Widgets area.
2. Simply drag this widget to the sidebar of your choice.
3. Enter your Twitter Username, and configure the remaining options as you see fit.
4. Be sure to click Save, and you’re all done. Go back to your homepage and see the Twitter testimonials in all their glory!

= Options =
* How many tweets would you like to display?: You can display up to 20 tweets
* Widget Title (optional): By default the title of the widget will be Tweet-stimonials, but you optionally change it here.
* Show Avatars: When checked, the Twitter avatars that correspond with each tweet will be displayed to the left of the tweet.
* Show Follow Me Link: This will display a Follow @username link at the bottom of the widget which will link directly to your Twitter page.
* Show View All Link: This will display a View All link at the bottom of the widget which will link directly to your Twitter favorites.

== Frequently Asked Questions ==

= What version of PHP is supported? =
Tweet-stimonials requires at least PHP5.

== Changelog ==

= 1.0 =
* The first full version release of Tweet-stimonials

== Upgrade Notice ==

= 1.0 =
If you are using a pre-release version of Tweet-stimonials (0.9x) you should upgrade to this version which addresses all concerns related to Twitter API throttling.