JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
updated docs
[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 RewriteEngine  on
33 RewriteBase    /metaform/
34 RewriteRule    .*\.tgz$  /metaform/index.php
35
36 Note: the above .htaccess file assumes that the "metaform" directory you
37 created in step one is IN the root www directory. If it's in a sub directory
38 (for example you access it via: http://example.com/my/sub/dir/metaform/) then
39 replace the two occurrences of "metaform" in the .htaccess file with the path
40 to that directory (for example "my/sub/dir/metaform").
41
42 5) If php can't write to /tmp then you'll have to fix the $tmp_dir in
43 code/wfpl/tar.php