MDW Gallery ASP 1.21 By Mike DeWolfe (mike@dewolfe.bc.ca) ---------------------- README.TXT ---------------------- The zip file contains all of the components needed to install and use this gallery application. 1. Terms And Conditions 2. Included Files 3. Prerequisites 4. Use 5. Digital Alms 1. Terms And Conditions ----------------------------------------------------------------- These programs are shareware, they may be used for an UNLIMITED period of evaluation free of charge, by private users only. They are not Freeware and are not allowed to be used in a commercial or government environment. If you like them you should register in order to gain all the benefits. The included files are are created, owned and licensed exclusively by Mike DeWolfe, Web: www.dewolfe.bc.ca . Reverse-engineering or modifying this software with the exception of HTML modifications is strictly prohibited. LIMITED WARRANTY: THESE PROGRAMS AND ACCOMPANYING WRITTEN MATERIALS ARE PROVIDED "AS IS" WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. NEITHER THE AUTHOR NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION OR DELIVERY OF THIS PRODUCT SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE SUCH PRODUCT EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. BY USING THIS APPLICATION AND/OR ANY ONE OF THESE ACTIVE SERVER PAGES, YOU EXPLICITLY AGREE TO THESE TERMS AND CONDITIONS. 2. Included Files ----------------------------------------------------------------- readme.txt --- The readme file that you reading. gallery.asp --- The gallery script itself. I have made this purposefully skimpy so that you can dress up the formatting as you wish. galleryjs.asp --- The gallery script rigged to work with an JavaScript and an IFRAME. galleryalljs.asp --- The gallery script rigged to work with JavaScript on a single page. gallery.mdb --- The gallery database written as an Access database. It contains no sensitive information in of itself. If someone tries to download it, they will get information that would be likely found otherwise. admin.asp --- This is the administration tool. AFTER you run setup, you can visit this page to edit, delete and scan for new images. gallerymech.asp --- These are the functions built into this application. They are kept separate so that the main page (gallery.asp) is that much smaller. setup.asp --- This is a script that will test whether your directory is set up properly and cofigure passwords, and other needed information. When run successfully, it will A) make an ASP called config.asp; B) it will delete itself. To use the setup script, you will have to re-upload this script again. alms.html --- Digital Alms. I am not beyond the need for money. If you feel that this application is worthwhile, feel free to open up the alms.html, click on the PayPal link and gift to me anything from $5 to $10 for the use of this application. In return, you get product updates into perpetuity. 3. Prerequisites ----------------------------------------------------------------- These are the prerequsities: - Microsoft IIS 4.0 or better - Persits AspJpeg (available from http://www.aspupload.com/aspjpeg.html ) - A writable directory to contain the ASP pages, images and the database. - Images must be stored as JPEG images. - Images can in this base directory in a sub-folder. This version does not support automated retrieval or sub-sub-folders. 4. Use ----------------------------------------------------------------- 4.1 Installation ------------------------------ - The first thing you need to do is UNZIP the gallery.zip file. Take all of those files and upload in BINARY to a writeable directory on your server. - Then run the file called "setup.asp" (e.g. if you uploaded these to http://www.example.com/gallery, then you will need to run http://www.example.com/gallery/setup.asp ). Provide the information it required and hit "submit" 4.2 Admin Functions ------------------------------ These are some of the admin functions. Once you log in, the system will remember your identity for roughly 30 minutes. 4.2.1 Scan For New Images ------------------------------ The first thing you should do, is go to the admin.asp page, input your user-name and password, then "Scan For New Images". This will crawl through your gallery and its subfolders. It will find images, record their dimensions, build thumbnails, record their dimensions and then give you the option to edit entries, to include titles, descriptions and to categorize your images. 4.2.2 Edit Images ------------------------------ You can choose to edit the information connected to an image (its title, category and description). Choose from the list of images, edit one as you choose, submit your changes and they will be updated in the database. 4.2.3 Delete Images ------------------------------ You can choose to delete and image and its accompanying information. Doing this will wipe it out from the server. **** CAUTION : Using the delete function DELETES THE IMAGE, ITS THUMBNAIL AND ITS DATABASE ENTRY. **** 4.3 General Use Notes ------------------------------ One feature with this application is it's auto-scan. When a general user goes to the gallery.asp page, the application will scan for new images and missing information. It will fill in the blanks and give the user thumbnails and report all of the dimensions. This process is only done for missing information. 4.4 Optional Views ------------------------------ Calling the default version of this page brings up the categories: http://example.com/gallery/gallery.asp You call a specific category using: http://example.com/gallery/gallery.asp?showoff=Title&Category=Happy In this example, The word "Happy" refers to a category called "Happy" and will show off all of the relevant images from Category. You can call just the newest images: http://example.com/gallery/gallery.asp?showoff=Added&top=10&New=yes You can also display the images sorted by their age: http://example.com/gallery/gallery.asp?showoff=Added You can limit how many show up with the "top" value : &top=10 added to a query will cap off the images displayed at 10 for instance. 5. Digital Alms ----------------------------------------------------------------- If you feel that this application is worth enough to you, feel free to donate a small sum. Go the page entitled "alms.html" and click on the PayPal link.