License: PSGallery is released under the following licence: This program is free software; you can redistribute it. You may modify parts of the code to meet the structure of your system. You may not remove or edit any text or source code linking back or refering to the Promote Science web directory. You may not use this software for use of any other than private usage unless with the permission of Promote Science (admin@promote-science.co.uk). You may not take parts of the source code for use in other pieces of software without the permission of Promote Science Software Administrator. You may not charge a fee for use of this software without the permission of Promote Science Software Administrator. You may not sell on this software. This software is provided under the above licence as the 'Free Version'. All permissions as above are removed when you purchase the full version licence (please contact the administrator). This program is WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. ----------------------------------------------------------------------------------------- ‘PSGallery v1.24’ – Promote Science Gallery ~ FREE VERSION PSGallery is one of the pieces of free software offered by the Promote Science Software Division. PSGallery is a PHP based script that will allow you to create an online media gallery. The script is directly executed in a web browser. It will list any files and folders within the ‘Active Folder’ in their current structure. The script will also create thumbnails of any supported image files. PSGallery supports the listing of any file type (videos, images, music etc.). ----------------------------------------------------------------------------------------- Features: Automatic thumbnail creation & image resizing Caching of thumbnails and resized images Supports JPG, GIF and PNG image formats Non-image files listing allowing users to download videos, music, archives, etc. Supports descriptions for albums and individual images Ability to hide certain albums from visible listing Ability to allow users to upload files ----------------------------------------------------------------------------------------- Requirements: PHP 4.0 or higher + GD 2.0.0 or higher ----------------------------------------------------------------------------------------- Installation: Unpack the archive Upload the entire contents to a directory on your web server (e.g. /gallery) Set access rights to 777 Upload all files into the folder ‘Gallery’ ----------------------------------------------------------------------------------------- Execution: Open the index.php file from the directory on your web server ----------------------------------------------------------------------------------------- Descriptions: Descriptions can be applied to any type of items listed - images, entire albums, and downloadable non-image objects. Descriptions are optional. It can be enabled or disabled - refer to the configuration file. To make use descriptions you need create file named "desc.txt" and put it in directory with the items you want to be described. The file "desc.txt" must contain data in the next format: ItemFileName.jpg Description of item ItemFileName2 Description of second item, file extension omitted SomeFileName Description of some other item As can be seen, description of each item is placed on the single line. It is supposed that the filename of item (which described on current line) is located at the beginning of the line and separated from description body by the space (separating character may be changed by the "description_delimiter" parameter in configuration file). Extension in the filename of item described may be omitted if it is not disallowed in configuration file. There are defined two special "virtual filenames" - "." and "..". Description with the "." in place of filename is considered as the title of current album and will be shown at the top of album. Description with the ".." in place of filename is considered as the comment to title of current album and will be shown under the album title. ----------------------------------------------------------------------------------------- Hiding Objects: When album listing is enabled, you may to wish to hide some albums from the listing. To hide albums, assign names starting with "." (e.g. ".private"). This prefix may be changed by using "hidden_prefix" parameter in configuration file. Hidden albums will not be listed at the albums listings, so these albums can be accessed only by direct URL such as http://www.website.com/gallery/index.php/.private ----------------------------------------------------------------------------------------- Public Access: Index2.php allows users to upload files into the Gallery folder by clicking the 'Upload File' text. You may edit the upload.php file. Link to Index2.php if you want to allow users to have this feature. You will need to edit the index2.php file (e.g. in notepad). Search for "/Gallery/" (without ") and replace the entire string (/Gallery/upoad.php) with the direct location of the upload file (e.g. http://yoursite.com/upload.php). Make sure permissions on the gallery folder are 777 (full access).