Changes between Version 26 and Version 27 of BackwardsIncompatibleChanges

Timestamp:

Nov 10, 2005, 10:34:44 PM (19 years ago)

Author:

Adrian Holovaty

Comment:

Added "Separated flatpages and redirects into standalone, optional apps" section

BackwardsIncompatibleChanges

@@ -117 +117 @@
 == Refactored the admin app not to require its own settings file ==
 
-As of an upcoming changeset, the admin will have been refactored, to make things simpler and tighter -- both conceptually and in code layout.
+As of [948], the admin has been refactored, to make things simpler and tighter -- both conceptually and in code layout.
 
 === What changed ===
@@ -215 +215 @@
  * Change {{{DJANGO_SETTINGS_MODULE}}} in Apache configuration from {{{"myproject.settings.main"}}} to {{{"myproject.settings"}}}.
  * Having done all this, delete the directory {{{myproject/settings}}}.
+
+== Separated flatpages and redirects into standalone, optional apps ==
+
+As of ____, flatpages and redirects, previously installed by default, are now optional add-ons. Now they must be installed manually.
+
+=== What changed ===
+
+ * The flatpages and redirects database files are no longer installed by default.
+ * Renamed all references to "flatfiles" -- a previous name for flatpages -- to "flatpages", to be unambiguous.
+ * Renamed the flatpages and redirects database tables.
+ * Moved all flatpages and redirects logic from throughout the Django code to {{{django.contrib}}}.
+ * To use flatpages and redirects, you now need to specify them in {{{INSTALLED_APPS}}} -- use {{{"django.contrib.flatpages"}}} and {{{"django.contrib.redirects"}}}.
+
+=== How to update your code ===
+
+If you're using a Django installation from before this changeset, do the following to restore flatpages and redirects functionality:
+
+==== If you don't want to use flatfiles ====
+
+ * Execute the following SQL:
+   {{{
+   DROP TABLE flatfiles;
+   DROP TABLE flatfiles_sites;
+   DELETE FROM auth_permissions WHERE package = 'core' AND codename IN ('add_flatfile', 'change_flatfile', 'delete_flatfile');
+   DELETE FROM content_types WHERE package = 'core' AND python_module_name = 'flatfiles';
+   }}}
+
+==== If you don't want to use redirects ====
+
+ * Execute the following SQL:
+   {{{
+   DROP TABLE redirects;
+   DELETE FROM auth_permissions WHERE package = 'core' AND codename IN ('add_redirect', 'change_redirect', 'delete_redirect');
+   DELETE FROM content_types WHERE package = 'core' AND python_module_name = 'redirects';
+   }}}
+
+==== If you do want to use flatfiles and redirects ====
+
+ * Execute the following SQL:
+   {{{
+   ALTER TABLE redirects RENAME TO django_redirects;
+   ALTER TABLE flatfiles RENAME TO django_flatpages;
+   ALTER TABLE flatfiles_sites RENAME TO django_flatpages_sites;
+   ALTER TABLE django_flatpages_sites RENAME flatfile_id TO flatpage_id;
+   INSERT INTO packages (label, name) VALUES ('flatpages', 'flatpages');
+   UPDATE content_types SET package = 'flatpages', python_module_name = 'flatpages' WHERE package = 'core' AND python_module_name = 'flatfiles';
+   UPDATE auth_permissions SET package = 'flatpages' WHERE package = 'core' AND codename IN ('add_flatfile', 'change_flatfile', 'delete_flatfile');
+   INSERT INTO packages (label, name) VALUES ('redirects', 'redirects');
+   UPDATE content_types SET package = 'redirects', python_module_name = 'redirects' WHERE package = 'core' AND python_module_name = 'redirects';
+   UPDATE auth_permissions SET package = 'redirects' WHERE package = 'core' AND codename IN ('add_redirect', 'change_redirect', 'delete_redirect');
+   }}}
+ * If you're using PostgreSQL, execute this SQL:
+   {{{
+   ALTER TABLE redirects_id_seq RENAME TO django_redirects_id_seq;
+   ALTER TABLE django_redirects ALTER COLUMN id DROP DEFAULT;
+   ALTER TABLE django_redirects ALTER COLUMN id SET DEFAULT nextval('public.django_redirects_id_seq'::text);
+   ALTER TABLE flatfiles_id_seq RENAME TO django_flatpages_id_seq;
+   ALTER TABLE django_flatpages ALTER COLUMN id DROP DEFAULT;
+   ALTER TABLE django_flatpages ALTER COLUMN id SET DEFAULT nextval('public.django_flatpages_id_seq'::text);
+   }}}
+ * If you have a {{{flatfiles/default.html}}} template, rename it to {{{flatpages/default.html}}}.
+ * In every one of your flatpage templates, change the variable {{{flatfile}}} to {{{flatpage}}}.
+ * If you use the URLconf {{{django.conf.urls.flatfiles}}}, now point to {{{django.contrib.flatpages.urls}}}.
+ * If you have a {{{USE_FLAT_PAGES}}} setting, remove it.