Installation

The easiest way to get django-disqus is if you have pip installed:

pip install django-disqus

Without pip, it’s still pretty easy. Download the django-disqus.tar.gz file from django-disqus’ PyPI page, untar it and run:

python setup.py install

Configuring your Django installation

First, add disqus to your INSTALLED_APPS. You don’t need to run syncdb as there are no models provided.

Next, add DISQUS_API_KEY and DISQUS_WEBSITE_SHORTNAME to your settings. You can get your API key here (you must be logged in on the DISQUS website). To see the shortname of your website, navigate to Settings->General on the DISQUS website.

Example settings.py:

INSTALLED_APPS = (
     ...
     'disqus',
 )

 DISQUS_API_KEY = 'FOOBARFOOBARFOOBARFOOBARFOOBARF'
 DISQUS_WEBSITE_SHORTNAME = 'foobar'

Finally, you need to change the domain of your Site to the domain you’re actually going to use for your website. The easiest way to do this is to enable django.contrib.admin and just click on the Site object to modify it. If you don’t have contrib.admin installed (or don’t want to install it), you can run python manage.py shell and change the value in the cli:

>>> from django.contrib.sites.models import Site
>>> Site.objects.all()
[<Site: example.org>]
>>> s = Site.objects.all()[0]
>>> s.domain = 'arthurkoziel.com'
>>> s.name = 'arthurkoziel.com'
>>> s.save()
>>> Site.objects.all()
[<Site: arthurkoziel.com>]