Location: PHPKode > scripts > AutoSlider > autoslider/README.txt
*********************************************************************
AUTOSLIDER v0.9 ------------------------------------- 15 Dec 2000
      PHP script for simple automated slide presentations 
  Italian Network of Telepathology and University of Udine, Italy

Copyright (C) 2000-02  Vincenzo Della Mea, University of Udine, Italy.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License (http://www.fsf.org/licenses/gpl.html)
as published by the Free Software Foundation.

This program 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.  See the
GNU General Public License for more details.


*********************************************************************

FILES
  autoslider.tar contains the following files:
  - autoslider.php : main PHP script
  - asg/ : directory containing button graphics for the pages (next.gif, prev.gif, etc)
  -conf.inc: sample configuration file to be put in the presentation folder
  - README : this file     

INSTALLATION
  Just untar autoloader.tar inside a web-accessible directory, then setup the variables as explained below. 

USAGE 
  Inside autoslider.php, set $slidebase as the URL of the directory where presentations are 
  kept (even on another server); it is near the <body> tag.

  Each presentation is a folder, containing images with names
  1.ext, 2.ext, ... N.ext. In addition, each folder contains a conf.inc 
  file where title, author, homepage, homepage name, file extension, and
  eventually number of slides (in the $last variable) are to be set.
  A sample conf.inc file is provided with these files. 
  You can run a presentation with:
  <your-url>/autoslider.php?presentation=foldername[&n=slidenumber]
  Each page will display title, author, 4 buttons for navigating into
  the presentation.


EXAMPLE
  at the URL http://your.site.com/dir1/dir2/slides/ there are the
  following folders: phpcourse, htmlcourse. Each of them contains the
  files named 1.jpg, 2.jpg, etc., and a conf.inc file:

	%> ls slides/*:
	phpcourse:
	1.jpg      2.jpg     3.jpg     4.jpg     5.jpg      6.jpg
	7.jpg     8.jpg     9.jpg     10.jpg   11.jpg     12.jpg      conf.php
	phpcourse:
	1.jpg      2.jpg     3.jpg     4.jpg     5.jpg      6.jpg
	7.jpg     8.jpg     9.jpg     10.jpg   11.jpg     12.jpg      conf.php

  The conf.php file inside phpcourse such file will have the following content:
  <?php
  $title = "Beatiful PHP Course";
  $author = "Phil H.P. Expert, 11/2000";
  $homepage ="http://ppp.hhh.ppp/~php/";
  $homename = "Teaching material of P.H.P. Expert";
  $imagetype =".jpg";
  $last = 12; //optional
    ?>

  Your customized autoslider.php file can be put everywhere, e.g. at
  http://your.site.com/autoslider.php and will contain these code lines:
  $slidebase = "http://your.site.com/dir1/dir2/slides/";
  $homepage = "http://www.yous.site.com/";
  To show the first presentation from the beginning, it can be called 
  as follows:
  http://your.site.com/autoslider.php?presentation=phpcourse
  To start from the fourth slide,
  http://your.site.com/autoslider.php?presentation=phpcourse&n=4
  To show the other presentation,
  http://your.site.com/autoslider.php?presentation=htmlcourse

  To show just a subset of presentation you might just pass the "last" 
  parameter too:
  http://your.site.com/autoslider.php?presentation=phpcourse&n=4&last=7
 

Return current item: AutoSlider