JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
metaform: fix download_tar() (stylus not less)
[wfpl.git] / INSTALL
1 INSTALLING WFPL
2
3 This directory must be accessible to your PHP files via the relative path: code/wfpl/
4
5 The recommended way to do this is to create a directory named "code" in the
6 main folder of your website. And make symbolic links to that "code" directory
7 from all directories in your website where you run PHP.
8
9 Install wfpl within that "code" directory. That is, these files should be in a
10 directory named "wfpl" in the "code" directory described above.
11
12
13
14 INSTALLING METAFORM on apache (OPTIONAL)
15
16 Note: metaform is a code generator. It is NOT required to use wfpl. It is a
17 tool for auto-generating code for your site which makes use of wfpl.
18
19 metaform.php unfortunately has a couple extra steps.
20
21 1) make a directory (named "metaform" in this example) for metaform.
22
23 2) make sure code/wfpl is accessible in this directory (link to your main
24 "code" directory) as described above
25
26 3) make a symbolic link to metaform.php called index.php:
27
28 ln -s code/wfpl/metaform.php index.php
29
30 4) make a file named .htaccess that looks like this:
31
32 php_flag register_globals off
33 php_flag magic_quotes_gpc off
34 AddDefaultCharset UTF-8
35 RewriteEngine  on
36 RewriteBase    /metaform/
37 RewriteRule    .*\.tgz$  /metaform/index.php
38
39 Note: the above .htaccess file assumes that the "metaform" directory you
40 created in step one is IN the root www directory. If it's in a sub directory
41 (for example you access it via: http://example.com/my/sub/dir/metaform/) then
42 replace the two occurrences of "metaform" in the .htaccess file with the path
43 to that directory (for example "my/sub/dir/metaform").
44
45 5) If php can't write to /tmp then you'll have to fix the $tmp_dir in
46 code/wfpl/tar.php