81 lines
		
	
	
		
			3.1 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			81 lines
		
	
	
		
			3.1 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
| # Quick installation instruction
 | |
| 
 | |
| The installation of InDefero is composed of 2 parts, first the
 | |
| installation of the [Pluf framework](http://www.pluf.org) and second,
 | |
| the installation of InDefero by itself.
 | |
| 
 | |
| ## Installation of Pluf
 | |
| 
 | |
| * Checkout the trunk of [Pluf](http://www.pluf.org).
 | |
| * Install the `Mail` and `Mail_mime` classes from [PEAR](http://pear.php.net). You must use the `--alldeps` flag when installing these modules:
 | |
| 
 | |
|     $ sudo pear install --alldeps Mail
 | |
|     $ sudo pear install --alldeps Mail_mime
 | |
| 
 | |
| The Pluf installation folder is the folder containing the file `Pluf.php`.
 | |
| 
 | |
| ## Installation of InDefero
 | |
| 
 | |
| The installation is composed of the following steps:
 | |
| 
 | |
| * Get the InDefero archive.
 | |
| * Configure it correctly.
 | |
| * Installation the database with the `migrate.php` script.
 | |
| * Bootstrap the application with a `bootstrap.php` script.
 | |
| 
 | |
| Here is the step-by-step installation procedure:
 | |
| 
 | |
| * Extract the InDefero archive somewhere.
 | |
| * The InDefero installation folder is the folder containing this file INSTALL.mdtext.
 | |
| * 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.
 | |
| * Open a terminal/shell and go into the InDefero installation folder.
 | |
| * Run `php /path/to/pluf/src/migrate.php --conf=src/IDF/conf/idf.php -a -i -d -u` to test the installation of the tables.
 | |
| * Run `php /path/to/pluf/src/migrate.php --conf=src/IDF/conf/idf.php -a -i -d` to really install the tables.
 | |
| * Create a bootstrap file to create the first project and admin user for example `www/bootstrap.php`. Do not forget to update the second line with your path to Pluf:
 | |
| 
 | |
|     <?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 www/bootstrap.php`.
 | |
| * Remove the `www/bootstrap.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
 | |
| 
 | |
| 
 |