Go to file
Benjamin Dauvergne a5a2356495 setup.py: add command to run tests
also add url and settings file for running the tests
2013-09-06 15:02:19 +02:00
django_journal bump release to 1.20.0 2013-07-30 10:08:05 +02:00
.gitignore first commit of django-journal 1.0 2012-12-10 14:27:15 +01:00
MANIFEST.in add README.rst to MANIFEST.in 2013-06-06 09:47:43 +02:00
README.rst first commit of django-journal 1.0 2012-12-10 14:27:15 +01:00
setup.py setup.py: add command to run tests 2013-09-06 15:02:19 +02:00
test_settings.py setup.py: add command to run tests 2013-09-06 15:02:19 +02:00
test_urls.py setup.py: add command to run tests 2013-09-06 15:02:19 +02:00

README.rst

Journal application
===================

Log event to a journal. Keep details of the event linked to the event message,
keep also the template for displaying the event in case we want to improve
display.

To use just do::

      import django_journal
      django_journal.record('my-tag', '{user} did this to {that}',
                 user=request.user, that=model_instance)


Admin display
-------------

``admin.JournalModelAdmin`` recompute messages from the journal message as HTML
adding links for filtering by object and to the ``change`` admin page for the
object if it has one.

Recording error events
----------------------

If you use transactions you must use ``error_record()`` instead of
``record()`` and set ``JOURNAL_DB_FOR_ERROR_ALIAS`` in your settings to
define another db alias to use so that journal record does not happen
inside the current transaction.