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

Uploaded Source

File details

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

File metadata

File hashes

Hashes for django-fsm-admin-1.0.0.tar.gz
Algorithm Hash digest
SHA256 975e818d854bbed423334c8937a623636dd56d57671a05bfaa88783a6cf86bd0
MD5 5b58703ca80f3eb0ac8953b6a4f72533
BLAKE2b-256 c1ebc301eb766de2dea6c2e2e1f8fab2fa01fc2fe3267a05adfce87ccafa97c9

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