Skip to main content

Forum for Django framework.

Project description

https://coveralls.io/repos/mapeveri/django-musette/badge.svg https://travis-ci.org/mapeveri/django-musette.svg?branch=master

Forum for Django framework. This reusable application it is designed to be easily integrated into an existing Django application.

NOTE: This application is under development. It is not recommended to use in a production environment.

Installing

With pip:

pip install django-musette

Requirements:

  1. Jquery (Version 2.x)

  2. Bootstrap (Version 3.x) and bootstrap material design (https://fezvrasta.github.io/bootstrap-material-design/)

  3. Angular.js (Version 1.x)

Quick start:

  1. Add application ‘musette’ and dependencies to INSTALLED_APPS:

    INSTALLED_APPS = (
            ...
            'log',
            'hitcount',
            'endless_pagination',
            'rest_framework',
            'musette',
    )
  2. Add this urls to file urls.py:

    url(r'^' , include('musette.urls')),
  3. And in settings.py add this variable:

    SESSION_SAVE_EVERY_REQUEST = True
  4. Configure in the settings.py URL_LOGIN, STATIC and MEDIA root. Something very important is to set the variable CACHES for redis. example:

    CACHES = {
        'default': {
            'BACKEND' : 'redis_cache.RedisCache',
            'LOCATION' : 'localhost:6379',
            'OPTIONS' : {
                'DB' : 1
                }
            }
    }
  5. Set this variables if differ from the default values:

    APP_PROFILE = 'profiles' # Application for your profiles
    MODEL_PROFILE = 'Profile' # Model for profiles
    FIELD_PHOTO_PROFILE = "photo" # Field that contains url the profile photo
    URL_PROFILE = '/profile/' # Url for profile
    URL_PROFILE_PARAMS = ("username",) # Params of url profile, indicate field user model
  6. Execute command migrate:

    python manage.py migrate
  7. The application django-musette need a template base of name base.html. With the following tags:

    {% block content %}{% endblock %}
    {% block extra_css %}{% endblock %}
    {% block extra_js %}{% endblock %}
    {% block hitcount_javascript %}{% endblock %}

And add files static css and js (Angular, Jquery, Bootstrap).

Example.

https://github.com/mapeveri/django-musette/blob/master/example/plantillas/base.html

  1. If you need to enable the forum in Spanish:

    https://github.com/mapeveri/django-musette/blob/master/internationalization.rst

How to use?:

  1. Login in django admin and start to insert categories necessary. Example:

https://github.com/mapeveri/django-musette/blob/master/images/categories.png

The field position is for indicate the order of the categories.

  1. Insert the forum necessary: Example:

https://github.com/mapeveri/django-musette/blob/master/images/forums.png

Field more importants:

  • Position: The field position is for indicate the order of the forums in the categories.

  • Topics count: Total forum topics.

  • Check topics: If you need to review the topics by a moderator.

  1. Make sure that each user registration exist in the profile table.

Ready!

Execute in the terminal:

python manage.py runserver
  1. In other terminal execute this command for run server tornado for web sockets:

    python manage.py musette_run_server_ws

Visit 127.0.0.1:8000/forums you should see the categories and forums.

https://github.com/mapeveri/django-musette/blob/master/images/index.png https://github.com/mapeveri/django-musette/blob/master/images/forum.png https://github.com/mapeveri/django-musette/blob/master/images/notifications.png https://github.com/mapeveri/django-musette/blob/master/images/topic.png https://github.com/mapeveri/django-musette/blob/master/images/new_comment.png https://github.com/mapeveri/django-musette/blob/master/images/comment.png https://github.com/mapeveri/django-musette/blob/master/images/new_topic.png https://github.com/mapeveri/django-musette/blob/master/images/edit_topic.png

Features:

  1. Multiple forums ordered by for category.

  2. Notifications (Still not support sending emails).

  3. Notifications and comments in real time.

  4. Count views for forum and topic.

  5. Infinite scroll for comments of one topic.

  6. Support of files media for topics.

  7. Easy integration with other applications Django of your project.

  8. Pre-moderation of topics.

  9. Models registered in admin django for administrators.

  10. Search for topics in a forum.

  11. Modern design, thank you to Bootstrap material design.

  12. Avatar.

  13. Support to English and Spanish language.

  14. Validation of forms in real time with AngularJs.

  15. User registration a forum.

  16. Support to Markdown.

  17. Support to rss to forums.

  18. API REST with django-rest-framework.

Contribute:

  1. Fork this repo and install it

  2. Follow PEP8, Style Guide for Python Code

  3. Write code

  4. Write unit test

  5. Send pull request

Project details


Download files

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

Source Distribution

django-musette-0.1.tar.bz2 (423.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page