Changes between Version 11 and Version 12 of BackwardsIncompatibleChanges

Timestamp:

Oct 18, 2005, 7:44:50 PM (20 years ago)

Author:

Adrian Holovaty

Comment:

Added preliminary "Refactored the admin app" section (Refs #627)

BackwardsIncompatibleChanges

@@ -114 +114 @@
 
 As of [867], {{{django.core.template_loader}}} is deprecated. Use {{{django.core.template.loader}}} instead.
+
+== Refactored the admin app not to require its own settings file ==
+
+As of an upcoming changeset, the admin will have been refactored.
+
+=== What changed ===
+
+ * The admin no longer requires its own settings file. The "main" site and admin site can run on the same Django installation.
+ * All the admin code moved to {{{django/contrib/admin}}}.
+ * If you're using the admin, you need to add {{{"django.contrib.admin"}}} to your {{{INSTALLED_APPS}}}.
+ * The admin database table isn't installed unless you explicitly have the admin installed ({{{django-admin.py install admin}}}).
+ * Renamed the admin log database table to give it a {{{"django"}}} prefix.
+
+=== How to update your code ===
+
+If you're using a Django installation from before this changeset, do the following to restore your admin site:
+
+ * Execute this SQL command: {{{ALTER TABLE auth_admin_log RENAME TO django_admin_log;}}}
+ * Edit your Django settings file (probably called {{{settings/main.py}}}) to make the following changes:
+   * Add {{{"django.contrib.admin"}}} to {{{INSTALLED_APPS}}}. Order doesn't matter; it can be the first, last, whatever.
+   * Remove {{{"django.middleware.admin.AdminUserRequired"}}} from {{{MIDDLEWARE_CLASSES}}}, if it's in there.
+   * Add {{{"django.middleware.sessions.SessionMiddleware"}}} to {{{MIDDLEWARE_CLASSES}}}, if it's not already in there.
+   * Add {{{"django.core.template.loaders.app_directories.load_template_source"}}} to {{{TEMPLATE_LOADERS}}}, after {{{"django.core.template.loaders.filesystem.load_template_source"}}}. If you don't have the {{{TEMPLATE_LOADERS}}} setting, set it to this:
+     {{{
+     TEMPLATE_LOADERS = (
+         'django.core.template.loaders.filesystem.load_template_source',
+         'django.core.template.loaders.app_directories.load_template_source',
+     )
+     }}}
+
+ * Remove your admin settings file (probably called {{{settings/admin.py}}}) and admin URLconf (probably called {{{settings/urls/admin.py}}}).
+ * Edit your main URLconf (probably called {{{settings/urls/main.py}}}) and add this line:
+
+     {{{
+     (r'^admin/', include('django.contrib.admin.urls.admin')),
+     }}}
+
+   Change that {{{"admin"}}} to whatever URL you were using for the admin site.
+
+The following steps are optional but will tighten your code up. All assume your project is called {{{myproject}}}.
+
+ * Move {{{myproject/settings/urls/main.py}}} to {{{myproject/urls.py}}}.
+ * Delete {{{myproject/settings/urls/admin.py}}} (unless you had custom things in it, of course).
+ * Move {{{myproject/settings/main.py}}} to {{{myproject/settings.py}}}.
+ * Edit {{{myproject/settings.py}}} to change {{{ROOT_URLCONF}} from {{{"myproject.settings.urls.main"}}} to {{{"myproject.urls"}}}.