The Complete Resource To Php & Mysql Programming.zip

********************************************************** phpPhotoAlbum Manual By Steve Knoblock Version 1.0.0.2 beta http://www.phphelp.com/phpPhotoAlbum/ ********************************************************** ********************************************************** * UPGRADERS PLEASE READ! * * Configuration files have been renamed in this version * * of the album (1.0.0.2 or higher). share.inf is now * * share.inc and album_mainConfig.[file extension of your * * choice] (usually album_mainConfig.wphp) is now * * album.inf Please backup your old share.inf and * * album_mainConfig.wphp files before installing the new * * album software. Copy and rename these files to the new * * names. * ********************************************************** This document is incomplete and all instructions may not apply to your version of phpPhotoAlbum. THIS PROGRAM IS LICENSED UNDER THE GNU PUBLIC LICENSE v2 OR LATER. PLEASE READ THE LICENSE AGREEMENT INCLUDED WITH THIS PROGRAM BEFORE PROCEEDING! IF YOU ARE REDISTRIBUTING THE phpPhotoAlbum UNDER THE GPL YOU MUST REMOVE THIS SPECIFIC AGREEMENT! THE SOFTWARE COMPRISING THE phpPhotoAlbum IS KNOWN AS THE PROGRAM. LICENSOR IS STEVE KNOBLOCK, CITY GALLERY, PHPHELP OR ANY EMPLOYEES OR ASSOCIATES OR DEVELOPERS OF THE PROGRAM. IN ADDITION TO THE LICENSE ACCOMPANYING THE PROGRAM USE OF THE PROGRAM INDICATES YOUR AGREEMENT TO THE FOLLOWING TERMS GOVERNING THE RELATIONSHIP OF YOU TO THE LICENSOR AND INDEMNIFYING THE LICENSOR FROM ANY LIABILITY ARISING FROM CONTENT DISTRIBUTED OR PUBLISHED USING THE PROGRAM. THE TERMS OF THIS AGREEMENT AND THE RELATIONSHIP BETWEEN YOU AND LICENSOR SHALL BE GOVERNED BY AND CONSTRUED IN ACCORDANCE WITH THE LAWS OF THE STATE OF VIRGINIA AND THE UNITED STATES WITHOUT REGARD TO CONFLICT OF LAW PROVISIONS. YOU AND LICENSOR AGREE TO SUBMIT TO THE PERSONAL AND EXCLUSIVE JURISDICTION OF THE COURTS LOCATED IN THE COUNTY OF ARLINGTON IN THE STATE OF VIRGINIA. LICENSOR IS NOT RESPONSIBLE FOR THE CONTENT OF MESSAGES DISTRIBUTED THROUGH THE PROGRAM, WEB BASED DISCUSSION GROUPS, EMAIL DISCUSSION GROUPS, EMAIL DISTRIBUTION LISTS OR MAILING LISTS, AND ASSUMES NO RESPONSIBILITY FOR AND MAKES NO WARRANTY OR REPRESENTATION AS TO THE ACCURACY, CURRENCY, COMPLETENESS, RELIABILITY OR USEFULNESS OF INFORMATION DISTRIBUTED THROUGH THE PROGRAM (BY YOU OR ANY THIRD PARTY). ********************************************************** * Preparing to Install ********************************************************** 1) You must have PHP (http://www.php.net) installed. Version 3.0.9 is recommended. But currently we are running it on version 3.0.6 without any known problems (although this version does have known problems). 2) Make sure you have a database server that is supported by this application. We currently support only MySQL (http://www.tcx.se). 3) Make sure that you have either created a database for use by this application or that your hosting provider has created on for you. This application does not create the database, only the tables required for it to function. 4) Make sure that you have the proper database permissions. The database user must have permission to issue the following SQL statements: SELECT, INSERT, UPDATE, DELETE. PLEASE READ THE SECURITY SECTION AT THE END OF THIS DOUCMENT! ********************************************************** * What is phpPhotoAlbum? ********************************************************** phpPhotoAlbum is an online album for sharing digitized photographs, digital photographs or digital artwork. The album can hold any information that you can think of, from video files or animations to family photos. If a browser can display the file, the photo album can include it in the album pages for viewing. It enables users to upload from anywhere in the world a select set of important images to be viewed on the web and discussed by members of a mailing list. The phpPhotoAlbum is a web application intended to run on the Apache web server and use MySQL database server. Images uploaded by users are stored on the web server file system for efficiency. Information pertaining to each image is stored in the SQL database. ********************************************************** * Features of phpPhotoAlbum ********************************************************** - Enables images to be uploaded from anywhere through a standard web browser through an easy to use form on a web page. - Full language and localization support. Currently supports English and French. Create your own language and localization file! - Uses powerful SQL database server to store information about images. Your data stays independent of format or presentation, ready for analysis or transfer. - Presentation of album pages fully customizable through user supplied header and footer HTML files. The albums fits in with your existing design. - Comprehensive album navigation. Album pages can be browsed or access through a table of contents list. The table of contents list supports a "next N images" navigation scheme (or alternatively a "more..." images scheme). - Fully customizable image category list. Categorize images by type of image or any user specified set of types. - Automatic announcement of new images to email distribution list (optional; you must supply list server). - Search the album by keyword in image captions and descriptions. - Easily approve an image for public display by clicking a link. System allows editorial approval of all submitted images prior to public display by clicking a link from an email message set to the editor. - You have full control over the types and maximum size of files allowed for upload. - You may specify custom headers and footers on an individual basis for front pages and album pages. - Ability to inlclude a feature of the day on the front page. ********************************************************** * Installing the Application ********************************************************** Moving Albums Files to the Web Server Use an FTP application to transfer the required files to a directory on your web server. These are all the files ending in php3 or wphp. Before you transfer the files, setup a directory under the document root (where public HTML files reside). This directory is usually called public_html or document_root or htdocs or www or any number of names. Contact your administrator if you have questions about where your public HTML directory is. IMPORTANT! The album archive comes with the script files packed in the albumN were N is the album version. When you create the directory where the album lives, please leave the version number off of the directory name. If the album directory in the archive is _album10_ call the remote directory _album_. * Go to /tools/setup.php3 in your web browser. (This is not yet implemented or shipped with the current version). * CHMOD 777 (this should be unnecessary) the images/ directory. ********************************************************** * Customizing the Album ********************************************************** Populating the Image Type List The image upload forms displays a field called "Type," which is intended for the user to specify what type of image this is (if they know). This is *not* intended for categorizing the image by subject, but so that images may be searched for by the type of image. For example, a historical photograph album may offer a