=== Plugin Name ===
Contributors: topsylabs
Tags: topsy, twitter, widget, trackback, trackbacks, comment, comments, tweetbacks, tweet, tweets, retweet, retweets
Requires at least: 2.0
Tested up to: 2.8.5
Stable tag: 1.0.0

Let readers retweet from your blog. Show how many times your posts have been retweeted. Turn tweets into comments automatically.

== Description ==

Places a button on your blog posts showing how many times each has been retweeted, and allowing readers to retweet by clicking. Turn tweets into comments for your WordPress blog. This plugin queries Topsy's real-time index of tweets to automatically generate retweet buttons and trackback comments on your posts.

== Installation ==

Note: Plugin requires PHP 5.0 or greater.

1. Download and extract the plugin.
2. Copy the "topsy" folder to the "/wp-content/plugins/" directory
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Look at the plugin's Settings page. Activate Trackback Comments, if desired; adjust Retweet Button settings as desired, etc.

The Topsy plugin will create Retweet buttons on your blog posts, which: a) Show how many times the post has been tweeted; and b) Allow your readers to easily retweet about your posts. If you turn on the Trackback Comments feature, the plugin will also check for tweets that link to your blog posts, and generate a new comment on the target post for each tweet.

= Upgrade Instructions =

You should get a message in your admin dashboard saying that a new version is available. Use the "upgrade automatically" link. If that fails, you can simply download and extract the new file, and copy the new "topsy" folder over the older one in your plugins directory.

== Frequently Asked Questions ==

= If I deactivate or remove the plugin, what happens to my trackback comments? =

Trackback comments are real comments, inserted into the WP comments database. The plugin creates the comments, but after that, they exist on their own. Deactivating or removing the plugin will have no effect on them.

If you want to remove the plugin <em>and</em> all the trackback comments, you should start by using the "Delete Trackback Comments" button. This will delete all the trackback comments that were created by the plugin (and leave other comments and trackbacks untouched). In the yellow message box at the top of the next page, click the "deactivate this plugin" link, and then you can delete the plugin.

= When someone links to a post of mine, how quickly will the trackback comment appear? =

It will appear the next time someone tries to load the post page. As the page loads, the Topsy plugin checks to see if there are any new links to the page, and adds comments if there are.

However, if you're allowing search engines to index your blog, then the search engine's hits will also trigger the plugin, so it's entirely possible that search engines will keep your trackback comments up-to-date without any human intervention.

= I deleted one of the trackback comments, but it keeps coming back. Help! =

If the plugin is still activated, it will re-generate trackback comments every time a blog post page is loaded.

If you want to keep the plugin activated, and block one or two comments from reappearing, you can use the "Unapprove" feature in the WordPress dashboard. An Unapproved comment will not be visible on your blog's pages.

= I used one of the 0.9.x releases, and have trackback comments in old styles (with "Original tweet" and "Topsy page" links). How can I make my old comments like the new ones? =

Just use the new "Delete Trackback Comments" button. Since the plugin will automatically regenerate comments if it's still active, the delete button will clean up the old comments and let new ones be created in the new style.

= How can I get rid of the duplicate trackback comments littering my blog? =

Again, just use the "Delete Trackback Comments" button. All the duplicate comments will go away, and then the correct ones will be regenerated over the next day or so. Alternatively, if you delete duplicate comments manually, the incorrect ones <em>will not</em> reappear - that bug has been resolved, and will not reoccur.

= I get a fatal error when I try to activate the plugin. =

If you get an error message like:

`Plugin could not be activated because it triggered a fatal error.
Parse error: syntax error, unexpected '{' in
/.../wp-content/plugins/topsy/topsy.php on line 195`

it means you're using a version of PHP older than 5.0. The line that triggers the fatal error uses the PHP5 "exceptions" feature (also known as "try/catch/throw"). This is a feature that PHP4 doesn't have, so it can't figure out what to do.

== Screenshots ==

1. A tweet that links (via bit.ly) to a WordPress blog post
2. The resulting trackback comment on that blog post, created by the Topsy plugin.
3. Two examples of the Retweets Button in place on a blog page. Both are before content, floated right; the first is the large-size button, the second is the small one.

== Changelog ==

= 1.0.0 - 2009-11-03 =

Major release! Added Retweet button. Added "Delete Trackback Comments" button. Fixed duplicate trackbacks bug. Removed "Original tweet/Topsy page" links, and changed default settings so user must explicitly activate trackback comments.

= 0.9.4 - 2009-11-02 =

Test to verify WordPress distribution mechanisms.

= 0.9.3 - 2009-10-22 =

Bug fix: Resolved issue where "Topsy page" trackback link from pages with ? or + in their URL showed no trackbacks.

= 0.9.2 - 2009-10-16 =

Added "ignore list" feature. Added option to display trackbacks as comments, not just trackbacks. Added auto-linking of @usernames and #hashtags. General code cleanup.

= 0.9.1 - 2009-10-13 =

Revised format of trackback comment text to remove "On Twitter..." lead-in. Added rate limiting support.

= 0.9.0 - 2009-10-09 =

Initial release.