Changes between Version 55 and Version 56 of NewformsAdminBranch

Timestamp:

Jul 8, 2008, 5:12:28 PM (16 years ago)

Author:

jashugan@…

Comment:

presented how to go about separating out admin functionality into its own file

NewformsAdminBranch

@@ -115 +115 @@
 In this example, the admin options still live in the {{{models.py}}} file. But there's nothing that requires them to do so. The only requirement is that the {{{register()}}} calls are executed at some point, and putting them in the {{{models.py}}} is an easy way to ensure that. We'll likely come up with a nice convention for this.[[BR]]
 
-'''A proposed convention''': Specifying all admin options in a file called {{{admin.py}}}, and import it in the {{{__init__.py}}} file of your application module to do the registering during the initialization.
+'''A proposed convention''': Specifying all admin options in a file called {{{admins.py}}}, and import it in the {{{__init__.py}}} file of your application module to do the registering during the initialization. In this case the above example would look like this:
+{{{
+#!python
+# a sample models.py file
+from django.db import models
+
+class Author(models.Model):
+    first_name = models.CharField(max_length=30)
+    last_name = models.CharField(max_length=30)
+
+    def __unicode__(self):
+        return u'%s %s' % (self.first_name, self.last_name)
+
+class Book(models.Model):
+    title = models.CharField(max_length=100)
+    author = models.ForeignKey(Author)
+
+# a sample admins.py file
+from django.contrib import admin
+
+class BookAdmin(admin.ModelAdmin):
+    list_display = ('title', 'author')
+    ordering = ('title',)
+
+# a sample __init__.py file
+from django.contrib import admin
+from models import Author, Book
+from admins import BookAdmin
+
+admin.site.register(Author)
+admin.site.register(Book, BookAdmin)
+}}}
 
 You'll notice the {{{BookAdmin}}} class looks a lot like the old-style {{{class Admin}}}. Almost all of the old {{{class Admin}}} options work exactly the same, with one or two exceptions. (For the options that have changed, we've made them '''much''' more powerful.) In addition to the classic options such as {{{list_display}}} and {{{ordering}}}, the {{{ModelAdmin}}} class introduces a wealth of extra hooks you can use to customize the admin site for that particular model. For example: