Changes between Version 5 and Version 6 of BackwardsIncompatibleChanges

Timestamp:

Aug 16, 2005, 5:54:41 PM (20 years ago)

Author:

Adrian Holovaty

Comment:

Added "anonymous sessions" section.

BackwardsIncompatibleChanges

@@ -61 +61 @@
 ALTER TABLE auth_admin_log MODIFY object_id TEXT;
 }}}
+
+== Added support for anonymous sessions ==
+
+As of [518], Django has support for anonymous sessions. If you're using a Django database installation from before [518] and you want to use the Django admin, anonymous sessions or auth-based sessions, you'll need to make a few updates to your database and settings files.
+
+=== Change your settings files ===
+
+Add {{{"django.middleware.sessions.SessionMiddleware"}}} to the {{{MIDDLEWARE_CLASSES}}} tuple in your admin settings file. Make sure it appears before {{{"django.middleware.admin.AdminUserRequired"}}}. (The middleware classes are applied in order, and the admin middleware requires that the session middleware come first.)
+
+If you want session support any other (i.e., non-admin) Django installation, change the {{{MIDDLEWARE_CLASSES}}} setting accordingly. The order (i.e., whether it comes before or after the other installed middleware classes) doesn't matter.
+
+=== Create the core_sessions database table ===
+
+In PostgreSQL, use this:
+
+{{{
+CREATE TABLE core_sessions (
+    session_key varchar(40) NOT NULL PRIMARY KEY,
+    session_data text NOT NULL,
+    expire_date timestamp with time zone NOT NULL
+);
+INSERT INTO content_types (name, package, python_module_name) VALUES ('session', 'core', 'sessions');
+}}}
+
+In MySQL and SQLite, use this:
+
+{{{
+CREATE TABLE core_sessions (
+    session_key varchar(40) NOT NULL PRIMARY KEY,
+    session_data text NOT NULL,
+    expire_date datetime NOT NULL
+);
+}}}
+
+=== Remove old, unneeded things ===
+
+Execute this SQL in your database:
+
+{{{
+DROP TABLE auth_sessions;
+DELETE FROM content_types WHERE package = 'auth' AND python_module_name = 'sessions';
+}}}
+
+Edit your settings file(s) to remove {{{AUTH_SESSION_COOKIE}}} and {{{REGISTRATION_COOKIE_DOMAIN}}}, if they exist.