=== Twitter Tools === Tags: twitter, tweet, integration, post, digest, notify, integrate, archive, wid get

Contributors: alexkingorg Requires at least: 2.3 Tested up to: 2.7.1 Stable tag: 1.6 Twitter Tools is a plugin that creates a complete integration between your WordP ress blog and your Twitter account. == Details == Twitter Tools integrates with Twitter by giving you the following functionality: * Archive your Twitter tweets (downloaded every 10 minutes) * Create a blog post from each of your tweets * Create a daily or weekly digest post of your tweets * Create a tweet on Twitter whenever you post in your blog, with a link to the b log post * Post a tweet from your sidebar * Post a tweet from the WP Admin screens * Pass your tweets along to another service (via API hook) == Installation == 1. Download the plugin archive and expand it (you've likely already done this). 2. Put the 'twitter-tools.php' file into your wp-content/plugins/ directory. 3. Go to the Plugins page in your WordPress Administration area and click 'Activ ate' for Twitter Tools. 4. Go to the Twitter Tools Options page (Options > Twitter Tools) to set your Tw itter account information and preferences. == Configuration == There are a number of configuration options for Twitter Tools. You can find thes e in Options > Twitter Tools. == Showing Your Tweets == = Widget Friendly = If you are using widgets, you can drag Twitter Tools to your sidebar to display your latest tweets. = Template Tags = If you are not using widgest, you can use a template tag to add your latest twee

ts to your sidebar. `<?php aktt_sidebar_tweets(); ?>` If you just want your latest tweet, use this template tag. `<?php aktt_latest_tweet(); ?>` == Hooks/API == Twitter Tools contains a hook that can be used to pass along your tweet data to another service (for example, some folks have wanted to be able to update their Facebook status). To use this hook, create a plugin and add an action to: `aktt_add_tweet` Your plugin function will receive an `aktt_tweet` object as the first parameter. Example psuedo-code: `function my_status_update($tweet) { // do something here }` `add_action('aktt_add_tweet', 'my_status_update')` Twitter Tools also provides a filter on the URL sent to Twitter so that you can run it through an URL-shortening service if you like. `tweet_blog_post_url` Your plugin function will receive the URL as the first parameter. Example psuedo-code: `function my_short_url($long_url) { // do something here - return the shortened URL }` `add_filter('tweet_blog_post_url', 'my_short_url')` == Known Issues == * Only one Twitter account is supported (not one account per author). * Tweets are not deleted from the tweet table in your WordPress database when th ey are deleted from Twitter. To delete from your WordPress database, use a datab ase admin tool like phpMyAdmin. * The relative date function isn't fully localized. == Frequently Asked Questions == = Who is allowed to post a Tweet from within WordPress? = Anyone who has a 'publish_post' permission. Basically, if you can post to the bl og, you can also post to Twitter (using the account info in the Twitter Tools co nfiguration). = What happens if I have both my tweets posting to my blog as posts and my posts sent to Twitter? Will it cause the world to end in a spinning fireball of death ? =

Actually, Twitter Tools has taken this into account and you can safely enable bo th creating posts from your tweets and tweets from your posts without duplicatin g them in either place. = Does Twitter Tools use a URL shortening service by default? = No, Twitter Tools sends your long URL to Twitter and Twitter chooses to shorten it or not. = Can Twitter Tools use a URL shortening service? = Yes, Twitter Tools includes a filter: `tweet_blog_post_url` as of version 1.6. Plugins for this filter may already exist, or you can create your own. The plugin needs to attach to this filter using the standard WordPress `add_filter()` function and return a URL that will then be passed with your blo g post tweet. = Is there any way to change the 'New Blog Post:' prefix when my new posts get t weeted? = Yes there is, but you have to change the code in the plugin file. The reason this is done this way, and not as an easily changeable option from th e admin screen, is so that the plugin correctly identifies the tweets that origi nated from previous blog posts when creating the digest posts, displaying the la test tweet, displaying sidebar tweets, and creating blog posts from tweets (you don't want tweets that are blog post notifications being treated like tweets tha t originated on Twitter). To make the change, look for and modify the following line: `$this->tweet_prefix = 'New blog post';` = Can I remove the 'New Blog Post:' prefix entirely? = No, this is not a good idea. Twitter Tools needs to be able to look at the begin ning of the tweet and identify if it's a notification from your blog or not. Oth erwise, Twitter Tools and Twitter could keep passing the blog posts and resultin g tweets back and forth resulting in the 'spinning fireball of death' mentioned above. = Anything else? = That about does it - enjoy! --Alex King http://alexking.org/projects/wordpress