Skip to main content

A reusable Django app that provides threaded conversations between users.

Project description

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

The conversations in this app are threaded, that means a conversation is related to one object. In this case the object is a user. So if user1 starts a conversation with user2 all messages between those users are stored in one conversation (you know it, if your are e.g. a Facebook user).

This app allows another relation, so you can also add a content object to a conversation between two users. Let’s say you built a sports app. user1 wants to talk with user2 about a fight called Klitschko vs. Tyson. They can now start a conversation, which is also related to that fight. But, they can also start a new conversation about other fights or talk to each other without another relation, for sure.

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

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-conversation-1.3.1.tar.gz (14.1 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