Changes between Version 188 and Version 189 of BackwardsIncompatibleChanges

Timestamp:

Jul 18, 2008, 11:35:33 PM (16 years ago)

Author:

Brian Rosner

Comment:

added a bit about the admin urls.py change.

BackwardsIncompatibleChanges

@@ -686 +686 @@
 As of [7967] we have merged newforms-admin into trunk. Here is list of things that have changed:
 
+A lot has changed in this branch. Let's start with the syntax for URLconfs:
+
+{{{
+#!python
+
+# OLD:
+from django.conf.urls.defaults import *
+
+urlpatterns = patterns('',
+    (r'^admin/', include('django.contrib.admin.urls')),
+)
+
+# NEW:
+from django.conf.urls.defaults import *
+from django.contrib import admin
+
+admin.autodiscover()
+
+urlpatterns = patterns('',
+    (r'^admin/(.*)', admin.site.root),
+)
+}}}
+
+Note that, in this above URLconf example, we're dealing with the object {{{django.contrib.admin.site}}}. This is an instance of {{{django.contrib.admin.AdminSite}}}, which is a class that lets you specify admin-site functionality. The object {{{django.contrib.admin.site}}} is a default {{{AdminSite}}} instance that is created for you automatically, but you can also create other instances as you see fit.
+
+We use the {{{admin.autodiscover()}}} call above to force the import of the {{{admin.py}}} module of each {{{INSTALLED_APPS}}} entry. This won't be needed if you use your own {{{AdminSite}}} instance since you will likely be importing those modules explicily in a project-level {{{admin.py}}}. This was added in [7872].
+
+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 ===