GIS 1.1 HOWTO by fisk

1. Credits
2. Brief introduction
3. Install overview
4. Installation



---
1. Credits
---

     Written by: Gussoh
Co-developed by: Fredrik


---
2. Brief introduction
---
Gussoh ImageSystem (GIS) is a PHP-based script that automatically makes thumbnails out of JPEG-files, for viewing on the web. It uses the PHP-GD extension and caches the thumbnails for faster viewing. GIS uses PHP 4.x and GD 1.x or 2.x. It is written and maintained primarily by Gustav "Gussoh" Sohtell.


---
3. Install overview
---

First of all you will need PHP installed in your operating system, the currently latest release is 4.3.0 which also contains the PHP-GD extension. However if you choose to install a previous version you will need the PHP-GD (preferrably version 2.x), which you can obtain from here:

http://www.boutell.com/gd/

or PHP 4.3.0 which is available from here:

http://www.php.net/

Then you need to setup your webserver with PHP4-support, and then you need to configure PHP4 to support GD, this is available in separate documents and will *NOT* be handled here.

---
Installation
---

Place the files within the archive at a path you wish to use the GIS in (ie. /var/www/gis/)

Rename the index.phps to index.php by typing:

# mv index.phps index.php   (without the #)

Then edit the index.php with your favourite editor, these are the lines you can change:


###################CODE####################

$max_width = 100; /* thumnail maxwidth */
$max_height = 100; /* maxheight */
$screenwidth = 790; /* standardwidth of the browser */
$quality = 70; /* jpg quality of the thumbnails (to update you'll have to remove all the .thumb-files) */
$imagespacing = 20; /* space between each picture, standard at 20 */

$gd = 2; /* This is your phpGD-version. If you have phpGD 2.x installed (or later), write 2 here
                If you are using phpGD 1.x, write 1 here. */
$show_hidden_folders = false; /* If you want to show folders starting with '.' */

/*      Icons, use any browsersupported imagetype. Standard size is 11x11px. Gif is recommended.
        do NOT use spaces in your filename, it will NOT work.
        If you don't want any icon, just remove the line or comment it using '//' */

//$foldericon = "../folder.gif"; /* folder icon */
$foldericon = "../folder.gif"; /* folder icon */
//$folderupicon = "../folderup.gif"; /* foldericon to go up one level in the tree */
$folderupicon = "../folder.gif"; /* foldericon to go up one level in the tree */
$aviicon = "../avi.gif"; /* .avi icon */
$wmvicon = "../wmvicon.gif"; /* .wmv icon */
$gificon = "../gificon.gif"; /* .gif icon */

//$aviicon = "../transicon.gif"; /* .avi icon */
//$wmvicon = "../transicon.gif"; /* .wmv icon */
//$gificon = "../transicon.gif"; /* .gif icon */

/* Right now you can't add your own icons by yorself (without changing the code),
   send me a mail with your new icon and perhaps I'll add it. */

/* This sets the DEFAULT order of the files and folderlistings use "date" to sort by date or nothing ("") to sort by alphabet. */
$order = "date";

##############################################

If you dislike having all the images (ie. avi.gif, folder.gif, etc.) shown in your root-
-path then just configure it like above, and move all these to the parent path:

# mv *.gif ..   (without the #)

Also, all directories which GIS uses needs to be '777', so it can create the thumbnails,
otherwise the program will crash with a horrible end.

That should be it, place all the images you want in the GIS-directory, and browse to it,
it will take some time to load (to create all the thumbnails), but after that it smooth.