=== 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.2 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 *and* 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. = My trackback comments don't show up. I just see the author's name, which is a hyperlink to the original tweet... but the tweet text doesn't show up on my blog. = Some WordPress themes omit the text of trackbacks. The theme you're using is apparently one of them. You can get full texts in your trackback comments by having the plugin create them as comments, rather than as trackbacks. Look for the "Comment Display Style" option on the Topsy Widgets plugin's Settings page. After changing the setting for comments, you can get rid of existing blank trackbacks with the "Delete Trackback Comments" button. when the plugin regenerates them, it will build them as comments instead. = 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 *will not* 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. The PHP development team [announced the end of support for PHP4 on July 13, 2007](http://www.php.net/archive/2007.php#2007-07-13-1). Since even the PHP team has not supported PHP4 for over two years, we have no plans to add support for PHP4 in our plugin. You should contact your web hosting provider or system administrator to see about getting your server upgraded to PHP5. == 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.2 - 2009-11-11 = Bug fix release: temporary fix for "Missing argument 2 for topsy\_unpublish\_post\_hook()" warning message. Also enabled support for PHP4. = 1.0.1 - 2009-11-09 = Can now put Retweets button on RSS feeds as well as web pages. Added option to notify Topsy of post publication/deletion. Improved handling of duplicate detection. Better messaging regarding trackbacks vs. comments. Fixed backward-compatibility issue caused by shortcodes. = 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.