Read Me

Fisherman's Slide Show v.1.08

Fisherman's Slide Show is PHP script which resizes and displays your images with JPG, GIF or PNG extension from chosen directory. Fisherman's Slide Show is nice and simple way to create presentations or image gallery on your site.

Copyright (C) 2005 Wangchuk Sonam
Fisherman's Slide Show is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
Fisherman's Slide Show is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

For newer version check phoenix.frihost.net/fisherman/read_me.php

Features:

1. Grab images from chosen directory
2. Slide show with your timing
3. Resize images on your predefined dimensions
4. Show three types of images - JPG (JPEG), GIF and PNG. Also, you can
display single type, any types combination or all types at once
5. Possibility to show/hide description, define font, etc.
6. Set target URL from images - on original image, predefined URL in
description.txt or none
7. For descriptions use Flat File (txt file) and not MySQL or any other DB
8. Does not need Java or JavaScript enabled

and much more...

Installation:

Extract Fisherman's.zip in root folder.
In a new subfolder "Fisherman's" find seven files: slideshow.php, custom.php, frame.php, Fisherman's.php, description.txt, read_me.php and GNU License.

Put this script below on your php page...

<?php
include $_SERVER["DOCUMENT_ROOT"] . "/Fisherman's/slideshow.php";
?>

...and in browser you will see Fisherman's Slide Show with three example.

Then open custom.php and and customize slide show with your preferences. Additional instructions you will find inside custom.php.

Image Sorting:

Fisherman's Slide Show by default sorts your images by their names. For example if you have three images with names mercedes.jpg, ford.jpg and hundai.jpg Fisherman's will first display ford.jpg then hundai.jpg and on the end mercedes.jpg.

How to sort images in other ways?

Sorting by numbers:
Just type number and hyphens (-) at the beginning of image name and Fisherman's will sort your images following the order of numbers. E.g. 1-ford.jpg, 2-mercedes.jpg and 3-hundai.jpg will result with displaying ford.jpg, mercedes.jpg and hundai.jpg.

How to push some images in front of others:
If you set numbers only for few images, not for all, Fisherman's will pick up those images and display them first. Others will sort by the name. E.g. 1-ganga.jpg will come before amazona.jpg. and bahamas.jpg

How to push some images behind of all others:
If you have lot of images and you don't want to use numbers on all, you can push some images backward with letters zz and number. For example
zz1-amazona.jpg and zz2-ganga.jpg Fisherman's will display them behind of all others.

How to display complexly name (if is in custom.php preset 2 for displaying image names)?

Just use underscore (_) in your image name. E.g. My_new_house.jpg Fisherman's will display like My new house.

Note:
1. Don't use dots in your image names. Dot is exclusively used for extensions.
2. Fisherman's will not resize images which both dimensions are smaller then preset image height and width in custom.php.
3. Fisherman's will remove numbers and letters in the front of your image names and extensions at the end if you preset show name on 2 in custom.php. In that case 2-Mercedes.jpg will display Mercedes,
zz1-AMAZONA.jpg will display AMAZONA and 1-My_new_house.jpg will display My new house in the following ordrer:

My new house
Mercedes
AMAZONA

Important:
Optimize your images for faster download and displaying.

Description.txt customatization (if you preset 1 for description in custom.php):

Every row in description.txt is divided in three columns and every row defines one image. You can set descriptions for all images or only for few because Fisherman's Slide Show will find appropriate image. In the first column you need to type name of image (with extension). In second target URL (Fisherman's Slide Show will ignore this column if you preset in custom.php 0 - URL to original image or 2 - without URL). In the third column you need to type image description. You can use html definitions for better view or links, too.

NOTE:
Every definition for each image starts in new line but doesn't break anyway this definition with Enter or Ctrl+Enter (html code are included). Otherwise you will see only part of your description.

Simple example for description.txt:

JPG_image1.jpg|http://www.phoenix.frihost.net|Free PHP scripts!
PNG_image2.png|http://www.phoenix.frihost.net|<center>Phoenix free PHP scripts!</center> Free PHP scripts for everyone.
GIF_image3.gif|http://www.linklottery.phoenix.frihost.net|<center>Link Lottery</center> Free, fun and reliable game. Link Lottery daily draw out three winners. Read more about: <center><a href="http://www.linklottery.phoenix.frihost.net/index.php" target="_blank" >Link Lottery</a></center>

That’s all, folks. Have fun!

If you use Fisherman's Slide Show and would like to help us please rate it, place a link to us on your website or refer to us in one of good webmaster's forum. Thank you!