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.