Documentation

The full documentation is at https://django-moderation-model-mixin.readthedocs.io.

Quickstart

Install Django Moderation Model Mixin:

pip install django-moderation-model-mixin

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'moderation_model_mixin',
    ...
)

Features

• ModerationModelMixin

• ModerationModelMixinAdmin

• ModerableQuerySet

• Actions in admin changelist

• Signals associated to moderation action

Example of usage

# in your admin.py
class ExampleModelAdmin(ModerationModelMixinAdmin, admin.ModelAdmin):
    ...

admin.site.register(ExampleModel, ExampleModelAdmin)

# in your models.py
from moderation_model_mixin.models import ModerationModelMixin

class ExampleModel(ModerationModelMixin, models.Model):
    ...

Admin Interface

Here some users interface example.

First one is how the change form is shown. There are two new buttons in the submit row that allows to accept or reject entries that not yet moderated.

This is how an accepted entry looks.

This is how a rejected entry looks.

A confirmation pop-up is shown when an acceptance or rejection request is made

Last image shows actions in the changelist.

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox

Development commands

pip install -r requirements_dev.txt
invoke -l

Credits

Tools used in rendering this package:

• Cookiecutter

• cookiecutter-djangopackage

History