Skip to content

Latest commit

 

History

History
73 lines (53 loc) · 2.63 KB

README.md

File metadata and controls

73 lines (53 loc) · 2.63 KB
Raw

django-reverse-admin

Django package for handling 'embedded' models in the admin pages

Credits

This module was originally developed by bjourne for Django 1.1.1 and can be found on djangosnippets.

Project updated by ramusus. Updated code can be found on gist.

Original Documentation

Module that makes django admin handle OneToOneFields in a better way.

A common use case for one-to-one relationships is to "embed" a model inside another one. For example, a Person may have multiple foreign keys pointing to an Address entity, one home address, one business address and so on. Django admin displays those relations using select boxes, letting the user choose which address entity to connect to a person. A more natural way to handle the relationship is using inlines. However, since the foreign key is placed on the owning entity, django admins standard inline classes can't be used. Which is why I created this module that implements "reverse inlines" for this use case.

Example:

from django.db import models
class Address(models.Model):
    street = models.CharField(max_length = 255)
    zipcode = models.CharField(max_length = 10)
    city = models.CharField(max_length = 255)
class Person(models.Model):
    name = models.CharField(max_length = 255)
    business_addr = models.ForeignKey(Address,
                                         related_name = 'business_addr')
    home_addr = models.OneToOneField(Address, related_name = 'home_addr')
    other_addr = models.OneToOneField(Address, related_name = 'other_addr')

This is how standard django admin renders it:

http://img9.imageshack.us/i/beforetz.png/

Here is how it looks when using the reverseadmin module:

http://img408.imageshack.us/i/afterw.png/

You use reverseadmin in the following way:

from django.contrib import admin
from django.db import models
from models import Person
from reverseadmin import ReverseModelAdmin
class AddressForm(models.Form):
    pass
class PersonAdmin(ReverseModelAdmin):
    inline_type = 'tabular'
    inline_reverse = ('business_addr', ('home_addr', AddressForm), ('other_addr' (
        'form': OtherForm
        'exclude': ()
    )))
admin.site.register(Person, PersonAdmin)

inline_type can be either "tabular" or "stacked" for tabular and stacked inlines respectively.

The module is designed to work with Django 1.1.1. Since it hooks into the internals of the admin package, it may not work with later Django versions.