indefero/INSTALL.mdtext

# Quick installation instruction

* Checkout the trunk of [Pluf](http://www.pluf.org).
* Install the `Mail` and `Mail_mime` classes from [PEAR](http://pear.php.net).
* Make a copy of `src/IDF/conf/idf.php-dist` as `src/IDF/conf/idf.php`.
* Update the idf.php file to match your system.
* Run `php /path/to/pluf/src/migrate.php --conf=IDF/conf/idf.php -a -i -d -u` to test the installation of the tables.
* Run `php /path/to/pluf/src/migrate.php --conf=IDF/conf/idf.php -a -i -d` to really install the tables.
* Create a bootsrap file to create the first project and admin user for example `www/bootstrap.php`:

    <?php
    set_include_path(get_include_path().PATH_SEPARATOR.dirname(__FILE__).'/../src');
    set_include_path(get_include_path().PATH_SEPARATOR.'/path/to/pluf/src');
    require 'Pluf.php';
    Pluf::start(dirname(__FILE__).'/../src/IDF/conf/idf.php');
    Pluf_Dispatcher::loadControllers(Pluf::f('idf_views'));
    
    $project = new IDF_Project();
    $project->name = 'Your project';
    $project->shortname = 'yourproject'; //Only letters digits
    $project->description = 'This is your project.';
    $project->create();
    $user = new Pluf_User();
    $user->first_name = 'John';
    $user->last_name = 'Doe';
    $user->login = 'doe';
    $user->email = 'doe@example.com';
    $user->password = 'yourpassword'; // the password is salted/hashed 
                                      // in the database, so do not worry :)
    $user->administrator = true;
    $user->active = true;
    $user->create();
    print "Bootstrap ok\n";
    ?>

* Run `php bootstrap.php`.
* Remove the `bootstrp.php` file.

Now you can login with this user into the interface.

## For the Apache Webserver Users

If you are using [Apache](http://httpd.apache.org/) for your webserver
and want to have nice URLs like `http://yourdomain.com/p/yourproject/`
and not `http://yourdomain.com/index.php/p/yourproject/` you can use
the following `.htaccess` file to be put in the same folder of the
`www/index.php` file.

    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^(.*) /index.php/$1