LIGHTBOX PHOTO GALLERY
CONFIGURATION
Version 3.04
This page displays a short summary of the database statistics
- Total Members: Total number of members that currently reside in the
database
- Total Category: Total number of categories that currently reside in
the database
- Total Media: Total number of media that currently reside in the
database
- Total User Lightbox: Total number of user's lightboxes that
currently reside in the database
- Total Order: Total number of orders that currently reside in the database
This section allows the administrator to configure the end-user's
gallery interface.
- Enable new account validation: This feature
allows the administrator to validate the email address entered by
the end-user.
Once the end-user has completed the registration process, an automated email will be sent to end-user's
email address for validation.
The end-user is required to activate their email by clicking on a link that
will be included in the activation email. To disable
the
email validation feature, uncheck the
“Enable new account validation” check box. If this feature
is disabled, any users who sign up for the site will be active upon
completion of the registration process.
- Notify me when someone signs up: To be notified
when some one signs up, check the box, otherwise leave unchecked. The notification email will be sent to the email address
that is entered under “Notification Email Address”
field.
- Notification Email Address: The system will use
this email address to send the notification email when a new user
signs up.
- Date Format: There are two types of date format
that the administrator can choose from.
- mm/dd/yyyy: The date will be displayed in month/day/year format
- dd/mm/yyyy: The date will be displayed in
day/month/year format
- Category Display Style: There are two-category
display styles.
a. Two columns display style: The system will display categories in two columns
b. One column display style: The system will display categories in a single column
- Number of media rows per page: the number of
rows that will be used to display media per page
- Number of media cols per page: the number of
columns that will be used to display media per page
- Default sort field: Before displaying media or
categories to user's browser, the system will sort data based on this field
setting.
Select a value from the drop down list to be used as default
sort field.
a. System name: the media will be sorted based on system file name
b. Display name: the media will be sorted based on media or category display name
c. Author: the media will be sorted based on media author
d. Last modified: the media will be sorted based on when the media last modified
- Default sort order: There are two types of
sort order. Select a value from the drop down list to be used as default
sort order.
a. Ascending: the media will be sorted in ascending order
b. Descending: the media will be sorted in descending order
- Display Gallery Button: This button is used to
display the gallery main category page once it is clicked. To disable this
button, uncheck the box.
- Display New Image Button: This button is used
to display all new media based on a date that they are entered. To
disable this button, uncheck the box
- Display Light box Button: This button is used
to display end user's Lightbox. To disable this
button, uncheck the box
- Display User Account Button: This button is
used to display end-user's account page info. This page shows the
end-user's order history and also allows end-users to download any
instant download order. To disable this button, uncheck the box
- Display Shopping Cart Button: This button is
used to display end-user's shopping cart. To disable
this button, uncheck the box
- Display Order Info Button: This button is used
to display "Ordering Info" page. The administrator can use this page to
explain the ordering procedure to
end-users. The
template for this page is available in the template section with the
file name order_info.tpl. To disable
this button, uncheck this box
- Display About Us Button: This button is used to
display the "About Us" page. The administrator can use this page to
describe their company, product or service. The template of this page is available in the
template section with the file name about.tpl. To
disable this button, uncheck the box
- Display Contact Button: This button is used to
display the "Contact" page. The administrator can use this page to
display the company
contact information. The template of this page is available in the
template section with the file name contact.tpl. To
disable this button, uncheck the box
- Enable Slide Show: The gallery has the ability
to display media in a slideshow. To disable slide show, uncheck the box
- Show Category Stats: To retrieve the category stats
may take sometime. The system will count all its sub-categories and
media. To save data processing resources the administrator can disable
this feature by unchecking the box
- Slide Show Timeout: Slide show timeout. Enter
value as desired. The value must be numeric
- Slide Show Width: The slide show width. Enter
value as desired. The value must be numeric
- Slide Show Height: The slide show height. Enter
value as desired. The value must be numeric
- Slide Show Color: Slide show background color.
There are five colors available at this time which are black, blue,
white, grey dark and grey light
- Currency Sign: This currency sign will be used
for entire application. Enter desired currency sign to be used for
this application
- Button Display Style: The system supports two
types of button layout
a. Horizontal Style: All buttons will be displayed in horizontal style
Gallery | New Images | Lightbox | My Account | Shopping Cart | Order Info | ....
b. Vertical Style: All buttons will be displayed in vertical syle
Gallery
New Images
Lightbox
My Account
.............
The media type feature allows the administrator to add new media types, edit or delete existing media types. The media type code will be used to open the media when it is in a detail page. The most common types are included with the installation. If you need to add a new media type that is not in the list, the administrator can add it to the database using the add feature.
- To add new file type
Extension: file's extension. It should not contain a dot.
- Ex: media.mp3 then the entered characters should be mp3
Open Code: This code will be used to open media. Enter code in this box. The code should not contain any actual file paths.
- <EMBED src="[FILENAME]" type="audio/mp3" hidden=true autostart=true loop=true height=1 width=1> </EMBED><table border=0 cellspacing=0 cellpadding=3><tr><td> </td><td align=center><font face="Verdana,Arial,Helvetica" size=1>Having trouble hearing this file?</font><br><font face="Verdana,Arial,Helvetica" size=2><a href="[FILENAME]"><b>Click here to download it!</b></a></font></td></tr></table>
As the code shows [FILENAME] tag. The system will replace a real system file name with this tag. So when adding a new open code, simply replace the file path with [FILENAME] tag. If you are not sure about this code, please see other sample codes that are already available in the system.
- To Edit file type
a. Click on the Edit link of a desired media type
b. Modify value of desired field
c. Click Submit to save changes
- To Delete file type
a. Click on the Delete link of the desired media type
b. Click No to cancel
c. Click Yes to delete the media type. We recommend that you should not delete any media types. They might be needed sometime in the future
This feature allows the administrator to customize the gallery layout. It is suggested that the administrator should make a copy of the templates in a temp folder. That way you will be able to experiment with modifications without worrying about losing template defaults.
- about.tpl: The administrator can use this page to
describe their company, product or service. The system also supports images
and links, therefore when adding images or links to this template make sure the
path is valid.
- activate_email.txt: This template is used
for the activation email that would be sent to end-users if the Enable
Email Validation check box is checked in the configuration page.
There are three tags available.
[USERNAME]: end user's username
[PASSWORD]: end user's password
[LINK]: activation link that allows users to click on it to activate their account
- category.tpl: This template is used to display
each category. There are four tags available
a. [DISPLAYNAME] this tag will be replaced with category display name or system name
b. [CATEGORYDETAIL] this tag will be replaced with category details (category number, media number)
c. [LASTMODIFIED] this tag will be replaced with a date of last modification
d. [DESCRIPTION] this tag will be replaced with the category description
- If there are features that you do not want to use, then simply remove these tags from the template.
- confirm.tpl: This template is used in the check
out page. There is no tag available for this template. The administrator can use
this page to tell end-users what they should expect after their
purchase.
- contact.tpl: The administrator can use this
template to display company contact information
- css.css: This system is designed based on CSS
(Cascading Style Sheets). To change the site layout just
modify this file as required.
- media.tpl: This template is used to display
each of the media. There are nine tags available
a. [FILENAME]: The system will replace this tag with the thumbnail image
b. [DISPLAYNAME]: The system will replace this tag with the file system name or display name
c. [AUTHOR]: The system will replace this tag with the media's author
d. [COPYRIGHT]: The system will replace this tag with the media's copyright
e. [HIT]: The system will replace this tag with the number of hits
f. [LASTMODIFIED]: The system will replace this tag with the media's last modified date
g. [DESCRIPTION]: The system will replace this tag with the media's description
- If there are features that you do not want to use, then simply remove these tags from the template.
There is an alternative template called media_slide.tpl that can be renamed to media.tpl which will give the media a "slide" frame to the image.
- media_detail.tpl: This template is used to
display the media detail page. There are nine tags available.
a. [FILENAME]: The system will replace this tag with the enlarged image
b. [DISPLAYNAME]: The system will replace this tag with the file system name or display name
c. [AUTHOR]: The system will replace this tag with the media's author
d. [COPYRIGHT]: The system will replace this tag with the media's copyright
e. [HIT]: The system will replace this tag with the number of hits
f. [LASTMODIFIED]: The system will replace this tag with the media's last modified date
g. [DESCRIPTION]: The system will replace this tag with the media's description
h. [PRODUCTTYPE]: The system will replace this tag with the product type if any
i. [ADDTOCART]: The system will replace this tag with the add to cart button
- If there are features that you do not want to use, then simply remove these tags from the template.
- orderinfo.tpl: The administrator can use this page to
explain the ordering procedure to
end-users.
- password_email.txt: This template is used to
recover a lost password. There are two tags available.
a. [USERNAME] The system will replace this tag with the username
b. [PASSWORD] The system will replace this tag with the password
- user.tpl: This template is used for the end-user
interface. There are four tags available
a. [GALLERY] The system will replace this tag with the gallery media
b. [MENU] The system will replace this tag with the all of the menu buttons
c. [KEYWORDSEARCH]: The system will replace this tag with the search feature
d. [CATEGORYDROPDOWN]: The system will replace this tag with the drop down category selector. The category drop down list will display all of the main categories that currently reside in the database
This template must include these lines of code below:
<meta HTTP-EQUIV="imagetoolbar" CONTENT="no">
<SCRIPT language=JavaScript src="./scripts/javascripts.js" type=text/javascript></SCRIPT>
<SCRIPT language=JavaScript src="./scripts/protect.js" type=text/javascript></script> This javascript file will help protect images from unauthorized use. There are features that can restrict the functionality of your site and depending on your application, may not be desirable. The administrator can deactivate the individual features in this file by adding the comments // in front of the code that needs to be deactivated. The following features are included
- Disables right click in IE
- Disables right click in NS versions 4 and up
- Check if mouse button pressed is the right one
- If browser is IE, set the right click event not to show the context menu when clicked
- If browser is NS4 - NS6, capture the right click event and set it not to show the context menu when clicked
- Disable drag & drop
- Disable text selecting and copy-paste functions
- Disables showing URL of links in status bar, it works by showing a custom message in the statusbar when the mouse is moving
- Disable offline use by detecting whether the URL of the webpage is not an HTTP protocol
- Keep page out of frames
- This function clears the clipboard data (text or pictures)
- This code triggers the interval for deleting clipboard contents and also it will set to not show error messages in case of bugs with the browser, so that it doesn't show any error alerts
- user_account_info.tpl: This template is used for the User Account page. This page shows the end-user's order history and also allows end-users to download any instant download order.
This section allows the administrator to keep track of registered customers
who are in pending and active mode.
Pending customers are ones that may not have activated their
account or are pending by admin. If customers are in pending mode they
are not able to access the check out page, and account page but they be
able to access the site to view the thumbnail or detail page.
Active customers are able to access all pages of the gallery, but not
the
administration area.
Registration: The registration feature allows the administrator to
add, edit, or delete registration form fields. There are three fields
already included in the registration form that are required by the
system. These are username, password
and email.
- Add: To add a new form field
- Detail: To edit the current form field
- Delete: To delete the current form field.
Note: Please make sure to backup all data from the database before deleting a form field. Once you delete the selected form field, all data will be lost and it can not be recovered. - Up: Move the field up one position
- Down: Move the field down one position
- Generate Form: To view the current registration
layout.
Form Field Properties
Field Name: The database name of the field. The name should not contain any invalid characters such as
~ ! @ # $ % ^ & * ( ) + \ | } { [ ] " : ; > . < , ? / 1 2 3 4 5 6 7 8 9 0 and space
Field Type: The type of the field. There are five types available in the drop down-list. They are TEXT, SELECT, TEXTAREA, CHECKBOX, and RADIO types.
Default Value: The field's default value. This value will be used for the field initialization step.
If the SELECT type is selected, the default value should end with ; to separate each value in the string
If the CHECKBOX or RADIO type is selected then the true value should be 1 and false value should be 0. Enter 1 to make the box checked as default otherwise leave it blank or enter 0 for default value
Field Size: Field size is the width of the field
Max Size: Max size is the maximum number of the characters allowed to be entered
Active: To make a field active on the form check this box
Required: To make a field required, check the box. Once the box is checked users must provide data in this field
Error if contains: The script will check for errors based on any entered character: ex ~~!@#$%^&*()+=|\}]{["':;?/>,<
Field Label: Label of the field
Display Error: Prompted for this error message if an error is detected
Submit: To add the new field click Submit
- To change customer status to pending, click on the pending link in the
Active Customers page
- To activate customers simply click on the active link in the
Pending Customers page
- To Email a customer
a. From: this is the return email address
b. To: select desired group in the drop down list (active, pending or all customers). If active customers is selected the outgoing email will be sent to active customers only. This applies the same to the pending customer group also. To send an email to all customers, simply select All customers in the TO drop down list
c. Subject: message subject
d. Message: e-mail message
e. Click Send to send the message, click Reset to clear all fields
This section allows the administrator to configure and set up the payment
gateway. The system supports two gateways at this time. They are
PayPal and 2Checkout. The Administrator can even choose either PayPal or
2Checkout for the payment gateways by checking both boxes.
- Config
a. Enable PayPal Gateway: To disable this gateway simply uncheck the box
b. Enable 2Checkout Gateway: To disable this gateway simply uncheck the box
c. Order Name: This name will be used for order name
- PayPal
a. PayPal Email Address: Enter PayPal registered email address here
b. PayPal Secure URL Address: No need to change this field
c. PayPal Currency Code: Select desired currency code from the drop down list. This code will be used for PayPal gateway
- 2CheckOut
a. SID: enter your SID here. This ID can be found in your 2Checkout account
b. 2 Checkout URL: no need to change this field
c. Secret Code: The secret code that is entered in your 2checkout account. This code should be changed once you sign up for a 2checkout account.
The tax manager section allows the administrator to tax any order or customer
upon making a purchase. Tax will be calculated based on the setting
of the Tax page. The administrator can tell the system to tax any order,
or any customer that matches the setting. To set up this section,
you must have added at least one customization field in the registration
section. For example you have added the State/Province field in
the registration section and you want to tax any customer who is located
in the state of IL with 8.5% of Tax1. So any customer
that resides in this state will be taxed. In this example you should
enter as follow:
Check the State check box
Enter IL in the matches value field
Enter 8.5 in the Tax1 field
- Config
Enable Tax Feature: To disable tax feature simply uncheck this box. The system will not tax any order if Tax Feature is disabled.
- Tax
a. Tax any person who's: check the box that you want the system to check for. If you want to tax all customers simply check the “Tax all customers” box
b. Matches: Enter checking value in this field. This value will be checked on any customers when they are checking out. If the value is matched then the tax will be applied to the order, otherwise no tax will be applied.
c. Tax1: enter tax1 percentage (this can be city tax) (numeric only)
d. Tax2: enter tax2 percentage (this can be state tax) (numeric only)
c. Tax3: enter tax3 percentage if applied (numeric only)
d. Tax4: enter tax4 percentage if applied (numeric only)
e. Tax5: enter tax5 percentage if applied (numeric only)
f. Click Submit to save changes
This section allows the administrator to create different product types. The system supports unlimited product types, as long as the new product type is assigned a price it will be displayed to end-users for selection. The system also supports instant downloads. This type allows end-user to instantly download a media file as soon as the payment has been completed.
- Product type
a. To add a new product type, enter its name and label and then click the Add button. The new product type will be added to database upon clicking the Add button. The field name must not contain any invalid characters such as: ~ ! @ # $ % ^ & * ( ) _ + ` - = [ ] \ { } | ; ' : " , . / < > ? 1 2 3 4 5 6 7 8 9 0 and spaces
b. To edit a product type simply click on the Edit link of the desired product type
c. To delete a product type simply click on the Delete link of the desired product type. Please remember all data will be lost and can't be recovered once it is deleted.
d. To move a product type up one position in the display click on the Up link
e. To move a product type down one position click on the Down link
This section allows the administrator to manage the online media database. With this section the administrator can add, edit or remove any media or category.
- Media Manager
The media manager page shows all categories and media that currently reside in the database. To browse from one category to another click on the category name and all of its sub-categories or media will be displayed.
a. To add a New Category click the Add New Category link. Before adding a new category name on the server the system will check for the Safe Mode. This mode must be turned off in order for this system work properly. Please check with your hosting service provider that it is set correctly. If this configuration is not possible the gallery administrator can create a new category using any FTP client to create a new folder (category) on the server and change its file permission to 0777(read/write/execute) before uploading any new media to it. If the Safe Mode is off the new category page should be displayed
- System Name: System names must not contain any invalid characters: ~ ` ! @ # $ % ^ & * ( ) + = \ | } ] { [ " ' : ; / ? > . < , and spaces
- Display Name: Enter Category display name. By default the system name is displayed. If you enter a display name it will be used instead of the system name.
- Description: Category description.
- Icon: Category Icon. The administrator can choose an icon for this category or tell the system not to use an icon for this category. The administrator can upload a new icon for a category to the icon directory in the gallery system directory using any FTP client.
- Your current working directory: This line shows the current working category that the administrator is browsing. The new category will be created under this category
- Click Submit to add a new category to the database and server
- Click Reset to clear all form fields
- To Edit category click Edit. Enter the desired value to the desired
field and click Submit to make changes. The system name is disabled
when editing a category
- To Remove a category from the database, click remove. Once the category
is removed, it remains on the server but not in the database.
- To add new media click on Add New Media
The new media will be created under the current working category. The current working category is shown at the top left of the page. If you have added product types they will be shown here, which allows the administrator to assign a price and a shipping cost to the media. It is not possible to assign an instant download while adding new media. To assign an instant download, please use the Edit function that is located on the Media Manager page. The page to add new media page displays the following:
- System Name: click on the browse button, to browse to a file on your local computer
(If you want to use the systems "Auto Generate Thumbnail" feature, the administrator should convert all images to jpg format before uploading it to the server. Most PHP versions no longer support gif image format. Alternatively, you can upload the other file types with a pre-made thumbnail, remember to upload the thumbnail to the same directory and give the thumbnail the prefix gallery_ )- Display Name: Media display name. This name will be used instead of system name when displaying it on the gallery page.
- Author: Media Author can be placed in this field
- Copyright: Admin can place the copyright info for this media in this field
- Description: Media description
- Product Type: If the product type has already been added to the database, they will be displayed here. Enter a price to the product type and a shipping cost if applicable. The Additional Item Shipping Cost will be applied if the end-user purchases more than one of the same media type. For example, the shipping cost of the media is $5 and additional shipping cost is $3. So if the end-user purchases 5 of the same type of a media then the shipping cost would be calculated as follows:
The shipping cost of the first item is $5
The shipping cost of a remaining items is (5-1) x 3 = $12
So the total shipping cost for this order is $5 + $12 = $17
- Click Submit to add the new Media
- Click Reset to clear all form fields
- To edit media click the Edit link. If the product types are added in
the database they will be displayed in the edit media page. On this
page, the administrator can assign the download file to selected media.
- System name: This field is disabled in edit mode
- Display name: Media display name
- Author: Media Author
- Copyright: Media copyright
- Description: Media description
- Product type: If the product type is available for this media, enter a price. If the product type is not available for this media then leave it blank and it will not display in the gallery. If the product type is an instant download Type click on the “Enable Download Link” which allows administrator to assign a download file to this media. To upload the instant download files to the server, please use any FTP program to upload them into the download directory. The download directory is protected with .htaccess file and only the system can access.
To remove the download link click on the “Remove Download Link” which allows the administrator to remove download link from this media.
- click Submit to save changes.
NOTE: The product type will only be available for the end-user to select if it has been assigned a price.
- To remove media from the database click on the Remove link.
- Media Auto Detection
This feature allows the administrator to automatically add a new category or media to the database with one click.
To detect new media, categories or sub-categories click on the Category link at the bottom of the page. The new category or media will be detected and shown on the top of the page with an “Add to Database” link on the right side of the screen.
Clicking Add to Database will add the new media or category and its contents to the database. Remember the thumbnail will not be automatically created when using this feature. To create the thumbnail for the new media please go to the thumbnail section.
- Rebuild Database
This feature allows the administrator to remove any invalid links from the database. The invalid links might have occurred when moving files from one directory to another or deleting files from the system. To avoid invalid links the administrator should run this feature once a week. Depending on the database size, the rebuild process will take sometime to complete.
Click Yes to rebuild database
Click No to cancel rebuild database
This section allows the administrator to configure/manage the gallery thumbnails and to watermark images.
- Config
a. Thumbnail Prefix name: The name will be attached to image for its thumbnail name. This is how the gallery matches the thumbnail to the larger image.
b. Reduce from its original size: The thumbnail size will be created based on this percentage. 100% represents the original image size.
c. GD Version 2.0 or Higher: To find out the GD version simply click on the Click Here link to find out and look under the GD section. If it says “ 2.0 or higher” then check the box.
d. Watermark type: there are two types, Image and text.
- If Image is selected the system will use the image that is shown in the line “Watermark image or logo” for the watermark
- If Text is selected the system will use the Watermark text string for the watermark
- To Upload a New Watermark Image or Logo, click on the Upload New Watermark link. The new image or logo will be used once it is upload on the server and will replace the old one. The file that you upload must be called logo.jpg
- To view a demo of how the image looks after it has been watermarked, click on the View Demo link.
- Watermark position: the position that will be used to place the watermark image or text.
- Click Save to save new configuration
- Watermark
To watermark an entire category click on the watermark link on the right side of the screen. The image will be watermark based on the setting of the configuration above. Please note: the image can not be recovered to its original unmarked condition after has been watermarked, so please make sure to back up media before doing so. To view a demo of how the image looks after it has been watermarked, click on the View Demo link on the Thumbnail Configuration page.
- Generate Thumbnail
To generate thumbnails for an entire category click on the Generate Thumbnail link on the right side of the screen. The thumbnail will be created based on the above configuration setting.
Note: If there are a large number of images in the directory the execution may timeout, this is not a fault in the system. Just click the Back button and click on the Generate Thumbnail again. Keep doing this until you see the Action performed successfully. Also, in order to have the thumbnail created the directory (category) file permissions must be set to 0777 (read/write/execute).
- Video and other format
If the media is video, audio or another format different to jpg. Do the following:
create a thumbnail image for the media and upload it to the same directory where the media is located.
Ex:
Media system name: video.mpg (this is a video type)
The thumbnail prefix name: gallery_ (this can be found in the config section)
Then the thumbnail for this media should be gallery_video.jpg
Upload this thumbnail to the directory where the video.mpg is located.
This section allows the administrator to keep track of the end-users lightboxes and to set a maximum number of media that end-user is allowed to add to their lightbox.
- Config
Enter the maximum number of media allowed for each lightbox. This number will be used to prevent any users from trying to abuse the system. The bigger the number, the more space that is required on the database. The default number is 30.
- Lightbox
This page shows all of the end-user's lightbox media and the IP addresses that the end-users have used to access the system. To delete an end-user's lightbox, simply click on the Delete link. There is no confirmation page for this deletion, so be careful in doing this.
This section shows the end-user's shopping cart, including the user's session id and the date added.
To delete an end-user's shopping cart, simply click on a delete link. There is no confirmation page for this action, so be careful in doing this.
This section allows the administrator to keep track of all end-user's order history, including pending and completed orders.
The pending orders, are orders that have not been paid.
The Completed orders are orders that have been paid.
The administrator can change the status of a selected order by using the action
section
- Complete is to change the order status from pending to completed
- Pending is to change the order status from completed to pending
- To view details of a selected order, click on the order id
number. The media product type will be displayed on a detail page.
- To view the media image click on the media id on the order detail page
This section allows the administrator to reset their username, password and email address when needed.
click on the My profile link to view the current username, password and email address.
The download area is located in the download directory.
Before assigning a download link to desired media id, the "download file" must be uploaded to the server and it must reside in the download directory. This directory is protected by apache .htaccess.
To upload "download files" to your server
- Use any FTP program
- Connect to your server
- Browse to the Lightbox Photo Gallery directory
- Browse to download directory
- Upload the "download files" to this directory
Once it is on the server it will be displayed in the Enable Download Link popup window.
Thank you for choosing Lightbox Photo Gallery