This application is currently in alpha. It should not be used in production environments.

Django-machina is a forum framework for Django providing a way to build community-driven websites. It offers a full-featured yet very extensible forum solution:

• Topic and post editing
• Forums tree management
• Per-forum permissions
• Anonymous posting
• Polls and attachments
• Moderation and pre-moderation
• ...

Django-machina was built with integration in mind: the application is designed to be used inside existing Django applications. It is not a standalone forum solution.

Django-machina was built with customization and extensibility in mind: each single functionality of the application can be customized or overriden to accommodate with your needs. In fact, django-machina uses the same techniques as those introduced by the famous django-oscar e-commerce framework to allow powerfull customizations.

Online browsable documentation is available at https://django-machina.readthedocs.org.

Head over to the documentation for all the details on how to set up your forum and how to customize it to suit your needs.

Python 2.7+ or 3.3+, Django 1.8+. Please refer to the requirements section of the documentation for a full list of dependencies.

Two demo sites can be tested:

• the vanilla project contains a standard installation of django-machina without customization
• the demo project showcases the customization possibilities of django-machina

• Topic subscriptions: a user can get a list of all topics to which he subscribed
• A view to get all the posts of a forum member
• A setting to limit the maximum size of an attachment
• A way to prevent users to submit too many posts in a given period

Morgan Aubert (@ellmetha) and contributors

BSD. See LICENSE for more details.