Version 2.1
Author: Martin Auer
http://martin.protgp.com/dasbequemstefotoalbum/
email: martin.wien12@chello.at
© Martin Auer 2004
You are entitled to make as many copies for personal use as you need but you are not allowed to distribute this program in any way, be it commercially or non-commercially.
The script accepts images in JPG, GIF and PNG format.
It can be used in the simplest possible way: Upload all program files to the directory where your images are situated, link to index.php and go!
The script creates thumbnail images on the fly and shows them in the table of contents in the left frame, the images themselves in the main frame.The script does not need to be configured, but it can be in many ways. This happens on the page album_maintain.php. To make use of this the permissions for album.ini and album_kommentare.txt have to be set to 666 with chmod. To enable uploading and deleting of images and creation of subdirectories from within the script the permissions for the image directory have to be set to 777. Do not forget this. If you get error messages or nothing happens when you try to change things, the reason possibly are missing permissions.
To configure the album, open album_maintain.php. The initial password for the configuration page is gallery and should be changed when you first use the configure page. If you click on view album the album will open in album view and you will see a link namend admin at the bottom of the table of contents. This link will take you back to configuration view. This link will not be there when the album is opened by opening index.php directly.
To merge your image gallery into the look and feel of your site, enter as primary stylesheet the stylesheet of your site. Or you can edit the file album_prim.css. You can even place background graphics in the album directory if you name them something like album_bg_1.gif, album_bg_brownpaper.jpg. Files beginning with album_bg will not be shown in the album. To change gallery-specific styles you should edit album_sek.css. You can specify a cover image for the title page. Of yourse you can create any title page you want and name it album_main.php. (It doesn't have to have PHP functionality).
In version 1.0 one album or gallery consists of one directory.
Version 2 beta now can create galleries with a tree structure consisting of as many generations of subdirectories as you like. When you create a new subdirectory, the complete script copies itself into the new directory. This concept may seem strange, but it has some advantages. One is that no database is necessary. Each directory is a self contained album. You can grab it and put it somewhere else and it will work as if nothing had happened. Each album will automatically recognize its parent directory and will link to it if it is an album (that is, if it contains the file album.ini), just as it will link to all subdirectories if they are albums. You can navigate through the gallery using the links in the left frame. If the parent directory or a subdirectory contain images, the first or the last of them will be shown as a thumbnail in the left frame. (Wether the first or the last depends on your configuration of image sequence.) It is possible to set a different password for each directory. When you create a directory, it will also inherit the password from its parent directory. But if you change the parent's password later, the subdirectoriy's password will not be changed.
If you configure it to this, the album can also display some types of non image files, like text or HTML files. Some digital cameras for instance create text files with informations about the pictures. You might want to empty your camera's storage medium into one directory including the info.txt file or whatever it is called.
When you configure an album and then create a subdirectory, the subdirectory will automatically inherit the configuration of its parent, including styles and background-image (if correctly named). You can then navigate to the subdirectory and change its configuration. Navigation always happens in album-view, configuration in admin-view. When you create a directory the necessary permissions will be set automatically. You only have to set them for the initial directory.
You can create and delete directories from within the gallery script. But if you delete or move a directory by ftp or any other method, it will not affect the functionality of the gallery. When deleting directories you will be warned, also when you try to create a directory with the name of an existing file. You will not be warned when you try to create a directory that already exists. If you do that, all the program files will be copied into this directory again, except album_kommentare.txt (the text file containing comments). That means, if you have inadvertently damaged some program files they will be restored, and the album.ini file and style sheets will be overwritten. And that again means you will not lose your comments, and the subdirecory will be set to the configuration and styles of its parent.
What can be changed in the configuration page:
Album title
Album Subtitle
Cover image
Show title on every page
Show title page or immediately jump to first image
Size of thumbnails
Width of frames
Thumbnails labels: filename or other label or no label
Only text links, no thumbnails
Only image page, no table of contents
Sequence of images ascending or descending alphabetically
according to filename
Arbitrary links for next and previous image
Show comments
Filenames can be changed in order to change the sequence
of the images. When the name of a file is changed
the comment associated to it will be lost.
Directories can be created and deleted from within
the gallery program.
Directory names can be changed to change sequence
of albums. Albums can be named individually.
Special characters and spaces in filenames can lead to unexpected effects."-" and "_" are ok.
The zip-archive contains the following files:
index.php: the frameset containing the album
album_verzeichnis.php: contains the table of contents
in the left frame and the javascript that creates
the album pages in the right frame.
album_main.php: The title page of the album initially
contained in the main frame.
album_thumb.php: the script that creates the thumbnails.
album.ini: contains the configuration details
album_prim.css: the primary stylesheet containing
generals styles like background, font and so on.
album_sek.css: the secondary stylesheet containing
gallery-specific styles (explained in the stylesheet).
album_maintain.php: contains the forms for configuration
album_kommentare.txt: contains the comments
album_bg_1.gif: a background image
readme.htm: this page
Version 1.0
Author: Martin Auer
http://martin.protgp.com/thecushiestslideshow/
email: martin.wien12@chello.at
© Martin Auer 2004
You are entitled to make as many copies for personal use as you need but you are not allowed to distribute this program in any way, be it commercially or non-commercially.
The script accepts images in JPG, GIF and PNG format.It can be used in the simplest possible way: Upload all program files to the directory where your images are situated, link to album_slide.php and go!
The cushiest slideshow on the web will detect all the images in a directory and will display them in a dynamic slideshow. If you are happy with the presets you don't have to configure a thing. But of course you can set the duration ofthe slides, you can add a title to the show and idividual comments to each picture. Configuration happens on the page album_slide_maintain.php. To make use of this the permissions for album_slide.ini and album_kommentare.txt have to be set to 666 with chmod. To enable uploading and deleting of images from within the script the permissions for the image directory have to be set to 777. Do not forget this. If you get error messages or nothing happens when you try to change things, the reason possibly are missing permissions.
To configure the slideshow, open album_slide_maintain.php. The initial password for the configuration page is gallery and should be changed when you first use the configuration page. If you click on view slideshow the slideshow will open in slideshow view and you will see a link namend admin at the bottom left. This link will take you back to configuration view. This link will not be there when the slideshow is opened by opening album_slide.php directly.
To merge your slideshow into the look and feel of your site, enter as primary stylesheet the stylesheet of your site. Or you can edit the file album_prim.css. You can even place background graphics in the slideshow directory if you name them something like album_bg_1.gif, album_bg_brownpaper.jpg. Files beginning with album_ will not be shown in the slideshow. To change slideshow-specific styles you should edit album_sek.css.
The cushiest slideshow on the web makes use of the blendTrans and revealTrans styles proprietary to MS Internet Explorer. This allows you to choose between 25 transition effects from smooth crossfade to all sorts of fancy transitions. Although only Internet Explorer supports theses transition effects the slideshow will still work in all browsers.
The admin panel also provides forms for uploading and deleting images, and also for renaming files to change the sequence of the show. (When renaming an image its comment will be lost and has to be entered again).
A slideshow looks best if all images are of the same format, especially when you use transition effects. That is why a utility to resize your images online is included. You can resize all or selected images in a direcotry to the same width and/or height or by an arbitrary percentage. This may come in handy when you upload pictures from a place where you don't have access to your image processing program.
You can use the cushiest slideshow on the web as a standalone application or you can integrate it into a web-page. The best way is to create a table and to put <?php include ("album_slide.php") ?> into a cell of appropriate size. Tick the appropriate field in the configuration panel to tell the slideshow that it is included. If you want to use images on the page that should not be shown in the slideshow, for instance a logo, you must put them in a different directory or give them a filename beginning with album_ (e.g. album_logo.jpg).
The cushiest slideshow on the web will also integrate into the cushiest image gallery on the web. When the cushiest image gallery on the web detects the presence of the cushiest slideshow on the web in the directory it will automatically create a link labelled Slideshow giving the user the choice either to click thumbnails or to lean back and watch the show. With the cushiest image gallery on the web you can also create a directory tree that contains multiple slideshows.
Additional files for the cushiest slideshow on the web:
album_slide.php: The slideshow
album_slide_maintain.php: Configuration panel
for the slideshow
album_resize.php: Doesn't do the resizing but
creates the thumbnails for album_slide_maintain.php
album_slide.ini: Contains the configuration
settings for the slideshow