Help

Install

Once you have downloaded vision.txt rename it as you want with php extension (ex: index.php) and put it on your FTP in a folder containing images. Then acces to the page with your favourite web browser.

Install (suite)

By default, anybody can do allmost anything with your viewer, but you can lock / unlock some funtions giving the password you want.

To make it possible, you need to :

• Choose a password.
• Crypt it on this page (or with any other MD5 hashing software). Retreave a password from it's crypted version is impossible.
• Create a text file, copy in it your crypted password (without quotes) and save it as "_pass" (without extention).
• Upload that file in the .cache folder located in the viewer's folder, if the .cache folder doesn't exists, it means you still have not used your viewer, so you can create it yourself.

Once it's done, you will find a field to enter your not crypted password on the viewer and some functions would have disappeared, you will have to enter the good password to make those appear again.

Administrator Mode

When you enter a password, it is crypted and compared with the one you saved as _pass, if they match, a session is created and you get the administrator's rights : functions that desappeared and other ones will appear :

Functions hidden to users when an administrator acount exists

• Configuration
• Cache deletion

Fonctions only availble to the administrator

• Change the password
• Upload images
• Rename images
• Delete images
• Delete comments

Configuration

At the first start or when you ask for it, configuration page appears.

You can set :

• thumbnails size.
• viewer's title that will be shown on the web browser.
• sorting method (by date, size, name, ...).
• the number of columns and rows displayed.
• the maximum image's name's length that will be shorten.
• the display of hidden files (a file is hidden when its name begins with a dot, like under Linux)
• an inhibitor.

Thanks to the inhibitor you can make the viewer not diplay some images.
Images that have a name that contains the string you gave in the inhibitor won't be displayed

In administrator mode, you will be able to change your password. Giving an "empty" password will delete the _pass file and parameters will be availbable to anyone again.

The cache

At the first start, the viewer create a .cache folder where it will be stocked configuration file _config.ini and comments in _comments.xml.
The main function is to keep generated thumbnails, that way, they won't be regenerated at each visit.
These thumbnails are in JPEG format, their strange names are the MD5 hash of the corresponding image, that allows to be sure that thumbnails are allways corresponding to their images.

Problems

This application is under developpement; although the checks I do, bugs can remains.

The viewer checks at every use if an update exists, and update itself.
If a bug remains in the update procedure, the viewer could be unusble. If it happens, you would have to download and install again and hope the problem is solved meanwhile.

Known problems

For now, i think only to one :
Depending to your host PHP can defer, by exemple it is rare that PHP can handle GIF images, and the viewer (still) cannot know it. If you try to displey unsupported GIF images, you will get an error message.

Last change 26/06/2005