Skip to main content

A minimalistic Django forum app

Project description


Yet another Django forum app.

It is simple and more suited for an internal team use (like a company’s extranet) than for big public communities. By the way all the view are restricted at less to authenticated users, there is no access for anonymous.

Message content is actually raw text with break line split into paragraph with no escaping, it is planned to use a markup like RST.


  • Have categories that contains threads that contains messages;
  • Have thread watches: users can subscribe to receive email notification for each new message in a thread;
  • Have thread sticky mode and announce mode;
  • i18n usage for the interface;
  • Global or ‘per object’ moderation on categories, threads and messages;



Add it to your installed apps in settings :


Add its settings (in your project settings) :

from forum.settings import *

(Also you can override some of its settings, see forum.settings).

Add django-guardian settings (see its doc for more details) :

    'django.contrib.auth.backends.ModelBackend', # this is default


Then register autobreadcrumbs context processor in settings :


Finally mount its urls and add the autobreadcrumbs autodiscover in your main :

import autobreadcrumbs

urlpatterns = patterns('',
    (r'^forum/', include('forum.urls', namespace='forum')),

About autobreadcrumbs

If you don’t want to use it you have two choices :

  • Simply ignore it, it will be used for automatic page titles but just override forum’s base template to remove it;
  • If you don’t install it, you will have to remove it from your settings and urls, then overrides all forum’s template that use its tags;



The forum make usage of django-guardian to manage ‘per object permissions’ or ‘global permissions’.

Actually you need to use the Django admin and be a staff user with the right permissions for managing forum objects to add these permissions for your users.

And so, you can add the needed permissions globally to the whole forum within each user accounts. Or you can add a permission for a specific object its edit page using the link named Object permissions.

  • Users with forum.add_category permissions can create categories;
  • All users can create a new thread;
  • All users can add a new message to a thread that is visible and not closed;
  • Users with forum.moderate_category can edit them and can manage (edit, delete) their threads parameters and messages. They are called Category moderators;
  • Users with forum.moderate_thread can edit thread parameters, edit thread messages and delete thread messages. They are called Thread moderators;
  • Users have permission to edit their own message if settings.FORUM_OWNER_MESSAGE_CAN_EDIT is True;

Others Category’s and Thread’s model permissions have no roles on frontend.

Permission error is rendered though a 403.html template that is allready embedded within this app, you override it in your project with adding your custom 403.html template in your project templates directory. Also you can use another template name, you will have to define its name in settings.GUARDIAN_TEMPLATE_403 (yes, this is setting from django-guardian, see its doc for more details).

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for emencia-django-forum, version 0.5
Filename, size File type Python version Upload date Hashes
Filename, size emencia-django-forum-0.5.tar.gz (20.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page