Changes between Version 12 and Version 13 of NewformsAdminBranch

Timestamp:

Apr 6, 2007, 11:31:28 PM (17 years ago)

Author:

Adrian Holovaty

Comment:

Added "Backwards-incompatible changes" section, which is incomplete

NewformsAdminBranch

@@ -44 +44 @@
 || Change {{{raw_id_admin}}} so that it's a {{{class Admin}}} option rather than being a database {{{Field}}} option. || Done in [4430] ||
 || Figure out a cleaner way of specifying admin options, now that {{{class Admin}}} is much more powerful. It doesn't feel like it should live in the model anymore. || Not done yet; discussion is [http://groups.google.com/group/django-developers/browse_frm/thread/d94c7b11392c5085/# here] ||
+
+== Backwards-incompatible changes ==
+
+This is a (currently incomplete) list of backwards-incompatible changes made in this branch.
+
+=== 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 one of these methods:
+
+  * {{{queryset()}}}
+  * {{{queryset_add()}}}
+  * {{{queryset_change()}}}
+
+These give you much more flexibility.
+
+Note that this change was made to the NewformsAdminBranch. (We initially called the new method {{{change_list_queryset}}}, but this was changed in [4584] to be more flexible.) The change will not be made to trunk until that branch is merged to trunk.
+
+=== 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. Here's an example comparing old syntax and new syntax:
+
+{{{
+#!python
+
+# OLD:
+class MyModel(models.Model):
+    first_name = models.CharField(maxlength=30)
+    last_name = models.CharField(maxlength=30)
+    slug = models.CharField(maxlength=60, prepopulate_from=('first_name', 'last_name'))
+
+    class Admin:
+        pass
+
+# NEW:
+class MyModel(models.Model):
+    first_name = models.CharField(maxlength=30)
+    last_name = models.CharField(maxlength=30)
+    slug = models.CharField(maxlength=60)
+
+    class Admin:
+        prepopulated_fields = {'slug': ('first_name', 'last_name')}
+}}}
+
+Note that this change was made to the NewformsAdminBranch. The change will not be made to trunk until that branch is merged to trunk.
+
+=== 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 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.
+
+Because we've moved the doc views, you now have to activate admin docs explicitly. Do this by adding the following line to your URLconf:
+
+{{{
+#!python
+(r'^admin/doc/', include('django.contrib.admindocs.urls')),
+}}}
+
+Note that this change was made to the NewformsAdminBranch. The change will not be made to trunk until that branch is merged to trunk.