Tools for Twitter 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)
Tools for Twitter 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 Tools for Twitter, your data will need to be converted to the new Tools for Twitter format. On the Tools for Twitter Options page you will see a prompt to upgrade if appropriate. Follow the steps to convert your data.
Tools for Twitter now stores complete Twitter data along with your basic tweet content. Over time, Tools for Twitter 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).
Any Twitter accounts connected on the Social settings page are available for Tools for Twitter. You can enable them on a per-account account basis, as well as specifying per-account preferences for creating blog posts, etc. (on the Tools for Twitter 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. Tools for Twitter 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
Tools for Twitter 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 Tools for Twitter 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 Tools for Twitter widget via a few settings.
Create Blog Posts
Tools for Twitter 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 Tools for Twitter 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).
Tools for Twitter 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
Tools for Twitter relies on the Social plugin to connect to Twitter. If you aren’t already using this plugin please install it before installing Tools for Twitter.
- Download the plugin archive and expand it (you’ve likely already done this).
- Put the ‘twitter-tools’ directory into your wp-content/plugins/ directory.
- Go to the Plugins page in your WordPress Administration area and click ‘Activate’ for Tools for Twitter.
- Go to the Tools for Twitter Options page (Settings > Tools for Twitter) to set up your Twitter information and preferences.