Skip to main content

# django-fsm-admin

Mixin and template tags to integrate [django-fsm](https://github.com/kmmbvnr/django-fsm)
state transitions into the django admin.

## Installation

$ pip install django-fsm-admin

Or from github:

$ pip install -e git://github.com/gadventures/django-fsm-admin.git#egg=django-fsm-admin

## Usage

1. Add `fsm_admin` to your INSTALLED_APPS

2. In your admin.py file, use `FSMTransitionMixin` to add behaviour to your ModelAdmin.

from fsm_admin.mixins import FSMTransitionMixin

class YourModelAdmin(FSMTransitionMixin, admin.ModelAdmin):
pass

admin.site.register(PublishableModel, PublishableModelAdmin)

3. Override the admin change_form.html for your model

{% extends 'admin/change_form.html' %}
{% load fsm_admin %}

{% block submit_buttons_bottom %}{% fsm_submit_row %}{% endblock %}

{% block after_field_sets %}
{{ block.super }}
{% fsm_transition_hints %}
{% endblock %}

(e.g. `your_app/templates/admin/your_app/your_model/change_form.html`)

## Try the example

git clone git@github.com:gadventures/django-fsm-admin.git
cd django-fsm-admin
mkvirtualenv fsm_admin
pip install -r requirements.txt
python fsm_admin/setup.py develop
cd example
./manage.py syncdb
./manage.py runserver

## Demo

[![Watch a QuickCast of the django-fsm-admin example](http://i.imgur.com/IJuE9Sr.png)](http://quick.as/aq8fogo)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-fsm-admin-1.0.1.tar.gz (6.2 kB view details)

Uploaded Source

File details

Details for the file django-fsm-admin-1.0.1.tar.gz.

File metadata

File hashes

Hashes for django-fsm-admin-1.0.1.tar.gz
Algorithm Hash digest
SHA256 5d6c9a8f7a84bc186c3f7c8dacf5e9e87d3e24958f0ac127444e0c7e0130aaed
MD5 160c53eeb1161c7ea67d54965d1b408b
BLAKE2b-256 8c705b63003613afa7fd96ebab451b735b4b9f0725e6d5adee0caacbf60ac240

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page