Changes between Version 240 and Version 241 of BackwardsIncompatibleChanges

Timestamp:

Aug 21, 2008, 2:59:17 PM (16 years ago)

Author:

Brian Rosner

Comment:

fixed #8474. added an explicit example of the ModelAdmin.

BackwardsIncompatibleChanges

@@ -712 +712 @@
 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.
 
+=== Moved inner-model ```class Admin``` to ```ModelAdmin``` classes ===
+
+The syntax to define your models in the admin has changed slightly. It is now longer in your model and is instead in an application level ```admin.py``` module. Here is a quick example showing you the change:
+
+{{{
+#!python
+
+# OLD:
+# models.py
+from django.db import models
+
+class MyModel(models.Model):
+    name = models.CharField(max_length=100)
+
+    class Admin:
+        pass
+
+# NEW:
+# models.py
+from django.db import models
+
+class MyModel(models.Model):
+    name = models.CharField(max_length=100)
+
+# admin.py
+from django.contrib import admin
+from myproject.myapp.models import MyModel
+
+admin.site.register(MyModel)
+}}}
+
+If your old inner admin class defined options that controlled the behavior of the admin they have moved to class level in a ```ModelAdmin``` class. All options are the same with the exception of the ones noted in this section below.
+
+{{{
+#!python
+
+# OLD:
+# models.py
+from django.db import models
+
+class MyModel(models.Model):
+    name = models.CharField(max_length=100)
+
+    class Admin:
+        list_display = ('name',)
+
+# NEW:
+# models.py
+from django.db import models
+
+class MyModel(models.Model):
+    name = models.CharField(max_length=100)
+
+# admin.py
+from django.contrib import admin
+from myproject.myapp.models import MyModel
+
+class MyModelAdmin(admin.ModelAdmin):
+    list_display = ('name',)
+
+admin.site.register(MyModel, MyModelAdmin)
+}}}
+
 === Changed Admin.manager option to more flexible hook ===