make metaform tarballs come with install doc

[wfpl.git] / metaform / htaccess

diff --git a/metaform/htaccess b/metaform/htaccess
index 4073890..acd597b 100644 (file)
--- a/metaform/htaccess
+++ b/metaform/htaccess
@@ -1,6 +1,31 @@
+# Tell php not to mangle form data or let the user set globals.
 php_flag register_globals off
 php_flag magic_quotes_gpc off
-Options -MultiViews
+
+# All your files are UTF-8... RIGHT?
 AddDefaultCharset UTF-8
+
+############ START OF PRETTY URLS SETTINGS
+# This section contains directives to enable pretty URLs, and instruct apache
+# to run wfpl on them. This runs code/config.php if it exists, then loads
+# templates, then loads the php file, and call's it's main function. See
+# code/wfpl/run.php and code/wfpl/README for more details.
+
+# To have "pretty" urls (no file extension at the end) we use mod_rewrite. But
+# first we've got to disable a couple url-mangling features of apache that take
+# precedence over mod_rewrite:
+Options -MultiViews
+DirectorySlash Off
+
+# Activate mod_rewrite:
 RewriteEngine  on
-RewriteRule    ^[^/.]*$  /~form~/run.php
+
+# Unfortunately, the rewrite rules only work with absolute paths, so if your
+# files are not at the top level of the domain, you'll have to customize this
+# part. Here's the config for running at the top level:
+RewriteRule    ^[^/.]*$  /run.php
+
+# use this line instead if you have this (.htaccess) file and your php and html
+# files in the ~form~ directory:
+#RewriteRule    ^[^/.]*$  /~form~/run.php
+############ END OF PRETTY URLS SETTINGS