Permalink
Browse files

docs(upgrading): Warn site owners about MultiViews and /settings URLs

Fixes #8806
  • Loading branch information...
mrclay committed Sep 7, 2015
1 parent 369e9e2 commit 0ada89d68c69e6185cf3c1165f759780de8967c3
Showing with 22 additions and 0 deletions.
  1. +8 −0 docs/admin/upgrading.rst
  2. +9 −0 docs/appendix/faqs/general.rst
  3. +5 −0 install/config/htaccess.dist
View
@@ -64,6 +64,14 @@ script. You **must** remove these rewrite rules from your webserver config (e.g.
Also remove the rules for paths like ``export/*``; these endpoints have been removed.
+Apache MultiViews
+-----------------
+
+If you place your ``settings.php`` file in the installation root, Apache's MultiViews option will
+interfere with loading URLs beginning with ``/settings``. If you cannot disable MultiViews, there are
+a couple lines you must uncomment in your ``.htaccess`` file. These can be found in
+``/install/config/htaccess.dist``.
+
From 1.10 to 1.11
========================
@@ -42,6 +42,15 @@ If the white screen is due to a bad plugin, remove the latest plugins that you h
If you are getting a WSOD when performing an action, like logging in or posting a blog, but there are no error messages, it's most likely caused by non-printable characters in plugin code. Check the plugin for white spaces/new lines characters after finishing php tag (``?>``) and remove them.
+WSOD on settings pages in 2.0
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If you place your ``settings.php`` file in the installation root, Apache's MultiViews option will
+interfere with loading URLs beginning with ``/settings``. If you cannot disable MultiViews, there are
+a couple lines you must uncomment in your ``.htaccess`` file. These can be found in
+``/install/config/htaccess.dist``.
+
+
Page not found
--------------
@@ -127,6 +127,11 @@ RewriteEngine on
# hide all dot files/dirs (.git)
RewriteRule (^\.|/\.) - [F]
+# If you have settings.php in the root and cannot disable MultiViews, you will need to
+# uncomment this to access URLs starting with /settings.
+#RewriteCond %{REQUEST_FILENAME} -f
+#RewriteRule ^(settings\.php)$ index.php?__elgg_uri=$1 [QSA,L]
+
# Everything else that isn't a file gets routed through Elgg
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

0 comments on commit 0ada89d

Please sign in to comment.