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-0.0.4.tar.gz (6.0 kB view details)

Uploaded Source

File details

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

File metadata

File hashes

Hashes for django-fsm-admin-0.0.4.tar.gz
Algorithm Hash digest
SHA256 c1ae12f9e7e5b6305b4246fdeed4d0675d92a3eeea6526cc75995fddc029987c
MD5 c4704c23727041e64ae114612848519a
BLAKE2b-256 662cda65f12f4ed8b0f925123bb872fa01710d4a1ddedea7f0018307cc4b0676

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 Sentry Error logging StatusPage Status page