Supybot-plugins/Twitter
Valentin Lorentz 7f8fcfd54c Twitter: Catch SyntaxError exceptions and raise callbacks.Error instead. 2014-04-16 07:21:15 +00:00
..
local Twitter: First commit (can authenticate and get friendslist) 2011-02-18 19:48:14 +01:00
locales Rename all 'locale' directories to 'locales'. 2012-12-26 15:47:23 +01:00
README.txt Twitter: Add warning about capabilities in the README. 2013-04-27 19:31:12 +02:00
__init__.py All plugins: Add Python 3 support. 2013-03-25 19:12:08 +01:00
config.py Twitter: Add supybot.plugins.Twitter.announce.users. 2013-05-10 16:57:25 +02:00
get_access_token.py Twitter: Fix get_access_token.py. 2012-05-06 18:37:05 +00:00
messages.pot Twitter: update l10n-it. 2012-06-27 14:20:01 +02:00
plugin.py Twitter: Catch SyntaxError exceptions and raise callbacks.Error instead. 2014-04-16 07:21:15 +00:00
test.py All plugins: Add Python 3 support. 2013-03-25 19:12:08 +01:00
twitter.py Twitter: Fix 0~fec7cb8529ca84bd5a01545da73a5b6ed27749181. 2013-07-16 09:46:21 +00:00

README.txt

Advanced Twitter plugin for Supybot, with capabilities handling, and
per-channel user account.

Configuration
=============

Ever noticed a text "sent from web" or "sent via Android" under a tweet?
This is called the consumer. You have two choices:
* Keep the default consumer. This is the easier way; and the text will
  be "sent via Supybot // Limnoria".
* Create your own consumer at https://dev.twitter.com/ . If you choosed
  this way, you will have to set supybot.plugins.Twitter.consumer.key
  and supybot.plugins.Twitter.consumer.secret with the consumer
  key/secret given by Twitter.


Now, you have to set the accounts credentials (called access token)
for every channel you want to associate with a Twitter account.

If you use the default consumer, it is easy : just run the get_access_token.py
script provided with this plugin.
Otherwise, you will have either to edit the script with your own consumer
key/secret and run it, or get the token from dev.twitter.com.



Once you got the token key/secret, set it _as a channel-specific variable_
to supybot.plugins.Twitter.accounts.channel.key and 
supybot.plugins.Twitter.accounts.channel.secret.


Capabilities
============

All users are allowed to use all commands by default! Use this command to
disable account administration (follow, unfollow, ...) by default:
@defaultcapability add -twitteradmin

To disable posts and retweets by default, use this one:
@defaultcapability add -twitterpost

Extra features
==============

If the Untiny plugin is loaded, this plugin will automaticaly extract original
links from t.co ones.