added changelog entries for version 1.1
[phpfspot.git] / INSTALL
1 phpfspot install howto:
2
3 * requirements
4  
5  - apache/apache2 (in fact any webserver which supports php)
6  - php5
7    - the following extensions must be available
8      (compiled in or as shared object):
9      * gd
10      * sqlite3 (native or as PDO driver)
11    - PEAR extensions (pear install %name%)
12      * Calendar
13      * HTML_AJAX
14  - smarty (php template engine, http://smarty.php.net)
15  - sqlite3
16   
17 * installation
18
19  1. copy the sample phpfspot-config-file to your new config file
20
21     cp phpfspot_cfg.php.dist phpfspot_cfg.php
22
23  2. Edit phpfspot_cfg.php and edit the necessary configuration
24     parameters. This file also include explanation of each option.
25     Take care that the path to the f-spot database (photos.db)
26     and the f-spot photo base directory (usally Photos) is set
27     correctly.
28
29  3. Open phpfspot in our favourite browser. The URL depends what
30     you have specify as $webpath in the configuration var. But
31     usually it will be http://myserver/phpfspot (where myserver
32     is your webservers IP, server name, virtual host name, ...).
33
34  4. To pre-create all thumbnails invoke the script gen_thumbs.php
35
36     cd ${phpfspot_home}
37     "./gen_thumbs.php"
38     or 
39     "php gen_thumbs.php" (if execute-permission is not set)
40
41     thumbnails can also be created on-the-fly by the webserver but
42     this will take away a lot of resources of your system during
43     thumb-generation. pre-creation on the shell works faster.