JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
metaform: newline at end of run.php
[wfpl.git] / metaform / INSTALL
1 Install Instructions For The Files In This Directory
2 ====================================================
3
4 If your directory is already set up for WFPL, then all you have to do is copy
5 the files from this directory (except INSTALL and .htaccess) to that directory,
6 and it should run as-is. If not, keep reading...
7
8 Instructions For Setting Up A Directory For WFPL
9 ------------------------------------------------
10
11 1.      "cd" to the directory that will contain all your content and code files.
12
13 2.      make a "code" directory:
14
15                 mkdir code
16
17 3.      download wfpl:
18
19                 cd code
20                 git clone git://gitorious.org/wfpl/wfpl.git
21                 cd ..
22
23 4.      make the run.php link:
24
25                 ln -s code/wfpl/run.php
26
27 5.      Copy the file named ".htaccess" from this directory to the hosting folder
28         (where you put the php file.)  This is included as a separate step,
29         because the "." at the beginning makes the file hidden. This means it does
30         not show up in directory listings (unless you pass -a) and does not match
31         "*" in shell commands. Here's how you could copy it:
32
33                 cp directory-containing-this-INSTALL-file/.htaccess .
34
35 6.      If you have a domain name pointing directly at the directory you're
36         setting up (for example, it's accessible as http://example.com/) then
37         you're done! But if this directory is acessed with a directory (or
38         multiple directories) in the URL path (for example:
39         http://example.com/foo/bar/) then you'll need to edit the RewriteRule in
40         .htaccess (read the comments in that file for further explanation and
41         examples.)
42
43
44 That's it! Now that you've got the directory set up, just place your php files
45 and your html templates in there, and you should be good to go. Remember to
46 omit the file extension in the URL.