LightboxPhoto.com

If you still have questions after reviewing this documentation,  

Close Window

Short Database Statistics

This page displays a short summary of the database statistics when first logged into the admin area.

1. Total Members: Total number of members that currently reside in the database
    
2. Total Category: Total number of categories that currently reside in the database
    
3. Total Media: Total number of media that currently reside in the database
    
4. Total User Lightbox: Total number of user's lightboxes that currently reside in the database
    
5. Total Orders: Total number of orders that currently reside in the database
    
6. Total Pending Orders: Total number of pending orders that currently reside in the database
    
7. Total Completed Orders: Total number of completed orders that currently reside in the database

Back to Top

General Configuration

This section allows the administrator to configure various aspects of the end-user's gallery and administrator's interface.
 

1. Cell Colour: To change the admin skin cell colour, enter a new value here.
   
   
2. Header Colour: To change the admin skin header table colour, enter a new value here.
   
    
3. Cookie Lifespan (in days): To change the lifespan of the cookies that are set by the system, enter a new value here.
   
    
4. Download Buffer Size: If the download file is larger than a few MB, the download may not work correctly, or nothing appears to happen after clicking on the download button. This may occur because the memory limit is exceeded when the system reads the contents of the download file and then stores it in the buffer before creating the .zip file. If this occurs the admin should increase the buffer size accordingly by selecting from the drop down list.
   
   
   
5. 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 user that registers to the site will become active upon completion of the registration process.
   
    
6. 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.
   
    
7. Notification Email Address: The system will use this email address to send the notification email when a new user signs up.
   
    
8. bcc me a copy of SEND TO FRIEND email: Check this box to have a blind carbon copy of the sent message to the admin's email.
     
    
9. Date Format: There are two types of date format that the administrator can choose from.
   1. mm/dd/yyyy: The date will be displayed in month/day/year format
   2. dd/mm/yyyy: The date will be displayed in day/month/year format
      
       
10. Number of category columns per page: the number of category columns that will be displayed per page.
    
     
11. Number of media rows per page: the number of rows that will be used to display media per page.
    
     
12. Number of media cols per page: the number of columns that will be used to display media per page.
    
     
13. Default sort field: Before displaying media or categories in the user's browser, the system will sort the data based on this field setting. Select a value from the drop down list to be used as the 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
    d. Last modified: the media will be sorted based on when the media was last modified.
    
     
14. Default sort order: There are two types of sort order. Select a value from the drop down list to be used as the default sort order.
    a. Ascending: the media will be sorted in ascending order.
    b. Descending: the media will be sorted in descending order.
    
     
15. 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.
    
     
16. Display New Image Button: This button is used to display all new media based on the date that they are entered. To disable this button, uncheck the box.
    
     
17. Display Lightbox Button: This button is used to display end user's Lightbox. To disable this button, uncheck the box.
    
     
18. Display My Account Button: This button is used to display the 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 orders. To disable this button, uncheck the box.
    
     
19. Display Shopping Cart Button: This button is used to display the end-user's shopping cart. To disable this button, uncheck the box.
    
     
20. Display Order Info Button: This button is used to display the "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.
    
     
21. 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 for this page is available in the template section with the file name about.tpl. To disable this button, uncheck the box.
    
     
22. Display Contact Button: This button is used to display the "Contact" page. The administrator can use this page to display the company's contact information. The template for this page is available in the template section with the file name contact.tpl. To disable this button, uncheck the box.
    
     
23. Enable Slide Show: The gallery has the ability to display media in a slideshow. To disable the slide show feature, uncheck the box.
    
     
24. 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 un-checking the box. If this feature is disabled then the admin will want to remove the call ([CATEGORYDETAIL])  from the category.tpl template in the template section.
    
     
25. Slide Show Timeout: Slide show timeout. Enter value as desired. The value must be numeric.
    
     
26. Slide Show Width: The slide show width. Enter value as desired. The value must be numeric.
    
     
27. Slide Show Height: The slide show height. Enter value as desired. The value must be numeric.
    
     
28. Slide Show Color: Slide show background color. There are five colors available which are black, blue, white, grey dark and grey light.
    
     
29. Currency Sign: This currency sign will be used for entire application. Enter desired currency sign to be used for this application.
    
     
30. 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 style
    Gallery
    New Images
    Lightbox
    My Account
    ......
    If the admin selects the vertical style, the user.tpl will need to be edited to accommodate the vertical menu.
    
     
31. Enable Rollover Menu Image: By checking this box the menu rollover feature will be enabled. To replace the rollover image (or the static menu image) you can simply upload new button images to the images folder while maintaining the existing file names.
    
     
32. Show Bar Stats: By checking this box, the bar containing the stats XX Media in XX Categories will be displayed. To remove this bar uncheck the box. The appearance of this bar can modified in the CSS.
    
     
33. Show Category Links: By checking this box, the bar containing the category links (breadcrumbs) will be displayed. To remove this bar uncheck the box. The appearance of this bar can modified in the CSS.
    
     
34. Enable Email Invoice Notification: If this box is checked, an invoice will be sent via email to the admin and to the end-user when an order is processed. To disable this feature, uncheck the box.
    
     
35. Enable Invoice Thumbnail: By checking this box, a thumbnail image will display on the invoice. To disable this feature, uncheck the box.

Back to Top

Media Type

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.

1. To add new file type
   
   Extension: file's extension. It should not contain a dot.
   - e.g. media .mp3 then the entered characters should be mp3
   
   
   Opening 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.
   
    
2. 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
   
    
3. 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 do not delete any media types. They might be needed sometime in the future.

Back to Top

Template Customization

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. The standard set of templates can be used "out of the box", edited to match an existing look and feel or you can replace the existing templates with new ones that you have created from the "ground up". Some templates have "call tags" and they can be moved within the template or deleted as required.

The main gallery template is the user.tpl, this where you can replace our logo, change the page background etc. (see below for more info on the user.tpl).
 

1. 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.
   
    
2. 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
   
    
3. agreement.tpl: The contents of this template will be displayed in the popup window that appears when the agreement confirmation checkbox is checked on the user registration form. The size of this popup window can be adjusted in the javascripts.js file in the scripts folder. The agreement checkbox can be removed from the registration form by changing the 1 to a 0 (zero) in the following line of the config.inc.php file in the config folder, define ( "ENABLE_AGREEMENT", 1 );
   
    
4. category.tpl: This template is used to display each category. There are four tags available
   a. [DISPLAYNAME] this tag will be replaced with the 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.
   
    
5. 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.
   
    
6. contact.tpl: The administrator can use this template to display company contact information.
   
    
7. css.css: This system is designed based on CSS (Cascading Style Sheets). To change the site layout, font size, colour etc. just modify this file as required.
   
    
8. customer_email.txt: This template is used for the LinkPoint gateway. Once the payment has been completed, the system will send out a notification email to customer
   
   
   
9. invoice.tpl: This template is for the Pro version only. This template is used when end-users want to print out the order invoice. The same template is used when an invoice is generated in the admin area. One tag is available:
   [INVOICE] the system will replace this tag with the order invoice.
   
    
10. media.tpl: This template is used to display the thumbnail of each of the media. There are five 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. [LIGHTBOX]: The system will replace this tag with the add to lightbox checkbox.
    d. [IPTC] (Only available in the Pro version): The system will replace this tag with the image's IPTC info. The display order is fixed, but individual fields can be turned on/off in the IPTC config section of gallery admin area.
    e. Floating IPTC tags (only available in the Pro version): This is an alternative method to displaying the IPTC metadata, which allows the admin to place the individual IPTC field calls anywhere on the template and in any order . For this method, the admin will have to remove the [IPTC] tag and replace it with the individual IPTC tags. The list of available calls can be seen below.
    
    For example if you wanted to display the Caption and Keywords only (in that order), then you would add the following to this template:
             Caption:  [caption]
        Keywords:  [keywords]
    
    object_name
    edit_status
    priority
    category
    supplementary_category
    fixture_identifier
    keywords
    release_date
    release_time
    special_instructions
    reference_service
    reference_date
    reference_number
    created_date
    originating_program
    program_version
    object_cycle
    byline
    byline_title
    city
    province_state
    country_code
    country
    original_transmission_reference
    headline
    credit
    source
    copyright_string
    caption
    local_caption
    
    
    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 thumbnail image.
    
     
11. media_detail.tpl: This template is used to display the media detail (enlarged display image) page. There are thirteen 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 info
    e. [HIT]: The system will replace this tag with the number of hits (image views)
    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
    i. [ADDTOCART]: The system will replace this tag with the add to cart button (Please Note: the add to cart button will not display unless a price has been added to at least one product type)
    j. [SENDTOFRIEND]: The system will replace this tag with the send to friend link
    k. [KEYWORD]: The system will replace this tag with the keyword section. This tag is only available in the Pro Version
    l. [IPTC] (Only available in the Pro version): The system will replace this tag with the image's IPTC info. The display order is fixed, but individual fields can be turned on/off in the IPTC config section of gallery admin area.
    m. Floating IPTC tags (only available in the Pro version): This is an alternative method to displaying the IPTC metadata, which allows the admin to place the individual IPTC field calls anywhere on the template and in any order . For this method, the admin will have to remove the [IPTC] tag and replace it with the individual IPTC tags. The list of available calls can be seen above.
    
    For example if you wanted to display the Caption and Keywords only (in that order), then you would add the following to this template:
             Caption:  [caption]
        Keywords:  [keywords]
    
    - If there are features that you do not want to use, then simply remove these tags from the template.
    
     
12. media_slide.tpl: This is an alternative template called that can be renamed to media.tpl which will give the media a "slide" frame to the thumbnail image.
    
     
13. notification_invoice.tpl: This template is used when an email notification invoice is sent by the system after an order has been completed. One tag is available:
    [INVOICE] the system will replace this tag with the order invoice.
    
     
14. orderinfo.tpl: The administrator can use this page to explain the ordering procedure to end-users.
    
     
15. 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
    
     
16. report.tpl: (Only available in the Pro version) The report template is used for the report section. One tag is available.
    [REPORT]: this tag will be replaced with the report
    
    
    
17. send_lightbox.tpl: This template is used to display "SEND LIGHTBOX" to a friend. One tag is required
    [SENDTOFRIEND]: the system will replace this tag with the send to friend form
    
    
    
18. send_lightbox_email.tpl: This template is used in the out going mail. There are 4 tags available
    [FRIENDNAME]: The system will replace this tag with the friend's name
    [SENDERNAME]: The system will replace this tag with the sender's name
    [MESSAGE]: The system will replace this tag with the user's message
    [LINK]: The system will replace this tag with a link that links to the user's lightbox
    
    
    
19. send_to_friend.tpl: This template is used to display "SEND TO FRIEND". One tag is required
    [SENDTOFRIEND]: The system will replace this tag with the send to friend form
    
    
    
20. send_to_friend_email.tpl: This template is used in the out going mail. There are 5 tags available.
    [FRIENDNAME]: The system will replace this tag with the user's friend's name
    [SENDERNAME]: The system will replace this tag with the sender's name
    [MESSAGE]: The system will replace this tag with the user's message
    [LINK]: The system will replace this tag with a link that links to your site
    [MEDIA]: The system will replace this tag with the media image
    
     
21. template_1.tpl: This is a sample template that can be used when the admin wishes to assign a different template to a specific category. This template is basically a copy of the user.tpl and can be assigned to a category by editing the category in the media manager. The admin can create and upload to the template folder, as many category templates as required. This feature is only available in the Pro Version. 
    
     
22. user.tpl: This template is used for the end-user interface (main gallery layout).  There are five tags available and they can be placed in any desired location.
    a. [GALLERY] The system will replace this tag with the gallery media
    b. [MENU] The system will replace this tag with all of the menu buttons. You can replace the included menu buttons with your own, simply by uploading new image files to the images folder, while maintaining the same file names. If you wish to add buttons or links to the menu, then you can remove the [MENU] call and replace the dynamic menu with a static menu of your own. You have to use the same URL paths (see below) that are used for the existing dynamic menu.
    
    <a href="index.php?pageId=0&start=0" > Home</a>
    <a href="index.php?pageId=102&start=0" > New Images</a>
    <a href="index.php?pageId=104&start=0" > Lightbox</a>
    <a href="index.php?pageId=115&start=0" > My Account</a>
    <a href="index.php?pageId=108&start=0" > Shopping Cart</a>
    <a href="index.php?pageId=117&start=0" > Ordering Info</a>
    <a href="index.php?pageId=118&start=0" > About Us</a>
    <a href="index.php?pageId=119&start=0" > Contact Us</a>
    
    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.
    e. [DISPLAYEDTHUMBNUMB]: The system will replace this tag with "Images per page" selector.
    
    This template must include these lines of code below:
    <SCRIPT language=JavaScript src="./scripts/javascripts.js" type=text/javascript></SCRIPT>
    
    and for image protection:
    
    <meta HTTP-EQUIV="imagetoolbar" CONTENT="no">
    <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 the 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 status bar 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.
    
     
23. user_account_info.tpl: This template is used for the My Account page. This page shows the end-user's order history  and also allows end-users to download any instant download orders. The user can also use links on this page to edit their profile or to logout from the system.
    
     
24. Advanced Search: There is no template for the advanced search, but the display may be modified to reduce the available search options if desired. To remove an option the Admin will need to change the 1 to a 0 (zero) in the appropriate line of the config.inc.php file in the config folder.
    
    //advanced search configure
    define ( "DISPLAY_CATEGORY_FIELD", 1 );
    define ( "DISPLAY_NAME_FIELD", 1 );
    define ( "DESCRIPTION_FIELD", 1 );
    define ( "AUTHOR_FIELD", 1 );
    define ( "COPYRIGHT_FIELD", 1 );
    define ( "KEYWORD_FIELD", 1 );
    define ( "METADATA_FIELD", 1 );
    
    

Other templates located in the tpl folder:

1. form_view.tpl: This template is used to display the dynamic registration form configuration when the "view form" link is used in the registration section of the customer manager.
   
    
2. private_search_form.tpl: The contents of this template will replace the [KEYWORDSEARCH] call in the private gallery. If you want to edit the text/link colours, form layout or properties you can do so by editing this template.
   
    
3. search_form.tpl: The contents of this template will replace the [KEYWORDSEARCH] call in the user.tpl. If you want to edit the text/link colours, form layout or properties you can do so by editing this template.
   
    
4. send_lightbox.tpl: The contents of this template are displayed in a popup window when the "Send Lightbox" link is used.
   
    
5. send_to_friend.tpl: The contents of this template are displayed in a popup window when the "Send to Friend" link is used.

Back to Top

Customer Manager

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 or account page, but they be able to access the site to view the thumbnail or media detail page.
Active customers are able to access all pages of the gallery, but not the administration area.

Registration: The dynamic 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 address. These are required by the system to track user activity and orders.

Agreement Checkbox:
 

1. Add: To add a new form field (see form field properties below)
2. Detail: To edit the current form field (see form field properties below)
3. 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.
4. Up: Move the field up one position
5. Down: Move the field down one position
6. View 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 or spaces.
   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 ~~!@#$%^&*()+=|\}]{["':;?/>,< (these can be removed if not required)
   Field Label: Label of the field (this will be displayed to the end-user)
   Display Error: This error message will be displayed if an error (as defined above) is detected.
   Submit: To add the new field click Submit.
   
    
7. To change customer status to pending, click on the pending link in the Active Customers page.
   
    
8. To activate customers, click on the active link in the Pending Customers page.
   
    
9. To edit a customer registration, click on the detail link. Edit the fields as necessary and click on submit to save changes.
   
    
10. To email an individual customer, click on their email address to open your mail client.
    
     
11. To Email a customer group:
    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 should be entered in this area. It is only possible to send text-based email using this feature.
    e. Click Send to send the message, click Reset to clear all fields.

Back to Top

This section allows the administrator to configure and set up the desired payment gateways. The system supports the following payment gateways. They are PayPal, 2Checkout, Protx - VSP, VeriSign Payflow Link, Skipjack, Concord, Commweb, Linkpoint and Authorize.Net. The Administrator can choose any or all of the payment gateways by checking the relevant boxes. Concord, Commweb, Linkpoint and Authorize.Net are only available in the Pro Version. Also in the Pro Version there is the option to capture the user's billing details and process the transaction offline.
 

1. Config
   a. Payment Required: By default the only way that a product designated as an instant download will be made available is by confirmation that a payment has been completed by the payment processor. If you wish to have all items in a shopping cart made available for download without receiving a payment, then you can uncheck this box. You will have to have setup at least one product type, but you do not have to assign a price to it.
   b. Enable PayPal Gateway: To disable this gateway simply uncheck the box.
   c. Enable 2Checkout Gateway: To disable this gateway simply uncheck the box.
   d. Enable Protx - VSP Gateway: To disable this gateway simply uncheck the box.
   e. Skipjack: To disable this gateway simply uncheck the box.
   f. Enable VeriSign Payflow Link Gateway: To disable simply uncheck the box.
   g. Concord: To disable this gateway simply uncheck the box (pro version only).
   h. Commweb: To disable this gateway simply uncheck the box (pro version only).
   i. Enable Linkpoint Gateway: To disable this gateway simply uncheck the box (pro version only).
   j. Enable Authorize.Net Gateway: To disable this gateway simply uncheck the box (pro version only).
   k. Offline Payment: To disable this gateway simply uncheck the box (pro version only).
   l. Minimum Order: Enter the minimum order purchase amount to this box. If the minimum order is not reached, the user will be instructed to continue shopping. The message displayed can be edited in the user language file.
   m. Order Name: This name will be used for the order name.
   
    
2. 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.
   
   For more information on PayPal, please visit their website www.paypal.com
   
    
3. 2CheckOut
   a. SID: Enter your SID here. This ID can be found in your 2Checkout account.
   b. 2 Checkout URL: There is 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.

Please Note: That in your 2CO account under the V2 login you will need set the Direct Return to Yes and input the following for the Approved URL in the Look and Feel Settings.

http://www.yourdomain.com/path-to-lightbox/twocheckout_activate.php

For more information on 2Checkout, please visit their website www2checkout.com

 
4. Protx - VSP Form
   a. Protx Secure URL: Enter Protx secure URL address in this field. Administrator should replace test URL with the real payment gateway once the testing is complete.
   b. Vendor Email: Enter vendor email address which is registered with Protx.
   c. Currency: Enter currency to be used for this gateway, by default it is GBP.
   d. Vendor Name: The name that Protx sends with the welcome email.
   e. Vendor Password: The password which Protx sends with the welcome email.
   
   Protx - VSP Direct
   The lightbox system will use the Protx direct method instead of  form method if the "Protx Secure URL" field is entered. These fields should be left blank unless you wish to use the direct method.
   a. Protx Secure URL:  Enter the secure URL to this field. This url should point to the protx.php file. The protx.php file is located where you installed the software. The URL should be something like this:  https://www.yourdomain.com/path-to-lightbox/protx.php
   b. Vendor Name: The name that Protx sends with the welcome email.
   c. Protx Posted URL: Enter Protx posted URL address in this field. Administrator should replace test URL with the real payment gateway once the testing is complete.
   
   For more information on Protx, please visit their website www.protx.com
   
    
5. Skipjack
   a. Merchant Serial #: Enter your merchant number in this field.
   b. Secure URL: There is no need to change this field.
   c. Secure Post URL: There is no need to change this field.

   You will need to input the following in your Skipjack admin area under Preferences/Response Files.
   
   Web Page Response Files: (Thank you for your order)
   http://www.yourdomain.com/path-to-lightbox/index.php?pageId=115&start=0  

   Backend Response URL:
   http://www.yourdomain.com/path-to-lightbox/skipjack_activate.php
   
   For more information on Skipjack, please visit their website www.skipjack.com 
   
    

6. VeriSign Payflow Link
   a. VeriSign Login ID: Enter your VeriSign login ID in this field.
   b. VeriSign Partner ID: Enter your VeriSign partner ID in this field.
   c. VeriSign URL: There is no need to change this field.
   
   In your VeriSign account you will need to set the following.

   Return URL:  http://www.yourdomain.com/path-to-lightbox/index.php?pageId=115&start=0

   Silent POST URL: (check the box) http://www.yourdomain.com/path-to-lightbox/verisign_activate.php

   For more information on VeriSign, please visit their website www.verisign.com
   
    

7. Concord
   a. Concord Secure URL: There is no need to change this field.
   b. Concord Posted URL: This will be supplied in the email sent you after your account has been setup.
   c. Concord Store Id: This will be supplied in the email sent you after your account has been setup.
   d. Concord Key Id: This will be supplied in the email sent you after your account has been setup.
   
   For more info. on Concord, please visit their website www.concordefsnet.com
   
    
8. Commweb
   a. Host IP Address: the host IP address for the server where Lightbox is installed.
   b. Host Port Number: the default value is 9050. Please ask your hosting provider to confirm.
   c. Return URL: The commweb_activate.php file is located where you installed the software. The URL should be something like this:  https://www.yourdomain.com/path-to-lightbox/commweb_activate.php
   
   
   
9. LinkPoint API
   This payment gateway is only available for the Pro version. If you want this gateway included in the system, please contact sales to upgrade to the Pro version.
   With this payment gateway you can process payments within your site. You need to have your site encrypted (SSL). To have you site encrypted you need:
   1. Certified key, you can create this key from providers such as Geo Trust,  VeriSign, Thawte,  or others.
   2. Install this key to your server. Please ask your hosting provider to learn more about this.
   
   a. LinkPoint Host Name: This host name is included in the welcome email after registering with LinkPoint.
   b. LinkPoint Store Name: Enter Linkpoint store name. This store name is in the welcome email.
   c. LinkPoint Port Number: Enter Port number here. By default it's 1129. You can find this number in the welcome email.
   d. Certification File Path: The certification file is stored in the pemfile directory. Please replace this file with yours. Enter other path if it's located elsewhere.
   e. LinkPoint Secure URL: Enter the secure URL to this field. This URL should point to the lp.php file. The lp.php file is located where you installed the software. The URL should be something like this:
   https://www.yourdomain.com/path-to-lightbox/lp.php
   
   For more information on Linkpoint, please visit their website www.linkpoint.com
   
    
10. Authorize.Net AIM
    This payment gateway is only available for the Pro version. If you want this gateway included in the system, please contact sales to upgrade to the Pro version.
    With this payment gateway you can process payments within your site. You need to have your site encrypted (SSL). To have you site encrypted you need:
    1. Certified key, you can create this key from providers such as Geo Trust,  VeriSign, Thawte,  or others.
    2. Install this key to your server. Please ask your hosting provider to learn more about this.
    
    a. Authorize.Net Login: This will be supplied in the email sent you after your account has been setup.
    b. Authorize.Net Transaction Key: To obtain your x_tran_key, log into the Authorize.Net Merchant Interface, click the SETTINGS link (on the left), then look under the SECURITY section and click OBTAIN TRANSACTION KEY.
    c. Authorize.Net Secure URL: This will be supplied in the email sent you after your account has been setup.
    d. Authorize Location: Enter the secure URL to this field. This URL should point to the authorize.php file. The authorize.php file is located where you installed the software. The URL should be something like this:
    https://www.yourdomain.com/path-to-lightbox/authorize.php
    
    For more information on Authorize.Net, please visit their website www.authorize.net 
    
     
11. Offline Processing
    This option is only available for the Pro version. If you want this option included in the system, please contact sales to upgrade to the Pro version.
    The Offline configuration allows the administrator to configure the secure URL address for the offline.php file. We recommend that the administrator uses a secure URL for this file (https). The offline.php file is located where you installed the software. The URL should be something like this: https://www.yourdomain.com/path-to-lightbox/offline.php

Back to Top

Back to Top

Tax Manager

The tax manager section allows the  administrator to tax any order based on a defined set of  variables. When applicable, tax will be applied to the order total after any discounts have been applied but before any shipping charges are added. .

1. Config
   Enable Tax Feature: To disable tax feature simply uncheck this box. The system will not tax any order if Tax Feature is disabled.
   
    
2. Tax Setup
   Tax any person who's:
   Select the field name from the drop down list. Any optional fields in the registration form will display here. You can add new fields to this list by adding them to registration form.
   Operand:
   - Equal: If the Equal operand is selected, the system will apply tax to customers who match the selected value in previous (drop down) field with the next (text input) field.
   - Not Equal: If the Not Equal operand is selected, the system will apply tax to customers who do not match the selected value in previous (drop down) field with the next (text input) field.
   Then Charge:
   Enter the tax percentage to be charged based on the above criteria.
   
   The Admin can add many tax options as necessary. The system will only tax the customer if the specified condition is matched.
    

Example 1: The admin needs to charge 8% tax to any customers that reside in Illinois.

Example 2: The admin needs to charge 15% tax to any customers that reside in Ontario, 7% to any customers that reside in Canada but outside of Ontario and 0% tax to any customers that reside outside of Canada.

Back to Top

Flat Shipping Manager

The flat shipping manager section allows the administrator to set a flat rate of shipping instead of assigning individual shipping values in the media manager.

1. Config
   Enable Flat Rate Feature: To disable this feature simply uncheck this box. If this feature is enabled all shipping costs entered in the media manager will be ignored.
   
    
2. Shipping
   Enter the range of the the total order to be associated with a shipping charge. You can create as many ranges as necessary. To remove a range, click on the delete link. Please note that the range entered should be less than the lower end and higher than the upper end.
   - Price From: the start price
   - Price To: the end price
   - Cost: the shipping cost for this range.
   eg: You enter:
   Price From: $ 99.99
   Price To: $250.01
   Cost: $30.
   The system will add $30 more to the total price for any purchase which is in the range of $100 to $250.
   
   To add a new flat shipping cost, fill in the values and click on the Add button.
    

Back to Top

1. 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 for the desired product type.
   c. To delete a product type simply click on the Delete link for the desired product type. Please remember that 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 in the display, click on the Down link.
    

Please note: The Add to Cart button will not display until at least one product type has been assigned a price.

Back to Top

Media Manager

Batch Upload Media:

Via FTP (we recommend WS_FTP Pro)
You can batch upload folders of media via FTP to the gallery folder. If you upload an entire folder of images then the folder name will become the category system name once the folder has been brought into the database using the Media Autodetect feature. After the media have been uploaded, please remember to give the files and folder permissions of 777 (r/w/e). Once the images have been added to the database, you can then create thumbnails, add watermarks, pricing, descriptions etc.

Via Batch Upload link (Your PHP installation needs to have zip support enabled)
Using this feature the admin can upload a batch of images contained in a .zip file. The .zip file will be unzipped and the files will automatically be added to the database. Although this feature is extremely convenient since no FTP software is required, it is limited by the default PHP setting of a 2MB upload limit. Once the images have been added to the database, you can then create thumbnails, add watermarks, pricing, descriptions etc.
 

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.

1. 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.
   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 777(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.
   - Template Name: (Pro Version only). The default gallery template is the user.tpl. This drop down menu allows the admin to assign a template to a specific category (ideal for advertising or branding). All templates in the template folder will display here, but the admin should only select the user.tpl (default gallery template) or another template created using the same dynamic calls as the user.tpl. The admin can create and upload to the template folder, as many templates as required.
   - 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.
   
    
2. Batch Upload (Your PHP installation needs to have zip support enabled)
   This feature will not be visible in the main gallery directory. The admin must browse to a category to use it. Using this feature the admin can upload a batch of images contained in a .zip file. The .zip file will be unzipped and the files will automatically be added to the database. Although this feature is extremely convenient since no FTP software is required, it is limited by the default PHP setting of a 2MB upload limit. Once the images have been added to the database, you can then create thumbnails, add watermarks, pricing, descriptions etc.
   
    
3. Global Update  This feature will not be visible in the main gallery directory. The admin must browse to a category to use it. The global update feature allows the admin to update the media properties for images in a category or for the entire gallery. This feature allows the admin to update the following media's fields:
   
   1. Display Name
   2. Description
   3. Author
   4. Copyright
   5. Keywords
   
   To update the media properties:
   1. Browse to the category/folder that you wish to update
   2. Select the Field name.
   2. Including Subcategories. The system will update all subcategories and their contents if this checkbox is checked.
   3. Enter the data to be updated for the selected field
   
   Once you click on the Submit button, the new data will be updated for all media in the selected category.
   
    
4. Downloadable Link
   The downloadable feature allows the administrator to enable download links for an entire category of media. Before using this feature, please make sure that all download files are residing in the download directory under the same directory structure as the gallery folder and you have prefixed the file name with the product type.
   
   Example:
   If you have a product type called largeprint then the prefix would be largeprint_

   The gallery file path should be: gallery/categoryone/image1.jpg and the download file path should be: download/categoryone/largeprint_image1.jpg

   You select the category, assign a price, select the product type and then click enable download.
   
    

5. Global Price This feature allows the Admin to assign a price to a product type for an entire category (inc. subcategories if selected) of media.
   - Category: Select the category that you wish to assign pricing
   - Including Subcategories: Check this box if you want the pricing to be applied to the current category as well as any subcategories that it contains.
   - Start From: To prevent a server timeout, enter the start from number and the number of rows to be altered in the provided fields or leave them blank for all media. This feature is only for advanced users, with very large galleries.
   - Global Price: Enter a price that will be assigned to all media in the selected category for the specified product type.
   - Product Type: Select the product type that you wish to assign a price.
   Click on the update button to assign the pricing.

   Global Product Type Pricing
   If you want to assign a price for a product type to all media in the gallery you can simply enter a price for the product types listed in the Global Product Type section and click on the update button.
   
    

6. Sort Order: Using this feature you can set the order that the categories will display. This will override the sort order setting in the general config. Enter 1 for the category to display first , 2 for the next to display and so on, as required.
   
    
7. Status: If the category is protected, the status will display as private. If the category is un-protected (default) then the status will display as public.
   
    
8. To Edit a category click Edit.
   - System Name: The system name is disabled when editing a category.
   - 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.
   - Template Name: (Pro Version only). The default gallery template is the user.tpl. This drop down menu allows the admin to assign a template to a specific category (ideal for advertising or branding). All templates in the template folder will display here, but the admin should only select the user.tpl (default gallery template) or another template created using the same dynamic calls as the user.tpl. The admin can create and upload to the template folder, as many templates as required.
   - 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.
   
    
9. To Remove a category from the database, click Remove. Once the category is removed, it remains on the server but not in the database.
   
    
10. To Delete a category from the database, click Delete. Once the category is deleted, it is deleted from the server and the database.
    
     
11. To Add IPTC information for this category click on the Add IPTC link. Using the drop down menu, select the category to which you want to add IPTC info. Add information to the desired fields and click submit. Upon clicking submit the entered fields will be saved to the images IPTC metadata header.
    
    Please note: Before using this feature, you must ensure that all image folders and files have permissions of 777 (r/w/e). Using this feature will overwrite any existing IPTC metadata for selected category of images and the original info can not be recovered.
    
    To learn more about IPTC please see the IPTC section.
    
    
    
12. Searchable IPTC: in order to enable the system to search media IPTC info, you need to add this embedded information to the database. This function allows the administrator to achieve this.
    To add IPTC info for a category to the searchable database, simply click on the Searchable IPTC link of the desired category. If you have sub-categories you have to use the link in the lowest category and work your way up the category structure. After completing this you will need to also click on the rebuild searchable contents link.
    
     
13. Protect
    This feature is only available in the Pro version. The Protect feature allows the administrator to Protect or Un-Protect a selected category. If the category is protected, the system will only allow users that have input the assigned user/password combination for the protected category to be able to view it. If the category is protected, the status will display as private. If the category is un-protected (default), then the status will display as public.
    
    Add Access User
    The Add Access User feature allows the administrator to add user/password combinations that will allow access to the protected category. The Add Access User link is only available when the category is protected.
    
    To add new users to a protected category:
    - Select the protected category by clicking on the Add Access User link
    - Input a username and password  and click Submit to give access to the selected user/password combination.
    
    The Admin can assign an access user to more than one protected category by adding the same user/pass combination to the additional categories as desired.
    
    By default the Admin can access all protected (private) categories by clicking on the Private Gallery link and logging in with their gallery admin user/pass combination.
    
    There is usually no reason to include a logout link in the gallery as users given access to a private category do not need access to the public gallery. If your application requires this, then you can add the following logout code to the user.tpl. <a href="index.php?pageId=logout">LOGOUT</a>
     
    Un-Protect
    The Un-Protect feature allows the administrator to un-protect a protected category. When the category is un-protected it can be viewed by all users.
    
    
     
14. To add new media click on Add New Media.
    This feature allows the admin to add individual media to a category. To upload a batch of images, please see the information on batch uploading via FTP at the top of this category. This feature will not be visible in the main gallery directory. The admin must browse to a category to use it. 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 to an individual image while adding new media. To assign an instant download, please use the Edit function that is located on the Media Manager page, or assign the instant download using the Downloadable feature above. 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
    Note:  If you want to use the system's "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 admin defined thumbnail prefix, which is  gallery_ by default.

    - 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
    
     

15. To edit media browse to the file you want to edit and click the Edit link.
    - 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 types are added in the database they will be displayed on this page so that a price can be entered. 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 has access. If you prefer to assign the download files for an entire category at once then you should use the downloadable link (see above).
    To remove the download link, click on the ìRemove Download Linkî which allows the administrator to remove the download link for 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. The Add to Cart button will not display unless at least one product type has been assigned a price.
    
     
16. To Add IPTC info to this media click on the IPTC info link. Add information to the desired fields and click submit. Upon clicking submit the entered fields will be saved to the images IPTC metadata header.
    
    Please note: Before using this feature, you must ensure that all image folders and files have permissions of 777 (r/w/e).
    
    To learn more about IPTC please see the IPTC section.
    
     
17. # Hits: This feature displays the hits (views) for each media.
    
     
18. To remove media from the database click on the Remove link.
    
     
19. To delete media from the database and the server click on the Delete link.
    
     
20. 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. If you upload an entire category of images you can bring all images in that category into the database with one click. If you add images to a category that has already been added to the database, you will have to add the the images with individual clicks.
    
    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.
    
     
21. Rebuild Searchable Contents:  MySQL requires search terms to be four characters or more. Therefore any search strings less than four characters would normally be ignored by the system. The rebuild searchable contents is used to improve efficiency and accuracy of the search results.
    
     
22. 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

Back to Top

Available IPTC fields that the system utilizes:

object_name
edit_status
priority
category
supplementary_category
fixture_identifier
keywords
release_date
release_time
special_instructions
reference_service
reference_date
reference_number
created_date
originating_program
program_version
object_cycle
byline
byline_title
city
province_state
country_code
country
original_transmission_reference
headline
credit
source
copyright_string
caption
local_caption
 

Back to Top
 

Media Config. & Thumbnail Manager

This section allows the administrator to configure/manage the gallery thumbnails and to watermark images.

1. Configuration
   a. Thumbnail Prefix name: The name will be attached to the image filename for its thumbnail name. This is how the gallery matches the thumbnail to the larger display image.
   b. Reduce from its original size: The thumbnail size will be created based on this percentage reduction. Therefore to create a smaller thumbnail you will have to input a larger number (more reduction).
   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.  Over write enable: Check this box if you want to be able generate a new size of thumbnail and have the previous file replaced. This feature is designed to allow the Admin to experiment with different size thumbnails until the desired size is achieved. Once the desired percentage reduction is determined, the over write enable box should be unchecked. Otherwise, it can cause a server time out before the operation completes in a large category of images. For large galleries, it is recommended that the existing thumbnails are deleted from your server using your ftp client and then generate new thumbnails.
   e. Resize To: This feature is not recommended for a large category of images, or for very large files, as it will cause the server to timeout. It is more efficient to run a batch process to resize your images prior to upload.
   Enter the new size here if you want to resize any image which has a larger size compared to this size. The system will auto generate a new Width or Height depending on the selection from the dropdown list next to the Pixels field.
   e.g. if you select enter 500 Pixels Width then the image's height will be automatically calculated based on this 500 pixels wide. Otherwise the Width will be automatically generated. Using this feature helps the administrator to resize all images to the same width or height. We suggest the administrator enters a width of 500 pixels.
   f . Watermark type: there are two types available, 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.
   - Transparency Value: this value can be edited to adjust the transparency of the watermark. The admin can view the effect of changing this value by using the watermark demo feature. The default value is 30.
   - 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.
   
    
2. IPTC Configuration
   This feature allows the Admin to control which IPTC fields display. In addition the admin can allow fields to be hyperlinked searches (or unlinked) and allow fields to be linked as individual words or linked in keyword phrases, depending how they were captioned. To activate/de-activate an option for a field, check or un-check the boxes as required.
   
   
   
3. Resize Image
   The Resize feature allows the administrator to resize all images on the gallery to the same width or height. Click the Resize link of the desired category to resize its images. The resize image process will take sometime depending on the size of the original images and number of images. If a blank page is displayed please continue refreshing the screen until the message "Action Performed Successfully" is shown. This indicates that the resize image process is complete.
   NOTE: images can't be recovered to their original size after resizing. So please make sure that you backup all images before doing so. Before using this feature, you must ensure that all image folders and files have permissions of 777 (r/w/e)
   
    
4. Watermark
   To watermark an entire category, click on the watermark link on the right side of the screen. The images will be watermarked based on the setting in the configuration above. Please note: the image can not be recovered to its original unmarked condition after has been watermarked, so please make sure you 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. Before using this feature, you must ensure that all image folders and files have permissions of 777 (r/w/e)
   
    
5. Generate Thumbnails
   If you want to use the system's "Generate Thumbnails" feature, the administrator should convert all images to jpg format before uploading it to the server. 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 admin defined thumbnail prefix, which is  gallery_ by default.
   
   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 on the browser refresh button and the system will continue to generate thumbnails from where it left off. Keep doing this until you see the Action performed successfully message. If you do not see this success message, check to see if the thumbnail overwrite box in the configuration section is checked. If it is, uncheck the box and click on the generate thumbnails link again. Before using this feature, you must ensure that all image folders and files have permissions of 777 (r/w/e)
   
    
6. 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.
   Example:
   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.

Back to Top

This section allows the administrator to keep track of the end-users lightboxes and to set a maximum number of media that end-users are allowed to add to their lightbox.

1. 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.
   
    
2. 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 view the contents of the user's lightbox, click on the session id link. 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.

Back to Top

Back to Top

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
 

1. Complete is to change the order status from pending to completed
    
2. Pending is to change the order status from completed to pending
    
3. To view details of a selected order, click on the order id number. The media product type will be displayed on a detail page.
    
4. To view the media image click on the media id on the order detail page

Invoice Configuration: Invoice configuration page allows the administrator to customize the user's invoice. To add more fields to the invoice select the Field name in the dropdown list and click Submit. The new field data will be displayed in the user's invoice. This feature is only available on the Pro version.

To View the Invoice select the Invoice number and click on the View Invoice button.

Back to Top

Back to Top

Back to Top

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

If you wish to assign the files individually, browse to the media file in the media manager and click Edit. Then check the Enable Download Link box, browse to the download file in the popup window and click select.

If you wish to assign a category of images for download, use the Downloadable link.

Downloadable Link
The downloadable feature allows the administrator to enable download links for an entire category of media. Before using this feature, please make sure that all download files are residing in the download directory under the same directory structure as the gallery folder and you have prefixed the file name with the product type.

eg: If you have a product type called productone then the prefix would be productone_

The gallery file path should be:  gallery/categoryone/image1.jpg and the download file path should be: download/categoryone/productone_image1.jpg

You select the category, assign a price, select the product type and then click enable download.

Back to Top

In the language folder there are four files:

admin.language.php
form.language.php
user.language.php
iptc.language.php (pro version only)

Simply edit these files as required and the changes will be displayed throughout the gallery. You can also add html code to the language text if required.

Example: You would like to replace the term QUICK JUMP with the term FAST FIND, then you need to edit the following line in the user.language.php file in the language folder.
- (Before)   define ( "_MD_VIEW_CATEGORY", "QUICK JUMP" );
- (After)       define ( "_MD_VIEW_CATEGORY", "FAST FIND );

Back to Top

Back to Top
 

Back to Top
 

Batch Upload Media via ftp:

Q.  I have a category that contains over 600 images, what is the best way to add them to the gallery?
A.  You can batch upload media via ftp to the gallery folder. If you upload an entire folder of images then the folder name will become the category system name once the folder has been brought into the database using the Media Autodetect feature. After the media have been uploaded, please remember to to give the files and folder permissions of 777 (r/w/e). Once the images have been added to the database, you can then create thumbnails, add watermarks, pricing, descriptions etc.

Customizing:

Q.  I have entered a minimum order amount of $ 10.00, but when the message shown to the customer says that the minimum order is $ 20.00. How can I change that?
A.  The message for the customer can edited in the user.language.php file.

Q.  I would like to change the size of the popup windows, where can I do that?
A.  The size of the popup windows can be adjusted in the javascripts.js file in the scripts folder.

Q.  I would like to remove the required checkbox (that pops up the agreement window) from the registration form. Is this possible?
A.  Yes, you will need to change the 1 to a 0 (zero) in the following line of the config.inc.php file in the config folder, define ( "ENABLE_AGREEMENT", 1 );

Q.  Iím playing around with the template and canít figure out how to make the text above the search field white?
A.  Look up the search_form.tpl file in the tpl directory, with this file you can adjust the color as you need.

Q.  Can I use a transparent .gif for the watermark image?
A.   Not with the file extension .gif, but you can change the file extension to .jpg and it will work.

Q.  Can I add html code to the language files?
A.  Yes, you can add html code to the language files to bold an item, change text colour etc

Q.  Can I add html code to the file description field?
A.  Yes, you can add html code to the description field.

Q.  Can I add html code to the product type label field?
A.  Yes, you can add html code to the product type label field to bold an item, add hyperlinks etc

Q.  Can I use special characters such as 's in my file names?
A.   Do not use any special character or leave spaces in your file or category names. You can use any combination of letters and numbers, but do not start the file name with a number. If you wish to use spaces in the file or category names, then use the ( _ ) underscore instead.

Q.  I would like to change the silver buttons on the menu bar to green ones that match those on my home page, how can I do this?
A.  To change the menu buttons, you just need to upload your new buttons to the image folder giving them the same file names and they will replace the existing buttons.

Q.  How should I separate keywords and IPTC info?
A.  Keywords and IPTC info should be delimited by spaces and not commas. Also, do not use special characters such as the ( ' ) apostrophe. 
 

Miscellaneous:

Q.  I uploaded my images, added watermarks and then generated my thumbnails. Now my thumbnails are watermarked, is it possible not to have watermarks on the thumbnails?
A.  Yes, you just have to change your operating order. After uploading your images, you should generate your thumbnails first and then add your watermarks. This way, only your display images will be watermarked.

Q.  After unzipping the the software, I see an index.html file in each folder. What is this for?
A.  This file is to prevent directory browsing if your server (hosting account) allows it.

Back to Top