summaryrefslogtreecommitdiff
path: root/docs/ref/contrib/admin
diff options
context:
space:
mode:
authorBrian Holdefehr <bhold45@gmail.com>2012-12-17 19:04:10 -0500
committerTim Graham <timograham@gmail.com>2013-09-18 11:44:10 -0400
commit98514849dce07acfaa224a90a784bba9d97249e5 (patch)
treea15ade3b3380f171a9ba17e3979606e0d688b738 /docs/ref/contrib/admin
parentd1c9802811b5c3f5abd3defcfecac160135fa6e7 (diff)
Fixed #19414 -- Added admin registration decorator
Thanks stavros for the suggestion.
Diffstat (limited to 'docs/ref/contrib/admin')
-rw-r--r--docs/ref/contrib/admin/index.txt28
1 files changed, 28 insertions, 0 deletions
diff --git a/docs/ref/contrib/admin/index.txt b/docs/ref/contrib/admin/index.txt
index bc26a15b42..dd31d11dee 100644
--- a/docs/ref/contrib/admin/index.txt
+++ b/docs/ref/contrib/admin/index.txt
@@ -101,6 +101,34 @@ Other topics
admin.site.register(Author)
+The register decorator
+----------------------
+
+.. function:: register(*models, [site=django.admin.sites.site])
+
+ .. versionadded:: 1.7
+
+ There is also a decorator for registering your ``ModelAdmin`` classes::
+
+ from django.contrib import admin
+ from .models import Author
+
+ @admin.register(Author)
+ class AuthorAdmin(admin.ModelAdmin):
+ pass
+
+ It is given one or more model classes to register with the ``ModelAdmin``
+ and an optional keyword argument ``site`` if you are not using the default
+ ``AdminSite``::
+
+ from django.contrib import admin
+ from .models import Author, Reader, Editor
+ from myproject.admin_site import custom_admin_site
+
+ @admin.register(Author, Reader, Editor, site=custom_admin_site)
+ class PersonAdmin(admin.ModelAdmin):
+ pass
+
``ModelAdmin`` options
----------------------