Thickbox Gallery 2006-09-27 By Yuji Takenaka Scirpts and sample photos are: Copyright (c) 2006 Yuji Takenaka (http://www.free-design.jp/tbg/) Licensed under the MIT License: http://www.opensource.org/licenses/mit-license.php ThickBox 2.1 - One Box To Rule Them All. By Cody Lindley (http://www.codylindley.com) Copyright (c) 2006 cody lindley Licensed under the MIT License jQuery - New Wave Javascript Copyright (c) 2006 John Resig (jquery.com) Licensed under the MIT License Thank you for downloading Thickbox Gallery. This is a script for simple image, music and video galleries using ThickBox2.1 JavaScript library. This script was inspired by: http://www.goodpic.com/mt/archives2/2006/06/lightboxjs_php.html http://www.iron-horse.org/~naokih/photos/200608_sturgis/ ===== File Structure ===== tbg |- albums |- sample |- niagara1.jpg (sample image) |- niagara2.jpg (sample image) |- niagara3.jpg (sample image) |- niagara4.jpg (sample image) |- niagara5.jpg (sample image) |- niagara6.jpg (sample image) |- icons |- download.gif (download icon) |- flickr.gif（Flickr upload icon） |- max.gif (original icon) |- play.gif (thumbnail for audio and video file) |- playa.gif (play audio icon) |- playv.gif（play video icon) |- inc |- inc.php (include file) |- settings.php (configuration file) |- zip.lib.php (zip compression library) |- thickbox |- thickbox.css (style sheet) |- loadingAnimation.gif (loading image) |- jquery-compressed.js (compressed jQuery library) |- thickbox.js (ThickBox library) |- tbg.php (main script) ===== About Library Files ===== For your convenience, thickbox.js (http://jquery.com/demo/thickbox/) and jquery-compressed.js (http://jquery.com/) are already included in the package, however I recommend to download the latest files from their official sites. If you use the latest ThickBox library, please change a path for loadingAnimation.gif in thickbox.js to thickbox/loadingAnimation.gif. ===== Features ===== - Generate png thumbnails for image files To generate thumbnails for a lot of images takes long time, I recommend you create thumbnails at local in advance and upload them to a server - Audio and video files are displayed without generating thumbnails - Multiple galleries - Zip compression for downloading - All in one page or pagination - Look and feel modification - Choose Lightbox JS or Highslide JS instead of ThickBox - Generate xml file for Google Sitemaps - Display a link for uploading a photo to Flickr ===== Requirements ===== - PHP 4.2 or higher, maybe - Layout was checked with IE6 and FF1.5 on Windows XP SP2 I do not have Mac, so please check the layout and let me know - File uploading is possible, however, please upload files using FTP in advance because this feature is a kind of accessories. ===== Installation ===== 1. Unzip the download file and upload all files except this file to your server 2. To generate thumbnails, chomod 0777 album folders, e.g. ./albums/sample/ 3. Point to the url of tbg.php in your browser and if you see a gallery, the installation is completed 4. Remove all sample images and upload your images 5. If you change a folder, change $Albums[x]["url"] in settings.php, x is a number 6. Point to tbg.php again and refresh, if you see your images, the configuration is completed 7. If you want to make multiple galleries, just add $Albums[x] in settings.php 8. Lightbox JS and Highslide JS are not included in this package If you want to use them, download them from official sites below Lightbox JS v2.0: http://www.huddletogether.com/projects/lightbox2/ How to use Lightbox JS v2.0: http://www.free-design.jp/tbg/tbg_lb_en.php Highslide JS: http://vikjavev.no/highslide/ How to use Highslide JS: http://www.free-design.jp/tbg/tbg_hs_en.php 9. When you generate a xml file for Google Sitemaps, check permission a folder where you create the file in. ===== Upgrade ===== 1. Upload all folders and files except album folders, settings.php and readme.txt 2. You need to modify an existing settings.php based on a new settings.php, then upload it to your server 2006-09-15 or 2006-09-22 -> 2006-09-27 or later $TbUrl in settings.php became obsolete. It is replaced with $Albums[x]["js_library_path"]. 2006-09-15 -> 2006-09-22 or later File structure was changed, follow this process. 1. Modify existing settings.php according to new settings.php 2. Create inc folder and move settings.php to there 3. Replace all files except albums folders and settings.php 4. If you customize Thickbox Gallery, modify scripts properly. ===== Setting ===== Edit settings.php as you wish. ===== Notes ===== - Thumbnails are generated at the first time browsing a gallery after you upload images, so you better to browse at lease one time when you uload images. - If too many images in a gallery, PHP may timeout before generating all thumbnails. In that case, please try refresh a browser to generate all thumbnails. - If set $Albums[x]["refresh"] to 1 in a gallery which has many images, the program generate thumbnails for same images and timeout. In this case, delete all thumbnails and set $Albums[x]["refresh"] to 0, then repeat refresh until all thumbnails are generated. - Thumbnails of audio files and video files are not generated automatically, please create thumbnails at local and upload them. ===== Contact ===== Your suggestions and requests are welcome. Just email me (webmaster@davilin.com) or leave your comment on my blog http://www.free-design.jp/~yujit/weblog_yt/ (Japanese) ===== Thank you ===== For John Resig, author of jQuery (http://jquery.com/) For Cody Lindley, author of ThickBox 2.1 (http://jquery.com/demo/thickbox/) For jkaneko and Hiroshima, they gave me a motivation to create this program And for all people who download Thickbox Gallery ===== Revisions ===== 2006-09-27 - Modify the package due to a release of ThickBox 2.1 - Change to handle Thickbox2.1, Lightbox JS v2.0 and Highslide JS - Create icon folder for the above purpose - Display file names instead of taken dates, EXIF info displays on zooming - Add a feature to create a xml file for Google Sitemaps - Add a link for uploading a photo to Flickr 2006-09-22 - Change file structure for the future expandability, I do not have plan, anyway. - Add a download icon for visitors do not know "right click" like my mother in law - Add a zip compression option - Add a feature to handle audio and video files 2006-09-15b - Fix function_exists("exif_read_data") 2006-09-15 - Release [EOF]