Twitter Tools integrates with Twitter by giving you the following functionality:
- Connect multiple Twitter accounts (via Social)
- Archive the tweets from your Twitter accounts (downloaded every 10 minutes)
- Create a blog post from each of your tweets
- Create a tweet on Twitter whenever you post in your blog, with a link to the blog post (via Social)
- Browse your tweets locally by @mention, #hashtag or user account (optionally display these publicly)
Twitter Tools leverages Social’s connection to Twitter so that you don’t have to create an app and copy keys around. It supports multiple accounts (must be authorized as “global” accounts in Social) with settings on a per-account basis.
Support Level: Product Support (we want to fix bugs and make the product great, but do not provide individual support).
Developers: Fork and contribute on GitHub.
If you have upgraded from an older version of Twitter Tools, your data will need to be converted to the new Twitter Tools format. On the Twitter Tools Options page you will see a prompt to upgrade if appropriate. Follow the steps to convert your data.
Twitter Tools now stores complete Twitter data along with your basic tweet content. Over time, Twitter Tools will request this data for upgraded tweets. This process make take a few days, as only 10 tweets are requested per hour (to avoid egatively impacting your rate limit).
Connecting Twitter Accounts
Any Twitter accounts connected on the Social settings page are available for Twitter Tools. You can enable them on a per-account account basis, as well as specifying per-account preferences for creating blog posts, etc. (on the Twitter Tools options screen).
Managing your Tweets
You can view, edit and delete (or unpublish) the local copy of your Tweets right in your WordPress admin. Navigate the tweets from the “Tweets” menu item and manage them just as you would any other post type. Twitter Tools does not know if you’ve deleted a tweet on Twitter, so you’ll need to also delete the copy of the tweet from the admin to remove it from your WordPress site.
Displaying your Tweets
Twitter Tools include options to create URLs for your local tweets using the following scheme:
- single tweet: http://alexking.org/tweets/253580615113400321
- account archive: http://alexking.org/tweet-accounts/alexkingorg
- @mention archive: http://alexking.org/tweet-mentions/sogrady
- #hashtag archive: http://alexking.org/tweet-hashtags/monktoberfest
You can enable public URLs for your tweets in your Twitter Tools settings. If you choose not to enable public URLs for your tweets, you can still vuew and manage them from within the admin screens.
You can use a shortcode to display a list of tweets.
If you want, you can specify some additional parameters to control how many tweets are displayed:
[aktt_tweets account="alexkingorg" count="5" offset="0"]
You can also choose to explicitly include or exclude replies and retweets:
[aktt_tweets account="alexkingorg" include_rts="0" include_replies="1"]
If you want to limit the tweets to specific @mentions or #hashtags, you can to that as well:
[aktt_tweets account="alexkingorg" mentions="crowdfavorite,twittertools" hashtags="wordpress,plugin,twittertools"]
The options for the shortcode are also available for the Twitter Tools widget via a few settings.
Create Blog Posts with Tweets
WordPress Twitter Tools Plugin can create a blog post from each of your Tweets. This feature can be enabled on a per-account basis. If there is an image included in the media data of the tweet Twitter Tools will try to save that image as the featured image for the post and append it to the blog post content.
Please note that this will take effect for all future tweets, it does not retroactively create posts for older tweets (though you could pretty easily script it to do so if you desired).
Twitter Tools is designed to be customizable via the standard hook/filter API. If you find you need additional hooks (or to suggest other bug fixes and enhancements) please create a pull request on GitHub.
Get creative! Here are some examples of ways to use more of the full Twitter data to create links back into Twitter where appropriate:
- linking to the original tweet on Twitter
- linking to “in reply to” tweets