django-conversation 1.0

A reusable Django app that provides threaded conversations between users.

A reusable Django app that provides threaded conversations between users.

Installation

To get the latest stable release from PyPi

$ pip install django-conversation

To get the latest commit from GitHub

$ pip install -e git+git://github.com/bitmazk/django-conversation.git#egg=conversation

TODO: Describe further installation steps (edit / remove the examples below):

Add conversation to your INSTALLED_APPS

INSTALLED_APPS = (
    ...,
    'conversation',
)

Add the conversation URLs to your urls.py

urlpatterns = patterns('',
    ...
    url(r'^conversation/', include('conversation.urls')),
)

Don’t forget to migrate your database

./manage.py migrate conversation

Usage

If you have executed the tasks written above, the app is ready to work. Note: The templates are based on Twitter Bootstrap (http://getbootstrap.com/). If you don’t use it, simply overwrite them.

In almost every case you want to customize stuff, add jQuery/JavaScript, add CSS, your own templates and so on, so this app is kept very simple.

Settings

CONVERSATION_MESSAGE_FORM

Default: None

If you want to use your own message form, you can define it here:

CONVERSATION_MESSAGE_FORM = 'my_app.forms.MyMessageForm'

Contribute

If you want to contribute to this project, please perform the following steps

# Fork this repository
# Clone your fork
$ mkvirtualenv -p python2.7 django-conversation
$ python setup.py install
$ pip install -r dev_requirements.txt

$ git co -b feature_branch master
# Implement your feature and tests
$ git add . && git commit
$ git push -u origin feature_branch
# Send us a pull request for your feature branch