1. Extract the files from the tarball or zip file into a directory you specifically set up for Plain Pics. Anywhere is okay as long as you know where that directory is. 2. Edit plainpics_config.xml. Here it is, item by item (YOU MUST EDIT THIS FILE!): <HeaderComment> DISABLED CURRENTLY 1.0 Any text you want to show up at the head of the main page can go here. It can be HTML but < and > must be typed as '&'lt; and '&'gt; *<PhotoDir> This must be a relative path to a directory where your directories of photos are. So, if your directory structure is like this: public_html/ /plainpics /photos /wedding /vacation_2005 then you this setting should look like: <PhotoDir>../photos</PhotoDir> *<DefaultAlbum> This is the directory of photos you want to come up first. Again with the directory setup above, it should look like this: <DefaultAlbum>vacation_2005</DefaultAlbum> <Logo> It is not strictly neccessary to replace this beautiful artwork but if you do, it should go here. The png or jpg or gif file should be placed in the plain pics directory. <LogoLink> This is where you want to take the user when they click on the logo. It is, again, a relative path. So if you want to go to your home page, it might look like this: <LogoLink>../index.html</LogoLink> <GraphicHeader> This is a true or false value although currently, PlainPics will act as though it's false, no matter what you put here. This will change in an immediate update: <GraphicHeader>false</GraphicHeader> <AdminPassword> The password for adding captions and other settings. <AdminPassword>admin</AdminPassword> <PPStyle> Currently this value can be 'default' or 'white'. Default is a black background with white text and 'white' is the opposite. <PPStyle>default<PPStyle> That's it! Seven settings, two (*) of which are essential if you want Plain Pics to work. 3. Ftp your photos into directories you create within your <PhotoDir> directory. Name them descriptively as the name is what will show up in the drop down menu. The photos can be any size but will get clipped beyond 640 by 480 pixels. (it will also be heck a slow). Thumbnails are all a predetermined size (this will be changed in later releases). 4. Make sure that <PhotoDir> and it's subdirectories are readable (and writable if you want to add captions) by PlainPics (they must have group level read/write permissions).
How to Enter Captions
To add captions to your photos simply click "Login Admin". A login page will appear in the photo space. Input "admin" for login name and then your admin password as specified in the configuration file. (It is "admin" as a default). Click Submit and if successful, the photo that was there before will now appear with a caption input box below it. Type in your caption and click save. You can go on the next photo and the next, ad finitum and do the same. When you finished adding captions, click Logout Admin and you'll be taken back to user mode. You will see your new captions under the photos. If it doesn't work, it means you have not set "write" permissions for groups for that folder. You can do this through most ftp clients, ssh, or the File Administrator program in your web control panel (CPanel, VDECK, etc.).
The simple way to run PlainPics, once you have your configuration set is to type in your browser: http://www.yoursite.com/plainpics/photomaster.php You may not have named your plainpics directory, "plainpics" but you get the idea. This will run PlainPics with the settings in plainpics_config.xml By default, <PhotoDir>MasterDir</PhotoDir> is the master gallery containing the other subgallery folders. PlainPics is only one level deep at this stage. If you want multiple master galleries you can override the configured <PhotoDir> by passing in a new master gallery folder: http://www.yoursite.com/plainpics/photomaster.php?photoDir=../photos/subMasterGallery This would display all the sub-galleries in ../photos/subMasterGallery if it weren't for the fact that PlainPics needs to know the album within the new master gallery that you want displayed first. So you must have something like this: http://www.yoursite.com/plainpics/photomaster.php?photoDir=../photos/subMasterGallery&album=May2005 You can also use the album parameter to override the default album in the default <PhotoDir>: http://www.yoursite.com/plainpics/photomaster.php?album=May2005 And finally, if you want to ONLY display one album out of many: http://www.yoursite.com/plainpics/photomaster.php?album=May2005?thisalbumonly=1 The one thing to watch here is that if you pass an album and a photoDir parameter in and the album is not actually located within the photoDir, you will see nothing. Blackness (or whiteness).