Skip to content

Latest commit

 

History

History
86 lines (57 loc) · 3.14 KB

README.rst

File metadata and controls

86 lines (57 loc) · 3.14 KB

django-machina

Documentation Status License Latest Version Join chat Build status Codecov status

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
  • Forum conversations search
  • ...
https://raw.githubusercontent.com/ellmetha/django-machina/master/docs/_images/machina_forum_header.png

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

Morgan Aubert (@ellmetha) and contributors

BSD. See LICENSE for more details.