EZWebAlbum - Version 2.0

The New EZWebAlbum

EZWebAlbum Version History

EZWebAlbum v2.0.x Help File

Table of Contents:

Setup
Main
Category
Album
Images
- Edit Image

Readme
Table of Contents

###################################################
#                                                 #
#  EEEEE ZZZZZ W     W  AAA      2222       000   #
#  E        Z  W     W A   A         2     0   0  #
#  EEEE    Z   W  W  W A   A      222      0   0  #
#  E      Z    W W W W AAAAA     2      .. 0   0  #
#  EEEEE ZZZZZ  W   W  A   A     22222  ..  000   #
#                                                 #
###################################################
#                                                 #
# EZWebAlbum V2.0.x  Copyright 2004  Viehland.org #
#                                                 #
# This program is an original script written by   #
# Brian Viehland.  This script is licensed for    #
# use through http://www.viehland.org for a fee.  #
# For support, first visit viehland.org/support   #
#                                                 #
# The contents of this file are the intellectual  #
# property of Brian Viehland and viehland.org.    #
# Redistribution of this file or its contents in  #
# whole or in part is in violation of the terms   #
# of the copyright.  If you have obtained a copy  #
# of this file from a source other than the above #
# mentioned website, please contact the author at #
# scripts@viehland.org to report the source.      #
#                                                 #
# This program is for sale at these prices:       #
# *** FREEWARE NOW  -- HAVE FUN ***               #
#                                                 #
# This program can be used on adult sites as long #
# as the content does not violate local, federal, #
# or state laws regarding distribution of such    #
# materials.  The site owner using this program   #
# takes full responsibility for the content of    #
# the albums shown.  The program creator/author   #
# takes no responsibility in how this program is  #
# used nor for the images displayed within it.    #
#                                                 #
###################################################

EZWebAlbum is licensed for use, not sold. It cannot be distributed or resold without permission from the author. I spent way too many hours on both nights and weekends getting this script to work, for it to be given away. I don't charge much, so it's not unreasonable to purchase a legal license for the script.

Requirements / Prerequisites
Table of Contents

This script cannot operate without a few free perl modules installed on your server.

the CGI perl module
and CGI::Cookie (part of CGI.pm)
and ImageMagick OR GD perl module

ImageMagick provides additional features such as the ability to rotate images!

Note: To find out if your server has these modules, you can download and install
Perldiver by ScriptSolutions.com © 1997- 2004

How to Download
Table of Contents

After you've purchased your license ** ITS FREEWARE NOW!***, you will be emailed a username and password that gives you access to the download site. This email will be sent to the email address you used with Paypal.

Files
Table of Contents

When you extract the zip file you downloaded, you will find two folders:

public_html

cgi-bin

In the public_html folder there is a folder called EZAlbums. Place that entire folder and all its contents into your main html directory (www, httpdocs, public_html, etc)

In the cgi-bin folder you will find five files and a folder.

ezwebalbum.cgi (this is the main display file)

EZWAmain.cgi (this is the main admin file)

EZWAcategory.cgi (this is the category admin file)

EZWAsetup.pl (this is the script you run first to set those variables)

EZWABatchThumbnail.cgi (this script will recreate all your thumbanails)

EZadmin folder (this contains all the support files)

Put all five files and the EZadmin Folder into your cgi-bin directory

You must change the permissions to the EZWAsetup.pl file to be 755

Then run the EZWAsetup.pl file by opening a browser window to it and fill in the 9 fields as directed.

See this example of the installation program.

Note: After running, the setup script resets its permissions to deny future use. To rerun the script, you must reset its permissions to 755!

Edit Program Name
Table of Contents

The program name is the text that will show up in the title bar at the top of the browser, in the footnote at the bottom of the display, and in the template anywhere you use the tag <insert programname> tag

Edit Main Description Field
Table of Contents

The main description field is a text file that is included into the display of the front page of the albums. It can contain any html tags you want, but be careful, if you leave a tag open ended, it could affect the look of the rest of the page. I would suggest you use text formatting tags only if you are proficient in html.

This description file is included on the front page where you place the <insert description> tag in your template.

Note: Only the main administrators have permissions to edit this field

Choose Main Theme / Edit Theme Template
Table of Contents

You can choose the main theme from the drop down menu shown. There is also a link to a page that contains all the themes that have been made publicly available that you can download.

To change the theme, simply choose the theme you want to use from the pulldown menu and the site will automatically update to use that theme.

The current theme's template is displayed in the text editor for you to make changes as you wish. Changes made will immediately take effect on the main page and on any category that is using the main page's theme as its default

Only the main administrators have permissions to edit these settings

To install a new theme, simply copy the theme folder and all its contents into the following directory:
/home/username/public_html/EZAlbums/EZthemes
Once placed there, that theme is immediately available for use

Note: Check out the Theme Tutorial for information on how to create your own themes!

Add/Remove Main Administrative Users
Table of Contents

This function lets you add and delete the main administrative users to your program

To add a user, enter the new username, password, and then re-enter the password as indicated. You can add up to 4 users at a time

To delete a user (or multiple users), check the box beside the user's name.

When you click on Add/Delete Users, the changes will be made.

Note: Administrative users have full permission to make all the same changes you can!

Edit Main Viewing Permissions
Table of Contents

To set your whole program to be password protected, check the box next to "Password Protected." This will require all visitors to enter their username and password prior to entering the site. To remove the password protection, check the box beside "Open to All"

To allow and disallow users the ability to create their own categories in your program, check the box beside "yes" or "no" as desired.

To add users to the list of those allowed to view the contents of your program, enter the username, password, and reenter the password as indicated. You can add up to 10 users at a time.

To remove users from the list of permitted viewers, simply check the box beside their name.

When you click on Edit Viewing Permissions, the changes will be made.

Note: Only administrative users have permission to make these changes.

Add Category
Table of Contents

Each category has a one word identifier. This is the folder name used on the server. Categories are organized alphabetically by their identifier name. If you want a particular category to always show up first, use an identifier like 00001. The end user never sees this field

The category name is what shows up under its cover image on the main display. This field is truncated in the display based on the themesettings.txt file included in each theme.

The category description field is very similar to the main description field, but only shows up on the front page of that category. It too appears where the template includes the tag <insert description>

Choosing a theme here (or choosing the main page's default) sets the look for the entire category.

Public album creation, when set to yes, allows visitors to create their own albums in this category
This can be changed later through the category viewing settings

When you click on Make New Category, the changes will be made.

Note: Only administrative users have permission to add categories unless the Main Viewing Permissions allow visitors to also create categories.

Delete Category
Table of Contents

When choosing to delete a category, you will be shown a list of all existing categories.

You can only delete categories one at a time and when doing so you will be prompted to verify that you indeed want to proceed with that action.

Note: Once deleted, that category, all the albums in it, the images, thumbnails, and descriptions are all gone!!!

Edit Category Information
Table of Contents

Editing a category is very similar to Adding a Category. You can change the identifier, the Display Name, the category's description, and the visitor's ability to create their own albums.

Simply change the current values, which are shown on the screen for your reference, and click on "Make Changes"

Choose Category Theme / Edit Theme Template
Table of Contents

You can choose the category theme from the drop down menu shown. There is also a link to a page that contains all the themes that have been made publicly available that you can download.

To change the theme, simply choose the theme you want to use from the pulldown menu and the category and all the albums in it will automatically update to use that theme.

To allow category admins to edit their themes, the theme name must match the category identifier. This must be done by the site owner. To do this, the site owner must either rename a theme folder, or copy a theme folder and name the copy with the category identifier.

See the Main Theme section of this help file.

Note: Check out the Theme Tutorial for information on how to create your own themes!

Edit Category Cover Image
Table of Contents

The cover image for each category starts out as the theme's default while the category is empty. The first image to be uploaded into any of the category's albums automatically gets set as the category (and that album's) cover image.

To change the cover image for a category, simply choose an image file on your local machine to upload in place of the current cover (the current cover is shown on screen for your reference).

To remove the category cover image, thus resetting it to the theme default, check yes beside "Delete Cover File" and then click the button.

Add/Delete Category Admin User
Table of Contents

This function lets you add and delete the category administrative users to the current category

To add a user, enter the new username, password, and then re-enter the password as indicated.
You can add up to 4 users at a time

To delete a user (or multiple users), check the box beside the user's name.

When you click on Add/Delete Users, the changes will be made.

Note: Category administrative users have full permissions to make all changes to that category!

Edit Category Viewing Permissions
Table of Contents

To set the current category to be password protected, check the box next to "Password Protected." This will require all visitors to enter their username and password prior to entering the category. They will be able to see the cover image you've selected. To remove the password protection, check the box beside "Open to All"

To allow and disallow users the ability to create their own albums in this category, check the box beside "yes" or "no" as desired.

To add users to the list of those allowed to view the contents of this category, enter the username, password, and reenter the password as indicated. You can add up to 10 users at a time.

To remove users from the list of permitted viewers, simply check the box beside their name.

When you click on Edit Viewing Permissions, the changes will be made.

Note: All main and category administrative users have permission to make these changes.

Add Album
Table of Contents

Each album has a one word identifier. This is the folder name used on the server. Albums are organized alphabetically by their identifier name. If you want a particular album to always show up first, use an identifier like 00001. The end user never sees this field

The album name is what shows up under its cover image on the category display. This field is truncated in the display based on the themesettings.txt file included in each theme.

The album description field is very similar to the main description field, but only shows up on the front page of that album. It too appears where the template includes the tag <insert description>

When you click on Make New Album, the changes will be made.

Note: Only main and category administrative users have permission to add albums unless the Category Viewing Permissions allow visitors to also create albums.

Delete Album
Table of Contents

When choosing to delete an album, you will be shown a list of all existing albums.

You can only delete albums one at a time and when doing so you will be prompted to verify that you indeed want to proceed with that action.

Note: Once deleted, that album and the images, thumbnails, and descriptions in it are deleted permanantly!

Edit Album Information
Table of Contents

Editing an album is very similar to Adding an Album. You can change the identifier, the Display Name, the album's description, and the visitor's ability to upload their own images.

Simply change the current values, which are shown on the screen for your reference, and click on "Make Changes"

Edit Album Cover Image
Table of Contents

The cover image for each album starts out as the theme's default while the album is empty. The first image to be uploaded into the album automatically gets set as the album's cover image.

To change the cover image for the album, simply choose an image file on your local machine to upload in place of the current cover (the current cover is shown on screen for your reference).

To remove the album's cover image, thus resetting it to the theme default, check yes beside "Delete Cover File" and then click the button.

The only difference between album covers and Category Covers is that in the album cover edit function, you are given the option to choose any of the images that already exist in the album as the cover. This is much faster as the image has already been loaded onto the server previously, so there's no waiting for the file to upload.

Upload Images
Table of Contents

You can upload images five at a time. Each image you choose to upload has a description area below it. You can either enter your image's description at this time, or edit the image later.

Note: If you are uploading really large image files (greater than 500K each) you may want to upload them one or two at a time, otherwise each upload will take a really long time.

Note: You may also think about reducing the size of your images on your local machine prior to uploading them (again, just to save time).

Delete Images
Table of Contents

The delete function shows you the thumbnail of each of the images in the current album. Simply check the box next to the image(s) you want to delete and click the button.

You will be asked for confirmation prior to deleting the images. This function deletes the full size image, the thumbnail image, and the description file associated with the image and cannot be undone.

Edit Image
Table of Contents

For all users, you are shown the image in question and are given the opportunity to add or change the description that will be shown with the image display. As in all the description fields, this entry can be any length you wish and can contain html code as you desire.

For ImageMagick Users, you will be given an option to rotate the image. Simply choose 90 deg clockwise, 90 deg counter clockwise, or 180 deg of rotation and click the button. Rotation of images does require that you refresh your browser at the album display and again at the image display in order to see the new layout.

Thanks for reading up on the EZWebAlbum program and good luck with your customization!

Rate this script at the following sites! It only takes a second, really, just click
cgi.resourceindex.com View Ratings	scriptsearch.com View Ratings	hotscripts.com View Ratings