This plugin automatically posts Tweets to your Twitter via the oAuth authentication protocol when specific pages are changed.

You can specify which page updates are sent, by including the ~~AUTOTWEET:~~ syntax in these specific pages.

The plugin uses the Abraham Williams abraham [at] abrah [dot] am OAuth for Twitter PHP Library.

Important

It is mandatory that you have installed the cURL Extension for PHP.

You can check if the extension is installed using the following code:

if ( function_exists('curl_init') ) {
  echo 'cURL is installed';
}
else {
  echo 'cURL is NOT installed';
}

The plugin communicates with Twitter using the oAuth authentication protocol. This protocol requires authentication keys that you will get by setting up a Twitter App.

Head to Twitter and set up an application.

Important Make sure you selected “Read & Write” acces.

Once you've created your Twitter application get the parameters for authentication.

These parameters must be used in the configuration of the plugin, so that the plugin can communicate with Twitter.

Optionally, you can use syntax parameters to specify alternate Twitter Apps for specific pages. This, however, is optional.

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

If you wish to track changes for a specific page, add the ~~AUTOTWEET:~~ syntax to that page.

If a page containing the ~~AUTOTWEET:~~ syntax is edited, the change_log information is used to assemble a message, which is then forwarded to the configured Twitter App as a Tweet.

~~AUTOTWEET:~~

If you wish to use alternate Twitter Apps for specific pages, you can optionally add syntax parameters.

~~AUTOTWEET:consumer_key=<consumer_key>&consumer_secret=<consumer_secret>&access_token=<access_token>&access_token_secret=<access_token_secret>~~

You can use the parameters to overwrite the configuration settings for specific pages. This is not normally necessary.

~~AUTOTWEET:key=value&..key=value~~

You can set more than one element at once by using an & delimiter.

Available parameters:

Note: Normally you would use the same settings for all pages, in which case the syntax ~~AUTOTWEET:~~ is sufficient.

Default usage:

~~AUTOTWEET:~~

For convenience you can change the formatting of the tweet sent to Twitter via the 'message_template' configuration parameter. The fields in the message will be replaced by the plugin.

Default:

{type} {page} - {summary} {user}

Example (including link to the page):

{date} {type} http://www.dokuwiki.org/{page} - {summary} @{user}

• 2011-10-06: Version 1.0
  • Initial release

• 2014-05-27: Change twitteroauth.php from 1 to 1.1 and it works with latest dokuwiki-release 2014-05-05 “Ponder Stibbons”

  public $host = "https://api.twitter.com/1.1/";

• 2013-12-28: Change twitteroauth.php from 1 to 1.1 and it works with latest dokuwiki-release 2013-12-08 “Binky”

  public $host = "https://api.twitter.com/1.1/";

• I tried step by step, double check but doesnot work, is there a debug mode somehere?
  • It works now (just had to wait a couple of days)

• I am considering adding a configuration parameter 'track_all_changes'. If the parameter is set, all pages will be regarded by the plugin and tweets will be sent for all page changes, regardless of an ~~AUTOTWEET:~~ syntax being present or not.
  • + 1
• Thanks for this plugin! I am wondering whether it would be possible to set it up so that rather than tweet from a particular page it tweets from a particular NS. I imagine this would not be too hard to add in…I may try to do it myself but would probably bumble quite a bit.
• It were great, if tweets only sent, when the checkbox “small changes” is unchecked.

Hello… ¿how can I launch a tweet each time a new page is created? (I'm configuring a blog, and I need to comunicate new entries in the blog) (www.laterriblecorduradelidiota.es)