django-twitter 0.1.0

django-twitter allows your users to login into your application using Twitter in a easy way.

How To Use
==========
1. Add 'twitter' to your apps list

2. Include('twitter.urls') in your url app

3. Add in settings.py:
CONSUMER_KEY = "your_consumer_key"
CONSUMER_SECRET = "your_consumer_secret"
CALLBACK_URL = 'your_awesome_url'

CONSUMER_KEY: You can obtain it from your Twitter account.
CONSUMER_SECRET: You can obtain it from your Twitter account.
CALLBACK_URL: is the url inside your application that should be shown when the authentication process went ok. It must be same as Twitter callback url.

4. Connect with tokens_received signal:

from twitter import signals

def tokens_received(sender, request, screen_name, oauth_token, oauth_token_secret, **kwargs):
#Your stuff here

signals.tokens_received.connect(tokens_received)

How it works
============
To insert the link to Twitter, include this in your template : {% url twitter_begin_auth %} in a link.
When the user click on the link, is redirected to Twitter, and once logged in, it will redirect you to CALLBACK_URL in your application and tokens_received signal will be raised.

NOTE:
-----
Remember that your Twitter callback url must be the same as CALLBACK_URL

Dependencies
============
djano-twitter uses Django 1.3 and oauth2

References
==========
Some parts of Twython have been adapted to make possible this application. Thanks to Twython creator for share with us so amazing code.


Version 0.1.0
+ Initial release