A user-to-user messaging system for Django

Warning: Starting with r11804 django ships with a new contrib app called 'django.contrib.messages' which replaces the old request.user.message_set api for displaying so-called "flash messages" to users. To my knowledge django uses - in some places - only the last part of an app's name (import path) to identify the app, this means it is possible that django-messages will no longer work as expected as of that django revision.

Django-messages enables your users to send private messages to each other. It provides a basic set of functionality your would expect from such a system. Every user has an Inbox, an Outbox and a Trash. Messages can be composed and there is an easy url-based approach to preloading the compose-form with the recipient-user, which makes it extremly easy to put "send xyz a message" links on a profile-page.

Currently (svn-trunk) django-messages comes with these translations:

• de
• fr (thanks froland and dpaccoud)
• es_AR (thanks Juanjo-sfe)
• pl (thanks maczewski)
• es (thanks paz.lupita)
• pt_BR (thanks Diego Martins)
• ru (thanks overkrik)
• nl (thanks krisje8)
• da (thanks Michael Lind Mortensen)
• el (thanks Markos Gogoulos)
• zh_CN (thanks Gene Wu)
• ar (thanks to speedy)

If you want to add a translation of fix one of the current translations you can easily do it via Transifex at: http://www.transifex.net/projects/p/django-messages/c/trunk/

Documentation

The documentation is contained in the /docs/ directory and can be build with sphinx. A HTML version of the documentation is available at: http://files.arnebrodowski.de/software/django-messages/Documentation/

Install

Download the tar archive, unpack and run python setup.py install or checkout the trunk and put the messages folder on your PYTHONPATH. Trunk-version is recommended if you run django-trunk. The current packed release is still 0.96 compatible.

Usage

Add messages to your INSTALLED_APPS setting and add an include('messages.urls') at any point in your url-conf.

The app includes some default templates, which are pretty simple. They extend a template called "base.html" and only emit stuff in the block "content" and block "sidebar". You may want to use your own templates, but the included ones are good enough for testing and getting started.

Versions

messages-0.3 and above are compatible with Django 1.0

messages-0.2 is still compatible with Django 0.96.x, but not longer maintaned

Dependencies

Django-messages has no external dependencied except for django. But if django-notification and/or django-mailer are found it will make use of them. Note: as of r65 django-messages will only use django-notification if 'notification' is also added to the INSTALLES_APPS setting. This has been done to make situations possible where notification is on pythonpath but should not be used, or where notification is an other python package as django-notification which has the same name.

News

2009-12-03	r129	marks the 0.4.3 release
2009-11-02	r126	added arabic translation contributed thorugh transifex by speedy.
2009-10-14	r121	updated french translation to 100% thanks to dpaccoud (gave wrong credit in commit message). This is the first translation submitted through Transifex
2009-10-05	r117	adds simplified chinese (zh_CN) translation contributed by Gene Wu
2009-09-09	r111	adds greek (el) translation contributed by Markos Gogoulos
2009-08-25	r109	adds danish (da) translation contributed by Michael Lind Mortensen
2009-08-05	r107	marks the 0.4.2 release, which incorporates the security fix from r105 and the new nl translation from r104. All users are encouraged to upgrade to the this release of django-messages. Users still using the Django 0.96 version should add the fix from r105 by hand.
2009-08-04	r105	adds a security fix. the reply-view could leak messages a user isn't supposed to see.
2009-07-07	r104	adding dutch (nl) translation contributed by krisje8
2009-05-11	r102	marks the 0.4.1 release, which contains a packaging bugfix and adds the ru_RU translation mentioned earlier