Alex King‘s Twitter Tools is a great little WordPress plugin for integrating your Twitter presence with your blog. It can show your latest tweets in a sidebar widget, create a “digest” post daily / weekly with a list of your tweets, and announce your blog posts to your twitter account.

In this post I’ll show you what changes are necessary to make it work with identi.ca instead of Twitter.

Why would you want to do that?

Identi.ca is often described as “an open source twitter” which it is, but it’s also the first instance of the Open Microblogging standard, which I believe will become increasingly important. Where Twitter users all share the same service, and are entirely dependent on Twitter for their ability to reach other, Identi.ca enables subscriptions across services, removing the need for a single point of failure.

Twitter Fail Whale, screenshot by John Rees

In other words, Twitter is a bit like the early days of email, when Compuserve users couldn’t email AOL users, and neither set of users could email the Internet. (I quality that with “a bit” since the Twitter API certainly makes possible clients which can do more than just post to Twitter). Identi.ca (or laconi.ca, as the software project behind identi.ca is called) is more like modern, decentralized, global-address-space email.

When identi.ca first launched, many folks were left stuck between the two alternatives: use identi.ca, which was more open and federated, or stay on Twitter, where a strong, rapidly developing community already existed (and, frankly, where many of the folks you were already talking to and listening to were unlikely to be persuaded to move en masse).

Evan Prodromou of Laconi.ca (photo by Zach Copley)

This ability means that for me, a version of Twitter Tools which would post to identi.ca (and let identi.ca cross-post to Twitter) was preferrable. Luckily, identi.ca has also implemented an API which responds to the same commands in the same way as the Twitter API.

This means that the changes needed are very simple.

In version 1.5.1a of Twitter Tools, lines 67-72 define the API endpoints to be used:


define('AKTT_API_POST_STATUS', 'http://twitter.com/statuses/update.json');
define('AKTT_API_USER_TIMELINE', 'http://twitter.com/statuses/user_timeline.json');
define('AKTT_API_STATUS_SHOW', 'http://twitter.com/statuses/show/###ID###.json');
define('AKTT_PROFILE_URL', 'http://twitter.com/###USERNAME###');
define('AKTT_STATUS_URL', 'http://twitter.com/###USERNAME###/statuses/###STATUS###');
define('AKTT_HASHTAG_URL', 'http://search.twitter.com/search?q=###HASHTAG###');


The key is to change these to map to the corresponding identi.ca API endpoints:


define('AKTT_API_POST_STATUS', 'http://identi.ca/api/statuses/update.json');
define('AKTT_API_USER_TIMELINE', 'http://identi.ca/api/statuses/user_timeline.json');
define('AKTT_API_STATUS_SHOW', 'http://identi.ca/api/statuses/show/###ID###.json');
define('AKTT_PROFILE_URL', 'http://identi.ca/###USERNAME###');
define('AKTT_STATUS_URL', 'http://identi.ca/notice/###STATUS###');
define('AKTT_HASHTAG_URL', 'http://identi.ca/###HASHTAG###');


For the most part, this just means replacing ‘twitter.com’ with ‘identi.ca/api’ except that the individual post urls and hashtag url have to be handled differently.

If you’re planning to use the sidebar widget, which includes a link to hashtags when you use them in a notice. , you’ll also need to find this line:

$hashtag = urlencode('#' . $hashtag);

And change it to:

$hashtag = urlencode($hashtag);

Finally, I also chose to update the “give credit” line, which occurs in two places in the code (not to remove credit for Twitter Tools but to point out the changes):

First, at roughly line 403 (this one is used in the blog post digest of tweets):

$content .= '<p class="aktt_credit">Powered by <a href="http://alexking.org/projects/wordpress">Twitter Tools</a>.</p>';

I changed that to:

$content .= '<p class="aktt_credit">Powered by <a href="http://www.openparenthesis.org/2009/01/25/identica-tools">Identi.ca Tools</a>, a modified version of <a href="http://alexking.org/projects/wordpress">Twitter Tools</a>.</p>';

And again later at line 768 (this is the one used in the sidebar widget):

$output .= '<p class="aktt_credit">Powered by <a href="http://alexking.org/projects/wordpress">Twitter Tools</a>.</p>';

Which I changed to:

$output .= '<p class="aktt_credit">Powered by <a href="http://www.openparenthesis.org/2009/01/25/identica-tools">Identi.ca Tools</a>, a modified version of <a href="http://alexking.org/projects/wordpress">Twitter Tools</a>.</p>';

This same approach could also be leveraged for other laconi.ca based sites with little effort.

Remember that these changes will get overwritten if you upgrade to newer versions of the Twitter Tools plugin.

(Here’s my modified copy of twitter-tools.php – just change the extension back to .php)