Currently django-tumblr is under-going some major changes. It may not be stable and I'm not going to guarantee backwards compatibility until it's ready for a release.
To install the latest version:
pip install git+git://github.com/jefftriplett/django-tumblr.git#egg=django-tumblr
django-tumblr
has some additional dependencies:
pip install poster
pip install git+git://github.com/jefftriplett/python-tumblr.git#egg=python-tumblr
pip install django-taggit
pip install django-haystack
-- optional for search integration
Add djumblr
to your project's INSTALLED_APPS
setting.
INSTALLED_APPS = (
'djumblr',
...
)
Add djumblr
to your project's urls.py
:
urlpatterns = patterns('',
(r'^djumblr/', include('djumblr.urls')),
...
)
Download djumblr and put it on your pythonpath. Include it in your INSTALLED_APPS
, and syncdb.
You now have models for tumblr content!
To sync, you first need to define the user(s) that have tumblr accounts. This is done with the
TUMBLR_USERS
settings in settings.py.
An example (from djumblr.scripts.populate_all()):
John has the username john
on his django website, but ignorantcarrot
on tumblr.
His TUMBLR_USERS
would be:
TUMBLR_USERS = { 'john':
{ 'tumblr_user': 'ignorantcarrot', }
}
If he wants to use the django site both for posting and syncing, he would have to update the TUMBLR_USERS variable with the email address and password he uses to log in to tumblr.com:
TUMBLR_USERS = { 'john':
{
'tumblr_user': 'ignorantcarrot',
'email': 'john.carrot@fullbladder.net',
'password': 'secret',
}
}
Once installed and configured, you may sync your tumblr accounts with:
python manage.py sync_tumblr
Alternatively, run populate_models(tumblr_user, user)
from the scripts module, where tumblr_user
is a string containing the username of the tumblr user, and user
is a User object.