Installation and Configuration
Installation
To use the complete functionallity of the gallery you have to have php > 4.3.0 and gdlib > 2.0.1 (To run the gallery with less
prerequisites
- see here how to install the version with less functionallity). You don't need a database because all titles and comments are stored in XML files in the cache folder.
The installation is really easy:
- Extract the downloaded archive into a folder on the web server (root folder possible since v1.01)
- Make the directory 'cache', 'counter' and 'xml' read and writeable (chmod 777) on the webserver.
- Copy the folders of your pictures into the 'picture' directory (Only one level is supported!). The directory name is the name of the gallery.
- To protect a gallery with a password you have to make an empty file with the name 'private' in the folder of the gallery. The password is the one from the config.php. To use a indivitual password for a gallery you have to insert this password into the 'private' file.
- Adapt the config.php to your needs (change passwords!).
- You can change the titel of the gallery in the language/language_<language>.php file at $lang_titel
- Have fun with the TinyWebGallery - It would be great to get some feedback if you are using the TinyWebGallery.
Forum
There is no need for a forum yet. If you have questions, problems or want to give some feedback - Just send a email. I will answer everything as soon as possible.
Configuration
Configuration of the border
- &noborder=true - Adding this parameter to the url disables the border.
- &withborder=true - Adding this parameter to the url enables the border.
- &smallnav=true - Adding this parameter to the url disables the big navigation on the details page.
- &bignav=true - Adding this parameter to the url enables the big navigation on the details page.
The remaining configurations can be done in the config.php.
- $default_language - The gallerie is started with this language if no language from the browser can be read.
To add a new language you have to translate one of the existing languagefile (e. g. language/language_de.php - the name of the needed flag is language/language_de.gif) and copy it in the 'language' directory (+ the flag).
- $basedir - This is the directory where the directories with the images has to be copied.
- $cachedir - This is the directory where all generated images are cached. This directory has to be made read- and writeable on the web server.
- $counterdir - This is the directory where all the counter data is stored. This directory has to be made read- and writeable on the web server.
- $xmldir - This is the directory where all xml files for titles and comments are stored. This directory has to be made read- and writeable on the web server.
- $thumbnails_x - Number of images in a row on the thumbnail page.
- $thumbnails_y - Number of images in a column on the thumbnail page.
- $titelpasswort - The password used for entering titles, delete comments and rotate images permanently.
- $privatepasswort - To protect a gallery with a passwort you have to create a empty file with the name 'private' in the direcory you want to protect. If you want to protect a gallery with a different password you have to enter the password in the 'private' file.
- $menu_y - Number of galleries which are shown in a row on the overview page.
- $kommentare - Enables comments (Enter, Display).
- $show_number_of_pic - Show the number of images in a gallery in the overview.
- $extension_slideshow - Extension for slideshow images (stored in the $cachedir).
- $extension_thumb - Extension for thumbnail images (stored in the $cachedir).
- $extension_small - Extension for the web images (stored in the $cachedir).
- $small_pic_size - max. size of the web images.
- $thumb_pic_size - max. size of the thumbnails.
- $menu_pic_size_x - width of the Galerie overview pictures - has to be dividable by 2
- $menu_pic_size_y - height of the Galerie overview pictures - has to be dividable by 2.
- $compression - compression of the generated images. 80 is a good value. Generates thumbnails (size 100) of ~ 4k. Generates web images (size 480) of ~ 33k
- $slideshow_backcolor_R - Background color of the slideshow images - R part of the RBG value as decimal value.
- $slideshow_backcolor_G - Background color of the slideshow images - G part of the RBG value as decimal value.
- $slideshow_backcolor_B - Background color of the slideshow images - B part of the RBG value as decimal value.
- $count_views - Shows the views counter in the right corner in the detailsview - This is quite slow because it has to read and write the counterxml-file everytime. A top 10 is planned for v1.05
- $show_colage - true: shows a collage of the first four images, false: 1st image is shown.
- $skip_thumbnail_page - skip thumbnail page - if you set this to true, the thumbnail page is not displayed - be careful if you have subdirectories some levels cannot be displayed if a level before has pictures as well (like the demo).
- $sort_albums_ascending - true: sorts the albums ascending; false: descending.
Lower prerequisites
To use the all functions of the TinyWegGallery You need PHP >= 4.3.0. It is important that
PHP is compiled with the bundled version of the GD library.
Otherweise the funktion rotateimage is not available even if you are using a newer version.
TinyWebGallery tries to detect this and removes the buttons for rotating the images. In the $cachedir is the file _rotate_available.jpg created if the function is available - otherwise the file _rotate_not_available.jpg.
If the automatic detections does not work you have to create the file _rotate_available.jpg manually (This can even be an empty file).
If you have a version of PHP >=4.06 and <4.3.0 you have to use the gallery without the rotation. Create the file _rotate_not_available.jpg in the $cachedir folder.
You can use the WebGallery with GD > 1.6. But the available graphic methods only use 256 colors and therefore it is not recommend to use this library. The function 'checkrotate' in inc/filefunctions.inc.php does some checking if certain functions are available. You have to remove these checks to get the gallery running with GD > 1.6.