Changes between Version 190 and Version 191 of BackwardsIncompatibleChanges

Timestamp:

Jul 19, 2008, 12:23:26 PM (16 years ago)

Author:

Brian Rosner

Comment:

improved the newforms-admin changes.

BackwardsIncompatibleChanges

@@ -715 +715 @@
 Previously, there was one "global" version of the admin site, which used all models that contained a {{{class Admin}}}. This new scheme allows for much more fine-grained control over your admin sites, allowing you to have multiple admin sites in the same Django instance.
 
-
 === Changed Admin.manager option to more flexible hook ===
 
-As of [4342], the {{{manager}}} option to {{{class Admin}}} no longer exists. This option was undocumented, but we're mentioning the change here in case you used it. In favor of this option, {{{class Admin}}} may now define a ```queryset``` method:
+The {{{manager}}} option to {{{class Admin}}} no longer exists. This option was undocumented, but we're mentioning the change here in case you used it. In favor of this option, a {{{ModelAdmin}}} clas may now define a ```queryset``` method:
 
 {{{
@@ -733 +732 @@
 === Changed prepopulate_from to be defined in the Admin class, not database field classes ===
 
-As of [4446], the {{{prepopulate_from}}} option to database fields no longer exists. It's been discontinued in favor of the new {{{prepopulated_fields}}} option on {{{class Admin}}}. The new {{{prepopulated_fields}}} option, if given, should be a dictionary mapping field names to lists/tuples of field names. This change was made in an effort to remove admin-specific options from the model itself. Here's an example comparing old syntax and new syntax:
+The {{{prepopulate_from}}} option to database fields no longer exists. It's been discontinued in favor of the new {{{prepopulated_fields}}} option in a {{{ModelAdmin}}}. The new {{{prepopulated_fields}}} option, if given, should be a dictionary mapping field names to lists/tuples of field names. This change was made in an effort to remove admin-specific options from the model itself. Here's an example comparing old syntax and new syntax:
 
 {{{
@@ -763 +762 @@
 === Moved admin doc views into django.contrib.admindocs ===
 
-As of [4585], the documentation views for the Django admin site were moved into a new package, {{{django.contrib.admindocs}}}.
+The documentation views for the Django admin site were moved into a new package, {{{django.contrib.admindocs}}}.
 
 The admin docs, which aren't documented very well, were located at {{{docs/}}} in the admin site. They're also linked-to by the "Documentation" link in the upper right of default admin templates.
@@ -812 +811 @@
 === Inline editing ===
 
-The syntax is now different and much, much better. 
+We have significantly improved working with inlines.
+
 Here is an example:
 {{{
 #!python
-from django.contrib import admin 
-
-class ChildInline(admin.TabularInline): 
-    model = Child 
-    extra = 3 
-
-class ParentAdmin(admin.ModelAdmin):
-    model = Parent
-    inlines = [ChildInline]
-}}}
-See [http://code.djangoproject.com/browser/django/branches/newforms-admin/docs/admin.txt#L506 this documentation] for more details on field options for inline classes
+
+# OLD:
+
+class Author(models.Model):
+    name = models.CharField(max_length=100)
+
+class Book(models.Model):
+    author = models.ForeignKey(Author, edit_inline=models.TABULAR)
+    title = models.CharField(max_length=100)
+
+# NEW:
+# no longer need the edit_inline database field option above. just remove it.
+
+from django.contrib import admin
+
+class BookInline(admin.TabularInline): 
+    model = Book
+    extra = 3
+
+class AuthorAdmin(admin.ModelAdmin):
+    inlines = [BookInline]
+
+admin.site.register(Author, AuthorAdmin)
+}}}
+
+Before you would define an {{{edit_inline}}} database field option and give it the value of the type of inline you wanted, either {{{models.TABULAR}}} or {{{models.STACKED}}}. This is now done with classes and gives you much more flexibility over the options of a specific inline. See [http://www.djangoproject.com/documentation/admin/#inlinemodeladmin-objects the inlines documentation] to learn more.
 
 === Refactored inner Admin ```js``` option to media definitions ===
@@ -901 +916 @@
 === ```django.contrib.auth``` is now using newforms ===
 
-In [7191] ```django.contrib.auth``` has been converted to use newforms as
-opposed to using oldforms. If you are relying on the oldforms, you will need
-to modify your code/templates to work with newforms.
+```django.contrib.auth``` has been converted to use newforms as opposed to
+using oldforms. If you are relying on the oldforms, you will need to modify
+your code/templates to work with newforms.
 
 === Moved radio_admin from the model definition ===