Installation Instructions

Twitter Tools relies on the Social plugin to connect to Twitter. If you aren't already using this plugin please install it before installing Twitter Tools.

1. Download the plugin archive and expand it (you've likely already done this).
2. Put the 'twitter-tools' directory into your wp-content/plugins/ directory.
3. Go to the Plugins page in your WordPress Administration area and click 'Activate' for Twitter Tools.
4. Go to the Twitter Tools Options page (Settings > Twitter Tools) to set up your Twitter information and preferences.

FAQ

What if I don't want to use Social's comment display?

All of Social's features (broadcasting, comment display, looking for responses on Twitter and Facebook and the ability to log in with Twitter or Facebook) can be disabled on Social's settings screen.

Will Twitter Tools pull in my entire tweet archive from Twitter?

Twitter Tools starts archiving from the time you enable it. It does not try to download your entire tweet history. However, there is code in Twitter Tools that can be scripted to download and import tweets. You can put together the pieces with your own code to create the combination of features you desire. Here's an Gist to get you started:

https://gist.github.com/3470627

Changelog

3.0.3

• Fix a typo that could prevent proper backfilling of tweet data

3.0.2

• Add aktt_tweet_create_blog_post filter to allow other plugins/code to make programatic decisions about when to create blog posts from tweets
• Add aktt_tweet_create_blog_post_format filter to allow post format to changed or omitted
• Properly apply title prefix when creating blog posts
• Address misc. multi-byte string issues
• Fix GMT/local time issues and set time properly for tweets and posts
• Properly enable featured image for tweet post type by merging with existing enabled post types

3.0.1

• Set categories and post tags properly on posts created from tweets
• Set GMT date explicitly for blog posts created from tweets (fixes time offset issue)
• Make enabled/disabled accounts more explicit visually

3.0

• Complete rewrite!
• Integrates with Social (required) to provide a vastly improved set-up experience
• Broadcasting features are now handled via the Social plugin
• Tweets are stored as a custom post type, providing easy admin access to edit or delete tweets as needed
• Tweets are cross-linked and browsable via custom taxonomies for accounts, @mentions and #hashtags
• Full Twitter is now stored with each tweet
• Comprehensive upgrade routine to migrate existing data and backfill upgraded tweets with full Twitter data
• Additional control over which tweets are displayed via shortcode and widget
• Daily and weekly digest functionality has been removed

2.4

• Replaced 401 authentication with OAuth.
• Now relies on WordPress to provide JSON encode/decode functions.
• WP 3.0 compatibility fix for hashtags plugin (set default hashtags properly).
• WP 3.0 compatibility fix for creating duplicate post meta.
• Added support form to settings page.

2.3.1

• Fixed a typo that was breaking the latest tweet template tag.

2.3

• Added nonces
• Patched several potential security issues (thanks Mark Jaquith)
• Load JS and CSS in separate process to possibly avoid some race conditions

2.2.1

• Typo-fix that should allow resetting digests properly (not sure when this broke, thanks lionel_chollet).

2.2

• The use of the native json_encode() function, required by the changes in WordPress 2.9 (version 2.1) created a problem for users with servers running 32-bit PHP. the json_decode() function treats the tweet ID field as an integer instead of a string, which causes the issues. Thanks to Joe Tortuga and Ciaran Walsh for sending in the fix.

2.1.2

• Missed one last(?) instance of Services_JSON

2.1.1

• Missed replacing a couple of instances of Services_JSON

2.1

• Make install code a little smarter
• Add unique index on tweet ID columns, remove duplicates and optimize table
• Track the currently installed version for easier upgrades in the future
• Cleanup around login test code
• Add action on Update Tweets (aktt_update_tweets)
• Add a shortcode to display recent tweets
• Exclude replies in aktt_latest_tweet() function (if option selected)
• Better RegEx for username and hashtag linking
• Use site_url() and admin_url(), losing backward compatibility but gaining SSL compatibility
• Added WordPress HelpCenter contact info to settings page
• Use standard meta boxes (not backwards compatible) for post screen settings
• Change how Services_JSON is included to be compatible with changes in WP 2.9 and PHP < 5.2
• Digest functionality is marked as experimental, they need to be fundamentally rewritten to avoid race conditions experienced by some users
• Misc code cleanup and bug fixes
• Added language dir and .pot file

Bit.ly plugin

• Changed RegEx for finding URLs in tweet content (thanks Porter Maus)
• Added a j.mp option
• Cleaned up the settings form
• Added a trim() on the API Key for people that struggle with copy/paste
• Use admin_url(), losing backward compatibility but gaining SSL compatibility

Exclude Category plugin

• Use admin_url(), losing backward compatibility but gaining SSL compatibility

Hashtags plugin

• Use admin_url(), losing backward compatibility but gaining SSL compatibility

2.0

• Added various hooks and filters to enable other plugins to interact with Twitter Tools.
• Added option to set blog post tweet prefix
• Added CSS classes for elements in tweet list
• Initial release of Bit.ly for Twitter Tools - enables shortening your URLs and tracking them on your Bit.ly account.
• Initial release of #hashtags for Twitter Tools - enables adding hashtags to your blog post tweets.
• Initial release of Exclude Category for Twitter Tools - enables not tweeting posts in chosen categories.