HELP MENU & SYSTEM CONFIGURATION
Version 5.03

Thank you for choosing Stockbox Photo® Gallery Software.
The preferred choice for professional photographers, artists and artisans to display and sell their work online.

• To launch the main help documentation, click on the icon that is located at the right top corner of the Stockbox Photo® Admin Control Panel.
• To launch help documentation for each section of the Admin Control Panel, click on the icon that is located on each page next to the main navigation menu.
• Throughout this documentation we will refer to Stockbox Photo® Gallery Software as Stockbox or the System.

• Select the topic from the main menu by clicking on it. This will display information for the selected topic.
• To search this document on a PC, click on the ctrl + F keys and enter the keywords you wish to search for. On a Mac, click on the Apple Key + F and enter the keywords you wish to search for.

• Standard Version
  The Standard Version offers the core functions that will allow you to display and sell your digital or tangible products online, but it does not include any of the advanced features.
  
  
• Professional Version
  The Professional Version contains all of the core features offered in the Standard Version and includes some of the more advanced features.
  
  
• Enterprise Version
  The Enterprise Version contains all of the core features offered in the Standard & Pro. Versions and includes all of the available advanced features.
  

Stage 1 - The physical installation of the software and customization of the templates.

• Installation
• General Configuration
• Media Configuration
• Template Customization

Stage 2 - Populating the gallery with your media

• Uploading Images
• Resize Images
• Thumbnails
• Watermarks
• Product Types
• Pricing Media
• Promotion Setup
• Shipping Configuration
• Tax Configuration
• Payment Gateways
• Instant Download Links
• Frequently Asked

1. Add New Categories
2. Edit an Existing Category
3. Remove or Delete Existing Categories
4. Set Category Sort Order
5. Visible to Photographers (Ent. version)
6. Add New Media (Via FTP or Web Browser)
   b. i. Individual Upload Media via a Web Browser
   b. ii. Batch Upload Media via a Web Browser (Pro. & Ent. versions)
7. Import Hi-res Files
8. Edit Existing Media
9. Remove or Delete Existing Media
10. Add Zoomify™ Files for Existing Media
11. Featured Media (Pro. & Ent. versions)
12. Enable Download Links (Instant Download Setup)
13. Pricing Selected Media
14. Approve Photographer's Media (Ent. version)
15. Un-Approve Selected Media (Ent. version)
16. Create new order (Ent. version)
17. Apply IPTC metadata to the Gallery (Pro. & Ent. versions)
18. Searchable IPTC Data (Pro. & Ent. versions)
19. Protect & Un-protect a Category (Pro. & Ent. versions)
20. Add Access-users for Private Galleries (Pro. & Ent. versions)
21. Set FTP Download Server for a Category (Ent. version)
22. Category Auto Price Configuration (Pro. & Ent. versions)
23. Global Update of Media Details
24. Category and Media Status
25. Quick Search Media (Pro. & Ent. versions)
26. Global FTP Download Server Configuration (Ent. version)
27. Multiple Media File Selection (Pro. & Ent. versions)
28. Auto Detect Newly Uploaded Media or Categories
29. Generate Thumbnails
30. Watermark Images
31. Rebuild Database
32. Resize Images
33. IPTC Configuration (Pro. & Ent. versions)
34. IPTC Mapping Configuration (Pro. & Ent. versions)
35. Media Type Manager
36. Media File Types
37. Media Utilities (Ent. version)
38. POP3 Media (Ent. version)
39. Send to Friend Logs
40. FTP Syndication (Ent. version)
41. Media Export (Ent. version)
42. Media Statistics (Ent. version)
43. Media Configuration

1. Add New Category
   Stockbox recognizes a system directory (folder) on your server as a category in the gallery. You can create as many categories (directories/folders) and sub-categories as you need.

   There are two ways to add a new category

   1. Using  the Media Manager
   2. Using an FTP client

   a. Using the Stockbox Media Manager (Manually)
   Using the manual method you can only create one category at a time. Since Stockbox recognizes a system directory as a category, you need to ensure that the gallery directory that you are about to add a new category to is writeable (777) also Safe Mode on your server must be turned off. If your host is unable to turn off the Safe Mode, then you will have to create the new categories with your FTP client (see below).
   

   • Click on the Media Manager Media Manager link in the main menu.
   • Browse to the particular category by clicking on the category name.
   • Click on the icon to add a new category.
     
     
      
   • Your current working directory
     This line shows the current working category that you are browsing. The new category will be created under (within) this category.
      
   • System Name
     The System Name is used as the physical server directory name. It must not contain any of the following invalid characters ~ ` ! @ # $ % ^ & * ( ) + = \ | } ] { [ " ' : ; / ? > . < , and spaces.
     If the system detects any of the invalid characters listed above, it will return an error when the data is submitted.
      
   • Display Name
     Use this field to add a more meaningful name to the category. You can use spaces and other characters that are not permitted in the system name. By default the category system name is displayed in the gallery. If you enter a display name it will be displayed instead of the system name.
      
   • Description
     Use this field to describe the category. You can use HTML code in this field if required.
      
   • Template Name: (Pro. & Ent. versions)
     With the Pro. and Ent. versions you can assign different gallery templates to different categories (ideal for advertising or branding). You can use this feature to create a different look and feel for each category (the functionality will be the same). If you do not select a template from the drop down menu when creating a new category, the system will use the default gallery template. All templates that are in the ./template/english/ folder will display in the drop down menu, but you should only select the category_template_sample.tpl or another template created using the same dynamic call tags and page header (head section of html code) as the category_template_sample.tpl template. You can create and upload via FTP as many templates as required to the "./template/english/" folder.
      
   • Icon (Category Icon)
     When the system displays the categories in the gallery, it can display an icon that is assigned to the particular category. You can either upload a category icon to the “icon” directory via FTP, or you can upload the icon to the category’s directory itself. If you upload the icon to the target category’s directory, then you must name it as “icon.jpg”. The system will automatically load the “icon.jpg” for the that particular category for selection when it detects one. You can also use thumbnail images in the particular category for icons, by selecting the “Use Random Image” option in the Icon drop down list. When you are using the “Use Random Image” option, the system will randomly use media thumbnail images from the target category and its sub categories for the category icon. The system will only display the category's display name if the “Do Not Use Icon” option is selected.
     
     
   • Use this setting for existing sub-categories
     Tick this checkbox if you want to use the same Icon Configuration for the target category's sub-categories.
      
   • Visible to Photographers (Ent. version)
     If you do not want the category to be visible in the Photographer's (Contributor's) Media Manager, then you should un-check this box.
      
   • Click the Submit button to add the new category.
     
     Before adding a new category name on the server, the system will check that the safe mode is turned off on the server. Please check with your hosting service provider that it is set correctly. If this configuration is not possible, you will have to create a new category using an FTP client by creating a new folder (category) on the server and changing its permissions to 777(read/write/execute) before uploading any new media to it.

   b. Using an  FTP Program to add a new category
   When you have finished adding or uploading new categories on the server, you will need to use the “Auto Detection” feature to add these new categories and their media to the database. Stockbox will only display the new categories and their media in the gallery after they have been added to the database. In order to use this method you need to have an FTP client program installed on your local computer. After adding a new category via FTP you will need to change its permissions to 777(read/write/execute) before uploading any new media to it.

   • Connect to your web server.
   • Browse to the directory where the Stockbox software is installed.
   • Browse to target directory inside of the "gallery" directory. All categories and images should be in folders (directories) under the "gallery" directory.
   • Upload the new directory and its contents to the target directory.
   • Once the uploading is complete, login to the Stockbox Admin Control Panel and click on the Media Manager Auto Detection link in the Media Manager drop down menu.
   • Click on the category that holds the new category and images that you have just finished uploading.
   • Click on the icon to add the new category and its contents to the database.
   • Click on the icon to add all of the new categories to the database (Pro. & Ent. versions).
   
   This method allows you to batch upload new categories and images to the Stockbox system. This is a very efficient method of uploading a large quantity of images to your gallery.

   There are three category statuses:

   • Public Status
     Categories with "Public Status" can be viewed by all users.
     
   • Private Status
     Categories with "Private Status" can only be viewed by users that have been granted access (username and password) to a Private Gallery. You can add Private users (access-users) to a Private category (protected category) using the "Add Access Users" feature.
     
   • Hidden Status
     Categories with "Hidden Status" are hidden to all users. Stockbox will not display the category (including its sub-categories and its media) in the gallery. The administrator will still be able to view the hidden folders and files in the Admin Control Panel.
     
     
2. Edit an Existing Category
   Use this feature to change a category’s properties. It is not possible to edit the category’s system name once it has been created.  When you are editing an existing category you are able to edit the following.
    
   1. Category Display Name.
   2. Category Description.
   3. Category Template.
   4. Category Icon.
      
      
   To edit an existing category.
    
   • Click on the Media Manager Media Manager link in the main menu.
   • Browse to the target category.
   • Click on the icon to edit the category properties.
   • Edit all information in the available text fields as required.
   • Click the Submit button to save the changes.
     
      
3. Remove or Delete an Existing Category  
   Stockbox recommends that you should set the category status to hidden instead of removing or deleting it from the database when your gallery is live and users have already purchased media from this selected category. This will prevent missing data on the Sales Reports and other sections.
    
   1. Remove
      The remove feature will remove the category and its contents from the database, but not the physical files from the web server.
   2. Delete
      The delete feature will delete the category and its contents from the database AND the physical files on the web server. The system may return a "Can't delete directory from the server" message upon confirming the delete action. If this happens, it means that there are still some files in the target directory that are rejecting the delete action. In this situation, you will need to use your FTP client to remove the directory from the physical server. After deleting the directory with your FTP client, you will need to use the Rebuild Database function to remove the old entries from the database.
       
   To remove or delete existing categories
    
   • Click on the Media Manager Media Manager link in the main menu .
   • Browse to the target category.
   • Click on the icon to remove the category and its contents from the database.
   • Click on the icon to delete the category and its contents from the database AND from the web server.
   • When performing either of these actions a confirmation dialog box will open. In order to complete the action, you will need to confirm the action by clicking on the icon in the dialog box.
     
     
   With the Ent. version you can delete multiple categories (directories) at the same time using the Media Utilities feature.

   Note: If you have assigned an image to more than one category and you only want to delete one instance of the image, then you will need to use the Remove function. DO NOT use the Delete function as it will delete the physical file from the server and remove all instances of the image.
    

4. Set Category Sort Order
   
   In order for the this feature to be active you will need to select the "Sort Order Value" option for the "Category Default Sort Field Name" in the Media Configuration.
   
   Stockbox displays categories in the gallery based on the “Sort Order” index value in ascending order. The lowest value will display in the first position and the highest value will display in the last position in the gallery. You do not have to use consecutive numbers (1,2,3,4...) if you want to leave room for additional categories. Therefore, you could add values such as (1,5,10,15...) if you perhaps want to later add a category between 1 and 5 in the display order.
   
   If you don't want the Virtual CD "categories" (Ent. version) to display in the category section of the gallery (only in the Virtual CD section), then you should input a sort order value of 0 (zero).
   
   To update the "Sort Order" index value, input a value into the target category's "Sort Order" field and click on the icon at the bottom of the screen.
   
    
5. Visible to Photogs (Ent. version)
   If you do not want the category to be visible in the Photographer's (Contributor's) Media Manager, then you should click on the "Yes" link. To make a category visible, you should click on the "No" link.
   
    
6. Add New Media
   Before selling your media online, you will need to upload the displayed images to the gallery folder and bring the related information into the database. The Stockbox system only stores the media path and all of its properties such as its category, description and other info to the database. It doesn’t convert the media to binary data and store this data in the database. In other words, all media files reside in the same physical location where you upload them or add them through the Stockbox system. With the Pro. and Ent. versions you can assign the same media file to more than one category without duplicating the physical instances of the media on your web server.

   Stockbox provides two methods for you to add new media to the system.

   1. Using an FTP (client) Program.
   2. Using the Stockbox Admin Control Panel.

   The most efficient way to upload a quantity of media is via FTP and then use the media Auto Detection function in the Media Manager section to add them to the database.
   

   6a. Using an FTP (client) Program
   This feature is similar to adding a new category using your FTP program. With this feature you can add an unlimited number of media to the Stockbox database at one time. Assuming that you have the FTP program installed on your local computer, you can follow the instructions below to upload new media to your gallery.
   

   • Use any FTP (client) program to connect to your server.
   • Browse to the directory where you installed the Stockbox software.
   • Browse to the "gallery" directory.
   • Browse to the directory (category) where you want to upload the images to, or create a new directory if required.
   • Browse to the local directory where you store your digital media.
   • Click Upload, to upload all selected media to the target directory (category).
   • Once the uploading is complete, login to the Stockbox Admin Control Panel and click on the Media Manager Auto Detection link in the main menu.
   • Click on the category that holds the images that you have just finished uploading.
   • Click on the icon to add the new images to the database.
   • Click on the icon to add all of the new images to the database (Pro. & Ent. versions).
     
     Note: If you upload an entire category of images (or you add images to a newly created directory) 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 and you're using the standard version, you will have to add the images with individual clicks.
     

   Uploading Images via FTP to the 'Upload' folder for use with the Import Hi-res function (Ent. version)

   This feature will automatically generate the download files, the display files and the thumbnail files from the high-resolution images that are uploaded to the "upload" folder. You must only upload hi-res images to this folder. Under the "upload" directory on your server, there may be some folders that are named as "admin" or the photographer's username. When a new photographer is added to the system, it will automatically create a new folder under the "upload" folder with the photographer's username. You can take advantage of this feature, by creating an FTP account for each photographer and grant the permission on their folder only. If you are not sure how to create FTP accounts, you will need to contact your hosting provider for assistance. In doing so, each photographer would be able to use their FTP account to upload their hi-res images to your server. Using an FTP client to upload hi-res images to the server is more efficient than doing so via your web browser. The admin user or photographer is able to import the hi-res images to the gallery as desired once their hi-res images have been upload to the server.
   

   
   Video and other formats of display media
   
   The workflow for uploading video content is basically the same as for images, except that the system is not able to generate a thumbnail image from the video clip file. Therefore If the media is video, audio or another format, you will need to create a thumbnail image offline for the media and upload it to the same directory where the media display file is located. The thumbnail file needs to be prefixed with the thumbnail prefix that is assigned to the system in the Media Configuration section.

   Example:
   Media system name: video1.mpg (this is a video type)
   The thumbnail prefix name: gallery_ (this can be set in the Media Configuration section)
   Then the thumbnail for this media should be gallery_video1.jpg
   Upload this thumbnail to the directory where the video1.mpg file is located.
    

   6b. Using the Stockbox Admin Control Panel to upload new media
   There are two methods of uploading images via the Admin Control Panel

   1. Single Image Upload
   2. Batch Upload Media (Pro. & Ent. versions)

   6b. i. Single Image Upload: The "Add New Media" icon will not be visible in the main gallery directory. You 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.

   • Login to the Stockbox admin control panel.
   • Click on the Media Manager Media Manager link in the main menu.
   • Create a new category if needed.
   • Browse to the category where you want to add the new media.
     
     
      
   • Click on the icon to add the new media.
   • Click the Browse button to browse to the image on your local machine.
   • Enter all information into the provided text fields or leave them blank if you're not ready at present (you can return later to edit).
   • Click Submit button to add the new media to the database. The new image is now uploaded and the information you entered is now stored in the database.
   • Continue to upload other images as required.
     
     
      
   • File Location (System Name)
     When uploading new media to the server you need to specify the location of the media file on your local machine. Click on the Browse button to locate your local media. Stockbox will upload your media to the current location that you are browsing. This location is the highlighted item in the category drop down list.
     Maximum Upload File Size x MB: Depending on your PHP configuration you may see a different notice for this. The x MB value is the maximum file size that you can upload to your server. This value can be increased by editing the "upload_max_filesize" value in your server's php.ini file. If you are on a shared server, you will need to ask your host to edit this value for you.
      
     
   • Reference ID (Pro. & Ent. versions)
     The Stockbox system will auto fill this field with a random number plus the prefixed value that is configured in the Media Configuration under the "Reference ID Prefix" option. You can update this field to any value as desired, but the system requires this value to be unique in the database.
     
     
   • Display Name
     Stockbox will display this name in place of the system name on the thumbnail and media detail pages.
      
   • Author
     Use this field to input the media's author. The system displays this info on the Media Detail page.
      
   • Copyright
     Use this field to input the media's copyright details. The system displays this info on the Media Detail page.
      
   • Keywords
     Use this field to add keywords for the target media. You will need to separate each keyword or keyword phrase by a “ ; ” semi-colon and avoid using punctuation. The system displays this info on the Media Detail page.
      
   • Description
     Use this field to add a description for the target media. The system displays this info on the Media Detail page.
      
   • Category
     Choose the category that you want add your media to. You can assign the same media file to multiple categories (Pro. & Ent. versions) by holding down the Ctrl key while clicking on the category name in the list. Note: If you have assigned an image to more than one category and you only want to delete one instance of the image, then you will need to browse to the image in the category that you want to remove it from and use the Remove function. DO NOT use the Delete function as it will delete the physical file from the server and remove all instances of the image.
      
   • Photographer (Ent. version)
     With the Ent. version you are able to select the photographer that is associated with the media. The photographer's username is taken from the photographer (contributors) registration section. When a photographer is assigned to the media, all sales will be applied to the specified photographer. The commission rate is calculated based on the commission rate that you set in the photographer's profile. The system will prefix the file name with the photographer's user name.
      
   • License Type (Ent. version)
     The media can be either “Royalty Free”, “Rights Managed”, “Rights Managed with no Calculator” or "Royalty Free & Rights Managed"
     When new media is uploaded it will be designated as "Royalty Free". For "Royalty Free" media, the available products (Product Types) will be displayed on the media detail page if a price has been assigned to the product type. For “Rights Managed’ media the system will use the Rights Managed Price Calculator created in the License Manager section of the Admin Control Panel. Therefore, you will need to configure the License Tree in order for the system to work correctly.
     
     
   • Media Type (Ent. version)
     This is an optional field that allows you to set the Media Type. By default there are two options available, Video and Image. You can also add additional Media Types by clicking on the icon. This feature is beneficial for users that want to search for a particular Media Type. If this option is enabled in the Advanced Search, then users are able to select which type of media they want to be returned in the search results. The system displays this info on the Media Detail page.
      
   • Release Status (Ent. version)
     With the Ent. version you are able to set the media release status. The three statuses available are, Model Release, Property Release and N/A. The system will display the status information in the gallery on the Media Detail page and the Media Preview window. The Release Status is also utilized on the advanced search page.
     
     
   • Black / White (Ent. version)
     This is an optional field that allows you to specify if an image is Black & White. If your image is Black & White, then you need to tick the box, otherwise leave it unchecked. This feature is beneficial for users that want to search for Black and White images only. If this option is enabled in the Advanced Search, then users are able to have only Black & White images returned in the search results. The system displays this info on the Media Detail page.
      
   • Orientation (Ent. version)
     The orientation option is used to describe (Horizontal, Vertical, Square or Panorama) the target media. This feature is beneficial for users that want to search for media that have a particular orientation. If this option is enabled in the Advanced Search, then users are able to select which type of media orientation they want to be returned in the search results. The system displays this info on the Media Detail page.
      
   • Google Map URL (Ent. version)
     Enter the Google Map URL address in this field, so that users are able to click on the link to view the location where the image was taken. The following link has information on how to create the Google Map URL,
     http://mapki.com/wiki/Google_Map_Parameters
      
   • Original File Path (Ent. version)
     This is the path to your original hi-res media file that is residing on the server. You can replace it with a new one by clicking on the Upload Original File icon. For printed product types, this image will be sent to the printing provider for print fulfillment.
      
   • Product Type
     Use this section to set prices (and credit costs Ent. version) for the available product types. If the product type is not available for this media then leave it blank and it will not display in the gallery. If you have configured the product types in the Product Manager section, then all available products will display here. The enable download links feature is not available when adding media.
     
     Note: The product type will only be available for the end-user to select on the Media Detail page 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.
     
     With the Ent. version you are able to set the credit cost for each media or to all media at once using the Product Manager section. The credit cost is only applied to the Subscription Product Type and Packages Product Type.
     
     When adding new media, the system will pre-fill the product type price and credit cost fields with a base price and credit cost respectively. You will need to click on the Submit button in order to set the product prices and credit costs for the target media.
      
   • Shipping Cost & Additional Shipping Cost
     This section is only used when you want to charge a shipping cost based on each individual media. The “Shipping Cost” is applied to the first quantity of the target media and the “Additional Shipping Cost” is applied to the second and subsequent quantities.
     
     Note: The shipping cost will NOT be applied to an “instant download” product type.
     
     Please see the “Single Item Shipping Method” to learn more on how to set the shipping cost and additional shipping for each media.
      

   6b. ii. Batch Upload Media: (Pro. & Ent. versions)
   Using this feature you can upload multiple display files, thumbnails. sample (comp) download files or high-res download files to your server in one operation. In order for this feature to function, your web browser must support flash files. All modern browsers should support flash files. If you don't see the flash file load when you click on the Upload Icon, you will need to install the flash add-on for your web browser.

   Once the "Flash Upload" file is loaded in your browser, you will see two "windows". One labeled "Local" and another with labeled "Server".
    
   Local
   This window will display the files on your local computer when you select them in the "Browse" window.
   
   Server
   This window will display the folders and files on your server where the Stockbox software is installed. You should only upload high-res files to the "Download Folder - Hi-res files" and "Hi-res Auto Resize" folder and your Display Images to the "Gallery Folder- Low-res Files" folder.  Please note that the "Hi-res Auto Resize" option in the server pane will not display if the ImageMagick© path set in the Media Configuration is not correct.
   

   • Login to the Stockbox Admin Control Panel.
   • Click on the Media Manager Media Manager link in the main menu.
   • Click on the Upload Icon.
     
     
     
     
     
   • Browse to the particular directory on your server by clicking on one of the "Download Folder - Hi-res Files", "Gallery Folder - Low-res files" or "Hi-res Auto Resize" (Ent. version) options.
   • When selecting the "Hi-res Auto Resize" folder (Ent. version) you must upload hi-res images to this folder only. This feature will automatically generate the download files, the display files and the thumbnail files from the uploaded hi-res images. This option is only available when you have ImageMagick© Installed on your server and you have input the correct path in the Media Configuration. Also, the system only supports JPG or JPEG file formats when using this feature. Once you have completed the upload of the hi-res files to this folder, you must use the Import Hi-res function to import these files into the gallery.
     
   • To browse back up one level, click on the ".." link displayed above the folder/file listings.
   • To browse back to the root level, click on the "." link displayed above the folder/file listings.
     
   •  Click the "Browse" button under the Local window.
     
     
     
      
   • To select more than one file, hold the Ctrl Key while selecting the additional files.
   • Click on the Open button to select the highlighted files.
   • Click on the Upload button to upload the selected files to the selected folder.
      
   • Gallery Upload Options:
     We recommend that run a batch process on your hi-res images to re-size them for display prior to uploading them to the gallery folder. You need to upload your display sized images to the gallery folder and the system will use these to generate the thumbnails. If you want to offer instant downloads, then you will need to upload the high resolution files to the download folder.
      
     • Display Files
       This option is only available when you upload files to the "Gallery" folder. If this option is selected, the system will automatically import (Auto Detect) the uploaded display images into the gallery database once the action is completed. Depending on the setting in the Media Configuration the system will also generate the thumbnail images for the media. The file names will be prefixed with the prefix assigned (gallery_ by default) in the Configuration Media section.
     • Sample Files
       This option is only available when you upload files to the "Gallery" folder. You should select this option when you're uploading sample files for the "Sample Download" feature. The system will prefix the uploaded files with the "sample_" prefix.
     • Thumbnail Files
       This option is only available when you upload files to the "Gallery" folder. You should select this option when you're uploading thumbnails for your display images. The file names will be prefixed with the prefix assigned (gallery_ by default) in the Configuration Media section.
        
   • Product Type Prefix:
     Once the download files have been uploaded you will need to assign the download files to display files using the Global Enable Download Links function. There is more information on this in the Media Manager Instant Download Links section of the main help menu.
      
     • Rights Managed
       This option is only available when you upload files to the "Download" folder. If you are uploading Rights Managed download files then you will need to select this option in the dropdown menu. The system will prefix the uploaded files with the "LICENSED_" prefix.
     • Other Product Types
       If you are uploading images for Royalty Free downloads then you should select the applicable Product Type in the dropdown menu and the system will prefix the uploaded files with the "Product Name" (not the Label) as specified in the Product Manager section of the Admin Control Panel.
        
   • Option:
      
     • Overwrite
       When this option is selected, the system will overwrite existing files in the selected category (directory) if they have the same filename as those being uploaded.
        
   • Cancel
     You are able to cancel the upload process at anytime after it has started by clicking on the Cancel button. The browser will continue to finish the current file upload before it stops.

     Note: This is not a FTP Client Application so it still relies on your server's PHP configuration. The maximum size for each file uploaded is restricted by the upload_max_filesize, post_max_size, max_execution_time and  memory_limit configuration settings in your php.ini file. The PHP default for the upload_max_filesize variable is 2 MB. If you have a dedicated server you can increase this limit by editing the php.ini file on your server. If you don't have a dedicated server, you will need to ask your hosting provider to do it for you. The server may timeout during the uploading of media to the server if your internet connection speed is too slow.
     
     
     

7. Import Hi-res Files  (Ent. version)
   This feature will automatically generate the download files, the display files and the thumbnail files from the high-resolution images that are uploaded to the "upload" folder. This option is only available when you have ImageMagick© Installed on your server and you have input the correct path in the Media Configuration. Also, the system only supports JPG or JPEG file formats when using this feature. The system will only generate the download files when the uploaded hi-res image satisfies the minimum dimension that are configured in the Product Type section. When there is no instant download configured for a particular product type, the system would recognize it as a print or delivery product and it would not generate the download files for these product types. Also, if you don't have any product types added when importing the hi-res images to the gallery, the system won't be able to generate the download files and you will need to manually generate the download files for the display images later if you want to offer them.
   
   Under the "upload" directory on your server, there may be some folders that are named as "admin" or the photographer's username. When a new photographer is added to the system, it will automatically create a new folder under the "upload" folder with the photographer's username. You can take advantage of this feature, by creating an FTP account for each photographer and grant the permission on their folder only. If you are not sure how to create FTP accounts, you will need to contact your hosting provider for assistance. In doing so, each photographer would be able to use their FTP account to upload their hi-res images to your server. Using an FTP client to upload hi-res images to the server is more efficient than doing so via your web browser. The admin user or photographer is able to import the hi-res images to the gallery as desired once their hi-res images have been upload to the server.
   
    
   • Click on the icon to import the hi-res Images to the gallery that were uploaded by the admin. To import the hi-res images for a particular photographer, you will need to click on the Import Icon for the particular photographer under the Photographers Active Photographers section.
   • The Dimensions below are the actual dimension of the uploaded images.
     
     
      
   • Click on the Import Icon for a particular file to import it to the database
     
     
      
     1. Fill-in all appropriate info to the provided fields.
     2. Enter 0 to any product type field that is not available for this image. The Dimension that shows in the Product Type section is the dimension that you have configured in the Product Type Instant Download Configuration. The system will auto calculate the other dimension based on the uploaded image's dimension and its orientation. The N/A in the PPI column indicates a print or delivery product and the system will not generate download files for these product types.
     3. Click on the Submit button to import this image into the gallery.
        
        NOTE: You must have ImageMagick© installed in order to use this function. Depending on your server configuration, this operation may take some time to process the download, display and thumbnail files.
        
        
        
   • To import multiple high-res files at once, tick the respective checkboxes and click on the "Import All" ion.
     
     
      
     1. Fill-in all appropriate info to the provided fields.
     2. When importing multiple hi-res images, you will need to select one of the three Product Type options.
        • All Product Types.
        • Only Instant Download Product Types
        • Only Non Instant Download Product Types.
     3. Click on the Submit button to import the selected hi-res images into the gallery.
        
        NOTE: You must have ImageMagick© installed in order to use this function. Depending on your server configuration, this operation may take some time to process the download, display and thumbnail files.
   
   
   
8. Edit Existing Media
   The Edit Existing Media feature is similar to adding new media to the system feature.
    
   • Browse to the target category in the Media Manager.
     
     
      
   • Click on the icon for the target media and edit the media properties as needed.
      
   • IPTC Tab (Pro. & Ent. versions)
     The IPTC feature allows you to add or edit the media's IPTC metadata header. Click on the IPTC Tab to view and edit the media's IPTC metadata info as required. The IPTC feature supports keyword phrase search strings. Please separate each keyword or keyword phrase by entering a " ; " semi-colon at the end of each keyword or phrase.
     
     Please note: Before using this feature, you must ensure that all image folders AND files have permissions of 777 (r/w/e) otherwise the IPTC changes will not be saved. To add the IPTC metadata for edited images to the searchable database, you will need to click on the Searchable IPTC icon for the target category in the Media Manager. Only the fields that are checked in the IPTC Configuration will be searchable.
      
   • File Location (System Name)
     It is not possible to edit the media system name once it has been added to the system.
      
   • Display Name
     Stockbox will display this name in place of the system name on the thumbnail and media detail pages.
      
   • Author
     Use this field to input the media's author. The system displays this info on the media details page.
      
   • Copyright
     Use this field to input the media's copyright details. The system displays this info on the media details page.
      
   • Keywords
     Use this field to add keywords for the target media. You will need to separate each keyword or keyword phrase by a “ ; ” semi-colon and avoid using punctuation. The system displays this info on the media details page.
      
   • Description
     Use this field to add a description for the target media. The system displays this info on the media details page.
      
   • Category
     Choose the category that you want add your media to. You can assign the same media file to multiple categories (Pro. & Ent. versions) by holding down the Ctrl key while clicking on the category name in the list. Note: If you have assigned an image to more than one category and you only want to delete one instance of the image, then you will need to use the Remove function. DO NOT use the Delete function as it will delete the physical file from the server and remove all instances of the image.
      
   • Photographer (Ent. version)
     With the Ent. version you are able to select the photographer that is associated with the media. The photographer's username is taken from the photographer (contributors) registration section. When a photographer is assigned to the media, all sales will be applied to the specified photographer. The commission rate is calculated based on the commission rate that you set in the photographer's profile. The system will prefix the file name with the photographer's user name.
      
   • License Type (Ent. version)
     The media can be either “Royalty Free”, “Rights Managed”, “Rights Managed with no Calculator” or "Royalty Free & Rights Managed"
     When new media is uploaded it will be designated as "Royalty Free". For "Royalty Free" media, the available products (Product Types) will be displayed on the media detail page if a price has been assigned to the product type. For “Rights Managed’ media the system will use the Rights Managed Price Calculator created in the License Manager section of the Admin Control Panel. Therefore, you will need to configure the License Tree in order for the system to work correctly.
     
     
   • Media Type (Ent. version)
     This is an optional field that allows you to set the Media Type. By default there are two options available, Video and Image. You can also add additional Media Types by clicking on the icon. This feature is beneficial for users that want to search for a particular Media Type. If this option is enabled in the Advanced Search, then users are able to select which type of media they want to be returned in the search results. The system displays this info on the Media Detail page.
      
   • Release Status (Ent. version)
     With the Ent. version you are able to set the media release status. The three statuses available are, Model Release, Property Release and N/A. The system will display the status information in the gallery on the Media Detail page and the Media Preview window. The Release Status is also utilized on the advanced search page.
      
   • Black / White (Ent. version)
     This is an optional field that allows you to specify if an image is Black & White. If your image is Black & White, then you need to tick the box, otherwise leave it unchecked. This feature is beneficial for users that want to search for Black and White images only. If this option is enabled in the Advanced Search, then users are able to have only Black & White images returned in the search results. The system displays this info on the Media Detail page.
      
   • Orientation (Ent. version)
     The orientation option is used to describe (Horizontal, Vertical, Square or Panorama) the target media. The system will automatically determine the orientation based on the dimensions of the display media when the display images are "Auto Detected", but this value can be changed using the dropdown menu options if desired. This feature is beneficial for users that want to search for media that have a particular orientation. If this option is enabled in the Advanced Search, then users are able to select which type of media orientation they want to be returned in the search results. The system displays this info on the Media Detail page.
      
   • Google Map URL (Ent. version)
     Enter the Google Map URL address in this field, so that users are able to click on the link to view the location where the image was taken. The following link has information on how to create the Google Map URL,
     http://mapki.com/wiki/Google_Map_Parameters
      
   • Original File Path (Ent. version)
     This is the path to your original hi-res media file that is residing on the server. You can replace it with a new one by clicking on the Upload Original File icon. For printed product types, this image will be sent to the printing provider for print fulfillment.
     
     
   • Product Type
     Use this section to set prices and credit costs (Ent. version) for the available product types. If you have correctly configured the product types in the Product Manager section, then all available products will display here. With the Ent. version you are able to set the credit cost for each media or to all media at once using the Product Manager section.

     Price: Enter the price for each product type that is available for this media. If the product type is not available for this media then leave the price field blank (or enter a value of 0.00) and it will not display in the gallery.
     
     Quantity: Enter the available quantity and the system will only allow the sale of products up to and including the quantity that you input here.
     
     Credit Cost: (Ent. version) The credit cost is only applied to the Subscription Product Type and Packages Product Type.
     
     
     
     
     
     To add a download link for a product type, click on the Enable Download Link checkbox for the target product type and a popup box will appear that will allow you to browse to the download file that you previously uploaded to the server.

     1. Click on the "Browse" button.
     2. Click on the target category to highlight it, followed by the "Browse" link (repeat to browse subcategories).
     3. Click on the target media file to highlight it, followed by the "Select" link to select the download file.
     4. Click on the "SAVE" button to assign the download link.

     To remove a download link for a product type, click on the Remove Download Link for the target product type.
     
     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.
      

   • Shipping Cost & Additional Shipping Cost
     This section is only used when you want to charge a shipping cost based on each individual media. The “Shipping Cost” is applied to the first quantity of the target media and the “Additional Shipping Cost” is applied to the second and subsequent quantities.
     
     Note: The shipping cost will NOT be applied to an “instant download” product type.
     
     Please see the “Single Item Shipping Method” to learn more on how to set the shipping cost and additional shipping for each media.
     
     
   • Click on the Submit button to save changes.
     
      
9. Remove or Delete Existing Media   
   Stockbox recommends that you should set the media status to hidden instead of removing or deleting it from the database when your gallery is live and users have already purchased this media. This will prevent missing data on the Sales Reports and other sections.
    
   1. Remove
      The remove feature will remove the target media from the database, but not the physical files from the web server.
   2. Delete
      The delete feature will delete the target media from the database and the physical files from the web server. Sometimes the system returns "Can't delete file from the server" message upon confirming the action. If this happens you will need to make sure that the file permissions for this media are set to 777 and try again.
       
   To remove or delete existing media
    
   • Click on the Media Manager Media Manager link in the main menu.
   • Browse to the target category.
   • Click on the icon to remove the target media from the database.
   • Click on the icon to delete the target media from the database and the physical files from the web server.
   • When performing either of these actions a confirmation dialog box will open. In order to complete the action, you will need to confirm the action by clicking on the icon in the dialog box.
     
     
     
10. Add Zoomify™ Files for Existing Media (Pro. & Ent. versions)
    Zoomify™ (www.zoomify.com) makes high-quality images zoom-and-pan for fast, interactive viewing on the web with just HTML, JPEGs, and Flash. Photoshop CS3 and later has a Zoomify™ export feature.
     
    • Click on the Media Manager Media Manager link in the main menu.
    • Click on the Zoomify™icon for the particular media.
      
      
      
      

      There are two ways to add the Zoomify™ files for a particular media.
       

      1. Zoomify™ Zip Package
         When using this option, you must zip all files under your Zoomify™ folder. This zip package must include the "html" file and the folder containing all Zoomify™ images.
         
         
         
         
         - Click on the Browse button to browse to the Zoomify™ zip file.
         - Click on the SUBMIT button to submit the Zoomify™ package. The Stockbox system will rename the html file to "index.html" and place this package in the "images/current-time-stamp-folder" on the server. If the package is correct you should see the URL in the Current Zoomify™ URL.
         
         
      2. Zoomify™ HTTP URL
         When using this option, you can enter the URL that links to your public Zoomify™ if you have one. The system will use this URL instead of the Zoomify™ Package.
    
    
    
11. Featured Media (Pro. & Ent. versions)
    The featured media are displayed in the Featured Media section in both the public and private galleries.
    
    To assign media to be featured, you will need to do the following.
     
    • Click on the Media Manager Media Manager link in the main menu.
    • Browse to the target category
    • Click on the NO link in the Featured Media column (the status will change to YES). The target media will now be Featured.
    • To remove media from the featured section, click on the YES link in the Featured Media column (the status will change to NO). The target media will no longer be featured.
    
    Stockbox replaces the [FEATUREDMEDIA] call tag with the featured media. The featured media tag can be added to the gallery.tpl template as desired.
    
    There are two ways to display featured media in the gallery. These can be defined in the Media Configuration section. Here you can change the style from horizontal to vertical and you can also specify how many images you whish to display. If there are more featured media than available spaces, the system will "rotate" (change) the media that are displayed each time the page refreshes.
    
    

    Horizontal Style	Vertical Style

     

12. Enable Download Links (Instant Download Links setup)
    Using Stockbox, you can offer instant downloads of your digital products and sell tangible products (such as prints) at the same time. Once the purchase has been confirmed by the payment processor the download link will be activated in the customer's "My Account area". There are two methods to assign download links
     
    1. Using the Global Enable Download Links function to assign links for an entire category of images.
    2. Assigning download links individually on the Media Properties page in the Media Manager section.

    When users assign a download link to target media, the system stores this download link path in the database and this info will not be changed unless the admin deletes a download link from this media. When you rename the target media using the Media Utilities (Ent. version) feature, the system will auto update the database with the new details and the download links will remain valid.
    
    a. The Global Enable Download Links function is used to assign the download links to the entire target category (directory) or multiple media (Pro. & Ent. versions). Before using this feature, you will need to ensure that the following items are configured correctly.

    • You will need to have created at least one Product Type in the Product Manager section.
    • The high resolution "download files" must be uploaded to the "download" directory via FTP or using the Batch Upload Media function, under the same directory structure (mirror) as the display images in the gallery directory AND you have prefixed the file name with the respective product type if you are uploading the images via FTP. If you use the Batch Upload Media function, then the system will apply the filename prefix for you. This download directory is protected by the Apache .htaccess. This directory is only accessible by the system and can not be accessed through a web browser.
    • Please note that when assigning download links for Rights Managed media (Ent. Version), you have to give the high resolution files a LICENSED_ prefix.

Enable Download Links for a Category

• Click on the icon to assign download links to the target category.

 

• Category
  Select the category from the drop down list. All of this category's media will be assigned a download link with the selected product by clicking on the Enable Download button.
• Enable Type
  Use the drop down list to select either Price, Credit or Rights-Managed (see below) for this download link.
• Product Type
  Select a product type from the drop down list. You will need to have created at least one Product Type in the Product Manager section to use this function.
• Price
  Enter the price of the product type.
• Credit
  Enter the credit cost for the product type.
• Disable File Extension
  Tick this checkbox and the system will ignore the difference between the display and download the file extensions. e.g. If you have .jpg display images and you have .tiff download files, then you will need to check this box.
• Use FTP Server  (Ent. version)
  Tick this checkbox if you are storing the download files on another server (Ent. version). You need to make sure that the FTP info of the target category (directory) is correctly configured. The system will not check for the FTP info during the setting of the Download Links to the target category.
• Including Subcategories
  Tick this checkbox and the system will apply the settings and download links to all media that are in subcategories of the target category.
• Click the Enable Download button to assign download links to the target category.
  

Enable Download Links for Selected Media (Pro. & Ent. versions)
To use this function you need to select media in the Media Manager section by ticking the checkbox in the second column of the Media Listing section.

• Enable Type
  Use the drop down list to select either Price, Credit or Rights Managed for the download link
  
• Product Type
  Select a product type from the drop down list. You will need to have created at least one Product Type in the Product Manager section to use this function.
  
• Price
  Enter the price of the product type.
• Credit
  Enter the credit cost for the product type.
  
• Disable File Extension
  Tick this checkbox and the system will ignore the difference between the display and download the file extensions. e.g. If you have .jpg display images and you have .tiff download files, then you will need to check this box.
• Use FTP Server  (Ent. version)
  Tick this checkbox if you are storing the download files on another server (Ent. version). You need to make sure that the FTP info of the target category (directory) is correctly configured. The system will not check for the FTP info during the setting of the Download Links to the target category.
• Including Subcategories
  Tick this checkbox and the system will apply the settings and download links to all media that are in subcategories of the target category.
  
• Click the Enable Download button to assign download links to the selected media.
   

Before using this feature, please make sure that all high resolution download files are residing in the download directory under the same directory structure (mirror) as the gallery folder and that you have prefixed the download files correctly.

Example of Royalty Free product type file name prefixes
e.g. Assuming you have the following:

pic1.jpg, pic2.jpg, pic3.jpg under the category1 with the path gallery/category1. So the paths of the pic1, pic2, pic3 are as follows:
gallery/category1/pic1.jpg
gallery/category1/pic2.jpg
gallery/category1/pic3.jpg

If you want to set the price for the product type named highdownload. Then the paths of the downloadable files should be as follows:
download/category1/highdownload_pic1.jpg
download/category1/highdownload_pic2.jpg
download/category1/highdownload_pic3.jpg

If you want to set the price for a second product type named lowdownload. Then the paths of the downloadable files should be as follows:
download/category1/lowdownload_pic1.jpg
download/category1/lowdownload_pic2.jpg
download/category1/lowdownload_pic3.jpg


Example of Rights-Managed file name prefixes
e.g. Assuming you have the following:

pic1.jpg, pic2.jpg, pic3.jpg under the category1 with the path gallery/category1. So the paths of the pic1, pic2, pic3 are as follows:
gallery/category1/pic1.jpg
gallery/category1/pic2.jpg
gallery/category1/pic3.jpg

For Rights Managed images the paths of the downloadable files should be as follows:
download/category1/LICENSED_pic1.jpg
download/category1/LICENSED_pic2.jpg
download/category1/LICENSED_pic3.jpg

Also please note that you can only assign one download file to media that have been designated as RM.
 

b. Assigning download links individually on the Media Properties page in the Media Manager.
 

• Browse to the target media in the Media Manager section.
• Click on the Edit icon.
  
  
   
• Check the "Enable Download Link" checkbox for the target product type and a popup box will appear that will allow you to browse to the download file that you previously uploaded to the server.
  
  
   
• Click on the "Browse" button to browse to the download file on the same server or click on the Use FTP Server if the download file is stored on a different server (Ent. version).
• Click on the target category to highlight it, followed by the "Browse" link (repeat to browse subcategories).
• Click on the target media file to highlight it, followed by the "Select" link to select the download file.
• Click on the "SAVE" button to assign the download link.
   

13. Pricing Selected Media
    By default any media that you upload to the system will be displayed for viewing by customers. However, the customers will not be able to add items to their shopping cart unless you apply a price to a product type for that media. There is more information on the various ways to price your media in the Pricing Media section of this help menu.
    

• Click on the Media Manager Media Manager link in the main menu.
• Click on the icon to assign the Global Pricing.
• To apply Global Pricing for multiple media, you will first need to select the particular media in the Media Manager by ticking the checkbox in the second column in the Media Listing section.
  
  
   
• Update Type
  Select the update type you want to apply from the dropdown list. The "Credit" Type is only available in the Ent. version.
• Price / Credit (Ent. version)
  Enter a price or credit cost that will be set to all media in the selected media for the specified product type.
• Product Type
  Select the product type that you wish to assign a price for.
• Click on the Update button to update the pricing/credit values.
  
  Remove Products/Pricing
  If you would like to remove a product type from display, you can enter a price of 0.00. This can be applied to a category or for the entire gallery by using the Global Pricing feature in the Product Manager section.
   

14. Approve Photographer's Media (Ent. version)
    When a photographer’s media is uploaded to your server its status depends on the photographer’s profile. If their “Enable File Upload Without Admin Approval” option is enabled then the uploaded media status will be “approved”, otherwise it will have a "pending" status. If the media is in a pending status, you will need to approve it before the system will display it in the gallery.  The same procedure applies to new photographer's categories as well.  The “Enable File Upload Without Admin Approval” option is changeable in the photographer’s profile.  When the media is in a pending status the photographer is still able to edit the media properties such as pricing, set shipping cost or assign a download link to it.
     
    • Click on the icon under the Media Manager features.
    • The list of the un-approved media will display.
    • Click on the icon to approve the selected media.
    • Click on the icon to view and edit the selected media details.
    • Click the "Approve All" link to approve all un-approved media.
      
      

    Note: The photographer that has been assigned to the media (username prefixed to file name) can be changed on the media properties page, by editing the media.
    
     

15. Un-Approve Selected Photographer's Media (Ent. version)
    To un-approve a photographer's media that was previously approved, you will need to do the following.
     
    • Select the media files that you want to Un-Approve.
    • Click on the Un-Approve Selected Media icon in the Media Manager feature menu.
    • The list of the previously Approved media you want to Un-Approve will display.
    • Click on the icon to Un-Approve the selected media.
      
      
      
       
16. Create New Order (Ent. version)
    With the Ent. version you are able to create a new order for your customers without going through the gallery. First you need to select the particular media in the Media Manager using the Multiple Media File Selection feature.
    
    
    • Click on the Create Order icon after selecting a group of media.
      
      
      
       
    • Tick the checkbox of desired Product Type or Add to Cart checkbox for rights managed media.
    • Click Submit to continue.
      
      
      
       
    • Select the Shipping Zone if it's available.
    • Select the Customer Username in the Username drop down list. The customer's info will be pre-populated in the billing fields based on the selected username. You could click on the Add New Customer icon to add a new customer to the system.
    • Fill in the Shipping Information. The system only displays this when it's a delivery order.
    • Click Submit button to continue.
      
      
      
       
    • Enter a Promotion Code if applicable and click on the icon to apply the code. The system will deduct the Promotion Value (if it's a valid Promotion Code) from the Grand Total.
    • Select the Order Status.
      Complete: the system will set this new order to completed status once it's submitted. If the order is an instant download type, then the user will be able to download the order once it has been created.
      Pending: the system will set this new order to pending status once it's submitted.
    • Click Submit
      The new order will be created in the system and the details can be viewed in the Order Manager section.
      
       
17. Apply IPTC metadata to the Gallery (Pro. & Ent. versions)
    The IPTC feature allows you to add media properties to it's metadata header. Stockbox can read, write, and display the IPTC metadata in the gallery. The media must be in the .jpg or .jpeg file format.
    
    There are two ways of writing the IPTC metadata to images.

    1. Using the Edit Media Properties feature (Apply to individual images)
    

    • Browse to the target category in the Media Manager.
      
      
       
    • Click on the Edit icon for the target media to edit the media properties.
    • Click on the IPTC Info icon to edit the embedded IPTC info.
      
      Note: Before using this feature, you must ensure that all image folders AND files have permissions of 777 (r/w/e). To add the IPTC metadata for edited images to the searchable database, you will need to click on the Searchable IPTC icon for the target category in the Media Manager. Only the fields that are checked in the IPTC Configuration will be searchable.
      
      
      
    2. Using the Global Apply IPTC feature  (Apply to all images in a category)
     
    • Click on the Apply IPTC icon for the target category.
    • Select the target Category in the drop down list.
    • Fill in all relevant information to the provided input fields. The IPTC feature supports keyword phrase search strings. Please separate each keyword or keyword phrase by entering a " ; " semi-colon at the end of each keyword or keyword phrase.
    • Click the Submit button to apply the new IPTC metadata to the media in the target category.
      
      
      
      
      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 the selected category of images and the original info can NOT be recovered. All IPTC metadata added using the Global Apply IPTC feature will be available for searching. However, it is recommended that you should click on the icon for the target category after each use of the Global Apply IPTC feature. Only the fields that are checked in the IPTC Configuration will be searchable.
      
       
18. Searchable IPTC Data (Pro. & Ent. versions)
    All IPTC metadata is automatically imported into the database upon uploading new media to the server or using the Global Apply IPTC feature. However, to ensure that all the IPTC metadata is searchable by users, Stockbox recommends that you should use this feature after you make changes to the IPTC metadata.
     
    • Browse to the target category.
    • Click on the Rebuild Searchable IPTC icon for the target category.
    • All IPTC metadata will be searchable by all users.
      
      Note: Only the fields that are checked in the IPTC Configuration will be searchable. If you make any changes to the IPTC configuration after you import your images to the database, you need to use the Rebuild Searchable IPTC  function again for it to update the new searchable contents.
      
       
19. Protect & Un-protect Category (Private Galleries) - (Pro. & Ent. versions)
    By default all new categories will have "Public" status. The Protect feature allows you 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 in the Media Manager. If the category is un-protected (default), then the status will display as Public.
     
    1. Protecting a category
       Browse to the target category.
       Click on the Protect icon to protect the target category.
       
       The system will prompt you for confirmation before protecting it. You will need to confirm the action by clicking on the icon on the confirmation page.
        
    2. Un-protecting a category
       The Un-protect feature is only visible when a category status is "Private" (protected). When you un-protect a protected category, all of its media will be un-protected as well and will become viewable to all users. By default this will not include it's sub-categories and media that are in the sub-categories. If you need to unprotect all contents of the target category including any sub-categories; you will need to check the “Including Sub-categories” checkbox on the confirmation page.
       
       
       
20. Access Users (Pro. & Ent. versions)
    The Access User icon is only visible when a category’s status is "Private" (protected). Click on this icon to add a new "Access User" to the target category. Once new access users are added to the system, they are able to login to the private gallery to view protected categories that are associated with username/password combination input into the Private Gallery Access User Manager.
    
    The system provides two options to add access user(s) to the protected category.
     
    • Registered User Access
      The system allows you to add existing registered customers to the protected category. Once it's added to the system, users need to login with the username/password that they created when they registered to your site. The advantage of this option is that the system doesn't require a second login for purchasing media.
       
    • Non-Registered User Access
      This option requires that you create a username/password combination for the user. After logging into the protected category, access user(s) are able to browse the contents of the protected category, but in order to make a purchase they will need to register to system. The advantage of using this option is that you can create a username/password combination to give out to your clients at an event, or have multiple users login to view media using the same user/pass.

    Click the Submit button to add the new access user to the database.

    To remove an access user, click on the icon for the user that you wish to remove.

    To access a protected category (Private Gallery) click on the Private Gallery link in the right top corner of the admin control panel, or from the Private Gallery Login link in the public gallery.

    Note: You can assign the same username/password combination to more than one protected category, so that a user can view more than one protected category. Also, you can add as many access users to a target category as required.
    
    
    

21. FTP Server Configuration for a Category (Ent. version)
    If you are storing the high resolution download files on another server (separate from the Stockbox installation), you can use this function to setup the FTP information of the other server. Each category has its own FTP server information, so you can have different categories of images residing on different servers. The system does not check for valid download files on the remote server. It assumes that you have correctly configured the download files on the remote server.
     
    • Click on the FTP Server Configuration icon to setup the FTP information.
    • Enter all information into the provided input fields.
    • Click on the Get button to set the path to the downloadable directory on the other server. This directory should contain all the downloaded files of the selected category. If the information is entered correctly you will see a popup window that will allow you to select the remote path.
    • Including Subcategories: Ticking this checkbox will allow the system to update the Remote FTP Server Configuration to all of the target category's subcategories.
    • Click the Submit button to submit the info to the server.
      
      
      
       
22. Category Auto Price and Credit Configuration (Pro. & Ent. versions)
    Use this configuration to disable the automatic pricing function set in the Product Manager Product Types section or enable the automatic pricing function for particular Product Type to selected categories.
     
    • Click on the icon to configure the auto price feature for the target category.
      
      
      
       
    • System Path
      This is the path of the target category.
    • Display Name
      The display name is a display of the selected category.
    • Disable Automatic Pricing on this Category
      To disable the "Auto Price" on the target category tick this box.
    • Including Sub-categories
      To apply the same setting to the subcategories of the target category, tick this box. The settings will be applied once the action is completed by clicking on the Apply icon.
    • Product Type
      Tick the Product Types that you want to "Auto Price" in the target category. The system will auto price the configured base price and base credit for all future media that are uploaded to the target category.
    • Click on the icon to apply the action, or click on the icon to cancel the action.
    
     
23. Global Update of Media Details
    The Global Update icon will not be visible in the main gallery directory. You must browse to a category to use it. The global update feature allows you to update the media properties for media in an entire category (including sub-categories if selected) or selected media. With this feature, you will be able to update the following media data fields:
     
    1. Display Name
    2. Description
    3. Author
    4. Photographer Username
    5. Copyright
    6. Keywords
    7. # Hits
    8. Rights Managed
    9. Rights Managed with no Calculator
    10. Royalty Free
    11. Rights Managed & Royalty Free
    12. Media Release
    13. Media Orientation
    14. Black & White
    15. Media Type
         
    Only use this feature if you want to add the same common information to every image in a category or selected media such as Author, Copyright and Rights Managed or Royalty Free etc.
     
    • Click on the Media Manager Media Manager link in the main menu.
    • Browse to the target Category or select particular media in the Media Manager.
    • Click on the icon under the media manager title.
      
      
       
    • Select "Global Update Type" in the drop down list. This dropdown will only display if you are updating selected media. To update a category of media, choose the "Update Selected Category" option, or to update a group of selected media, choose the "Updated Selected Media" option.
    • Select the desired field in the Field Name dropdown list.
    • Check the Including Subcategories checkbox, if you want to update all subcategories of the target Category. This option is only applied when you choose "Update Selected Category" in the "Global Update Type" dropdown list.
    • Check the Over Write Old Data box, to overwrite any existing data, otherwise leave this box un-checked and the new data will be appended to the existing data.
    • Enter the Global Value that you want to set such as Keywords, Description etc.
      - For Rights Managed and Royalty Free values are pre-defined, so you can't change this value
      - For Media Release values, you can input one of the following as required. 1 = Property Release, 2 = Model Release or 3 = All Release
      - For Media Orientation values, you can input one of the following. H = Horizontal, V = Vertical, S = Square, P = Panorama or N = N/A
      - For Black & White, you can input one of the following. 1 = Black & White or 0 = No Black & White
      - For Media Type, you can enter one of the following. 1 = Image or 2 = Video
    • Click the Submit button to update the data.
      
       
24. Category & Media Status
    Stockbox recommends that you should set the category or media's status to hidden instead of removing or deleting it from the database. This will prevent missing data on sections such as the Sales Reports.
     
    • To change the media status click on the icon for the target media.
    • To change the category status click on the icon for the target category.
      
      
       
    • Select the Category Status in the drop down list and click the Submit button to change its status.
      
       
25. Quick Search Media (Pro. & Ent. versions)
    To quickly view target media details, input the search phrase in the Media Search field and select the database field in the next dropdown list and then click the Submit button. The system will list all the media that match the search phrase.
    
    
    
26. Global FTP Download Server Configuration (Ent. version)
    You should use this feature only when you have all download links on the same remote server. You should not use this function when the download files are residing on the same server where the Stockbox system is installed.
    
    
    • Click on the Media Manager Media Manager  in the Navigation Menu.
    • Click on the Global FTP Server Configuration icon in the Media Manager.
      
      
      
       
    • Host Name:
      Enter the host name of the remote FTP server. It can be the IP Address or domain name.
    • Username:
      Enter the username of the remote FTP server.
    • Password:
      Enter the password of the remote FTP server.
    • Tick the SSL FTP Connection checkbox when your server requires an SSL connection.
    • Port #:
      Enter the port of remote FTP server. Most servers are using port 21 or 991 for an SSL connection.
    • Remote Home Directory:
      Click on the GET button to connect to the remote server and browse to the directory where the download files reside, then click SELECT.
    • Auto Assign to New Category:
      If this checkbox is checked, the system will auto update the Remote FTP server info to a new category when it's added to the system.
    
    Note: The system will not check whether the high-res files exist on the remote ftp server. The download files must be named using the same naming convention as the download files would be if you were using the Global Enable Download Links feature.
    
    
    
27. Multiple Media File Selection (Pro. & Ent. versions)
    The Multiple Media File Selection feature allows you to select a group of media for Global Update, Delete, Enable Download Links, Create New Order (Ent. version).
    
    
    • Click on the Media Manager Media Manager in the Navigation Menu.
    • Click on a particular category.
      
      
       
    • Tick the checkbox for the target media.
    • When you have a group of media that you want, you can click on any global Icon in the Media Manager Functions menu.
      
    
     
28. Auto Detection
    The Auto Detection function is used to detect new categories and media that are residing in the gallery directory on your server, but have not yet been added to the database. Using this function you can add an entire category of media and its contents to the database at one time.
    
    To Add a new category of media to the database
     
    • Click on the Media Manager Auto Detection link in the main menu.
    • Browse to the category that holds the newly uploaded category or media.
    • Click on the Add to Database icon to add the new category or media to the database. If you auto detect a category, Stockbox will add all of the media contents in this category to the database.
      
      
       

    To Add new media to the database
     

    • Browse to the category that holds the newly uploaded media.
    • Click on the icon to add the new media to the database.
    • If you are adding media to an existing category (already auto detected) then you will need to add the files individually.
    • If you have many individual files to add, you can click on the icon (Pro. & Ent. versions), to add all new media to the database at once.
      
      
      
       
29. Generate Thumbnails
    The thumbnail images can be generated automatically by checking the Auto Generate Thumbnail on New Media feature in the Media Configuration. By using this feature, the thumbnail images will automatically be generated from the uploaded display files (according to the reduction value specified) when new media are brought into the system using the Auto Detection feature. Otherwise they can be generated (or re-generated) using the method outlined below. Before using this feature, you must ensure that all image folders and files have permissions of 777 (r/w/e).

    If you want to use the system's "Generate Thumbnails" feature, you should convert all display images to jpg format (or .gif or .png if your server's GD version supports them) before uploading them to the server. Alternatively, you can upload 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.

    • Click on the Media Manager Generate Thumbnails link in the main menu.
    • Click on the icon for the target category to generate thumbnails. The thumbnails for the entire category of images will be created from the display images based on the reduction value set in the Media Configuration section.
    • Click on the icon to confirm and compete the action, or click on the icon to cancel the action.
    • After this action completes, the status for the target category will change from Not Generated to Generated.

    Note: If there are a large number of images in the directory, the execution may timeout before the operation completes, this is not a fault in the system. Just click on your browser's 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 the success message, check to see if the thumbnail overwrite box in the Media Configuration section is checked. If it is, un-check the box and click on the generate thumbnails link again.
     

    Video and other formats of display media

    If the media is video, audio or another format of display image, you will need to 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: video1.mpg (this is a video type).
    The thumbnail prefix name: gallery_ (this can be set in the Media Configuration section).
    Then the thumbnail for this media should be gallery_video1.jpg
    Upload this thumbnail to the directory where the video1.mpg is located.
     

30. Watermark Images
    The system can either apply a Text or Image watermark to the display images. The type of watermark that will be applied will be determined by the setting in the Media Configuration section. Before using this feature, you must ensure that all image folders AND files have permissions of 777 (r/w/e).
     
    • Click on the Media Manager Watermark Images link in the main menu.
    • Click on the icon for the target category to add watermarks.
    • Click on the Apply icon to add watermarks to images in the category that have not had a watermark previously applied.
    • Click on the Overwrite icon to use the watermark overwrite option that will apply a watermark to ALL images. If an image was previously watermarked it will be re-watermarked. This re-application will darken (make it less transparent) the appearance of the watermark.
    • Click on the Cancel icon to cancel the action.
    • After this action completes the status for the target category will change from Not Generated to Generated.

    Note: This feature applies a physical watermark on the display images. Images can't be recovered to their original un-watermarked state after they have been watermarked. So please make sure that you backup all display images locally before doing so. To view a demo of how the image will look after it has been watermarked, click on the icon in the Media Configuration section.
    
     

31. Rebuild Database
    This feature allows you to remove any invalid (old) entries from the database. Invalid entries will occur when moving files from one directory to another or deleting files from the system via your FTP client. To avoid invalid entries you should run this feature on a regular basis.

    To confirm the action click on the Rebuild icon.
    To cancel the action click on the Cancel icon.

    
     

32. Resize Images
    The most efficient method to resize your display images is to run a batch process on your high resolution original images prior to upload. This saves server resources and considerably saves file transfer times and bandwidth.

    The system will resize the longest dimension of the images to the size entered in the Media Configuration. The system will maintain the aspect ratio of the images during the resize process. Only images which have a larger size compared to the resize value will be resized. Before using this feature, you must ensure that all image folders AND files have permissions of 777 (r/w/e).

    This feature is not recommended for a large category of images or for very large files, as it can cause the server to timeout before the operation completes. If a blank page is displayed, please continue by refreshing the screen until the message "Action Performed Successfully" is shown. This indicates that the resize image process is complete.

    • Click on the Media Manager Resize Images link in the main menu.
    • Click on the Resize icon for the target category to resize that category of images.
    • Click on the icon to confirm and complete the action, or click on the Cancel icon to cancel the action.
    • The system will resize the images in the category based on the setting in the Media Configuration section.

    Note: Images can't be recovered to their original size after resizing. So please make sure that you backup all images locally before doing so.
     

33. IPTC Configuration (Pro. & Ent. versions)
    This feature allows you to control how the IPTC metadata information is displayed and utilized by the system. If your display images have IPTC metadata embedded, the Stockbox system will import and utilize this data for display and search purposes. The system can also be used to add IPTC metadata to your display images.
     
    • Click on the Media Manager IPTC Configuration in the main menu.
    • Displayed Status: Check the boxes for the desired metadata field(s) to make them display in the gallery.
    • Linkable: Check the boxes for the desired metadata field(s) to make them linkable in the gallery. This will create hyperlinks, that when clicked will return results for similar words or phrases.
    • Phrase: Check the boxes for the desired metadata field(s) to have the system search by phrase. When searching by phrase is enabled, you will need to ensure that your keywords and keyword phrases are separated with semi-colons.
    • Searchable: Check the boxes for the desired metadata field(s) to make them searchable.
    • Toggle All: To toggle all checkboxes for the selected column check this box.
       

    
    
     

34. IPTC Mapping Configuration (Pro. & Ent. versions)
    This feature allows you to have the Stockbox system automatically import the IPTC metadata to the specified Media Properties fields when new media is imported into the system.
    
    To launch the IPTC Mapping, click on the IPTC Mapping link in the IPTC Configuration section.
    
    
     
    • Select the IPTC field in the drop down menu for the corresponding Media Properties field name.
    • Click on the SUBMIT button to save the changes.
    
    
    Note: The system only maps the data once when the image is imported into the gallery. It won't update new data for existing image properties if you select a new setting in the dropdown menu. To update existing images with the new setting, you must either remove them from the database and then re-import them, or you can click on the Searchable IPTC icons for the respective categories in the Media Manager.
    
    
    
35. Media Type Manager
    You can create as many media types in the system as you wish. By default there are two media types available when you install the system, Video and Image. The system allows you to add the file type extension that will be associated with the target Media Type. When the system imports new media into the system, it will automatically set the Media Type for the media based on the file extension of the uploaded media.
    
    To launch the Media Type Manager, click on the Media Manager Media Type Manager link in the main menu.
    
    
    
    
    • To Add a new Media Type, enter the Type Label and associated File Extension(s) and click on the SUBMIT button.
    • To Edit a particular media type, click on the Edit icon
    • To Delete a particular media type, click on the Delete icon
    
    
    
36. Media File Types
    The system can display any files that are viewable in a web browser. If the file format is not viewable from within a web browser, the system provides a link for customers to download the file. The file can then be viewed locally in the associated application. In the same way, other file formats that will open in a web browser can be added to the system by inputting the opening code into the media file types section of the admin area. Current default file types are: gif, jpg, au, avi, aif, htm, html, mid, mp3, mp4, mpg, mov, png, ra, ram, rar, swf, wav, zip, wma, wmv, flv and pdf.

    The media file types feature allows you to add new media file types, edit or delete existing media file types. The media file type code will be used to open the media when it's displayed on the media detail page. If you need to add a new media file type that is not in the list, you can add it to the database using the add feature by clicking on the icon.

    • To Add a new file type
      Click on the icon to add a new media file type.
      
      Extension: this is the file's extension. It should not contain a dot.
      e.g. for media .mp3 the entered characters should be mp3
      
      Player Type: Only use this field when you have more than a player for the same file type.
      e.g. for the video file type, you could add a QuickTime Player and a Windows Player for users to switch from one to the other. You will need to add the opening code for each type.
      
      Label: Only use this field when you have more than a player for the same file type. The system will only show this on the Media Detail page for users to switch to another media player when it detects that there is more than one player for the selected media.
      
      Opening Code: Enter the code that will be used to open the media. The code should not contain any actual file paths (see the following example).
      
      <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>
      
      The system will replace the [FILENAME] tag with a real system file name. So when adding a new opening code, simply replace the actual file path with the [FILENAME] tag. If you are not sure about this code, please see other sample codes that are already available in the system.
      
      You can add the image's media properties or the IPTC metadata to the image's alt tag by enabling the "Media Alt Tag" option in the Media Configuration section. You will also need to make sure that you have the alt="[ALT]" tag entered into the Opening Code for the jpg and gif file types.
       
    • To Edit a file type
      Click on the Edit icon for the target media file type.
      Edit the opening code as required.
      Click the Submit button to save the changes.
       
    • To Delete a file type
      Click on the Delete icon for the target media file type.
      You will need to confirm the delete action by clicking on the icon on the confirmation page. Stockbox recommends that you do not delete any media file types, as they may be needed sometime in the future.
      
       
37. Media Utilities (Ent. version)
    The Media Utilities feature gives you the ability to edit your media from within the gallery admin area. This feature is available for the Ent. Version only and you need to ensure that ImageMagick® is installed on your server. Please visit the ImageMagick® website to download a copy of their software to install on your server. If you do not have root access to your server, you will need to ask your host install this for you.
     
    • Click on the Media Manager Media Utilities link in the main menu.
    • Click on the Detach icon to use the Media Utilities feature in a separate window.

    EDITING YOUR CATEGORY
    
    The folder icon symbolizes the media category.

    1. Click on the Resize icon for the target category to Resize all media inside this category.
        
       • At the RESIZE CONFIRMATION section: Enter your pixels dimension in the Resize To field. The system will resize the longest dimension to the specified value. The system will maintain the aspect ratio of the images during the resize process. Only images which have a larger size compared to the resize value will be resized.
       • Click on the icon to Cancel.
       • Click on the icon to complete the action.
          
    2. Click on the Rename icon for the target category to Rename this category.
       
    3. Click on the Delete icon for the target category to Delete this category.
       
    4. Click on the Move icon for the target category to Move this category to a different location. If you have assigned download links to media that you move, the links will remain valid unless you remove the download files from the original download folder location. If you prefer, you can move the download files in the download folder via FTP to match the new location of the display files and re-assign the download links using the Global Enable Download Links function.

    Note: To Resize, Delete or Move multiple categories, please check all of the target category checkboxes in the column, then click on the , or icons at the top of the MEDIA UTILITIES section to Resize, Delete or Move multiple categories.

    EDITING YOUR MEDIA

    1. Click on the Resize icon for the target media to Resize this media.
       
    2. Click on the Rename icon for the target media to Rename this media.
       
    3. Click on the Delete icon for the target media to Delete this media.
       
    4. Click on the Move icon for the target media to Move this media to a different location. f you have assigned download links to media that you move, the links will remain valid unless you remove the download files from the original download folder location. If you prefer, you can move the download files in the download folder via FTP to match the new location of the display files and re-assign the download links using the Global Enable Download Links function.

    Note: To Resize, Delete or Move multiple media, please check all of the target media checkboxes in the column, then click on the , or icons at the top of the MEDIA UTILITIES section to Resize, Delete or Move multiple media.

    USING ADVANCED MEDIA UTILITIES
    
    If your media extension is an image type, you can use our Advanced Utilities feature with powerful tools to edit your images.
    
    By clicking on the icon, you can choose the effect that you want to apply to the image.

    1. At the message Do you want to convert all media under this category? Click the Yes/No Action button. If you click Yes, then you will have the following options.
        
       1. Check the Do you want to convert all media under this category's subcategories? Check this box, if you want to apply your customized effect to all of the media in the current category and it's subcategories.
       2. Check the Do you want to continue converting your remaining media in this category? Check this box, if you want to continue applying this effect to the remaining media that did not have the effect applied previously, due to an issue while applying the effect during the last action.
       3. Click on the icon to Cancel or click on the icon to Convert

       After customizing the image with your desired effect(s) you can do one of the following:
       

    2. Click on the icon to "Save" your converted media.
        
    3. Click on the icon to "Save As" your converted media.
        
       1. Enter the new file name in the File Name field
       2. Choose the image type to save as in the Save as type dropdown list.
       3. Click on the Save button to save your new image. Click on the Cancel button to cancel.

       Note: If you use the "Save As" feature, then you will need to use the auto detection feature to bring the newly saved image into the database.
       
        

38. POP3 Media (Ent. version)
    Stockbox has a convenient way to add media to your database, it is called the POP 3 Media Manager feature. You or your photographers can just send an email with the media attached to an email account that is setup in the POP3 Media Manager section. Then you can use this feature to check the mailbox, download the attached media and add them to the gallery categories.

    This feature also allows you or your contributors to upload images to the gallery directly from their mobile phone (if they have a camera feature on their phone). After capturing their photo they can simply send the camera phone image to the email address that you have setup in the POP3 Media Manager.

    In the Account Information section:

    1. Hostname: Enter your POP3 Mail Server URL
    2. Username: Enter your POP3 Email Username
    3. Password: Enter your POP3 Email Password
    4. Mailbox Name: Enter your mailbox name, Stockbox will download all messages from this mailbox.
    5. Port #: Enter your POP3 server port number.
        
    Click on the Save icon to save the new settings.
    
    Click on the Download Mail icon to connect and download email messages from your POP3 Mail Server.
    
    POP3 MAIL MANAGER
    
    If you connect to your POP3 Mail Server successfully, all unread messages will be downloaded automatically. Messages that contain attached media will be listed.
    
    Click on the desired Media Name to preview your Media.
    
    Click on the desired Photographer to edit the photographer's profile. The photographer needs to prefix their file name with their user name (e.g. photog_image1.jpg) for the system to recognize that the image belongs to a particular photographer (contributor).
    
    Choose the category that you want to add new media to in the Category column, then click on the icon to add your media to the database.
    
    If you want to add more information to the new media before adding it to the database, click on the icon.
    
    If you want to delete the new media instead of adding it to the database, click on the icon.
    
     
39. Send to Friend Logs
    The Send to Friend Logs feature allows you to manage the user's send to friend email information.
     
    • You can view where the email was being sent to and other related information by clicking on the icon.
    • You can delete specific send to friend logs by clicking on the  icon for that log.
    • Click on the icon to delete all SEND TO FRIEND LOGS.
      
       
40. FTP Syndication (Ent. version)
    With the Ent. version you are able to upload selected media download files to a remote FTP server. This feature is an easy and efficient way for to supply your customers with images.
    
    First you need to select the particular media in the Media Manager using the Multiple Media File Selection feature. The system only allows you to upload selected media to the remote FTP server when the selected media has download links assigned to it. So you must assign the download links to the particular media before using this function.
    
    
    
    
    • Tick the Product Type for the particular media to upload.
    • Select the customer's username in the "Customer" drop down menu. When "Other" is selected, you will have to fill-in the Remote FTP details in the following screen prior to the upload.
    • Click on the CONTINUE button to continue the upload process.
       

    
    
    

    • FTP Info (Host Name, Password, etc.)
      The system will ask you for the FTP info if it doesn't see any FTP details configured for selected user.

    • Create New Directory on Remote Home Directory with the name
      You can instruct the system to create a new directory on the Remote FTP Server's home directory by entering the name in this field. The system will create the new directory with the entered name before uploading the download files to it.

    • Actions before uploading
      
      
      1. Zip all media with the name below
         Select this option when you want the Stockbox system to zip all download files into a Zip file named according to the name entered into the Zip Name field. This option is good when you want all files to be in a single package. However, this option will take a little more time for the system to zip all of the files before uploading the zip file to the server.
      2. Upload All Media as is
         Select this option when you want the Stockbox system to just upload all media as they are currently named. The system will upload all download files to the Remote FTP Server under the selected home directory.
          
    • Create New Order after upload is completed
      Tick this checkbox when you want system to create new order based on the selected media with the selected product type. The new order will be created once all files have been uploaded to the Remote FTP Server.
    • Click on the Upload button to start the upload process.
      
       
41. Media Export (Ent. version)

    Image Sitemap Export
    The Sitemap Export feature (in addition to the Stockbox SEO feature) is designed to improve the ability for the search engines to index your site content. You can find more information on sitemaps via the following sites.
    
    http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=178636
    http://www.sitemaps.org
    
    

    • Click on the Media Export icon in the Media Manager menu icons to launch the Media Export page
      
      
       
    • Language
      The system will list all current active languages that are in the system in the language drop down list. You can either select one language or have the system export the data for all languages. The language selection only applies to the media properties fields and not the IPTC metadata.
    • Image Caption
      Select the desired field for the Image Caption.
    • Image Geographic Location
      Select the desired field for the Image Geographic Location.
    • Image Title
      Select the desired field for Image Title.
    • Click on the EXPORT button to export all media based on the mapping field selections.


Stockbox exports all media from the database in the .xml format. The following describes how the Sitemap is generated.


• <loc>http://example.com/sample.html</loc>
  Stockbox system uses the category's URL for this tag
• <lastmod>yyyy-mm-dd</lastmod>
  Stockbox uses the category's last modified date for this tag
• <changefreq>monthly</changefreq>
  Stockbox uses the monthly setting for this tag. You could use other value for this tag, always, hourly, daily, weekly, yearly, never. Use this value for archived URLs.
  This value can be changed in the tpl/english/export/admin_sitemap_xml.tpl template.
• <priority>0.8</priority>
  Stockbox uses the 0.8 setting as the default value for this tag.
  This value can be changed in the tpl/english/export/admin_sitemap_xml.tpl template.
• <image:image>
  Stockbox lists all media for the category above.
  
  • <image:loc>
    Stockbox uses the URL path to the media thumbnail.
  • <image:caption>
    Stockbox uses the mapping field above.
  • <image:geo_location>
    Stockbox uses the mapping field above.
  • <image:title>
    Stockbox uses the mapping field above.
  • <image:license>
    Stockbox will not include this tag in the Sitemap file. If you would like to enable this tag, please open the file
    tpl/english/export/admin_sitemap_image.tpl and add your own value to it. When you're finished editing, upload it back to where it was downloaded from.



Depending on your database size, it may take a little while for the system to export all media in the database. Your web browser will ask you to save the export file to your local computer and by default the file name is called sitemap.xml (you shouldn't alter this name). Once you have it saved to your local computer, you can either submit the sitemap to the search engine(s), or upload the sitemap.xml file to www root directory on your server. The search engines will automatically detect this file when they crawl your site.




43. Media Statistics (Ent. version)
    The Media Statistics feature provides you with traffic statistics for your gallery. In order for the system to log user's activities, you must enable the "Enable Media Stats Logs" option in the  Media Configuration.
    
    
    
    
    1. To View more traffic details for a particular media ID, click on the icon.
    2. To have the system ignore a particular IP Address, click on the icon. Once the IP Address is added to the Ignore List, the system will not log data when the user from this IP is browsing your gallery. You may want to enter the IPs for the search engines so that their activity is not logged by the system.
    3. To Delete a particular log, click on the icon.
    4. To Empty ALL media statistics, click on the icon.
       
    
    Category Stats Report
    Similar to the Media Statistics, the Category Stats Report shows the logs for all user's category history. In order for the system to log user's activities, you must enable the "Enable Media Stats Logs" option in the  Media Configuration.
    
    
    
    
    1. To View more traffic details for a particular category ID, click on the icon.
    2. To have the system ignore a particular IP Address, click on the icon. Once the IP Address is added to the Ignore List, the system will not log data when the user from this IP is browsing your gallery. You may want to enter the IPs for the search engines so that their activity is not logged by the system.
    3. To Delete a particular log, click on the icon.
    4. To Empty ALL category statistics, click on the icon.
       
    
    
    Ignore IP
    Use this function to instruct the system to ignore (by-pass) any user that is using a particular IP Address to access your site. The system will not log any activities when it sees the IP Address is in this list.
    
    
    
    Important: If you have a high traffic site, the database may use up all of the available server space. To avoid this potential issue, you can set the Maximum Number of Logs per User in the General Configuration. The system will delete old entries for the user when it reaches the maximum number allowed, before inserting the new entries.
    
    
45. Media Configuration
    This section allows you to configure the gallery thumbnails, watermarks, etc., etc...
    
     

1. Manage Customer's Orders.
   • Completed Orders
   • Pending Orders
2. View, Print & Send Customer's Invoices.
3. View, Print & Export Sales Reports.
4. Download, FTP Syndication Instant Download orders
5. Complete Printing Fulfillment for Printed Orders

• Completed orders, are orders that have been paid for via one of the integrated payment gateways.
• Pending orders, are orders that have not yet been paid for, or have been canceled by the admin. It is possible that the order was paid for by the customer, but the system did not receive confirmation of the payment from the payment gateway due to a technical issue. In this situation, the order will remain in Pending status until it is manually completed by the gallery admin.
• The displayed sort order of the Customer Orders or related information can be changed by clicking on the column header title links.
• a.  Completed Orders
  The Completed Orders section displays a summary of all Completed orders that currently reside in the database.
   
  • Click on the Order Manager Completed Orders link in the main menu.
    
    
     
  • To View the Order Details, click on the Order Id link for the particular order.
     
    
  • To Download instant download orders click on the Download icon. This icon will only be displayed when the order is an instant download order.
    
    
  • To Send the ordered instant download files to the customer's email address, click on the Send Order   icon (Ent. version). You can enter a message for your customer on the next page that will be displayed. The system will zip all instant download files before it sends them to the customer's email address. Due to the limitation of sending large files via email, this function is only intend for use with small download file sizes.
    
    
  • To Upload the ordered instant download files to the customer's server via FTP, click on the FTP Syndication icon (Ent. version). The system will confirm FTP details for the remote server on the next page that will be displayed.
    
    
  • To Process a print order for Print Fulfillment, click on the Print Fulfillment icon (Ent. version). You need to choose the Print Fulfillment provider on the next page that will be displayed.
    
    
  • To make Notes pertaining to a particular order, click on the Notes icon for the particular order. The notes will be stored in the database until the selected order is deleted from the database. The system will display the notes under the Previous Notes section. The username of the person who added it and the date will also be logged. When a customer downloads an instant download type order from their My Account area, the details of the download will also be stored in the Previous Notes section.
     
  • To Print Order Details, click on the Print Order Details icon (Pro. & Ent versions).
    The order details for the selected Order Id will popup with a print function enabled.
     
  • To Cancel an order, click on the Cancel icon.
    Once the order has been cancelled, the order changes from Completed to Pending and the order will be moved to the Pending Orders section. When an order is pending, the download link will not be available to customers in their My Account area.
     
  • To Delete an order click on the Delete icon.
    You will need to confirm the delete action before the system removes the selected order from the database.
     
  • To change an order's Shipping Status, click on the link in the Shipping Status Column.
    With the Pro. or Ent. version you are able to input the shipping information for the selected order id. When clicking on the shipping link of the selected order id, another window will display which allows you to input shipping information such as shipping provider, provider URL etc. Customers will be able view all of the information that you input into the shipping information page (except the shipping cost), by clicking on the Shipping Info icon in their "My Account" area.
     
  • To view the Promotion Code details click on the promotion value hyperlink.
    The hyperlink is only visible if customers have input a promotion code during the checkout process. After clicking on the hyperlink, you will see all promotion codes that were used for the selected order id.
     
  • To view the customer's Registration information, click on the customer's username.
    The customer's profile page will display with the customer's profile information.
     
  • To Quick View Order Detail, enter the order id number into the Order Id # field and then click Submit.
    The order details of the input order id # will display if it exists in the database.
     

  b.  Pending Orders
  The Pending Orders section displays a summary of all Pending, Cancelled and Processing orders that currently reside in the database. A Cancelled order is a previously Completed order that was cancelled by the admin. A Processing order is an order submitted using the "Offline Form" and has not yet been processed by the admin.

  • Click on the Order Manager Pending Orders link in the main menu.
    
    
     
  • To View the Order Details, click on the Order Id for the particular order.
     
  • To change the status of an order from Pending to Completed click on the icon.
    When an order is completed, the download link will be available to customers in their My Account area if there is an instant download media in the order. Once the status is changed to Completed the order will be moved to the Completed Orders section.
     
  • To Delete an order click on the icon.
    You will need to confirm the delete action before the system removes the selected order from the database.
     
  • To view the Promotion Code details click on the promotion value hyperlink.
    The hyperlink is only visible if customers have input a promotion code during the checkout process. After clicking on the hyperlink, you will see all promotion codes that were used for the selected order id.
     
  • To view customer's Registration information, click on the customer's username.
    The customer's profile page will display with the customer's profile information.
     
  • To Quick View Order Detail, enter the order id number into the Order Id # field and then click Submit.
    The order details of the input order id # will display if it exists in the database.
    
     
• Invoice Manager - View Print & Send Customer's Invoices (Pro. & Ent. versions)
  You can preview, print or send an invoice to a customer's email address using this feature. The invoice data is taken from the customer's information collected through the Registration Form. You can add all information or just add selected fields using the invoice Configuration feature.
  
  There are three sets of customer information that are used by the invoice feature.
   
  1. Customer Registration Information
     This information is collected when the customer registers to your site.
      
  2. Billing Information
     The billing information is collected during the customer checkout process.
      
  3. Shipping Information
     If the order is a delivery order (not all instant download products), then the system will ask the customer to input their shipping address during the checkout process. This information is stored in the database and it's used for the invoice and order details sections.
     
     Below is a sample invoice.
     
     
     
     

  Invoice Configuration
  This feature allows you to control the customer's registration form fields that will be displayed on the invoice page or in the invoice email that is sent to customers. The system WILL NOT add these fields after you first install the software on your server. You will need to do this manually as described below. The billing and shipping details are predefined by the system.

  • Click on the Order Manager Invoice Manager link in the man menu.
     
  • Click on the Configuration link on the Customer Invoice Manager page.
    
    
     
  • New Field Name
    The fields displayed in the dropdown menu are taken from the Customer Registration Form Fields that you have configured. If you have not configured this form yet, click here to learn how.
     
  • Click the Submit button to add the new field to the database.
     
  • Click on the Delete icon for the target field name to delete it from the database.
     
  Using Invoice Functions
   
  • Click on the Order Manager Invoice Manager in the main menu.
    
    
     
  • Click on the Configuration link
    Use this feature to add or remove registration form fields from the invoice as required.
     
  • To send an invoice to the customer's registered email address, click on the Send Invoice icon for the target invoice id #.
     
  • To view a customer's invoice detail, click on the Preview icon for the target invoice id #.
     
  • To print a customer's invoice detail, click on the Print icon for the target invoice id #.
     
  • To quick print invoice detail, enter the invoice id # into the Quick Print Invoice # text field and click submit.
    The order invoice details for the entered id # will display if it exists in the database.
    
     
• Print Fulfillment Manager (Ent. version)
  The Frontline System requires all original images to be uploaded to their server via the provided FTP information. The provider require an XML file to be attached together with the uploaded images and order info. You will need to update your account info in the XML data. Each provider may require different file formats for printing, so please contact the provider for more information on the printing file format. 

  The system allows you to process the print order in two ways:
  

  1. Automatically
     To have the system automatically process the print fulfillment for all new orders automatically, you must enable the "Enable Automatic Print Fulfillment for New Completed Orders" option in the General Configuration.
  2. Manually
     To manually process the print fulfillment for a particular order, go to the Order Manager Completed Orders and click on the icon.

  In order for the system to upload the original images to the print provider's server, you must upload the original images to your server, so that they will be available for the system to upload to the print provider. The original images should reside in the "download" folder and the files should be named the same as the corresponding display file. Also, the folder structure of the download folder must be the same (mirror) as the gallery folder where the display files are stored. The system will first look into the original file path database field to see if there is a link attached to it. If no link is found, the system will look into the "download/category-path/file-name.jpg". When you upload images using the Hi-res auto Resize feature and using the Import function to import images to the gallery, the system will automatically move the hi-res images to the correct directory in the download folder as well as assigning the original link to the respective display image.

  When processing the print fulfillment, it is possible that you may encounter errors due to one or more of the following situations.

  1. The Original Images are not available.
  2. Print provider Product Code or Billing Code are not available.

  If either one of the above situations apply to all items in a particular order, then the system won’t process the print fulfillment for that order. However, if either situation above occurs to only one or more items in the order (not all items in order), then you can continue to process the order as long as you have the "Continue Processing Print Fulfillment for Orders with Errors" option in the General Configuration enabled. Only items with a valid Printing Code & the Original Images available will be processed.
  

  Frontline System - www.frontlinesystem.com

  • Click on the Order Manager Printing Manager link in the main menu.
  • Click on the Edit icon to update the Frontline XML data.

There are two methods to process a particular order.


• Relocation
  When this option is selected, you must provide the location where the order info and its images will be moved to. This location must reside on the same server where the Stockbox system is installed.
• FTP
  When this option is selected, you must provide the remote FTP info that you have from the Frontline Provider.
   
• XML Data
  There are few tags in the XML data that must not be removed or moved within the XML data. You can add more XML tags between these tags when needed.
  
  1. [BATCH] & [/BATCH]
     
  2. [IMAGE] & [/IMAGE]
     
     
  <?xml version="1.0" encoding="utf-8"?>
  <frontline removeAfterProcess="false" assignDefaultProfile="true">[BATCH]
  <batch code="[PRODUCT_CODE]">
  The system will replace this tag value with the Frontline Product Code. You must configure the Frontline Product Code in the Product Type Manager under the Action Column Section.
  
  <device>Stockbox</device> Replace this tag value with your own value. This description will appear in the Frontline order queue. Default = "Hotfolder"
  
  <customerID>99999</customerID>
  Replace this tag value with your Customer ID that you have from Frontline System Provider.
  
  <variables>
  <var name="info"><![CDATA[Frontlinesystem]]></var>
  No need to change the value of this tag.
  
  <var name="orderID">[order_info.order_id]</var>
  The system will replace this tag value with the purchased Order ID.
  
  <var name="userID">[customer_info.username]</var>
  The system will replace this tag value with the customer's Username.
  
  <var name="userEmail">[customer_info.email]</var>
  The system will replace this tag value with the Customer Email Address.
  <var name="ot_part">1</var>
  No need to change the value of this tag.
  
  </variables>
  <order sort="Stockbox_#[order_info.order_id]">[IMAGE]
  The system will replace the order_info.order_id with the purchased order ID.
  
  <image quantity="[order_details.quantity]" rotationAngle="0">
  No need to change the value of this tag.
  
  <path><![CDATA[[order_details.original_file_name]]]></path>
  The system will replace this tag value with the purchased Media System Name.
  
  <backPrint row="1"><![CDATA[(C) - Frontlinesystem]]></backPrint>
  Enter the backprint value as you wish. Frontline will use it for the backprint option.
  
  <backPrint row="2"><![CDATA[2006-03-03 <[order_details.original_file_name]>]]></backPrint>
  Enter the backprint row 2 as wish, otherwise Frontline will use the media system name.
  
  <variables>
  <var name="originalFileName"><![CDATA[[order_details.original_file_name]]]></var>
  The system will replace this tag value with the purchased media system name. </variables>
  </image>[/IMAGE]
  </order>
  </batch>[/BATCH]
  </frontline>
  
  
• Select Process Method
   
  • Relocation
    - In the "Relocation Directory" text field, enter the path where you want the system to move the order contents to. 
  • FTP
    - Enter the Host Name to the "Host Name" field
    - Enter the Host Username to the "Host Username" field
    - Enter the Host Password to the "Host Password" field
    - Enter the Port # to the "Port #" field
    - Tick the checkbox of "Enable Passive Mode" if Passive Mode is enabled on remote server
    - Tick the checkbox of "SSL Connection" if it's enabled on the remote Server
    - Enter the Remote Directory or select it using the GET button. The system will upload the order contents to this directory when it's processing a particular order.
    
    
• Enter the HotFolder Name.
  You should have the HotFolder Name that is assigned to you when you sign up with Frontline. If not you will need to request this name from Frontline.
• The system will create a new folder on the Remote FTP Server's home directory with the name that you enter in the HotFolder Name field. It will then upload all of the original images that the user has purchased and the order.xml file as well. The Frontline system will handle the rest.
   

Variables that you could use in Printing Fulfillment XML data



ORDER INFO.
[order_info.order_name]	Order Name that is configured in the Payment Gateway
[order_info.order_id]	Purchase Order ID
[order_info.username]	Customer Username
[order_info.transaction_id]	Transaction ID that is returned from the payment gateway processor
[order_info.tax]	Order Tax Price
[order_info.shipping]	Order Shipping Cost
[order_info.sub_total]	Order Sub Total Amount
[order_info.promotion_amount]	Order Promotion Amount
[order_info.grand_total]	Order Grand Total Amount
[order_info.order_date]	Order Purchase Date
[order_info.invoice_id]	Order Invoice ID
[order_info.order_time]	Order Purchase Time (hh:mm:ss)
ORDER DETAIL INFO.
[order_details.order_id]	Purchase Order ID, same as the [order_info.order_id]
[order_details.media_id]	Purchase Media ID
[order_details.photographer_username]	Purchase Media ID Photographer Username
[order_details.photographer_firstname]	Purchase Media Photographer First Name
[order_details.photographer_lastname]	Purchase Media Photographer Last Name
[order_details.product_name]	Purchase Stockbox Product Type for current Media ID
[order_details.product_label]	Purchase Stock Product Type Label for current Medai ID
[order_details.quantity]	Purchase Quantity
[order_details.price]	Media Price per Quantity
[order_details.total_price]	Purchase Price (Quantity x Media Price)
[order_details.order_date]	Order Date, same as the order_info.order_date
[order_details.order_time]	Order Purchase Time (hh:mm:ss)
[order_details.file_system_name]	Media File System Name
[order_details.file_display_name]	Media File Display Name
[order_details.file_path]	Media File Path
[order_details.original_file_path]	Media File Original Path
[order_details.original_file_name]	Media File Original Name
[order_details.bayphoto_ItemID]	Media Bay Photo Item ID (start from 1)
[order_details.bayphoto_product_name]	Media Bay Photo Product Name that is associated with Stockbox Product Name
[order_details.bayphoto_product_code]	Media Bay Photo Product Code that is associated with Stockbox Product Name
[order_details.bayphoto_billing_code]	Media Bay Photo Billing Code that is associated with Stockbox Product Name
[order_details.product_printing_code]	Media Frontline Printing Code (Batch Code) that is associated with Stockbox Product Name
ORDER BILLING INFO.
[billing_info.order_id]	Order ID
[billing_info.username]	Customer Username
[billing_info.customer_name]	Customer Billing Name
[billing_info.first_name]	Customer Billing First Name
[billing_info.last_name]	Customer Billing Last Name
[billing_info.address1]	Customer Billing Address 1
[billing_info.address2]	Customer Billing Address 2
[billing_info.city]	Customer Billing City
[billing_info.state]	Customer Billing State
[billing_info.zip]	Customer Billing Zip Code
[billing_info.country]	Customer Billing Country
[billing_info.phone]	Customer Billing Phone
[billing_info.email]	Customer Billing Email Address
ORDER SHIPPING INFO.
[shipping_info.order_id]	Purchase Order ID, same as order_info.order_id
[shipping_info.username]	Customer Registration Username
[shipping_info.customer_name]	Customer Shipping Name
[shipping_info.first_name]	Customer Shipping First Name
[shipping_info.last_name]	Customer Shipping Last Name
[shipping_info.address1]	Customer Shipping Address 1
[shipping_info.address2]	Customer Shipping Address 2
[shipping_info.city]	Customer Shipping City
[shipping_info.state]	Customer Shipping State
[shipping_info.country]	Customer Shipping Country
[shipping_info.phone]	Customer Shipping Phone
[shipping_info.email]	Customer Shipping Email Address
[shipping_info.comments]	Customer Shipping Comments
ORDER CUSTOMER REGISTRATION INFO.
[customer_info.email]	Customer Registered Email Address
[customer_info.username]	Customer Registered Username
[customer_info.registration_form_field_name]	The registration form field name is the field name in the customer registration form field



You could use any of the variables above in the XML format. The system will replace the call tag with the actual value from the database.




• Sales Report - View, Print and Export Sales Report (Pro. & Ent. versions)
  This feature allows you to view, print or export customer sales reports. You can customize the report layout as required (see below).
   
  1. Launching Sales Reports
      
     • Click on the Order Manager Sales Reports link in the main menu.
       
       
        
  2. View Sales Reports
      
     • Select the From date by clicking on the icon next to the From Date field. Select the Month and Year from the dropdown menus and select a date from the calendar to complete the selection.
     • Select the To date by clicking on the icon next to the To Date field. Select the Month and Year from the dropdown menus and select a date from the calendar to complete the selection.
     • Select the Order Status of the Customer's orders (All, Completed or Pending).
     • Select the Photographer from the drop down menu. When a particular photographer is selected, the system will only generate the report based on that photographer with the other selections.
     • Select the Product Type from the drop down menu. The system will only generate the report based on the particular product type when select.
     • Select the Category Path or Media ID from the Category / Media drop down when you want to generate the report based on this selection.
     • Enter the Report Title. The report title is used to describe the report.
     • Click on the Preview icon to view the report.

     The system will open a small window displaying all order summaries based on the selected date and the selected customization fields that you have configured in the "Current Configured Report Fields".
      

  3. Print Sales Reports
      
     • Select the From date by clicking on the icon next to the From Date field. Select the Month and Year from the dropdown menus and select a date from the calendar to complete the selection.
     • Select the To date by clicking on the icon next to the To Date field. Select the Month and Year from the dropdown menus and select a date from the calendar to complete the selection.
     • Select the Order Status of the Customer's orders (All, Completed or Pending).
     • Select the Photographer from the drop down menu. When a particular photographer is selected, the system will only generate the report based on that photographer with the other selections.
     • Select the Product Type from the drop down menu. The system will only generate the report based on the particular product type when select.
     • Select the Category Path or Media ID from the Category / Media drop down when you want to generate the report based on this selection.
     • Enter the Report Title. The report title is used to describe the report.
     • Click on the Print icon

     The system will open a small window (with a print function enabled) displaying all order summaries based on the selected date and the selected customization fields that you have configured in the "Current Configured Report Fields".
      

  4. Export Sales Reports
      
     • Select the From date by clicking on the icon next to the From Date field. Select the Month and Year from the dropdown menus and select a date from the calendar to complete the selection.
     • Select the To date by clicking on the icon next to the To Date field. Select the Month and Year from the dropdown menus and select a date from the calendar to complete the selection.
     • Select the Order Status of the Customer's orders (All, Completed or Pending).
     • Select the Photographer from the drop down menu. When a particular photographer is selected, the system will only generate the report based on that photographer with the other selections.
     • Select the Product Type from the drop down menu. The system will only generate the report based on the particular product type when select.
     • Select the Category Path or Media ID from the Category / Media drop down when you want to generate the report based on this selection.
     • Enter the Report Title. The report title is used to describe the report.
     • Click on the CSV Export icon.

     The system will open a small window that will allow you to Open or Save the Sales Report. The report will contain all order summaries based on the selected date and the selected customization fields that you have configured in the "Current Configured Report Fields". The export file is in .csv (comma separated value) format. You can open the exported file in Microsoft Excel® (or any other spreadsheet application).
      

  5. Customize Sales Reports
     Use this feature to customize the Sales Report layout. The system WILL NOT add these fields when you first install the software on your server. You will need to do this manually as described below before generating or exporting any sales reports.  There are four data sections in the “Database Field Name”.
      
     • Order Info
       This section is predefined by the system so you can’t add or remove any fields from the drop down menu.
     • Registration Info
       This information is collected when the customer registers to your site. If you add or remove fields from the registration form, the changes will be reflected in the dropdown menu.
     • Billing Info
       This section is predefined by the system so you can’t add or remove any fields from the drop down menu. The billing information is collected during the customer checkout process.
     • Shipping Info
       This section is predefined by the system so you can’t add or remove any fields from the drop down menu. The shipping information is collected during the customer checkout process.
       
        
     To customize Sales Reports
      
     • Click on the Order Manager Sales Reports in the menu function.
     • Select the field name in the "Database Field Name" drop down list.
     • Enter the Report Field Label to describe the field name.
     • Click the Add button, to add the new custom field to the report's layout.
     • Delete custom fields that are not required, by clicking on the Delete icon for the target field.
       
        

Using the Customer Manager

1. Active & Pending Customers
   After a customer registers to your site, their account status will be either in Pending or Active status.
    
   1. Pending Customers are those that either have not activated their account (if you are using the "Enable New Account Email Validation" feature) or have been changed from Active to Pending by you. If customers are in Pending mode they are not able to access the check out page or account page, but they are able to access the site to view the thumbnail or media detail pages.
       
   2. Active customers are able to access all features of the gallery, but not the administration or photographer's areas.
       
   • By clicking on either the “Active Customers” or “Pending Customers” link, the system will display the following screen.
     
     
      
   • To configure user FTP server details for a particular customer, click on the FTP Syndication icon. The system will use this information for the FTP Syndication function (Ent. version).
   • To view and/or edit a customer's information, click on the Edit icon for the particular customer.
   • To View the VIP Order History, click on the icon for the particular customer (Ent. version). This function is only available when a customer has been assigned VIP status.
   • To view a customer's Sample Download history, click on the icon (Pro. & Ent. versions).
   • To view a customer's Search Logs, click on the icon (Pro. & Ent versions).
   • To change a customer's status to Pending, click on the icon.
   • To change a customer's status to Active, click on the icon.
   • To Delete a customer from the database, click on the icon.
      
    
2. Email Customers
   Use this function to communicate with customers.
    
   • Click on the Customers Email Customers link in the main menu.
   • Select the email format. You can choose from either HTML or Plain Text for the outgoing email.
   • Enter the return email address into the "From" field. The return email address is the email address that customers would use if they wanted to reply to your message after receiving it.
   • Select the customer group in the "To" drop down list. (Active Customers, Pending Customers or All Customers).
   • Enter the Subject of the message.
   • Enter the message body into the Message field.
   • Click the Send button to send the message.
     
     
      
   Note: You need to configure the “Mail Server Configuration” correctly before using this function. The mail server configuration is in the General Configuration section.
   
    
3. Registration Form
   The Stockbox system supports an unlimited number of form fields for the customer registration form. You can add more fields or remove existing ones that are not required for your gallery. If you wish to remove a field from displaying on the form, Stockbox suggests that you edit the field and make it inactive rather than deleting the field, as you may wish to use it at a later date. By default when the software is installed the system will add the following fields to the customer registration form. Please see the Registration section for more information.
   
   Click on the Customers Registration link in the main menu.
    
   • firstname - Customer's first name
   • lastname - Customer's last name
   • address - Customer's physical address
   • city - Customer's city
   • state - Customer's state
   • zip - Customer's postal code
   • country - Customer's country
   • phone - Customer's phone number
      
   The collected data is used for the invoice and order details that are described in Order Manager section.
   
   
   
    
4. Contact Mapping
   There are a few places in the system that require customers to input information. This information may have already been collected during the registration process. Stockbox provides an option, which allows you to map these fields to the customer's registration form. With this mapping relationship the system will automatically pre-fill the customer’s data to the common defined fields, so that customers do not need to re-input data, which was already submitted.
   
   Click on the Customers Contact Mapping link in the main menu.

   Note: It is only necessary to make changes to this section if you remove any of the default Registration form fields and replace them with your own custom fields.
   
   
   
    

5. Add New Customer
   Within the admin control panel you can add a new customer to the system. The new customer will become active once you have submitted the data to the server. The system will not verify the email address even if you have set it to do so in the general configuration.
    
   • Click on the Customers Add Customer link in the main menu.
     
     
     
     The system displays the dynamic fields from the registration form that you have configured in the Customer Registration section. The username, password and email fields are all required by the system. Fill in all relevant values into the provided text fields and click the Submit button to add the new customer to the system.
     
      
6. Online Users (Ent. version)
   When the "Enable Online User Log" option in the Customer Configuration is selected, the system will log all users when they visit your site. This page will display all users that are currently viewing your gallery.

   
    

   • Session ID
     Visitor's current session ID.
   • Username
     Visitor's username. When users login to the system, the username will be logged.
   • Current Page
     The page the visitor is currently viewing.
   • Referred URL
     The URL that the user visited before browsing to the current page.
   • IP Address
     Visitor's IP Address
   • Visit Time
     Visitor's visit time
   • To view more details of a particular user, click on the View Details icon. The system will list all pages that the selected user has browsed in your gallery.
   • To instruct the system to ignore a particular IP Address, click on the Ignore IP icon. The system will not log user info for visitors from this IP once the IP Address has been added to the Ignore IP Address List.
   • To view all user's history click on the User Logs link. The "Maximum Number of Logs per User" is configured in the General Configuration.
   • To View the Ignore IP address list click on the "Ignore IP" link. You are able to add or remove IPs from it as desired.
   • To Delete a log from the database, click on the Delete icon.
   
   
   
7. Temporary Password Requests
   When users are requesting the recovery of a lost password in the gallery, the system will store the request in the database. The temporary password will be deleted once users have activated their new password by clicking on the link in the "Lost Password" email that the system sends out.
   
   
   
8. Temporary Session
   The Temporary Session is a session that Stockbox generates when a user sends their lightbox to a friend from the Private Gallery. You can delete any session on this page, but once it's been deleted the user's friend will not be able to access the private gallery. Therefore, you should only delete sessions that  have been in the database for an extended period of time. You can configure the system to delete any session that is no longer valid, using the "Remove Private Gallery Temporary Session After" option in the General Configuration.
   
    
9. VIP Customers (Ent. version)
   When users have been assigned VIP status, they are able to purchase download media from the gallery without needing to go through the checkout process.
   
   
   • To assign VIP status to a particular user
     Only the Administrator is able to set VIP status to a particular user by clicking on the Edit icon for the particular user and tick the VIP User checkbox.
     
     
   • View VIP user Order History (downloads)
     
     
     When VIP users purchase or download media from the gallery, the system will create a new order and add it to the database as a regular order. You are able to see the order tax, shipping (if available), sub total and other information by clicking on the Order Id. The "Paid Status" would be marked as "Unpaid" so that you could bill customer later. To change the "Paid Status" to "Paid", simply click on the "Unpaid" link and the status will be switched to Paid.
     
   
   
   
10. Customer Export (Pro. & Ent. versions)
     
    • To export customers registration data, click on the Customer Export link from either the Customers Active Customers or the Customers Pending Customers sections.
      
      Customer Export Configuration
       
    • Use this section to tell the system which Registration Fields you want to collect.
    • Database Field Name
      These fields are from the Customer Registration section.
    • Export Field Label
      Enter the label that you want for the selected field or leave it blank. When it's blank system will use the field name of selected field
    • Click ADD to add the new custom field to the export configuration. When a new field name is added it will display in the lower section. You can duplicate any field as desired.
    • To remove an Export Field, click on the Delete icon.
      
      
      
      
      Customer Export Generator
      
      
    • Enter the Start Date by clicking on the icon. Select the Month and Year from the dropdown menus and select a date from the calendar to complete the selection.
    • Enter the End Date by clicking on the icon. Select the Month and Year from the dropdown menus and select a date from the calendar to complete the selection.
    • Select the Customer Status (All, Active or Pending).
    • Enter the Customer Export Name.
    • Click on the Export button and the system will open a small window that will allow you to Open or Save the Customer Export. The export file is in .csv (comma separated value) format. You can open the exported file in Microsoft Excel® (or any other spreadsheet application).

    
    

11. Customer Configuration
    Within the Customer Configuration section you are able to configure the following.
    
    
    • Click on the Customers Configuration link in the main menu.
      
      
       
    • Enable Agreement Checkbox on Customer Registration Form
      When this option is enabled the system will require users to check the Agreement checkbox before being able to submit the registration data to your server.
    • Enable New Account Email Validation
      When this option is enabled the system will send out a "Validation Email" to the user's registered email which will allow them to validate their email address. Once they validate their email address, the system will update their account status to "Active", allowing them to purchase media from the gallery.
    • Send Welcome Email to New Customer on Approval
      When this option is enabled, the system will send out a "Welcome Email" to the user's registered email address when their account status changes to "Active".
    • Enable FTP Syndication in My Account Section
      When this option is enabled, users are able to configure their remote FTP server and upload their purchased instant download files directly to their server.
    • Enable Online User Log
      When this option is enabled, the system will log all visitors that access your gallery.
    • Minimum Number of Characters for Customer's Username
      This is the minimum number characters that customer must use for their username. A value of 7 or greater is suggested.
    
    Note: The system requires the "./config/config.inc.php" file to be writable in order for this function to work. You will need to change the file permission of the "config" directory and its files to 777 before using this function.
    
    
    

MANAGE PHOTOGRAPHERS (CONTRIBUTORS) (Ent. version)
With an Ent. version you are able to allow photographers (contributors) to upload and sell their own media on your site. The system calculates the commission due to the photographer based on the sales and commission rate that is set in the photographer configuration section. The system also generates sales reports for each photographer and gives you full control over all photographers and their submissions.

Before photographers are able to upload media to your server, they need to register to the gallery system. After registering to the system, their account status will either be in Pending or Active status, depending on the setting that you have configured in the Photographers Configuration section. The system provides a number of features that are described below for you to manage the photographers (contributors).

• Pending Photographers are those that either have not activated their account (if you are using the Enable Photographer Email Validation feature) or have been changed from Active to Pending by you. If you want the photographers to remain in pending status until you manually approve them, then you will need to use the Enable Photographer Email Validation feature and remove the [LINK] call tag from the photographer_activate_email.txt template. If photographers are in Pending mode, they are not able to access the photographer's section, but they are able to access the gallery.
• Active Photographers are able to access all pages of the gallery and the photographer's section, but not the Admin Control Panel.

1. Un-approved Media
   This section lists all the media that have not yet been approved by you for inclusion in the gallery. Any un-approved media will not be displayed in the gallery.
    
   • Click on the Photographers Un-approved Media in the main menu to view all un-approved media that are currently in the database.
     
     
      
   • Click on the icon to view the target media's details.
   • Click on the icon to approve the target media.
   • Click on the icon to delete the target media.
   • Click on the Approve All hyperlink to approve all un-approved media.
     
     Note: Stockbox only displays the photographer's media in the gallery when their status is Approved.
     
      
2. Active Photographers
    
   • Click on the Photographers Active Photographers in the main menu to show all active photographers that currently reside in the database.
   • To import a photographer hi-res image files to the database, click on the icon. The system will list all hi-res files that are under the "upload/photographer-username" on the next page.
   • To view the photographer's details, click on the icon.
   • To set the photographer's payment status, click on the icon.
   • To view the photographer's sales reports, click on the icon.
   • To view the photographer's Portfolio, click on the  icon
   • To change the photographer's status to pending, click on the icon.
   • To delete a photographer from the database, click on the icon. A deleted photographer is not able to access the photographer's section.
   • To email a particular Photographer, click on their email address.
     
     
     
      
3. Pending Photographers
    
   • Click on the Photographers Pending Photographers in the main menu to show all pending photographers that currently reside in the database.
   • To view the photographer's details, click on the icon.
   • To set the photographer's payment status, click on the icon.
   • To view the photographer's sales reports, click on the icon.
   • To change the photographer's status to active, click on the icon.
   • To delete a photographer from the database, click on the icon. A deleted photographer is not able to access the photographer's section.
   • To email a particular Photographer, click on their email address.
     
     
     
      
4. Photographer Payment History Report
   This page is used to display the Photographer's payment history. It also allows you to change the status from Not Paid to Paid.
    
   • Order Id: The order id that includes the Photographers' media sales in it. Click on the link to view the order details.
   • Sub Total: The order sub-total.
   • Tax: Tax amount for the order.
   • Commission Rate: The percentage of the sale that will be deducted before you pay the Photographer.
   • Commission Value: The total amount of the sale that will be deducted before you pay the Photographer.
   • Photographer Amount: The total amount that the Photographer will be paid for this order Id.
   • Order Status: The status of the order. Completed means that payment for the order has been received from the customer.
   • Paid Out Status: This indicates if the Photographer has been paid for the order.
   • Total Unpaid Amount: The total amount that is owed to the Photographer.
   • Payment Method: Here you can add details of how the photographer was paid (e.g. PayPal, Cheque, etc.).
   • Payment Method Details: Here you can add details of the Payment Method (e.g. PayPal receipt number, Cheque number, etc.).
   • Click on the Mark Paid button to change the status from Not Paid to Paid.
     
     
      
      
5. Photographer Sales Report
   This page is used to display the Photographer's Sales Report.
    
   • Order Id: The order id that includes the Photographer's media sale in it. Click on the link to view the order details.
   • Sub Total: Sub Total amount of the Photographer's media sold.
   • Rate: The commission rate is the percentage that you withhold from a sale before paying the Photographer.
   • Commission: The total commission amount based on the total sale and commission rate.
   • Photographer Amount: The total amount payable to the Photographer for this order Id.
   • Order Status: The status of the order id, (Pending or Completed).
   • Paid Out Status: The paid out status for the selected photographer.
   • Payment Method: The payment method entered during the payout process will display here.
   • Method Detail: The payment method details entered during the payout process will display here.
   • Paid Date: The date that you changed the status from Not Paid to Paid.
     
     
     
      
6. Email Photographers
   Use this function to send an email or newsletter to the photographers.
    
   • Click on the Photographers Email Photographers in the main menu.
   • Select the email format. You can choose from either HTML or Plain Text for the outgoing email.
   • Enter the return email address into the "From" field. The return email address is the email address that customers would use if they wanted to reply to your message after receiving it.
   • Select the customer group in the "To" drop down list. (Active Photographers, Pending Photographers or All Photographers).
   • Enter the Subject of the message.
   • Enter the message body into the Message field.
   • Click the Send button to send the message.
     
      
7. Add Photographer
   You can add a new photographer to the system using the Add Photographer function. The system will not verify the photographer's email address even if the “Enable Photographer Email Validation” option is set to do so in the configuration. The new photographer account status will be Active immediately after you click on the Submit button.
    
   • Click on the Photographers Add Photographer in the main menu.
     
     
      
   • Fill in all information to the relevant text fields.
   • Click the Submit button to add the new photographer to the database.
     
      
8. Password Requests
   When photographers request a lost password in the gallery, the system will store the request in the database. The temporary password is deleted once the photographer has activated their new password by clicking on the link in the "Lost Password" email that system sends out to them.
   
   
   
9. Configuration
   Use this function to configure the default settings that Stockbox will use when a new photographer signs up to your site. You can set the photographer's commission rate and require the administrator to approve newly uploaded media.
    
   • Click on the Photographers Configuration link in the main menu.
     
     
      
   • Enable Photographer Email Validation
     Check this box if you want to validate the photographer's email address before their registration is activated. Once a new Photographer registers to the system they will be emailed a link that will activate their account when clicked. If you want the photographers to remain in pending status until you manually approve them, then you will need to use this feature, but remove the [LINK] call tag from the photographer_activate_email.txt template.
      
   • Enable Photographer Agreement Checkbox on Registration Form
     Check this box if you want to display the agreement checkbox on the photographer's registration form. Photographers must check this checkbox on the form to complete the registration process.
      
     
   • Allow Photographers to Add New Category
     When this option is enabled, the system will allow photographers to create new categories in the gallery.
     
     
   • Enable Photographer Default File Upload Without Admin Approval
     Un-check this box if you want to approve each photographer's uploaded media (otherwise it will automatically be added to the gallery).
      
   • Enable Photographer Approval Notification
     Check this box if you want the system to send a notification email to your email address each time a photographer uploads new media to the system.
      
   • Enable Welcome email notification when photographers account status becomes active
     Check this box if you want the system to send a welcome message to the photographer's registered email address when their account becomes active.
     
     
   • Enable Photographer Marquee Listing
     When this option is enabled, the system will display all photographers in the gallery where the [PHOTOGRAPHER] call tag is positioned in the gallery.tpl template. The photographers names will be displayed in scrolling marquee style list.
     
     
   • Enable Send Email for Un-approved Media
     When this option is enable, system will send photographer email when his/her media is remove from the Media Approval List
     
     
   • Enable Send Email for Approved Media
     When this option is enable, system will send you photographer email when his/her media has been approved.
     
     
   • Enable Upload Hi-Res Auto Resize Images
     When this option is enabled, the system will allow photographers to upload hi-res images to the Hi-res Auto Resize Folder in the photographer section. This feature will automatically generate the download files, the display files and the thumbnail files from the uploaded hi-res images. This option is only available when you have ImageMagick© Installed on your server and you have input the correct path in the Media Configuration. Also, the system only supports JPG or JPEG file formats when using this feature. Once you have completed the upload of the hi-res files to this folder, you must use the Import Hi-res function to import these files into the gallery.
      
   • Allow Photographers to Add Portfolios
     When this option is enabled, the system will allow photographers to add their portfolio to the system. However, their portfolio will remain in Hidden status until the admin changes the status to Active.
      
   • Default Commission Rate
     This commission rate is applied for the default setup. This percentage is the amount that will be withheld by you before the Photographer is paid for the sales of their images. Therefore, if the sales total is $ 100.00 and the percentage is set to 30%, then the system will calculate that the amount owed to the Photographer is $ 70.00. You can change this value for an individual photographer by editing their photographer's profile.
     
     
   • Minimum Number of Characters for Photographer's Username
     This is the minimum number characters that photographer must use for their username.
      
   • Click the Submit button to save the changes.
     
      
10. Registration
    Using this function, Stockbox will collect the photographer's information. Please see the Registration section for more information. Although this functions in the same way as the Customer's Registration form, it is completely independent.
     
    • Click on the Photographers Registration in the main menu.
      
       
11. Photographer Export
     To export photographers registration data, click on the Photographer Export link from either the Photographers Active Photographers or the Photographers Pending Photographers sections.

Photographer Export Configuration

• Use this section to tell the system which Registration Fields you want to collect.
• Database Field Name
  These fields are from the Photographer Registration section.
• Export Field Label
  Enter the label that you want for the selected field or leave it blank. When it's blank system will use the field name of selected field
• Click ADD to add the new custom field to the export configuration. When a new field name is added it will display in the lower section. You can duplicate any field as desired.
• To remove an Export Field, click on the Delete icon.
  
  
  
  Photographer Export Generator
  
  
• Enter the Start Date by clicking on the icon. Select the Month and Year from the dropdown menus and select a date from the calendar to complete the selection.
• Enter the End Date by clicking on the icon. Select the Month and Year from the dropdown menus and select a date from the calendar to complete the selection.
• Select the Photographers Status (All, Active or Pending).
• Enter the Photographers Export Name.
• Click on the Export button and the system will open a small window that will allow you to Open or Save the Photographer Export. The export file is in .csv (comma separated value) format. You can open the exported file in Microsoft Excel® (or any other spreadsheet application).
  
  
  
12. Photographer Hi-res Import
    This function allows you to import photographer hi-res images from photographer's directory under the "upload" directory to the system. When a new photographer is added to the system, it will automatically create a new folder under the "upload" folder with the photographer's username. You can take advantage of this feature, by creating an FTP account for each photographer and grant the permission on their folder only. If you are not sure how to create FTP accounts, you will need to contact your hosting provider for assistance. In doing so, each photographer would be able to use their FTP account to upload their hi-res images to your server. Using an FTP client to upload hi-res images to the server is more efficient than doing so via your web browser. The admin user or photographer is able to import the hi-res images to the gallery as desired once their hi-res images have been upload to the server.

    This feature will automatically generate the download files, the display files and the thumbnail files from the high-resolution images that are uploaded to the "upload" folder. This option is only available when you have ImageMagick© Installed on your server and you have input the correct path in the Media Configuration. Also, the system only supports JPG or JPEG file formats when using this feature. The system will only generate the download files when the uploaded hi-res image satisfies the minimum dimension that are configured in the Product Type section. When there is no instant download configured for a particular product type, the system would recognize it as a print or delivery product and it would not generate the download files for these product types. Also, if you don't have any product types added when importing the hi-res images to the gallery, the system won't be able to generate the download files and you will need to manually generate the download files for the display images later if you want to offer them.

    Download Images will be generated based on the instant download dimensions that you have configured for the particular product type. A product type with no instant download dimensions will be recognized as print product, so no download image will be generated for that product type.
    Display images will be generated based on the "Resize To" dimension that is configured in the Media Configuration section.
    Thumbnails will be generated based on the Thumbnail Configuration that is in the Media Configuration section.
    
     

    • Click on the Import Hi-res icon for the particular photographer in the active photographer list.
      
      
      
      
    • Click on the icon to import the particular hi-res image.
    • You are able to choose the available product types for the selected hi-res image and the category where the images will be displayed.
    • Click on the  SUBMIT button to import the selected hi-res images to the gallery. The system will generate the download files based on the Instant Download Configuration that you configured for the particular product type, in the Product Manager Product Types section..
      
      
      
13. Photographer Contact Mapping
    The system needs the photographer's first name and last name to display in the gallery when you enable the "Enable Photographer Marquee Listing" option in the Photographer Configuration.

• Click on the Photographers Contact Mapping link in the main menu.
  
  
  
   
• Select the Mapping Field name in the drop down list and click on the SUBMIT button to save the changes.
  
  
  

1. User's Lightboxes
    
   • Click on the Lightbox User Lightboxes link in the main menu to view a listing of all user's lightboxes.
   • The Username column shows the visitor's username.
   • The IP Address column shows the visitor's IP Address.
   • The Added Date column shows the date the lightbox was created.
   • Click on the icon to delete the target lightbox session id and media.
   • Click on the icon to empty all of the lightboxes that are currently in the database.
     
     
      
   • Click on the customer's lightbox Session Id to view its contents.
     
     
      
   • With the Ent. version you are able to create a new order or upload the selected download files to a Remote FTP server.
   • Select the images that you want to create an order for and click on the Create Order icon to create the new order.
   • Select the instant download images that you want to upload to the remote FTP server and click on the FTP Syndication icon. You will be able to add the FTP login details on the following screen.
     
     
     
2. Send Lightbox Logs
   The Send Lightbox Logs allows you to manage the user's Send Lightbox Emails. On this page you can see where the email was being sent to and other related information.
    
   • Click on the Session Id link to view the contents of the sent lightbox.
   • With the Ent. version you are able to create a new order or upload the selected download files to a Remote FTP server.
   • Select the images that you want to create an order for and click on the Create Order icon to create the new order.
   • Select the instant download images that you want to upload to the remote FTP server and click on the FTP Syndication icon. You will be able to add the FTP login details on the following screen.
      
   • Click on the View Detail  icon to view the details of the sent email.
   • You can delete a particular Send Lightbox Log by clicking on the Delete icon for that log.
   • Click on the Empty icon to empty all of the lightboxes that are currently in the database.
     
     
     
3. Configuration
   Use this configuration page to manage the lightbox section in the gallery.
    
   • Click on the Lightbox Configuration link in the main menu
     
     
   • Maximum Number of Media for Each Lightbox
     Enter the Maximum Number of media that you allow users to add to each lightbox.
     
     
   • Enable Multi-Lightbox Feature (Ent. version)
     When this option is enabled, the "Require Login to Use Lightbox" and "Require Login to Send Lightbox" options are automatically enabled. The system will allow users to create as many lightboxes as desired in the gallery, but each lightbox still relies on the Maximum Number of Media for Each Lightbox value set above.
     
     
   • Require Login to Use Lightbox
     When this option is enabled, the system will require users to login before using the Lightbox Manager (Ent. version) or adding media to their active lightbox.
     
     
   • Require Login to Send Lightbox
     When this option is enabled, the system will require users to login before sending their lightbox.
     
     
   • Enable Send Request a Quote Feature (Ent. version)
     When this option is available the "Request a Quote" icon will display on the Lightbox page of the gallery.
      
   • Allow User Comments in Lightbox (Pro. & Ent. versions)
     When this option is enabled, the system will allow users to add comments to the media in their lightbox . The comments will be stored in the database until the user removes them from their lightbox.
     
     
   • Enable "Add to Cart" Button in Lightbox (Pro. & Ent. versions)
     When this option is enabled, the system will allow users to purchase images directly from their lightbox. Users can add as many media to their lightbox as they want and then add them to their shopping cart directly from their lightbox, without first having to visit the media detail page for each image. This feature is designed to streamline the purchase process for images that users have already added to their lightbox.
     
     
   • User Lightbox Session Life (in days)
     The system will remove any user lightbox contents from the database based on the value entered. If you don't want the system to remove the user lightbox contents, then you should enter 0 into the input field. The number of days is calculated from the date that the lightbox was created.
     
   
   
   
   

• Click on the Shopping Cart link in the main menu to view a listing of all user's shopping carts.
• Click on the customer's shopping cart Session Id to view its contents.
• The Username column shows the customer's username.
• The Media Count column shows how many media that are in the particular shopping cart.
• The Record Date is the date the shopping cart record was added to the database.
• Click on the icon to delete the target shopping cart session id and its contents from the database.
• Click on the icon to empty all shopping carts that are currently in the database.

Note: The default banner size is 713 px x 225 px (width x height). You should resize your images to this size prior to adding them to the system.

Adding Banner Images

• Click on the Banner Manager link in the main menu.
• Click on the Add icon.
  
  
   
• Browse to banner image on your desktop computer.
• Enter the Description for this image or leave it blank.
• Click on the SUBMIT button to upload the selected image and add it to the system.
   
• Once images are added to the database, their default status will be Hidden. You will need to change this to status to Active by clicking on the Hidden link in order for it to be displayed in the gallery.

• To edit a particular image, simply click on the Edit icon for the selected image.
• To delete a particular image from the banner images, simply click on the Delete icon for the selected image.

• Click on the Portfolio Manager link in the main menu.
• Click on the Add Portfolio icon to add a new portfolio.
  
  
   
• Portfolio Category Name
  The system will display this name to identify the particular portfolio.
• Portfolio Category Icon
  The system will display this icon in the Featured Portfolio section of the gallery.
• Photographer Profile
  Select the photographer that the portfolio belongs to, or you can click on the "Add Photographer Account Profile" to add a new photographer.
   

Portfolio Manager:

• Icon
  The system will display this icon in the Featured Portfolio section of the gallery.
• Portfolio Name
  Click on the Edit icon to change the Portfolio Name.
  Photographer
  This column displays the username of the photographer.
• Featured
  To feature a portfolio in the Featured Portfolio section, click on the NO link.
• Status
  When a new portfolio category or portfolio media are added to the system it will be assigned Hidden status. You will need to change this to status to Active by clicking on the Hidden link in order for it to be displayed in the gallery.
• Action
• To Add or Edit Media to a portfolio, click on the Add/Edit Portfolio Media icon. There are two ways to add media to the portfolio (see below for details).
• To Add Photographer Portfolio Profile, click on the Add Photographer Portfolio Profile icon.
• To Update Photographer Portfolio Profile Content, click on the Update Photographer Portfolio Profile Content icon.
• To edit a portfolio, click on the Edit icon.
• To delete a portfolio, click on the Delete icon.
   

Add Media to a Portfolio
There are two ways to Add Media to a particular portfolio.

1. From media in the gallery.
2. By uploading media from your desktop.

1. Add Media from the Gallery
   Before you can add gallery media to a portfolio, you will need to select them in the Media Manager.
   
   
   • Click on the Portfolio Manager link in the main menu.
   • Click on the Add/Edit Portfolio Media icon.
   • Click on the Add Portfolio Media from Gallery icon. If you have not already selected media in the Media Manager you will need to do so by clicking on the Add Media icon.
   • Browse to the target category that contains the portfolio images.
   • Tick the checkboxes to select the media files and click on the Global Add Media icon
     
     
      
   • Select the Portfolio Category in the Drop Down List. You must have created a portfolio category in order to add media to it.
   • Click on the ADD Button to add the selected media to the selected Portfolio.
      
2. Add Media Manually
   
   
   • Click on the Portfolio Manager link in the main menu.
   • Click on the Add/Edit Portfolio Media icon to add new media to the portfolio.
   • Click on the Add Portfolio Media Manually icon to add new media to the portfolio.
     
     
      
   • Click on the Browse button to select the media from your desktop computer.
   • Enter a Description or leave it blank.
   • Click on the SUBMIT button to add the new media to the selected portfolio.
      

Add Portfolio Profile Content

• Click on the Portfolio Manager link in the main menu.
• To Add Photographer Portfolio Profile, click on the Add Photographer Portfolio Profile icon. You will need to assign a Photographer Profile to the portfolio before you can add portfolio profile content.
• To Update Photographer Portfolio Profile Content, click on the Update Photographer Portfolio Profile Content icon.
  
  
  
  Profile
• Enter your Profile Content and click on the SUBMIT button to save the changes.
  
  Profile Media
• To insert images into the Portfolio Profile Content, you will need to upload them first to the server by clicking on the Upload Profile Media icon. Your uploaded images will be displayed in the "Profile Media" tab and you can also view the actual URL for the image. You will need to insert the URL into the "Image URL" field that will be displayed after clicking on the Insert / edit Image icon in the Tiny MCE Editor menu.
   

Using the General Configuration section

• Click on the Configuration General link in the main menu.
  

1. Mail Server Configuration
   Stockbox can use either of  two methods to send out mail. The Default Mail Server or SMTP Server.
    
   • Default Mail Server
     Stockbox recommends that you use the default mail server to send out mail to customers. No options are needed if you select to use the default mail server.
   • SMTP Server
     If for some reason you don't have a mail system installed on your server, you can use the SMTP method. The system will need a little more time to send out emails if you are using this method. It needs time to connect to the SMTP Server before sending out emails. To use this method, select SMTP Server in the drop down list and fill in all the information for your SMTP mail server configuration in the text fields. Click the icon to test the connection before saving the settings. If the entered info is correct, you will receive an email that is sent to the email address in the "Notification Email Address" text field.
      
2. Cookie Manager
   When a customer visits the gallery, a cookie is saved on the customer's computer to keep track of their actions. Stockbox uses this cookie for the shopping cart and the lightbox session id.
    
   • Cookie Lifespan (in days)
     The time that the cookie will last on the customer's computer. The time is reset whenever the customer returns to the gallery. To change the lifespan of the cookies that are set by the system, enter a new value here.
      
3. User Session
   Stockbox will automatically logout customers after the specified time has elapsed. This will prevent unauthorized access if the customer does not logout.
    
   • Session Timeout (In Minutes)
     Enter the desired value here. The default value is 30 minutes.
      
4. Execution Memory Limit
   When the system is executing functions, it needs memory to allocate data. By default, the system is only able to allocate the memory buffer that is configured in the servers php.ini file. Sometimes, the system needs a larger memory buffer to execute a function like zipping all download files. You may need to increase this number to a larger value to avoid a memory allocation problem. Depending on your server's configuration, it may not allow you to set the memory buffer during run time, but most servers do allow it.
   
   
5. Download Manager
    
   • Enable Download Link Verification on Purchase
     If this option is enabled and the product type is assigned with a instant download link, the system will check to make sure the assigned download link exists on the server. If it doesn't exist on the server, users will not able to purchase this product type. This option only works when the display and download files are on the same server where the Stockbox software is installed, it will not work with the Remote FTP server feature.
   • Maximum Download Zip Limit File Size When using memory buffer
     This number will vary depending on your server and PHP "memory limit" configuration. When users are trying to download their order, the system will zip all of the downloaded files in the order and store them to the server memory. If the download files are large and your server has insufficient resources to handle them, the server will return an error. To prevent this from occurring, the system will zip all of the files when it detects that the download file size exceeds this configured value to the actual zip file on your server instead of using the server memory to allocate these files. This method will take longer than the Memory Allocation method and it will use extra space on your server to store the zip package, but it will prevent the out of memory issue. The default number is 32MB and if you experience an out of memory issues at this setting you should reduce this value.
   • Remove download links after # of days
     Input the number of days that you want the system to maintain the active download links in the user's "My Account" area. After the specified number of days, the system will de-activate the links. The number of days are counted from the day after the customer made their purchase.
   • Download Readme File
     You can specify the readme file that will be included with the zipped download file(s). The system will list all files in the ./template/language-name/ folder in the dropdown menu. By Default, it will ignore any files with a "tpl", "html", and "css" file type extension. If you would like to use one of these file types. then you will need to remove it from the IGNORE_README_EXT variable in the ./config/config.inc.php file.
    
6. Registration configuration
   The system will use these configurations during the customer and photographer (Ent. version) registrations.
    
   • Notify me when someone signs up
     To be notified when some one signs up (registers), check this box, otherwise leave it un-checked. The notification email will be sent to the email address that is entered in the “Notification Email Address” field. The notification email contents can be modified by editing the notify.tpl template in the template section.
   • Notification Email Address
     The system will use this email address to send the notification email when a new user signs up.
   • Webmaster Name
     The system will use this name for the notification email.
      
7. Invoice Configuration (Pro. & Ent. versions)
   The system will use these configurations upon the completion of a customer's order.
    
   • Enable Notification Invoice Email
     If this box is checked, an invoice will be sent via email to you and to the customer when an order is completed. To disable this feature, un-check the box. The invoice email contents can be modified by editing the invoice.tpl template in the template section
   • Enable bcc Invoice
     To bcc (blind carbon copy) the invoice email to another email address, tick this checkbox.
   • bcc Invoice Email Address
     Enter the email address where the bcc email will be sent. This feature could be used to automatically send a copy of the invoice to your print shop or order fulfillment centre.
   • Mobile Notification Email Address
     Enter the email address for your mobile phone. The system will send a new order notification to the mobile phone email address that you input. You can obtain the mobile phone email address through your service provider.
   • Enable Show Invoice Thumbnail
     By checking this box, a thumbnail image will display on the invoice.
   • Enable Show Media Path
     By checking this box, the category path will display on the invoice.
   • Invoice Start Number
     Enter the starting value for the invoice number. The system will use this number as the starting value when a new order is created in the system. Any subsequent order will have the invoice number increased by one.
      
8. Send To Friend
    
   • bcc Admin a copy of SEND TO FRIEND email
     Check this box to have a blind carbon copy of the sent message emailed to your notification email address.
   • Enable SEND TO FRIEND Logs
     When this option is enable, the system will log the SEND TO FRIEND email to the database. You can view the log detail in the Media Manager Send To Friend Logs and Lightbox Manager Send Lightbox Logs sections.
    
9. Date Format Configuration
    
   • Date Format: There are two types of date format that you 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.
      
10. Slide Show Configuration
     
    • Enable Slide Show
      To enable slide show in your gallery, tick this checkbox. Otherwise leave it unchecked.
    • Slide Show Timeout
      Enter a value as desired (the value must be numeric). The lower the number, the faster the images are changed in the slide show.
    • Enable Slide Show Media Limitation
      When users activate the slide show, the system will query all images in the selected category and output that data to the browser. If the selected category contains many images and your server has a low memory limit, it will return an error. To prevent this issue, you should enable this option. When this option is enabled, the system will only query the images on the current page for the slide show instead of the entire selected category of images.
       
11. Currency Configuration
     
    • Currency Symbol
      Enter the desired currency symbol to be used. This currency symbol will be used throughout the system.
    • Currency Symbol Prefix
      Before Price: The system will display the currency symbol before the price.
      After Price: the system will display the currency symbol after the price.
    • Currency Decimal Separator
      Choose the symbol you want to separate the decimal part of the price for your currency (e.g. 10.00 or 10,00).
       
12. Default Payment Method Configuration (Ent. version)
     
    • Payment Option
      Choose the Payment Options for your site. There are three options available as follows.
      PPP Only: (Pay Per Purchase) If this option is selected, the system will only allow users to pay when checking out their order.
      Subscription Only: If this option is selected, users are only able to checkout when they have purchased one of your subscription products and changed their Payment Method to the purchased subscription.
      PPP & Subscription: If this option is selected, users are able to checkout regardless of whether they have purchased a subscription or not. The system will detect the appropriate payment method for your customer during the checkout process.
    • Default Payment Method
      Choose the default payment method for your site. This option is only available when you choose PPP & Subscription for the Payment Option.
      
      Subscription: the system will use the subscription option as the default payment method. If users have subscribed to your subscription, it will use the active subscription for the purchase. If the customer's subscription will not cover the order total, then the system will provide a PPP option for them to continue to checkout.
      
      PPP: the system will use the PPP (Pay Per Purchase) option as the default payment method. If users have subscribed to one of your subscriptions and they wish to use that for their purchase, then they will need to switch to the active subscription before being able to checkout with their prepaid subscription.
      
     
13. System URL Path Configuration
     
    • Gallery Landing Page
      Select the Stockbox Gallery Page for your gallery landing page. This page (URL) will be loaded when users click on the HOME link or button of the gallery or when the user enters the gallery using the URL..
    • Stockbox Full URL Path
      In order for the system to function correctly, this URL PATH must have a valid path. The system should obtain the FULL URL during the installation process, but for some reason your server may return an incorrect path. You should only modify this URL if it's incorrect. The correct path is: http://www.yourdomain.com/path-to-stockbox, no forward slash at the end of the URL.
    • User Logout Redirect URL
      Enter the FULL URL path where users will be redirected to upon logging out from their account. This URL will apply to all users, administrators, photographers and customers.
    • Home Public Breadcrumbs Link
      Enter the path you want the "Home" breadcrumb link to be associated with. By default it will point to the index.php (main gallery page). If you want it to point to another page on your site, please enter the correct path into the input text field. Please provide the absolute path for Stockbox SEO compatibility. e.g. http://www.yourdomain.com/path-to-stockbox/index.php.
       
14. Meta Tag Default Configuration
     
    • Gallery Page Title
      Enter the default meta page title by clicking on the icon. The page title will be displayed at the top of your web browser. It will also display on the search results page of the search engines. The page title is an important part of effective SEO. With the Pro. & Ent. versions you can add dynamic data to the category and media page titles in your gallery.
    • Gallery Meta Description
      Enter the default meta description by clicking on the icon. The meta description will be displayed on the search results page of the search engines. With the Pro. & Ent. versions you can add dynamic data to the category and media page meta descriptions in your gallery.
    • Gallery Page Keywords
      Enter the default meta keywords by clicking on the icon. With the Pro. & Ent. versions you can add dynamic data to the category and media page meta keywords in your gallery.
       
15. Other Configurations
     
    • Enable License Agreement Checkbox on Shopping Cart Page
      By checking this box, the system will require users to tick the agreement checkbox on the shopping cart page before continuing to checkout their order. The agreement text can be edited in the Template Manager section. The template name is "checkout_agreement.tpl".
    • Enable Individual Logout
      By default system will unset all current sessions when you logout in the current session. This including admin section, gallery section and photographer section. If you wish system to log you out from the session that you're current using then tick this checkbox.
    • Offline Form Credit Card
      There are three options that you can choose from in the dropdown list.
      Collect Credit Card & Other Payment Method: When this option is selected, the system will provide an option in the Offline Form which allows users to choose to not provide credit card information. You should only use this option if you accept other payment methods such as a bank transfer or you allow your customers to pay by cheque (check).
      Collect Credit Card Only: When this option is selected, the system requires users to enter credit card information in order to submit an order. The credit information is encrypted before being stored in the database. To view the customer's credit card information you will need to go to the Order Manager section and click on the "Complete" or "Processing" hyperlink in the status column for the particular order.
      Remove Credit Card Option: When this option is selected, the system will remove the credit card section from the Offline Form so that users are not required to enter their credit card info in order to submit an order. Users are only required to enter their personal info to submit order.
    • Enable Rollover Navigation Menu Button
      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.
    • Credit Card Expiration Year Range
      This value will be used for the credit year range in drop down list for the offline form.
    • Enable IPTC Metadata Feature
      Tick this checkbox when you want system to import IPTC metadata to the database when image is being imported to the database. If your media doesn't have IPTC metadata embed then you should not tick this checkbox, as this will reduce the loading time.
    • Enable IPTC Metadata Mapping
      Tick this checkbox, system will auto map the IPTC metadata to the media property page when image being imported to the system. The IPTC metadata mapping is under the IPTC Configuration section.
    • Admin Panel Query Row Limit
      Each time the system fetches data from the MySQL database, it will use this number to ask the DB to return the maximum number of rows. This number will be used throughout the admin control panel.
    • Remove Pending Orders After
      When users checkout an order, the system will create pending orders in the database. These orders will remain in the database until users complete the checkout or the admin manually deletes them. Use this field to tell the system to delete these orders automatically based on the #of days. This would free up some server space.
    • Remove Private Gallery Temporary Session After
      When users are using the Send to Friend feature in the private gallery, the system will create a temporary session and store it in the database. These sessions will remain in the database until you delete them. Use this field to tell the system to delete these session based on the # of days specified. When the session is deleted from the database, users will no longer be able to access to the gallery using that session ID. Enter 0 when you don't want system to delete them from the database.
    • Gallery Navigation Menu
      There are three options for you to choose from.
      
      1. Use Gallery Navigation Menu Button with Rollover Option Enabled
         When this option is selected, the system displays the navigation button in the gallery with Rollover option enabled. When you mouse over the navigation menu button it will change to the rollover button state.
      2. Use Gallery Navigation Menu Button with Rollover Option Disabled
         When this option is selected, the system will only display the navigation buttons in the gallery with no Rollover option enabled. When you mouse over the navigation button, it won't change to the rollover state.
      3. Use Gallery Navigation Menu Dropdown
         When this option is selected, the system will use a dropdown menu for the navigation menu function. You will be able to view the sub-menu items when you mouse over a particular menu button. This option is ideal for a site with many pages.
    • Show Private Categories in the Public Gallery
      By default, private galleries (protected categories) do not display in the Public Gallery, so users need to login the private gallery section in order to view their private galleries. When this option is checked, the system will list the Private Category name in the public gallery section and allow users to click on it to login.
    • Show Category with no Media
      When this option is checked, the system will list the category in the gallery regardless of whether it contains media or not.
    • Maximum Number of Logs per User (Ent. version)
      When the system stores user log data in the database, it will use this number to limit the number of rows to be logged for each user. Use this option to avoid filling all of the available MySQL database space. Enter 0 if you want the system to store the logs regardless of the amount of server space
      used.

Click on the SAVE button to save your new configuration settings.

1. Administrator Configuration (Ent. version)
   Administrator Configuration gives you options to enable or disable the Blacklisted IP feature, and manage the Malicious Characters feature for your gallery. To go to this configuration, click on the Administrator Configuration link in the main menu.
    
2. Customer Registration Configuration
   The Customer Registration Configuration allows you to collect customer's information during the registration process. You can either tell the system to require a user's input for the specified field or have the user input optional. To go to this configuration section, click on the Customers Registration link in the main menu.
   
   
3. Customer Configuration
   The Customer Configuration gives you an option to validate the customer email address, send a welcome email to customer upon approval and require users to read the Terms & Conditions before registering to your site. To go to this configuration, click on the Customers Configuration link in the main menu.
    
4. General Configuration
   The  General Configuration contains the majority of the available configuration settings. To go to this configuration section, click on the Configuration General link in the main menu.
    
5. Invoice Configuration (Pro. & Ent. versions).
   The Invoice Configuration allows you to control the target customer's registration form fields that will be displayed on the invoice page or in the invoice email that is sent to customers. To go to this configuration section, click on the Order Manager Invoice Manager link in the main menu and then click on the Invoice Configuration link.
    
6. IPTC Configuration (Pro. & Ent. versions).
   This IPTC Configuration allows you to control how the IPTC metadata information is displayed and utilized by the system. To go to this configuration section, click on the Media Manager IPTC Configuration link in the main menu.
    
7. Language Configuration (Ent. version)
   Language Configuration gives you the option to set the language selection display style in the gallery. To go to this configuration section, click on the Language Manager Configuration link in the main menu.
    
8. Lightbox Configuration
   Lightbox Configuration gives you options to manage user lightboxes. To go to this configuration section, click on the Lightbox Configuration link in the main menu.
    
9. Media Configuration
   The Media Configuration allows you to set the media properties such as Quick Preview Info, Thumbnail size, Watermark, etc. To go to this configuration section, click on the Configuration Media link in the main menu.
    
10. News Configuration (Ent. version)
    The News Configuration allows you to manage the way the News items are displayed by the system. To go to this configuration section, click on the Configuration News link in the main menu
    
    
11. Payment Gateway Configuration
    The Payment Gateway Configuration is used to tell the system which gateways will be available to users when they make a purchase. To go to this configuration section, click on the Payment Gateway link in the main menu.
     
12. Photographer Registration Configuration (Ent. version).
    The Photographer Registration Configuration allows you to collect the photographer's information during the registration process. This configuration is similar to the Customer Registration configuration, but they are completely independent. To go to this configuration section, click on the Photographers Registration link in the main menu.
    
    
13. Photographer Configuration (Ent. version)
    The Photographer Configuration gives you options to validate the photographer's email address, require photographers to read the Terms & Conditions before registering to your site, enable new category creation in your gallery, set default commissions etc. To go this configuration section, click on the Photographers Settings link in the main menu.
    
    
14. Product Type Configuration
    Product Type Configuration gives you options to configure the product type display style in the gallery, enable product options, subscriptions, virtual CD. To go to this configuration section, click on the Product Manager Configuration link in the main menu.
     
15. RSS Configuration (Pro. & Ent. versions)
    The RSS Configuration allows you to manage the content feed settings. To go to this configuration section, click on the Configuration RSS link in the main menu.
    
    
16. Promotion Configuration (Pro. & Ent. versions)
    Promotion Configuration gives you the option to enable or disable the promotion feature on your site. To go to this configuration, click on the Promotion Configuration link in the main menu.
    
    
17. Rights-Managed Configuration (Ent. version)
    Rights-Managed Configuration gives you options to make adjustments to the license price. To go to this configuration section, click on the License Manager Configuration link in the main menu.
    
    
18. Sales Report Configuration (Pro. & Ent. versions)
    The Sales Report Configuration allows you to tell the system to collect customer's registration, billing and shipping information and display them on the sales report. To go to this configuration section, click on the Order Manager Sales Reports link in the main menu.
     
19. Search Configuration
    Search Configuration gives you options to set the Search Method for the Quick Search function, configure options in the Advanced Search Form and other search options. To go to this configuration section, click on the Search Manager Configuration link in the main menu.
     
20. Shipping Configuration
    The Shipping Configuration section allows you to set the shipping cost that the system will use during the checkout process. You can use this configuration section to set Flat Rate Shipping, Zone Shipping, etc. To go to this configuration section, click on the Shipping Manager Configuration link in the main menu.
    
    
21. Tax Configuration
    The Tax Configuration allows you to set the tax method that the system will use to apply tax to customer orders. To go to this configuration section, click on the Tax Manager Configuration link in the main menu.
    

With the Ent. version you can also offer subscription products, packages of products and product options (e.g. Photo Frames) in your gallery.

1. Product Types
   Below are the steps required for you to create new product types.
    
   • Click on the Product Manager Product Types.
     
     
      
   • Product Name
     The product name is used by the system's database, so it should not contain any special characters, spaces or numbers.
     e.g. !@#$%^&*()_+|}{":?><1234567890-=\][';,./
      
   • Label
     You can use this field to describe the Product Type. The product label is what the user will see in the gallery and it may contain special characters, spaces, numbers and even HTML code.
      
   • Base Price
     The system uses this value to pre-populate a base price in the Media Properties and Global Pricing sections.
     Note: This base price will not apply to the media until you use the Global Update Product Price & Credit feature to update all media.
      
   • Base Credit (Ent. version)
     The system uses this value to pre-populate a base credit value in the Media Properties and Global Pricing sections. You need to enter a value in this field in order to be able to create the product type. If you don't want to enter an actual value then you can just enter 0 (zero).
     Note: This base credit will not apply to the media until you use the Global Update Product Price & Credit feature to update all media.
     
     
   • Auto. Price
     When a product type is set to Auto. Price, system will automatically assign this product type with its base price and credit (Ent. version) to newly uploaded media. You should only use this option when the Product Type is available for all of your media.
     Note: This only applies to new media, the existing media will not be affected.
      
   • Disable Tax
     If you don't need to tax customers for this Product Type, tick the checkbox. The system will not charge tax for items purchased with this product type.
      
   • Shipping Cost & Additional Shipping Cost
     Enter the shipping cost and additional shipping cost for this product type. The additional cost would be applied on the second and subsequent items with the same product type. To use the Product Type Shipping Cost, you must select "Use Product Type Shipping Method" in the Shipping Manager section of the admin control panel. Click here for other Shipping Methods.
      
   • Click the Add button to add the new Product Type to the database.

   Other Product Type Functions

   • Product Type Status
     The system only allows users to purchase a Product Type when its status is "Active". By default, newly created Product Types have an "Active" status. To change the status, click on the "Status Value" of the particular Product Type in the Status column.
     
     
     
   • Global Pricing (Pro. & Ent. versions)
     Use this function to assign pricing to selected Product Types, to selected categories of media in one operation. You can also use the same function to apply pricing to all Product Types, to all categories of media in one operation.
     
     
     • Click on the Global Pricing link or its icon at the top center of the Product Manager Product Types section.
       
       
        
     • All Product Type Checkbox
       Tick this checkbox, to tick all of the current Product Type checkboxes at once. This will apply pricing to ALL Product Types.
     • Specific Product Type Checkbox
       Tick the specific Product Type checkboxes that you want to apply pricing to. This will apply pricing only to the selected Product Types.
     • All Categories checkbox
       Tick this checkbox, to tick all of the current category checkboxes at once. Pricing will be applied for all "checked" Product Types to ALL categories in the gallery.
     • Specific Category Checkbox
       Tick the specific category checkboxes that you want to apply pricing to. Pricing will be applied for all "checked" Product Types only to the selected categories in the gallery.
     • Include Sub-Categories Checkbox
       Tick this checkbox if you want the system to auto check or un-check all sub-categories of the selected category when the parent category is checked or un-checked.
       
     • Click the Submit Button to update the Base Price and Base Credit for the selected Product Types to the selected Categories.
       
       Remove Products/Pricing
       If you would like to remove a product type from display, you can enter a price of 0.00.
       
        
   • Product Type Price & Credit Update (Pro. & Ent. versions)
     This function is similar to the Global Pricing function, but instead, it only allows you to apply Global Pricing for the target Product Type only.
     
     
     • Click on the Product Type Price & Credit Update icon for the target Product Type
       
       
        
     • Change the Base Price and Credit as desired.
     • Tick any category checkboxes that you want to assign the product pricing to and click the Submit Button. The system will update all of the media in the selected categories with the target Product Type's Base Price and Credit values.
       
       Remove Products/Pricing
       If you would like to remove a product type from display, you can enter a price of 0.00.
       
        
   • Global Price Adjustment (Pro. & Ent. versions)
     Use this function to adjust the existing pricing (or credit cost) for media with the target Product Type assigned, without interfering with other media that don't have the selected Product Type assigned.
     
     
     • Click on the Global Price Adjustment icon of the particular Product Type in the Action Column
       
       
        
     • Select the Price / Credit Adjustment Method. There are two methods available.
       Addition (+): The system will add the "Adjustment Amount" to the media's current price for the selected Product Type.
       Subtraction (-): The system will subtract the "Adjustment Amount" to the media's current price for the selected Product Type.
     • Select the Adjustment Type for adjustment, Price or Credit (Ent. version).
     • Enter the "Adjustment Amount", numeric only (no currency symbol).
     • Adjustment Amount Options. There are two options available:
       Fixed Amount: When the Fixed Amount option is selected, the system will add or subtract the entered value from the Product Type's current Price or Credit amount.
       Percentage: When the Percentage option is selected, the system first calculates the new amount based on the value entered in the "Adjustment Amount" field and then Adds or Subtracts it from the current price for the selected Product Type.
     • Tick the "Set to ..." checkbox if you want system to reset the Selected Product Type Price to 0 if the new adjusted value is less than 0. This will prevent the possibility of having a negative price.
       
       Note: The system will not update media which are not assigned to the Selected Product Type. The system will record all the past adjustments in the database for future reference.
       
        
   • Product Type Discount Configuration (Ent. version)
     Use this function to give discounts to customers that make bulk purchases.
     
     
     • Click on the Discount Configuration icon for the particular Product Type.
       
       
       
       
     • Minimum Purchase Quantity
       Enter the minimum quantity that the customer needs to purchase before the discount will be applied.
     • Discounted Price per item
       Enter the discounted item price. This price will apply if the quantity purchased by the customer is equal to or greater than this value.
     • Expiry Date
       Enter the date that the discount pricing will expire.
     • Promotion Code
       Enter the Promotion Code.
     • Auto Apply Discounted Pricing
       If this option is selected, the system will automatically apply the discounted pricing if the minimum quantity is purchased. The customer does not have to input a promotion code, but you will need to input a code when creating the discounted pricing so that the system can track when it is used. If this option is NOT selected, customers will need to enter the promotion code during the checkout process to have the discounted pricing applied to their purchase.
     • Status
       when the discounted product pricing is setup, it will have a "Hidden" status by default. The discounted pricing will not be available until you click on the "Hidden" link to change the status to "Active".
        
     • Note: You can create multiple discounts for the same Product Type, based on different purchase quantities. The one with the greater discount will be applied to the order.
       
       
       
   • Printing Code Configuration (Ent. version)
     Use this function to assign the Print Fulfillment Product Codes that you have from the print provider to the Stockbox Product Type. When the system process the order via the print provider, it will use this code instead of the Stockbox Product Type name.
      
     • Click on the icon for the particular product type to assign the printing code to it.
     • Click on the icon to Update Printing Code.
       
       
       
        
     • Enter the Provider Product Code for the selected Stockbox Product Type name and click the SUBMIT button to save.
       
       
       
   • Instant Download Configuration (Ent. version)
     Use this function to configure the instant download dimensions and its PPI for the Product Type. This configuration will be used for hi-res images import function. The system will only recognize a particular product type as an instant download type when it has an instant download configuration set to it. The download file will be generated based on the configuration that you set on this page.
      
     • Longest Dimension (pixels)
       The system will resize the longest dimension of the hi-res image to the size entered in this field. The system will maintain the aspect ratio of the images during the resize process.
       e.g. If you enter 500 Pixels and the hi-res image size is 1772px by 1186px. Then the system will re-size the image to 500px by 334px for its download file for this Product Type
     • PPI
       The system will set this PPI to the download image when it resizes the original image.
     • Use Original File
       Tick this checkbox when you want the system to use the original image for the download file. You must specify the "Resolution Minimum Value" when choosing this option. The system will only assign this product type when the hi-res image minimum dimension meets this minimum value.
        
     • Click on the SUBMIT button to save instant download configuration.

      

   • Edit Product Type
     
     
     • Click on the icon for the particular Product Type
       
       
       
       
     • Fill in all new values to the available fields and click SAVE. With the Ent. version you are able to label the Product Types in the other available languages by clicking on the respective language in the Language drop down list.
       
        
   • Delete Product Type
     Click on the icon for the particular Product Type to delete it. You will need to confirm the Delete Action by clicking on the icon on the confirmation page. Stockbox recommends that you should set the particular Product Type to be "Hidden" (by clicking on the "Active" link for that Product Type) instead of deleting it from the database. This will prevent missing data errors if customers have already purchased media with this Product Type.
     
     
     
   • Product Type Position
     To move a Product Type's position up or down in the display list, click on the or respectively. This is the order that the system will use to display the Product Types on the media detail page of the gallery.
     
     
     
2. Product Options (Ent. version)
   This feature allows you to sell accessories for your product. You can use this feature to sell photo frames etc. Using the Product Options Manager you can create as many product options as required. Stockbox will display them in the gallery for customers to purchase. When displaying the media details page, the system checks for the product type and product options. If there are product options available for the target media’s product types, the system will display a button to allow the customer to purchase the available product options. Note: The Product Option feature is not available when a customer is using a subscription payment method.
   
   Before using this feature, the system needs at least one product type to be created in the database.
    
   • Click on the Product Manager Product Options link in the main Menu.
     
     
      
   • Option Name
     The Option name is used by the system's database, so it should not contain any special characters, spaces or numbers.
     e.g. !@#$%^&*()_+|}{":?><1234567890-=\][';,./
      
   • Option Label
     You can use this field to describe the Product Option. The product label is what the user will see in the gallery and it may contain special characters, spaces and numbers.
      
   • Shipping Cost & Additional Shipping Cost
     Similar to the single item shipping or product item shipping calculation, the system will apply the same formula to calculate the shipping cost for this product option.
     Note: the system only applies this shipping setting when you're using the "Single Item Shipping Method" or "Product Type Shipping Method" in the Shipping Manager section of the admin control panel.
      
   • Available Products
     You need to tell the system which product types are available for this new product option. The system will not allow a customer to purchase this product option if there are no product types associated with this product option. If you have correctly configured the product types, the system will display them here for you to set the price and their available quantities.
      
     1. Status
        Check the check box if this new product option is available for this product type.
     2. Product Type
        The product type label.
     3. Price (Numeric Only)
        The price per item for this new product option.
     4. Available Quantity
        Product options available quantity. The system only allows customers to purchase if the sold quantities plus the customer's input quantities are less than the available quantity.
        
        
   • Option HTML Code
     The system requires you to input the Product Option HTML code. This HTML code is used to display in the gallery when a customer wants to preview it before purchasing. There are two tags that are required by the system.
      
     • [MEDIAIMAGE]
       The system will replace this tag with the actual media image.
       
     • [OPTION_ADD_TO_CART]
       The system will replace this tag with the "add to cart" button.
        
     • Product Option Sample
       
       
       
     • The following code was used to create the sample frame above. The images used for the frame can be found in the sample_frame.zip file in the images folder. The files should be uploaded to the tmp folder, if you would like to use the sample frame on your site. When you create a new frame, you can store the image files in the location of your choice as long as you have the correct file path in the html code.
       
       <table border="0" cellspacing="0" cellpadding="0">
         <tr>
           <td align="left" valign="top"><img src="tmp/topleft.gif" alt="" width="22" height="22" /></td>
           <td style="background-image:url(tmp/top.gif)"> </td>
           <td align="right" valign="top"><img src="tmp/topright.gif" alt="" width="22" height="22" /></td>
         </tr>
         <tr>
           <td style="background-image:url(tmp/left.gif)"> </td>
           <td>[MEDIAIMAGE]</td>
           <td style="background-image:url(tmp/right.gif)"> </td>
         </tr>
         <tr>
           <td align="left" valign="bottom"><img src="tmp/bottomleft.gif" alt="" width="22" height="23" /></td>
           <td style="background-image:url(tmp/bottom.gif)"> </td>
           <td align="right" valign="bottom"><img src="tmp/bottomright.gif" alt="" width="22" height="23" /></td>
         </tr>
       </table>
       <table border="0" cellspacing="0" cellpadding="0" align="center">
        <tr><td align="center">[OPTION_ADD_TO_CART]</td></tr>
       </table>
        
   
   Other Product Option Functions
    
   • To edit an existing product option click on the Edit Icon.
   • To delete an existing product option click on the Delete Icon.
     
      
3. Product Subscriptions (Ent. version)
   You can use the subscription feature to offer customers the ability to subscribe to your gallery before purchasing products or instant download media. Once the customer has purchased a subscription they can then use it to make "purchases" without having to pay at the checkout. There are two types of subscriptions available.
    
   • Duration Subscription
     Customers who subscribe to this subscription type are able to purchase products or downloads for any media that has product types that are available for this subscription. Customers will not able to use a subscription if it has expired.
      
   • Credit Subscription
     This subscription type is similar to the “Duration Subscription”, but instead of checking for the expiration date, the system will check for available credits to use. The available credits are the customers Subscription Credits minus the used credits. The customers can’t use their subscription when their remaining credits are zero.
     
     Note: If the product type is a delivery type then the customers will only need to pay for the shipping cost and not the media cost. If the product type is NOT a delivery type, then the customers will not be charged during the checkout process. Therefore, Stockbox recommends that you use the subscription product for instant download product types only, to avoid the customer having to pay for shipping charges upon checkout.

   Using Subscription Functions

   
   
    
   • Subscription Type
     Type of subscription, Duration or Credit type.
      
   • Subscription Name
     Name of subscription. This name should not contain any spaces or invalid characters.
      
   • Subscription Description
     Description of the subscription. Use this field to describe this subscription. The system will use this description in the gallery instead of the subscription name.
      
   • Subscription Price
     Subscription price.
      
   • Subscription Period / Credit Number
     Depending on the Subscription Type selected, the system will display the Subscription Period or Credit Number field. If the subscription type is Duration, then the Subscription Period will be shown. Otherwise the Credit Number will be shown. If the Credit Subscription Type is selected the system will display  the "Expire After" field to allow you to set the number of days after the purchase that the subscription will remain valid.
      
   • Available on Product Type
     Tick the desired product type for this subscription. The customers are only able to purchase or download any media that has this product type assigned to it.
      
   • Click the Submit button to add the new Subscription.
      
   Other Functions
    
   • To Delete an existing subscription click on the Icon.
     The system recommends that you should set the subscription status to "Hidden" instead of deleting it from the database. This will prevent missing data issues.
      
   • To View subscribers for a particular subscription click on the Icon
     With this function you are able to view sales reports for the subscribers. The system also calculates the photographer’s commission, if customers used their subscription to purchase or download a photographer's media.
      
   • To move a Subscription's position up or down in the display list, click on the or respectively. This is the order that the system will use to display the Subscriptions on the Products page of the gallery.
      
   • To hide a subscription from users, click on the "Active" hyperlink in the Status column.
     Customers are not able to purchase a subscription when its status is "Hidden".
      
   • To activate a "Hidden" subscription, click on the "Hidden" hyperlink in the Status column .

   Merging Subscriptions
    

   • The System only allows users to have one active credit subscription at a time. When users purchase another credit subscription while their current subscription is still active, the system will merge the two subscriptions together so that there is only one active credit subscription. The subscription which has the longer expiration date will be used for the “merged to” subscription.
      

   Product Packages (Ent. version)
   Use this feature to create Product Packages to sell a set of images for a set price.
    

   • Click on the Product Manager Product Packages link in the main menu.
     
     
      
   • Package Name
     Name of the package. You should not use any invalid characters "~`!@#$%^&*()-_+=\|]}{["':;??><,." or spaces.
      
   • Package Description
     Description of package. Use this field to describe the package.
      
   • Package Price
     Price of package.
      
   • Shipping Included
     If your price already includes the shipping cost, select Yes otherwise select No. If "Yes" is selected, the system will not charge shipping during the checkout process, otherwise the system will charge the shipping cost based on the Shipping Method that you configured in the Shipping section.
      
   • Product Type
     Enter the quantity for the desired product type. The system will check to make sure that the quantity that is purchased by users matches the quantity entered. If all quantities match, then users will be able to check out their order.
      
   • Click Add to add new product package
   • Click on the Icon to view its subscribers.
   • Click on the Icon to edit the particular product package.
   • Click on the Icon to delete the particular product package.
   • Click on the "Active" hyperlink to hide the particular product package from users.
   • Click on the "Hidden" hyperlink to display the particular product package for users to purchase.
   • To move the position up or down in the display list, click on the or respectively. This is the order that the system will use to display the Subscriptions on the Products page of the gallery.
     
     
     
4. Virtual CD (Ent. version)
   Using the Virtual CD feature you can sell group of selected media as a package. You can add as many media to the Virtual CD as desired and assign a download link to it, or set it as a delivery type. The system also provides you with options to set the shipping cost and tax.
    
   1. New Virtual CD
       
      • Click on the icon on the Virtual CD Manager page.
        
        
         
      • Click Browse to choose a Virtual CD thumbnail image from your desktop computer.
         
      • Click the "Check Thumbnail" link to make sure the thumbnail name is unique on the server.
         
      • Enter the Virtual CD Label. The system will display the label in the gallery for the name of the Virtual CD.
         
      • Enter the Virtual CD Description. The system will display the description on the Products page in the gallery.
         
      • Select the Virtual CD Type. There are two types available, Delivery and Download. When a Virtual CD is a delivery type, the system won't ask for its media Product Type, but it allows you to set the shipping cost for it. Alternatively, when a Virtual CD is a download type, you must assign a download link to the Virtual CD either as a "Single Download Package" or select the Instant Download Product Type in the list. If the Product Type option is selected, then you must make sure there is a download file in the "download" directory for each media file in the Virtual CD with the Selected Product Type prefix. The hierarchy of the download links must be the same as you configured for the other media in the gallery (you need to use the same naming convention and category structure as when assigning download links using the Global Enable Download Links feature).
         
      • Enter "Number of Media". The system only allows users to purchase a Virtual CD when you have added the number of media that matches this entered value.
         
      • Enter the Virtual CD Price.
         
      • Shipping Cost: this option is only available when the Virtual CD is a Delivery Type. You can choose either the Current Shipping Method, Fixed Price or No Charge.
         
      • Select the Tax Method. You can either choose, Disable Tax, Fixed Tax or Current Tax Configuration method.
         
      • Click Submit to add the new Virtual CD. If all data is valid, the system will create the new Virtual CD in the database and it will be shown in the Virtual CD Manager which allows you to update it later if needed. The status of the new Virtual CD will be "Public", but you will not be able to sell it until its number of media are filled.
        
        
   2. Add Media to Virtual CD
       
      • Click on the icon on the Virtual CD Manager page.
         
      • To add media to a particular Virtual CD, click on the Add Icon that is in the Action column of the particular Virtual CD.
        
        
         
      • to browse to sub categories or the media in a category, click on the category name.
         
      • to add all media in a particular category, click on the Add icon on the right side of the screen. The system will only add the number of media to the virtual CD until its "Number of Media" has not been reached. Once the number has been reached, the system will ignore additional  media.
         
      • to add multiple categories to a Virtual CD, tick on the checkbox for the particular categories and then click on the icon.
        
        
   3. Virtual CD Media
      To remove media from a Virtual CD, click on the icon for the particular Virtual CD.
       
   4. Empty Virtual CD
      To empty the contents of a Virtual CD, click on the icon for the particular Virtual CD.
       
   5. Edit Virtual CD
      To edit a Virtual CD, click on the icon for the particular Virtual CD.
       
   6. Create Virtual CD Order
      To create a Virtual CD order, click on the icon for the particular Virtual CD. Fill in all the relevant info in the next screen and continue to create the new order for your customer.
       
   7. Delete Virtual CD
      To delete a Virtual CD, click on the icon for the particular Virtual CD. You will need to confirm the action before the system deletes it.
      
       
5. Configuration
   Use this function to configure the Gallery Product Types.
   
   
   • Click on the Product Manager Configuration link in the main menu.
     
     
      
   • Product Type Listing Style
     Listing Style: the system will display the available Product Types in a list. With this method, customers are able to choose multiple Product Types for a particular media at the same time.
     Drop Down Style: the system will display the available Product Types in a drop down list. With this method customers are only able to choose one Product Type for a particular media at a time.
   • Enable Product Options
     When this option is enabled, the system will allow users to purchase Product Options (e.g. Photo Frames) for a particular media when its Product Type has an associated Product Option.
   • Enable Product Subscriptions
     When this option is enabled, the system will allow users to purchase subscription products and use the purchased subscriptions to pay for their orders / downloads.
   • Enable Product Package
     When this option is enabled, the system will allow users to purchase Product Packages and use them to pay for their choice of media based on the Product Package configuration.
   • Enable Virtual CD
     When this option is enabled, the system will allow users to purchase Virtual CDs.
   • Virtual CD Display Number
     Enter the number of Virtual CDs to be listed in the Virtual CD column in the gallery.
   • Virtual CD Display Style
     Select the display style for virtual CD listing.
     
     

• The system displays all option(s) of the same level of the same branch in the same drop down list. According to the above image, Option 1, Option 2, Option 3 are in the same drop down list.  The system also provides the option to allow you to label the level option.
   
• The Option value is only displayed for a user to select if it has a price of at least $0.00 or a positive number.
   
• The Option values are displayed based on their parent (rely on) level. According to the above image, Option 4, Option 5 and Option 6 are only displayed in the drop down list of the Level 2 when users select the Option 1 in the Level 1 drop down list. The Option 9, Option 10, Option 11 are displayed when users select Option 3 in the first level drop down list.
   
• The cost of the selected license is a SUM of all the selected Options in the license tree. According to above image the cost for Option 2 Option 8 Option 16 Option 22 is $22.50.
   
• The E presents for End of Tree, no other option values will be displayed when this option value is selected.
   
• Stockbox only allows users to add the RM media to the basket if all the license options in all drop down menus have been selected.
   
• Stockbox initializes the drop down option value with all of the options for the parent (rely on) level. According to the above image the Option 1, Option 2, Option 3 are pre-filled in the level 1 drop down list. The other level drop down lists will display N/A (not available).

There are three steps to configure the RM License Calculator feature.

1. License Data (set options)
   License data, is data that will be displayed in the drop down list for customers to select, based on the license that you created.
    
2. License Manager (set pricing)
   The License Manager allows you to create the license by assigning a value (cost) to the license data that was entered in the License Data section.
    
3. Set Media License Type
   You will need to set the media license type to Rights Managed for all media that you want to utilize the Media License Manager feature.
    

1. Use the License Data section to set license options (Ent. version)
    
   • Click on the License Manager License Data link in the menu function.
   • License Option Label is a label that is used to describe the data in the License Option Value field (e.g. Image Use).
   • Rely On: Each drop down list must rely on a parent option level.
     The TOP level means the data in this drop down list will be initially filled with the value that is entered in the License Option Value for users to choose from.
   • License Option Value are values that are used for this License Option.
     You can enter more values as long as they are separated by a ";" semicolon (e.g. Retail Products;Editorial;Multimedia;Advertising;Display/Signage;Internal Company Use;Marketing).
   • Click the Submit button to save the changes.
     
     Note: If the Option level will not be used by all options in the level that it is set to "Rely On", then an Option value of None should be added.
     
     
     The following is an example license setup with nine option levels:
     
     Option1:
     
     
     Option 2:
     
     
     Option 3:
     
     
     Option 4:
     
     
     Option 5:
     
     
     Option 6:
     
     
     Option 7:
     
     
     Option 8:
     
     
     Option 9:
     
     
     
     The following image shows the Option Level Manager with the nine option levels created above:
     
     
     
     
   • To edit an existing License Data Option, click on the icon of the target license option.
      
   • To delete an existing License Data Option, click on the icon of the target license option.
     Note: all data for this license option will be removed from the database. Stockbox will also remove data from License values that you have already created.
      
   • Using the example in the image above:
      
     • The Image Use, Distribution Area and Industry will be initially filled with options when the license is displayed to the user.
     • The Details Of Use options will only be filled when the customer selects an option from the Image Use field.
     • The Image Size, Print Run, Placement and Duration will only be filled with options once the customer has selected an option from the Details Of Use field.
     • The Distribution Area Detail will be filled when the customer selects an option from the Distribution Area field.
        
   • The License Option selection displayed in the user interface for a RM image will look like the following.
     
     
      
   • The Start Date drop down lists are added by the system to allow users to select the starting date of the license use.
     
      
2. Use the License Manager to set pricing for the license options (Ent. Version)
   This feature only applies to the Ent. version. The License Manager section relies on the License Data section. If you have not configured and input the License Data Options in the License Data section, please do so before using this section. Once you have configured the license options in the license data section you can now add pricing to the options. In this example we will add a pricing value of $ 0.00, for demonstration purposes. You can add your own values as required.
    
   • Click on the License Manager License Manager link in the main menu.
   • Stockbox will display all the license data options that are in the Main (TOP) level.
   • Price the target license tree.
   • Click the Submit button to submit the license price.
   • You are only able to browse to its sub-option when its price is $0.00 or greater than $0.00.
     
     Note: If a sub-option does not apply to the parent option then 0.00 should be entered for the "None" value.
     
     
     
     
      
   • Once the Main level options have be priced (with at least a $ 0 value), the sub level options can be priced by clicking on the main option. For this example we will follow the Advertising option and price the sub-options (by clicking on the Advertising link in the screen above).
     
     
     
      
   • After clicking on the Consumer Magazine link in the screen above, further options are displayed (see below).
     
     
     
      
   • The screen below is displayed after clicking on the Double Page link. This is the end of the tree as there are no more options relying on the Double Page option level.
     
     
      
   • The license price is calculated when customers select all the data in the license tree that you created.
      
   • The Price is the total price of the tree that the customer selected.
     
      
3. Set Media License Type
   By default all uploaded media has the media license type set to N/A. You will need to set the media license type to Rights Managed for media that will use the Media License Manager feature.
    
   • To set the Media License Type individually:
      
     • Click on the Media Manager Media Manager link in the main menu.
     • Browse to the target category.
     • Click on the icon to edit the target media.
     • Enter all information into the provided text fields.
     • Select the Rights Managed option in the Media License Type drop down list.
     • Click the Submit button to set the License Type to this selected Media.
     • Continue for other media as required.
       
       
        
   • To set the Media License Type for an entire category:
     Stockbox also allows you to set the License Type for all media in the target category at once using the Global Update function in the Media Manager section.
      
     • Click on the Media Manager Media Manager link in the main menu.
     • Browse to the target category.
     • Click on the icon.
     • Click on the Rights Managed in the drop down list.
     • Click the Submit button to set all media of the target category to the selected Media License Type.
       
       
       
       
       
4. Import License Data
   Using this feature, you can import an existing license to the Stockbox system. Before importing license data to the system, you must ensure that your data is a valid MySQL query (.sql file format) and you should also backup your current database data before proceeding. The import file must only contain three tables, vss_license_data, vss_license_levels, and vss_license_price. The system will empty data from the existing license tables and replace it with the new data values.
   
   
   
   
   To import the license data, click on the Browse button to browse to your local .sql file and click on the SUBMIT button. The system will empty the above tables from the database and import new data from the file selected.
   
   
   
5. Adjust License Price
   With this feature you can adjust the current pricing of an existing license tree. The system will add or subtract the adjustment amount to the existing configured pricing according to the options below. The adjustments will be reflected in the gallery when a customer makes a purchase using the RM pricing calculator.
   
   
   
   Select the Pricing Adjustment Calculation Method in the drop down list. There are two methods available. If the Addition option is selected then system will add the Adjustment Amount to the current price of the license tree, otherwise the system will subtract it from the current price.
   
   Enter the Adjustment Amount and select either the "Fixed" or "Percent" option in the drop down list.
   
   e.g.
   Selected License Price is: $100
   the License Adjustment was configured as follows
   - Addition
   - 10
   - Percentage
   Then the new displayed price would be as follows
   Adjustment Price is 100 * 0.1 = 10
   the new price is 100 + 10 = $110.
   
   
   
6. Quote Request Logs
   The Quote Request Logs section will display all user license requests that have been submitted from the gallery. To delete a particular license, simply click on the Delete icon.
   
   
7. License Configuration
   
   
   • Don't Display Rights-Managed Pricing Calculator
     When this option is enabled, the system will remove the license selection and "Add to Cart" button from the rights-managed media detail page. Users won't be able to make license selections or purchase this media from the gallery.
   • Enable License Selection in media "Request a Quote"
     When this option is enabled, the system will display the license selection on the Request a Quote page in the gallery. Users are able to select the license from the drop down list before sending their request. The request will be logged in the database and you can view the user license request history in the Quote Request Logs section.
   
   
    

1. Click on the Promotions link in the main menu.
   
   
    
2. Enter the Promotion Code in the promotion code field. The system will only apply the discount to the purchase if the Promotion Code is a match (it is not case sensitive).
3. Enter the Promotion Value. This is the amount that you want to give as a promotion (discount), if the code entered by the customer is verified by the system. Select if you want the Promotion to be an Exact Value or a % of Net Value (total before tax and shipping).
4. Enter the Promotion Net Value. The Net Value will be used to determine if the promotion code can be used for this purchase (minimum order total to qualify for the promotion). Stockbox will only apply the discount to the purchase if the customer's purchase is greater than or equal to the Promotion Net Value.
5. Enter the Maximum number of Uses for this promotion. The system will only allow a user to use this promotion until the maximum value is reached.
6. Select Auto Promotion
   If Yes is selected, Stockbox will apply the promotion code automatically if the conditions set above are met. The customer does not have to input a code, but you will need to input a code when creating the promotion code so that the system can track when it is used.
   If No is selected, the customers will need to enter the promotion code during the checkout process to have the discount applied to their purchase.
7. Enter the Start Date by clicking on the icon. Select the Month and Year from the dropdown menus and select a date from the calendar to complete the selection. The Promo. Code will not be active before this date.
8. Enter the Expiry Date by clicking on the icon. Select the Month and Year from the dropdown menus and select a date from the calendar to complete the selection. The Promo. Code will not be active after this date.
9. Click the Submit button to add the new promotion code.
   
   e.g.: You enter:
   Promotion code: XYZ123
   Promotion value: 25 You also need to select the promotion method in the dropdown list (Exact Value).
   Promotion net value: 125
   Auto promotion: No
   In this example the system will only deduct the promotion value from the customer's purchase if they purchase at least $125 (before tax and shipping). The promotion value is calculated based on the selected promotion method. If the promotion method is "Exact Value", the system will deduct the exact value entered in the promotion value field. Otherwise the promotion value will be calculated based on the specified percentage of the net value.
   
   100% Discounts to offer FREE products or downloads
   You can create a discount of 100% which will allow customers to download files for free, or you can allow them to download now and invoice them later.
    

Promotion Configuration:

• Enable Promotion Code
  Tick this checkbox to enable the promotion code feature in your gallery.
• Enable Multiple Promotion Codes on the same Purchase
  Users are able to use multiple promotion codes for the same order when this option is enabled.

1. Disable Shipping Feature
2. Use the Single Item Shipping Method.
3. Use the Flat Rate Shipping Method.
4. Use the Flat Rate Zone Shipping Method (Pro. & Ent versions).
5. Use the Product Type Shipping Method (Pro. & Ent versions).

Configuration
Before configuring the shipping cost for your gallery you need to tell the system which shipping method you are going to use. Use this function to set the shipping method for your gallery.
 

• Click on the Shipping Manager Configuration link in the main menu.
  
  
   
• Shipping Method
  The shipping method is the method that the system will use for all orders.
   
• To change the Shipping Method select the method in the Shipping Method drop down list and click the SAVE button.
   

1. Disable Shipping Feature
   If you don't offer any products that require shipping, you can select this option in the Shipping configuration section. Stockbox will not charge shipping on any purchases.
   
   
2. Use Single Item Shipping Method
   If you want to charge a shipping cost based on each individual media purchased then this option should used.
   
   Note: You need to enable the Single Item Shipping Method setting in the Shipping Configuration in order for this function to work.
    
   • Click on the Media Manager Media Manager link in the main menu.
   • Browse to the category that contains the desired media.
   • Click on the icon to edit the media's properties.
     
     
      
   • Enter the Shipping value.
   • Enter Additional Item Shipping value.
   • Click Submit to set the shipping cost for this media.
   • The Additional Item Shipping Cost value is only applied on the second and subsequent item for this media. e.g. a customer adds 3 of the same media to their shopping cart where the Shipping Cost and Additional Shipping Cost are $5 and $3 respectively. Stockbox will calculate the shipping cost as follows:
     Total Shipping Cost = 5 + (3-1)*3 = $11.00
     
     
     
      
3. Use Flat Rate Shipping Method
   The flat rate shipping manager section allows you to set a flat rate for shipping cost based on the total amount of the customer's order before tax is added, instead of assigning individual shipping values in the media manager.
   
   Note: You need to enable the Flat Rate Shipping Method setting in the Shipping Configuration page in order for this function to work.
   
   
   • Click on the Shipping Manager Flat Rate Shipping link in the main menu.
   • Enter a Price From value.
   • Enter a Price To value.
   • Enter a Shipping Cost for this range.
   • Click the Add button, to add the new flat rate shipping range.
   • To remove a range, click on the icon.
     
     You can create as many ranges as necessary. Stockbox charges customers based on the purchase total before tax.
     
     e.g. You create the flat rate shipping as follows:
     The Price From and Price To are $0.00 and $49.99 respectively with a shipping Cost of $10.00.
     The $10.00 will only be applied if the customer purchases items that total between the $0.00 - $49.99.
     
     
     
      
4. Use Flat Rate Zone Shipping Method (Pro. & Ent. versions)
   The zone shipping is similar to the flat rate shipping method except it allows you to set different shipping costs for different geographical zones. Customers need to select their shipping zone during the checkout process. The cost is calculated based on customers zone selection.
   
   Note: You need to enable the Flat Rate Zone Shipping Method setting in the Shipping Configuration page in order for this function to work.
    
   • Click on the Shipping Manager Zone Shipping link in the main menu.
     
     
      
   • Zone name
     The zone name must be unique for every zone. It should not contain any invalid characters or spaces.
   • Zone Label
     Using this field to describe this zone. The system will use this label to display to users for selection.
   • Click Add button to add the new zone .
   • Click on the icon to edit an existing shipping zone.
   • Click on the icon to delete an existing shipping zone.
   • Click on the icon to set the cost for the target zone.
     
     
     Zone Configuration
      
   • Click on the icon to launch the Shipping Zone Configuration page.
     
     
      
   • Enter a Price From value.
   • Enter a Price To value.
   • Enter a Shipping Cost for this range.
   • Click the Add button to add the new flat rate shipping range.
   • To remove a range, click on the icon.
     
     
     If you have correctly configured the shipping zone, the system will display the available zone options in a drop down menu on the shopping cart page.
     
     
     
      
5. Use Product Type Shipping Method
   The Product Type Shipping Method allows you to charge the shipping cost based on a Product Type. You should have at least one Product Type existing in the database in order to use this feature.
   
   Note: You need to enable the Product Type Shipping Method setting in the Shipping Configuration page in order for this function to work.
   
   
   • Click on the Product Manager Product Types link in the main menu.
   • Click on the icon to edit an existing Product Type (or you can add a new one if needed).
   • Enter the Base Price for this product type.
   • Enter the Base Credit value for this product type.
   • If you want to disable Tax on this product type tick the Disable Tax checkbox.
   • Enter the Shipping Cost for this product type.
   • Enter the Additional Shipping Cost for this product type. The Additional Shipping Cost is only applied on the second and subsequent items with the same product type.
     
     
     
      

1. Sales Tax (added) Method - this method applies an additional amount of tax to the order total.
2. Sales Tax (included) Method  (VAT system) - this method includes the tax amount in the order total.

1. Configuration
   Use this configuration section to tell the system which tax method it should use in the gallery.
    
   • Click on the Tax Manager Configuration link in the main menu.
     
     
      
   • Enable Apply Tax on Shipping (Pro. & Ent. versions)
     When this option is enabled, the system will also apply tax on the Shipping Cost as well as the Product cost.
      
   • Tax Calculation Method
     The Tax Method is the method that Stockbox uses to tax customers. There are three options available:
      
     1. Disable Tax System
        The system will not tax any order if this option is selected.
     2. Use Sales Tax (added) Method
        The system will tax customers based on the total purchase amount and the settings that you configured in the Use Sales Tax (added) section.
     3. Use Sales Tax (included)  Method (VAT system)
        The system will separate the already included tax from the sub total. The amount that is calculated is based on the settings that you have configured in the Sales Tax (included) manager section.
         
     Select the desired method in the Tax Calculation Method drop down list and click the SAVE button.
     
      

2. Sales Tax (added) Method
   You need to choose the "Use Sales Tax (added) Method" method in the Tax Configuration section for this function to work.
    

   • Click on the Tax Manager Sales Tax (added) link in the main menu.
     
     
      
   • If you don't see any values in the first drop down list (firstname), please see the Registration Form section to configure the form.
   • Select the value in the first drop down list.
   • Select the value in the second drop down list (operand).
   • Enter the value that will be matched to the customer's entered value. The system will only work correctly if the value is an exact match. We recommend that you should use a drop down type for this form field, so that customers are only able to select the value that you have entered here, instead of entering their data into a field.
   • Enter the tax percentage value.
   • Click the ADD button to add the more tax criteria.

   e.g. Assuming that you want to charge the customers who are in the State of Illinois (IL) 8.5%, all other states 5% and outside of the United States 0% then do the following. We assume you have the State and Country fields setup in the Registration Form section.

   Creating IL State Tax

   1. Select the State in the first drop down list.
   2. Select Equal in the second drop down list.
   3. Enter IL to the third text box field. We assume that IL is in the State drop down list that you initially entered when creating the registration form.
   4. Enter 8.5 to the Then Charge field.
   5. Click the ADD button.

   Creating Other State's Tax

   1. Select the State in the first drop down list.
   2. Select Not Equal in the second drop down list.
   3. Enter IL in the third field text box.
   4. Enter 5 to the Then Charge field.
   5. Click the ADD button.

   Creating Other Countries Tax (Outside US)

   1. Select Country in the first drop down list (We assume that you have the country drop down field in the registration form).
   2. Select Not Equal in the second drop down list.
   3. Enter USA in the third field text box (We assume that the USA value is in the Country drop down list that you initially entered when creating the registration form).
   4. Enter 0 to the Then Charge field.
   5. Click the ADD button.
       
   The above configuration will charge any customers who's State is IL 8.5%, all other states 5% and 0% for any customers who's country is outside of the United States.
   
    
3. Sales Tax (included) Method (VAT system)
   VAT is similar to the Sales Tax (added) method, but instead of adding sales tax to the sub total, the system will separate the already included tax from the sub total. The system uses the following formula to calculate the VAT.
   
   Total Tax = A1 – A1 / (100% + A2)
   A1 = order sub total cost
   A2 = tax percentage
   
   e.g.
   A1 = $100
   A2 = 8.5 %
   Total tax = 100 – 100 / (100% + 0.085) = 100 - 100 (1 + 0.085) = $7.83
   
   The Sales Tax (included) Method uses the same configuration function as described above in the Sales Tax Manager configuration section.
   
    

1. PayPal & PayPal Pro Gateway (US & International)
2. 2Checkout Gateway (US & International)
3. SagePay (Protx) - VSP Form & Direct Gateway (UK Based Company)
4. Skipjack Gateway (US Based Company)
5. VeriSign Payflow Link Gateway (US Based Company)
6. WestPac Gateway (AU Based Company)
7. WorldPay Gateway (UK & International)
8. PayGate Gateway (South African Based Company)
9. Paystation Gateway (New Zealand Based Company)
10. Przelewy Gateway (Polish Based Company)
11. Webstream Gateway (US Based Company)
12. Echo Gateway (US Based Company)
13. Concord Gateway (US Based Company)
14. LinkPoint Gateway (US Based Company)
15. Authorize.Net Gateway (US Based Company)
16. Payment Express Gateway (NZ Based Company)
17. ANZ Egate Gateway (Australian Based Company)
18. eProcessing Network Gateway (US Based Company)
19. WTC PayEx Gateway (Scandinavian based Company)
20. Beanstream Gateway (Canadian Based Company)
21. Chase Paymentech (US Based Company)
22. Moneris (Canadian Based Company)
23. Secure Hosting (UK Based Company)
24. eWay (Australian, NZ and UK based Company)
25. Suomen Verkkomaksut Oy (Finnish based Company)
26. Click and Buy (International)
27. ePDQ (UK Based Company)
28. Moneybookers (International)
29. Google Checkout (US and UK Based Company)
30. Robokassa (Russian Based Company)
31. Netbanx (UK Based Company)
32. cajAstur (Spanish Based Company)
33. Offline Processing (For Manual Offline Processing)
    

• PayPal Gateway
• 2Checkout Gateway
• Protx - VSP Form
• VeriSign Payflow Link Gateway
• Skipjack Gateway
• WorldPay Gateway
• WestPac Gateway
• PayGate Gateway
• Paystation Gateway
• Przelewy Gateway
• Webstream Gateway
• ANZ Egate Gateway
• Secure Hosting
• Suomen Verkkomaksut Oy
• Click and Buy
• ePDQ
• Moneybookers
• Google Checkout
• Robokassa
• Netbanx
• cajAstur

• PayPal Pro
• Concord Gateway
• LinkPoint Gateway
• Protx VSP Direct Gateway
• Echo Gateway
• Authorize Net Gateway
• Payment Express Gateway
• eProcessing Gateway
• WTC PayEx Gateway
• Beanstream Gateway
• Chase Paymentech
• Moneris
• eWay
• Offline Processing

Below are a few companies that offer SSL certificates.

• http://www.geotrust.com
• http://www.verisign.com
• http://www.thawte.com

Payment Gateway Configuration

• Click on the Payment Gateways link in the main menu.
  
  
   
• Tick all the gateways that you wish to use for payment processing (you will need to setup an account with each one that you wish to use). Stockbox will display these selections for customers to choose from on the checkout confirmation page.
• Tick the Payment Required checkbox. If this checkbox is not checked, then instead of being taken to the payment processor, the customer will be taken upon checkout directly to their "My Account" area. If they have ordered an instant download product, this is where it will be made available for download. If you want to offer ALL of your products and/or downloads for FREE, then you should leave this box un-checked.
• Enter the Minimum Order Amount. Stockbox will only process the order if the total meets the Minimum Order Amount. Otherwise the customer will be prompted to continue shopping.
• Enter the Order Description for the purchase. Stockbox sends the Order Description to the payment processor.
• Click the Submit button to save the configuration.
   
• Click on the icon to edit the configuration for the target gateway.
• To view details of how to set up each payment gateway click on the icon in each of the payment gateway configuration sections.

Once the payment processor receives the payment from the customer, the processor writes back to the Stockbox system confirming that the payment was received. This updates the status in real time of the order in the admin area from Pending to Completed and the customer will be re-directed to their "My Account" area. Here, the customer will see a summary of their transaction and they can print a copy of their invoice (Pro. & Ent. versions). If their purchase included an instant download product, then they will be able to download their order using the link provided.


 

TEMPLATE CUSTOMIZATION
The look and feel of the gallery is highly customizable by editing the set of html templates and CSS listed below. Any html editor can be used for this purpose, e.g. Dreamweaver©, Microsoft Expression© etc. It is suggested that you make a copy of the templates in a temporary folder before editing. That way, you will be able to experiment with modifications without worrying about "loosing" 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 dynamic "call tags" and they can be moved within the template or deleted as desired. Please note that if you remove a call tag from a particular template, the feature related to that template will not be available in your gallery.

We can also provide an affordable solution to match the look and feel of the gallery to your existing website or create a new look and feel based on your specified requirements. To receive a quotation, please forward your design requirements via the Help Desk and we will respond accordingly.

Below are some items that are required by the system.

• Predefined call tags
  You should not remove the predefined call tags from the templates unless you wish to remove the dynamic feature produced by the tag. You should exercise caution when removing tags, as you could remove features that will adversely affect the way the gallery functions. The tags are predefined variables surrounded by square brackets, e.g. [GALLERY]. Stockbox will replace these tags with dynamic content created by the system.
• JavaScript
  You must not remove any JavaScript that is included in the templates after the installation. The system will not work if the JavaScript is removed.
• CSS
  You should not remove any CSS tags that are in the templates unless you have experience in creating and calling your own CSS.

There are two template directories that Stockbox uses. Gallery Templates in the template folder and Smarty Templates in the tpl folder. If you can't find any particular template below in your Template Section, it means that your version doesn't use this template.

Before outputting the gallery contents to the user's browser, the system processes the data from the MySQL database and inserts it into the smarty templates. Then, the predefined call tags in the main gallery templates are replaced with the Smarty template output. Modifying "Smarty Templates" requires knowledge of the Smarty Engine. if you're not familiar with "Smarty Template System", we suggest that you should use system's default smarty template set.

• Gallery Templates
  All gallery templates are located in the “template” directory. You can modify these html templates via the Template Manager section of the admin control panel or by editing in any html editor such as Dreamweaver©. These templates contain predefined call tags that are described below.
   
  1. 404.tpl (Pro. & Ent. versions)
     This template is be used when users are trying to access a page that is does not exist in the system. The system will return a 404 " page not found" error before displaying this page to the user's browser. There are no predefined call tags available in this template.
      
  2. activate_email.txt
     The system will use this template for the activation email that is sent to end-users if the “Enable New Account Email Validation” option is checked in the General Configuration. There are three predefined tags in this template. The system uses a plain text format for this template, no HTML code is allowed.
      
     • [USERNAME]
       The system will replace this call tag with end user's username.
       
     • [ACTIVATE_CODE]
       The system will replace this call tag with the activation code. The activation code is generated by the system and the customer needs to input this code when validating their email address. If the code is valid, then the system will activate their account (Active status), otherwise it will not be activated.
     • [LINK]
       The system will replace this call tag with an activation link that allows users to click on it to validate their email address.
        
  3. agreement.tpl
     When you enable the “Enable Agreement Checkbox” in the General Configuration section, this template will be used to display your agreement details. You will need to input your site agreement (terms etc.) to this template and it's contents will display on the customer's registration form. No predefined tags are available for this template.
      
  4. category.tpl
     This template is used to display each media category. There are four predefined tags in this template.
      
     • [DISPLAYNAME]
       The system will replace this call tag with the category display name (if one is entered) or the system name by default.
     • [CATEGORYDETAIL]
       The system will replace this call tag with the category media count.
     • [LASTMODIFIED]
       The system will replace this call tag with the date of last modification.
     • [DESCRIPTION]
       The system will replace this call tag with the category description.
        
  5. category_template_sample.tpl (Pro. & Ent versions)
     This template is sample template for the Category Template feature.
     
     
  6. cb.css
     This file is used to control the dynamic content and layout of photographers area. By default, the photographer_home.tpl uses this style sheet for its layout style. There are a few ways to detect the CSS Style. The basic way is to view the page source, then find the "class" that applies to the tag you are looking for. The second way is using the Web Developer add-on for Firefox. You can install it here: https://addons.mozilla.org/en-US/firefox/addon/60. After installing this add-on, you can click on CSS View Style Information (or press Ctrl+Shift+Y) and then select the part that you want to view CSS style information for.
     
     
  7. checkout_agreement.tpl
     This template is used when users click on the "I have read and agree to the terms and conditions specified in this agreement" link on the shopping cart page. To enable this option you need to enable the "Enable License Agreement Checkbox on Shopping Cart Page" option in the General Configuration.
     
     
  8. confirm.tpl
     This template is used on the last checkout page. You can use this template to tell customers what they should expect after their purchase. There are no predefined tags for this template.
      
  9. contact_mail.tpl
     The system uses this template to create the email message when customers submit messages via the contact form on the Contact Us page. There are five predefined tags for this template.
      
     • [FIRSTNAME]
       The system replaces this call tag with the customer's input data for the first_name field on the contact form.
     • [LASTNAME]
       The system replaces this call tag with the customer's input data for the last_name field on the contact form.
     • [PHONE]
       The system replaces this call tag with the customer's input data for the phone field on the contact form.
     • [EMAIL]
       The system replaces this call tag with the customer's input data for the email field on the contact form.
     • [COMMENTS]
       The system replaces this call tag with the customer's input data for the comments field on the contact form.
        
  10. featured_category.tpl (Ent. version)
      The system uses this template for the home page in the featured category section. There is one predefined call-tag [CATEGORY_ICON] and the system will replace this call tag with the featured category thumbnail.
      
      
  11. gallery.css
      This file is used to control the dynamic content and layout of your gallery. By default, the gallery.tpl template uses this style sheet for its layout style. There are a few ways to detect the CSS Style. The basic way is to view the page source, then find the "class" that applies to the tag you are looking for. The second way is using the Web Developer add-on for Firefox. You can install it here: https://addons.mozilla.org/en-US/firefox/addon/60. After installing this add-on, you can click on CSS View Style Information (or press Ctrl+Shift+Y) and then select the part that you want to view CSS style information for.
      
      
  12. gallery.tpl
      Most pages in the gallery utilize this template for its content, except the Home page (Ent. version), Portfolio (Ent. version), and all static pages. "Static Pages" are those is in the Templates & CM Static Content Manager section. There are seventeen predefined call tags for this template.
      
      
      • [PAYMENTMETHOD_LINK] (Ent. version)
        The system will replace this call tag with the Payment Method link when the gallery is displayed. The contents of "Payment Method" link is in the "./tpl/english/others/user_switch_payment_method.tpl" template. This feature allows customers to switch the payment methods used to make purchases.
      • [PREVIEW_TOGGLE] (Pro. & Ent. versions)
        The system will replace this call tag with the Quick Preview Toggle Link when the gallery is displayed. The contents of "Quick Preview Toggle" link is in the "./tpl/english/media_manager/preview_media_toggle_link.tpl" template.
      • [SHOPPINGCARTSTATS]
        The system will replace this call tag with the customer's shopping cart details. The contents of the "Shopping Cart Stats" is in the "./tpl/english/others/user_shopping_cart_stats.tpl" template.
      • [KEYWORDSEARCH]
        The system will replace this call tag with the Quick Search form when the gallery is displayed. The contents of the "Quick Search" form is in the template "./tpl/tpl/english/others/user_quick_search_form.tpl" template.
      • [ADVANCED_SEARCH_LINK] (Pro. & Ent versions)
        The system will replace this call tag with the Advanced Search link when the gallery is displayed. The contents of the "Advanced Search" link form is in the template "./tpl/english/user_advanced_search_link.tpl" template.
      • [PRIVATE_LOGIN] (Pro. & Ent. versions)
        The system will replace this call tag with the Private Login link when the gallery is displayed. The contents of the "Private Login" link is in the "tpl/english/others/private_login.tpl" template.
      • [PHOTOGRAPHER_LOGIN] (Pro. & Ent. versions)
        The system will replace this call tag with the Photographer Login link when the gallery is displayed. The contents of the "Photographer Login" link is in the "tpl/english/others/photographer_login.tpl" template.
      • [CATEGORYDROPDOWN]
        The system will replace this call tag with the gallery categories. There are two display options for the gallery categories.
         
        1. Drop Down List Style
           The system displays the gallery categories in an drop down list.
        2. Listing Style
           The system displays the gallery categories in a listing style.
        3. Category Smarty Template
           The contents of "Category Listing" is in the "./tpl/english/others/user_main_cat.tpl" and "tpl/english/others/user_sub_categories.tpl" templates.
           
           
      • [FEATURED_MEDIA_RSS] (Pro. & Ent. versions)
        The system will replace this call tag with the Featured Media RSS Icon when the gallery is displayed. The contents for the "Featured Media" RSS link is in the "tpl/english/rss/user_featured_media_rss.tpl" template.
      • [FEATUREDMEDIA] (Pro. & Ent. versions)
        The system will replace this call tag with the gallery featured media. You can change the number of featured media that are displayed in this area by changing the "Featured Media Display Number" in the Media Configuration section. You can also change the setting to have the featured media displayed vertically in a column or horizontally in a row. The contents of the "Featured Media" is in the "./tpl/english/others/user_featured_media.tpl" template.
      • [VIRTUAL_CD_RSS] (Ent. version)
        The system will replace this call tag with the Virtual CD RSS link when the gallery is displayed. The contents for the "Virtual CD RSS" link is in the "tpl/english/rss/user_featured_virtual_cd_rss.tpl" template.
      • [VIRTUAL_CD] (Ent. version)
        The system will replace this call tag with the "Virtual CD" products when the gallery is displayed. The contents of the "Virtual CD" products is in the "tpl/english/others/user_featured_virtual_cd.tpl" template.
      • [PORTFOLIO] (Ent. version)
        The system will replace this call tag with all featured portfolios when gallery is displayed. The contents for each "Featured Portfolio" is in the "template/english/portfolio_thumbnail.tpl" template.
      • [PHOTOGRAPHER_LISTING_RSS] (Ent. version)
        The system will replace this call tag with the Photographer RSS link when gallery is displayed. The contents of the "Photographer RSS" link is in the "tpl/english/rss/user_photographer_list_rss.tpl" template.
      • [PHOTOGRAPHER] (Ent. version)
        The system will replace this call tag with the "Featured Photographer Listing" when the gallery is displayed. The contents of the "Featured Photographer Listing" is in the "./tpl/english/others/user_photographer_list.tpl" template.
      • [PREDEFINDED_KEYWORD] (Ent. version)
        The system will replace this call tag all of the predefined keywords that are entered in the Search Manager Pre-defined Keywords section.
      • [GALLERY]
        This is a main call tag of the gallery contents and it can't be removed from the template. The system will replace this call tag with the dynamic gallery data.
        
        
        
  13. home.tpl (Ent. version)
      This template is used for the home page. By default, there are ten call tags for this template, but you can include other call tags that are defined in the gallery.tpl template above.
      
      
      • [BANNER]
        The system will replace this call tag with the Active Banner Images in the Banner module.
      • [LATEST_NEWS]
        The system will replace this call tag with the latest news contents. The latest news contents is in the "template/english/latest_news.tpl" template.
      • [MOST_POPULAR]
        The system will replace this call tag with the most popular media thumbnail. The most popular media feature is configurable in the Media Configuration section.
      • [NEW_ADDITIONS]
        The system will replace this call tag with the new additions media thumbnail. The new additions feature is configurable in the Media Configuration section.
      • [FEATURED_CATEGORY]
        The system will replace this call tag with four randomly featured categories. The Featured Category status is changeable in the Media Manager section.
      • [KEYWORDSEARCH]
        The system will replace this call tag with the Quick Search form when the gallery is displayed. The contents of the "Quick Search" form is in the template "./tpl/tpl/english/others/user_quick_search_form.tpl" template.
      • [ADVANCED_SEARCH_LINK] (Pro. & Ent versions)
        The system will replace this call tag with the Advanced Search link when the gallery is displayed. The contents of the "Advanced Search" link form is in the template "./tpl/english/user_advanced_search_link.tpl" template.
      • [PRIVATE_LOGIN] (Pro. & Ent. versions)
        The system will replace this call tag with the Private Login link when the gallery is displayed. The contents of the "Private Login" link is in the "tpl/english/others/private_login.tpl" template.
      • [PHOTOGRAPHER_LOGIN] (Pro. & Ent. versions)
        The system will replace this call tag with the Photographer Login link when the gallery is displayed. The contents of the "Photographer Login" link is in the "tpl/english/others/photographer_login.tpl" template.
      • [VIRTUAL_CD] (Ent. version)
        The system will replace this call tag with the "Virtual CD" products when the gallery is displayed. The contents of the "Virtual CD" products is in the "tpl/english/others/user_featured_virtual_cd.tpl" template.
      • Other call tags please see the gallery.tpl template above.
        
      
      
      
  14. invoice.tpl (Pro. & Ent. versions)
      This template is used when customers want to view or print an order invoice. Also, the system uses this template to send an order invoice to customer and administrator when the “Enable Notification Invoice Email” option is enabled on in the General Configuration. There is only one predefined tag for this template.
       
      • [INVOICE]
        The system will replace this call tag with the order invoice.

      Note: If you add images to this template, make sure that you use the absolute path to the image file. e.g. src="http://www.your-domain.com/images/admin/english/logo.jpg" or you should include the [URL] tag in the path to the image file. e.g. src="[URL]/images/admin/english/logo.jpg".
      
      

  15. latest_news.tpl
      This template is used in the Latest News section on the home page. There are two call tags for this template.
      [TITLE]: Latest new title.
      [SHORT_CONTENTS]: Latest News short contents.
      The latest news feature is configurable in the News Manager section.
      
      
  16. main.tpl
      This is the main gallery template and anything that you change or add to this page will display on every page in the gallery
      
      You MUST NOT REMOVE the following javascript and CSS calls from the template code
      

      <title>[SEO_TITLE]</title>
      <meta name="description" content="[SEO_META_DESCRIPTION]" />
      <meta name="keywords" content="[SEO_META_KEYWORDS]" />
      <meta http-equiv="author" content="Stockbox Photo (TM) Gallery Software - www.stockboxphoto.com - Do not remove this line" />
      <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
      <meta http-equiv="imagetoolbar" content="no" />
      <script language="javascript" type="text/javascript">
      var $self = "[URL]";
      var $language = "[LANGUAGE_DIR]";
      </script>
      <script language="javascript" src="scripts/scripts.js" type="text/javascript"></script>
      <link rel="stylesheet" href="template/english/gallery.css" type="text/css" />

      The [SEO_TITLE], [SEO_META_DESCRIPTION] and [SEO_META_KEYWORDS tags will be replaced by the default meta tags. You can change the default meta tags in the "Meta Tag Default Configuration" section of the General Configuration.

      • [LANGUAGE] (Ent. version)
        The system will replace this call tag with the language selector feature, if your site supports more than a language. The contents of the "Language Selector" is in the "./tpl/english/language/user_select_language.tpl" template.
      • [MEMBERACCOUNT]
        The system will replace this call tag with the visitor's account welcome message when the gallery is displayed. The contents of the "Member Information" form is in the template "./tpl/english/media_manager/user_member_account_info.tpl" template.
      • [PRIVATE_LOGOUT]
        The system will replace this call tag with the Private Gallery Logout when one has logged in the private gallery. The contents for the private gallery login link is in the tpl/english/others/private_logout.tpl template.
         
      • [MENU]
        The system will replace this call tag with the gallery navigation menu buttons or drop down menu. You can replace the included menu buttons with your own using the " Nav. Menu Manager" feature or by uploading new image files to the images directory, while maintaining the same file names (these new files will overwrite the existing files). With the Pro. & Ent. versions you can also use the Templates & CM Static Content Manager to add extra content pages to your gallery. When adding a new page, the system will also add a button to the gallery navigation menu. If you have the Std. version or if you wish to add buttons or links to the menu that link to pages outside of the Stockbox system, you will need to remove the [MENU] call tag and replace the dynamic menu with a static menu of your own. You will have to use the same URL paths (see below) that are currently being used for the existing dynamic menu.
         
        1. <a href="index.php" > Home</a>
        2. <a href="index.php?module=media&pId=101" > New Media</a>
        3. <a href="index.php?module=lightbox&pId=100" > Lightbox</a>
        4. <a href="index.php?module=product_type&pId=100">Products</a>
        5. <a href="index.php?module=customer&pId=100" > My Account</a>
        6. <a href="index.php?module=basket&pId=100" > Shopping Cart</a>
        7. <a href="index.php?module=company&pId=100" > Ordering Info</a>
        8. <a href="index.php?module=company&pId=102" > Contact Us</a>
        9. <a href="index.php?module=company&pId=101" > About Us</a>
            
      • [BODY]
        This is a main call tag of the system contents and it can't be removed from the template. The system will replace this call tag with the dynamic gallery data.
      
      
      
  17. malicious_error.tpl (Ent. version)
      This template is used when the system detects input data containing malicious characters as defined in the in the Administrator Malicious Characters section.
      
      
  18. media.tpl
      This template is used to display the thumbnail image for each display image. There are six predefined tags for this template.
       
      • [FILENAME]
        The system will replace this call tag with the media thumbnail image.
      • [DISPLAYNAME]
        The system will replace this call tag with the file system name or display name (whichever is present).
      • [LIGHTBOX]
        The system will replace this call tag with the "Add Lightbox" or "Remove Lightbox" icon.
      • [LINK]
        The system will replace this call tag with the "Get Link" Icon. The contents of the "Get Link" icon is in the tpl/english/others/link.tpl.tpl template
      • [SHARE_LINK]
        The system will replace this call tag with the "Share Link" icon. The contents of the "Share Link" icon is in the tpl/english/others/user_share_link.tpl template
        
      • [ADDTOCART]
        The system will replace this call tag with the "Add to Cart" icon.
      • [LIGHTBOXCOMMENTS] (Pro. & Ent. versions)
        The system will replace this call tag with the "Add Media Comments" icon. This only applies on the lightbox page. The system will replace this tag with an empty string on the other pages.
      • [PRODUCTTYPE] (Pro. & Ent. versions)
        The system will replace this call tag with the available Product Types and the Add to Cart button on the Lightbox page if the "Enable "Add to Cart" Button in Lightbox" has been activated in the Lightbox Manager section. The system will only display the media product type if it has been assigned a price greater than zero.
      • Floating IPTC tags - Optional Call Tag - (Pro. & Ent. versions)
        This feature allows you to place the individual IPTC field calls anywhere on the template and in any order. For example if you wanted to display the Caption and Keywords only (in that order), then you will add the following to this template.
        
        Caption:       [caption]
        Keywords:  [keywords]

        Click here to see a list of available IPTC call tags.
         

  19. media_detail.tpl
      This template is used to display the media detail (enlarged display image) page.
       
      • [CATEGORY_BREADCRUMB_LINK]
        The system will replace this call tag with the category breadcrumb link. The contents for the category breadcrumb link is in the tpl/english/others/user_category_breadcrumb.tpl template
      • [RETURN_TO_THUMBNAIL_PAGE]
        The system will replace this call tag with the "Return To Thumbnail" Icon. The contents for "Return to Thumbnail Page" is in the tpl/english/media_manager/user_return_thumbnail.tpl template.
      • [GOOGLE_MAP_URL] (Ent. version)
        The system will replace this call tag with the "Google Map" Icon. The contents for the "Google Map" icon is in the tpl/english/others/user_google_map.tpl template. This icon is only available when image has a value in the "Google Map URL" in the Media Properties.
      • [SENDTOFRIEND]
        The system will replace this call tag with the "Send to Friend" icon. When customers click on this icon, the system will display the "SEND TO A FRIEND" form to allow customers to send the selected media to their friends.
      • [SENDREQUEST] (Ent. version)
        The system will replace this call tag with the "Request a Quote" icon. When customers click on this icon, the system will display the "REQUEST A QUOTE" form to allow customers to send a quote request to the Administrator.
      • [SAMPLEDOWNLOADLINK]  (Pro. & Ent. versions)
        The system will replace this call tag with a "Download Sample File" icon. The sample image download file must reside in the same location as the target display file. You need to name the sample download file as follows:
        media name:  media.jpg
        sample download file:  sample_media.jpg
        Note: If you use the batch upload feature in the Media Manager you can select to upload the "Sample Files" so that you do NOT have to prefix the files prior to uploading them as they will be automatically prefixed by the system. The system will only display the "Download Sample File" icon if it detects the sample download file on the server. If there is a sample download file, it allows customers to click on the download icon to download the sample media file. This feature can be used to offer "watermark free comp images".
      • [ZOOMIFY] (Pro. & Ent. versions)
        The system will replace this call tag with the Zoomify™ icon. The contents for Zoomify™ icon is in the tpl/english/others/user_zoomify_icon.tpl template. This icon is only available when a particular media has a Zoomify™ link attached to it. You can add a Zoomify™ link for your media in the Media Manager section.
      • [LIGHTBOX]
        The system will replace this call tag with the "Add Lightbox" or "Remove Lightbox" icon.
      • [LINK]
        The system will replace this call tag with the "Get Link" icon. The contents for "Get Link" icon is in the tpl/english/others/link.tpl.tpl template
      • [SHARE_LINK]
        The system will replace this call tag with the "Share Link" icon. The contents of the "Share Link" icon is in the tpl/english/others/user_share_link.tpl template
        
      • [FILENAME]
        The system will  replace this call tag with the enlarged display image.
      • [OTHER_PLAYERS] (Pro. & Ent. versions)
        The system will replace this call tag with a link to allow a user to view the current selected media with another media player if another has been configured in the Media Manager Media File Type section.
      • [PRODUCTTYPE]
        The system will replace this call tag with the available Product Types and the Add to Cart button.  The system will only display the media product type if it has been assigned a price greater than zero. You can use the Product Manager section to add or remove product types.
      • [REFERENCE_ID] (Pro. & Ent. versions)
        The system will replace this call tag with the media reference ID.
      • [DISPLAYNAME]
        The system will replace this call tag with the file system name or display name (whichever is present).
      • [AUTHOR]
        The system will replace this call tag with the media's author.
      • [COPYRIGHT]
        The system will replace this call tag with the media's copyright info.
      • [HIT]
        The system will replace this call tag with the number of hits (image views). You can edit this value in the Global Update section.
      • [LASTMODIFIED]
        The system will replace this call tag with the media's last modified date. Anytime you edit the media properties, the system will update the last modified date to the date it was edited.
      • [ADD_DATE]
        The system will replace this call tag with the date the media was added to the system.
      • [LICENSETYPE]  (Ent. version)
        The system will replace this call tag with the license type. The four available options are, Royalty Free, Rights Managed, Rights Managed with no Calculator or Royalty Free & Rights Managed.
      • [MEDIATYPE]  (Ent. version)
        The system will replace this call tag with the media type. The media type is changeable on the Media Properties page or the Global Update section.
      • [MEDIARELEASE] (Ent. version)
        The system will replace this call tag with the media release status. The media release status is changeable on the Media Properties page or the Global Update section.
        
      • [BLACK_WHITE] (Ent. version)
        The system will replace this call tag with the Black & White status of the media. The "Black & White" status is changeable on the Media Properties page or the Global Update section.
      • [MEDIAORIENTATION]  (Ent. version)
        The system will replace this call tag with the media orientation. The system will automatically determine if the image is either, Horizontal, Vertical, Square or Panorama, but the orientation is also changeable on the Media Properties page or the Global Update section.
      • [SOLD_NUM]  (Pro. & Ent. versions)
        The system will replace this call tag with the number of times an item from the particular media have been sold.
      • [DESCRIPTION]
        The system will replace this call tag with the media's description. The media description is changeable on the Media Properties page or the Global Update section.
      • [KEYWORD]  (Pro. & Ent. versions)
        The system will replace this call tag with the keywords section. The media keywords are changeable on the Media Properties page or the Global Update section.
      • [IPTC]  (Pro. & Ent. versions)
        The system will replace this call tag with the image's IPTC info. The display order is fixed, but individual fields can be turned on/off in the IPTC configuration section. You can also specify which fields will be searchable.
        
        Floating IPTC tags
        This is an alternative method to display the IPTC metadata. This feature allows you to place the individual IPTC field calls anywhere on the template and in any order. For example if you wanted to display the Caption and Keywords only (in that order), then you will add the following to this template.
        
        Caption:       [caption]
        Keywords:  [keywords]

        For this method, you will have to remove the [IPTC] call tag and replace it with the individual IPTC tags. The available call tags are listed below.
        
        [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]
         

  20. media_detail_with_tab.tpl (Pro. & Ent. versions)
      This template is similar to the media_detail.tpl but instead of displaying the IPTC metadata on the same page, the system will display the IPTC metadata on other tab. The call tags are the same as the media_detail.tpl template above. The system only uses this template when you enable this option in the Configuration Media section. You can use this template option to prevent the need to scroll down the page to view the IPTC metadata.
      
      
  21. media_preview.tpl (Pro. & Ent. versions)
      The system uses this template when customers "mouse over" a media thumbnail image. This feature needs to be enabled in the Configuration Media section.
       
      • [FILENAME]
        The system will  replace this call tag with the media preview image.
      • [DISPLAYNAME]
        The system will replace this call tag with the media display name or system name.
      • [AUTHOR]
        The system will replace this call tag with the media's author.
      • [COPYRIGHT]
        The system will replace this call tag with the media's copyright details.
      • [LICENSETYPE] (Ent. version)
        The system will replace this call tag with the license type, "Royalty Free", "Rights Managed", “Rights Managed with no Calculator” or "Royalty Free & Rights Managed".
      • [MEDIATYPE]  (Ent. version)
        The system will replace this call tag with the media type.
      • [HIT]
        The system will replace this call tag with the number of hits (image views).
      • [LASTMODIFIED]
        The system will replace this call tag with the media's last modified date.
      • [ADD_DATE]
        The system will replace this call tag with the date the media was added to the system.
      • [MEDIARELEASE] (Ent. version)
        The system will replace this call tag with the media's release status.
         
  22. mobile_order_notify.tpl  (Ent. version)
      The system uses this template to send a new order notification to the mobile phone email address that you input into the General Configuration. You can obtain the mobile phone email address through your service provider. The system will not use this template if a mobile email address is not detected. There are eight predefined tags for this template. The system uses plain text format for this template, therefore no HTML code is permitted.
       
      • [ORDER_ID]
        The system will replace this call tag with the new order id. The order id is generated when customers checkout their orders.
      • [CUSTOMER_USERNAME]
        The system will replace this call tag with the customer's username.
      • [SUB_TOTAL]
        The system will replace this call tag with the order's sub total.
      • [TAX]
        The system will replace this call tag with the amount of tax calculated for the order.
      • [SHIPPING]
        The system will replace this call tag with the order's shipping cost.
      • [PROMOTION]
        The system will replace this call tag with the promotion value that was applied to the order.
      • [GRAND_TOTAL]
        The system will replace this call tag with the order's grand total.
      • [PURCHASED_DATE]
        The system will replace this call tag the date that the order was created.
         
  23. news.tpl (Ent. version)
      This template is used for each news item on the News page.
      [TITLE]: The system will replace this call tag with the news title.
      [SHORT_CONTENTS]: The system will replace this call tag with the news short contents.
      
      
  24. news_details.tpl (Ent. version)
      This template is used for News Detail page.
      [TITLE]: The system will replace this call tag with the selected news title.
      [CONTENTS]: The system will replace this call tag with the selected news contents.
      
      
  25. notify.tpl
      If the “Notify me when someone signs up” is enabled in the General Configuration, the system will use this template to notify you when customers submit their new registration details to your server. This template can be configured differently depending on the information that you want collect from the customer. The system uses html format for this template.
      e.g. If you add a field name 'fax' to the registration form, then you will need to add the [fax] call tag to this template. Stockbox will replace this call tag with the customer's fax number.
       
  26. password_email.txt
      The system uses this template when customers are requesting to “Recover a lost password”.  There are two predefined call tags for this template. The system uses plain text format for this template, no HTML code is allowed.
       
      • [USERNAME]
        The system will replace this call tag with the customer's username.
      • [PASSWORD]
        The system will replace this call tag with the customer's password.
         
  27. photographer_activate_email.txt  (Ent. version)
      If the “Enable Photographer Email Validation” option is enabled in the Photographer Configuration section, the system will use this template when a photographer registers to your site. There are three predefined tags for this template. The system uses plain text format for this template, no HTML code is allowed.
       
      • [USERNAME]
        The system will replace this call tag with the photographer's registered username.
      • [ ACTIVATE_CODE]
        The system will replace this call tag with the activation code. The activation code is generated when a photographer submits their registration details.
      • [LINK]
        The system will replace this call tag with the activation link. The photographer needs to click on this link to activate their account.
         
  28. photographer_agreement.tpl  (Ent. version)
      This is similar to the Customer Agreement feature. When you enable the “Enable Photographer Agreement Checkbox” option in the Photographer Configuration section, this template will be used to display your agreement details. You will need to input your site agreement (terms etc.) to this template and it's contents will display on the photographer's registration form. No predefined call tags are available for this template.
       
  29. photographer_approval_notify.txt  (Ent. version)
      If the photographer's “Enable Photographer Approval Notification” option is enabled, the system will use this template to notify you when a photographer uploads new media to your server. The system uses plain text format for this template, no HTML code is allowed. There are four predefined tags for this template.
       
      • [MEDIA_NAME]
        The system will replace this call tag with the file system name or display name (whichever is present).
      • [MEDIA_CATEGORY]
        The system will replace this call tag with the media category.
      • [MEDIA_PATH]
        The system will replace this call tag with the media's actual file path.
      • [APPROVED_STATUS]
        The system will replace this call tag with the media approval status. The approval status is set based on approval status setting in the photographer's profile.
         
  30. photographer_home.tpl  (Ent. version)
      The system uses this template for the photographers home page. There are two predefined call tags for this template. This template uses the cb.css style sheet.
       
      • [MENU]
        The system will replace this call tag with the photographer's navigation menu.
      • [CONTENTS]
        The system will replace this call tag with the contents of the photographer's section.
         
  31. photographer_notify.tpl  (Ent. version)
      If the “Notify me when someone signs up” is enabled in the General Configuration, the system will use this template to notify you when photographers submit their new registration details to your server. This template can be configured differently depending on the information that you want collect from the photographers. The system uses plain text format for this template, no HTML code is allowed.
      e.g. If you add a field name 'fax' to the registration form, then you will need to add the [fax] call tag to this template. Stockbox will replace this call tag with the photographer's fax number.
       
  32. portfolio.tpl (Ent. version)
      This is the main template for the portfolio module. This template is used before the system outputs the data to the main.tpl template. All predefined call tags are similar to the gallery.tpl template above, except the system will replace the [GALLERY] call tag with the selected portfolio. When the portfolio page is called the first portfolio will be loaded.
      
      
  33. portfolio_thumbnail.tpl (Ent. version)
      This template is used for the Featured Portfolio section.
      [PORTFOLIO_THUMBNAIL]: The system will replace this call tag with the portfolio thumbnail.
      [DISPLAY_NAME]: The system will replace this call tag with the portfolio display name.
       
  34. readme.txt
      By default this file will be included in the zip file that the user will download after their purchase is complete. This template can be used to include your usage/license details (or any other information that you want to provide) for the end-user. You can specify a different file to be included in the download zip package by changing the setting in the General Configuration section. You must upload your file to the template/english folder via FTP in order for it to display in the General Configuration section.
      
      
  35. request_lightbox_quote.tpl (Ent. version)
      The system uses this template to send an email to the gallery administrator with the details of the lightbox quotation request. There are five predefined tags for this template. The system uses HTML format for this template. Note: If you add images to this template, make sure that you use the absolute path to the image file. e.g. src="http://www.your-domain.com/images/admin/english/logo.jpg" or you should include the [URL] tag in the path to the image file. e.g. src="[URL]/images/admin/english/logo.jpg".
       
      • [WEBMASTER_NAME]
        The system will replace this call tag with the gallery administrator's name (as input in the General Configuration).
      • [SENDERNAME]
        The system will replace this call tag with the input name.
      • [MESSAGE]
        The system will replace this call tag with the input usage details.
      • [PHONE]
        The system will replace this call tag with the input phone number.
      • [LINK]
        The system will replace this call tag with a clickable link. The link allows you to click to go back to your gallery to view the media.
         
  36. request_media_quote.tpl (Ent. version)
      The system uses this template to send an email to the gallery administrator with the details of the media quotation request. There six predefined tags for this template. The system uses HTML format for this template. Note: If you add images to this template, make sure that you use the absolute path to the image file. e.g. src="http://www.your-domain.com/images/admin/english/logo.jpg" or you should include the [URL] tag in the path to the image file. e.g. src="[URL]/images/admin/english/logo.jpg".
       
      • [WEBMASTER_NAME]
        The system will replace this call tag with the gallery administrator's name (as input in the General Configuration).
      • [SENDERNAME]
        The system will replace this call tag with the input name.
      • [USAGE]
        The system will replace this call tag with the input usage details.
      • [PHONE]
        The system will replace this call tag with the input phone number.
      • [LINK]
        The system will replace this call tag with a clickable link. The link allows you to click to go back to your gallery to view the media.
      • [MEDIA]
        The system will replace this call tag with the media's actual display image.
         
  37. send_activate_password.tpl
      This template is used when users request a new password from your site.
      
      
      • [USERNAME]
        The system will replace this call tag with the username of the requested user.
      • [PASSWORD]
        The system will replace this call tag with the temporary password.
      • [ACTIVATE]
        The system will replace this call tag with a randomly generated activation code that users will need input in order to activate their temporary password.
      • [URL]
        The system will replace this call tag with the URL link that allows users to click in order to activate their temporary password.
        
       
  38. send_approval_status.tpl (Ent. version)
      The system uses this template to send an email to the contributor to notify them that their submitted category or media has been approved or un-approved. There is only one predefined tag for this template. The system uses HTML format for this template. Note: If you add images to this template, make sure that you use the absolute path to the image file. e.g. src="http://www.your-domain.com/images/admin/english/logo.jpg" or you should include the [URL] tag in the path to the image file. e.g. src="[URL]/images/admin/english/logo.jpg".
       
      • [CONTENTS]
        The system will replace this call tag with the approval details.
         
  39. send_lightbox_email.tpl
      The system uses this template to create the email used when customers send their lightbox to their friends. There are four predefined tags for this template. The system uses HTML format for this template. Note: If you add images to this template, make sure that you use the absolute path to the image file. e.g. src="http://www.your-domain.com/images/admin/english/logo.jpg" or you should include the [URL] tag in the path to the image file. e.g. src="[URL]/images/admin/english/logo.jpg".
       
      • [FRIENDNAME]
        The system will replace this call tag with the customer's friend's name.
      • [SENDERNAME]
        The system will replace this call tag with the customer's name.
      • [MESSAGE]
        The system will replace this call tag with the customer's message.
      • [LINK]
        The system will replace this call tag with a clickable link. This link allows the customer's friend to click on it to go back to your site and view the contents of the sent lightbox.
         
  40. send_order_details.tpl (Pro. & Ent. versions)
      The system uses this template when you manually send order details to a customer. The email will be sent to the email address on the Order Details page. There are two predefined call tags for this template.
       
      • [MESSAGE]
        The system will replace this call tag with the message that you input.
      • [ORDER_DETAILS]
        The system will replace this call tag with the selected order details.
         
  41. send_portfolio_email.tpl (Ent. version)
      This template is used when a user sends the selected portfolio to their friends.
      
      
      • [FRIENDNAME]
        The system will replace this call tag with the customer's friend's name.
      • [SENDERNAME]
        The system will replace this call tag with the customer's name.
      • [MESSAGE]
        The system will replace this call tag with the customer's message.
      • [ICON]
        The system will replace this call tag with the selected portfolio thumbnail image.
      • [LINK]
        The system will replace this call tag with a clickable link. This link allows the customer's friend to click on it to go back to your site and view the selected portfolio.
      
      
      
  42. send_to_friend_email.tpl
      The system uses this template to create the email used when a customer sends a selected media to their friends. The system uses HTML format for this template. There are five predefined tags for this template. Note: If you add images to this template, make sure that you use the absolute path to the image file. e.g. src="http://www.your-domain.com/images/admin/english/logo.jpg" or you should include the [URL] tag in the path to the image file. e.g. src="[URL]/images/admin/english/logo.jpg".
       
      • [FRIENDNAME]
        The system will replace this call tag with the customer's friend's name.
      • [SENDERNAME]
        The system will replace this call tag with the customer's name.
      • [MESSAGE]
        The system will replace this call tag with the customer's message.
      • [LINK]
        The system will replace this call tag with a clickable link. The link allows the customer's friend to click to go back to your gallery to view the media.
      • [MEDIA]
        The system will replace this call tag with the media's actual image. Note: If the image is sent in the email it will no longer be protected by the "image protection" features. If you don't want to send the image in the email, you should remove this tag from the template.
         
  43. user_account_info.tpl
      This template is used for the "My Account" page. This page shows the customer's order history and also allows customers to download any instant download orders. The customer can also use links on this page to edit their profile or to logout from the system. There are no predefined tags for this template.
       
  44. virtual_cd_order_details.tpl (Pro. & Ent. versions)
      This template is used when customers want to view the details of a Virtual CD order in their "My Account" section. Note: If you add images to this template, make sure that you use the absolute path to the image file. e.g. src="http://www.your-domain.com/images/admin/english/logo.jpg" or you should include the [URL] tag in the path to the image file. e.g. src="[URL]/images/admin/english/logo.jpg".
      
      There is only one predefined call tag for this template.
       
      • [ORDER_DETAILS]
        The system will replace this call tag with the order details.
         
  45. welcome_new_member.tpl
      The system uses this template to send out a "welcome email" to the customer's registered email address if the "Enable Welcome New Customer Email" option is enabled in the General Configuration. There are two predefined tags for this template, plus dynamic tags that draw from the customer's registration form. The system uses plain text format for this template, no HTML code is allowed
       
      • [USERNAME]
        The system will replace this call tag with the customer's username.
      • [PASSWORD]
        The system displays the text ## Hidden ## instead of the user's actual password.
      • Dynamic tags
        If you add a new field name such as 'fax' to the customers' registration form, then you will need to add the tag [fax] to this template. Stockbox will replace this call tag with the customer's fax number.
       
  46. welcome_new_photographer.tpl  (Ent. version)
      The system uses this template to send out a "welcome email" to the photographer's registered email address if the "Enable welcome email notification when photographers account status becomes active" is enabled in the Photographer Configuration section. There are two predefined tags for this template, plus dynamic tags that draw from the photographer's registration form. The system uses plain text format for this template, no HTML code is allowed.
       
      • [USERNAME]
        The system will replace this call tag with the photographer's username.
      • [PASSWORD]
        The system displays the text ## Hidden ## instead of the photographer's actual password.
      • Dynamic tags
        If you add a new field name such as 'fax' to the photographers' registration form, then you will need to add the [fax] call tag to this template. Stockbox will replace this call tag with the photographer's fax number.
         
• Smarty Templates
  Stockbox version 4.00 and above utilizes the smarty template engine for its gallery templates. All smarty gallery templates are located in the tpl folder and its modules directories. You should have prior working knowledge of the Smarty Template Engine before attempting to modify any of these templates. It is recommended that you make a backup of the tpl folder before editing any of the Smarty templates, so that the original files can easily be replaced should problems occur. Please note that requests to modify the smarty templates, or the resolution of issues caused by changes to the smarty templates are not covered by standard support.
   
  • template_type:
    There are three types of templates that you need to be aware of:
     
    1. Any file that begins with "admin_" is used by the admin control panel. These templates do not need to be edited.
    2. Any file that begins with "cb_" is used by the photographers section. These templates do not need to be edited.
    3. Any file that begins with "user_" is used by public and private galleries. You can change the gallery layout by editing the smarty templates, but you must know how the Smarty engine works before doing so.
        
  • module_name_prefix: This is the first two letters of the module name. You can determine the page's module_name_prefix by the module variable in this page's URL's query string. e.g. If the URL is http://www.yourdomain.com/your_folder/private_gallery.php?module=media&pId=101&start=0, then the module variable is media, so the module_name_prefix will be "me".
    Note: If there are two or more modules that have a similar name to the first module name, then the module_name_prefix name will add a  letter for each similar module name. e.g. The modules list have two module names that are similar to each other, they are company and config modules, so the module_name_prefix for company is co and the module_name_prefix for config is con.
     
  • pId: Similar to the module_name_prefix, the pId can also be found in the URL query string. If there is no pId in the query string, the default value of 100 will be used.
     
  • template_name: The last template_name prefix will only be used if the three prefixes before it coincide .e.g. the tpl/english/media_manager folder have more than one user_me_102 file, so first file will be user_me_102.tpl, the second will be user_me_102_download_link.tpl and so on.
     

  The template name structure: <template_type>_<module_name_prefix>_<pId>_<template_name>.tpl.

  template_type = user
  module_name_prefix = me
  pId = 102
  template_name = download_link

  Therefore the corresponding Smarty template is tpl/english/media_manager/user_me_102_download_link.tpl

  Please use the following links to view a detailed guide on which Smarty templates control the specific sections of the gallery.

  Basic Template Guide

  Advanced Template Guide
   

   

1. Static Content Manager

• Click on the Templates & CM Static Content Manager link in the main menu.
  
  
   
• About Us
  This page content is used for the About Us page in the gallery.
• Contact Us
  This page content is used for the Contact Us page in the gallery.
• Order Info
  This page content is used for the Order Information page in the gallery.
   

2. Add a New Static Content Page (Pro. & Ent. versions)
   With the Pro. and Ent. versions you are able to add as many static pages to the system as you wish. Once they have been added to the system, you can link to them directly using the link that system generates in the Static Contents Manager page, or you can create a new menu button or navigation drop down button and link it to the new static page that you created. The URL for the static page will displayed in the URL list when you create the page.
    
   • Click on the Add icon to add a new static page to the system.
     
     
      
   • The system will use the "gallery.tpl" as the default layout for the new static page. You should only add your contents to the "PLEASE ADD YOUR..." section and leave other parts as they are. However you can remove call tags if you don't want the corresponding feature to be displayed on the new static page. You are not able to add the header or footer to the static page, as the system uses only one header and footer for the entire site. The header and footer are in the main.tpl template and all content for the static page will be loaded into the [BODY] call tag in the main.tpl template when the page is called by the user.
      
   • To insert images into a static page you will need to upload them first to the server using the "Upload Static Page Media" icon. Your uploaded images will be displayed in the "Static Page Media" tab and you can also view the actual URL for the image. You will need to insert the URL into the "Image URL" field that will be displayed after clicking on the Insert / edit Image icon in the Tiny MCE Editor menu.
     
   
    
3. Edit a Static Content Page
    
   • Click on the Edit icon for the particular page that you would like to edit.
     
     
     
      
   • Note: You should not remove any call tags from the page unless you don't want to use that feature in the selected template.
      
   • To insert images into a static page you will need to upload them first to the server using the "Upload Static Page Media" icon. Your uploaded images will be displayed in the "Static Page Media" tab and you can also view the actual URL for the image. You will need to insert the URL into the "Image URL" field that will be displayed after clicking on the Insert / edit Image icon in the Tiny MCE Editor menu.
      
   • You are not able to add the header or footer to the static page, as the system uses only one header and footer for the entire site. The header and footer are in the main.tpl template and all content for the static page will be loaded into the [BODY] call tag in the main.tpl template when the page is called by the user.
     
     

• Click on the News Manager link in the main menu.

• To specify that a particular news is to be featured, click on the No link in the Featured column. The Featured News will be listed on the home page in the Latest News section. Only one featured news item can be specified at a time.
• Click on the Status link to change the status of the particular news item to be Hidden or Active. Only active news items will be displayed in the gallery.
• Click on the Edit icon to edit a particular news item.
• Click on the Delete icon to delete a particular news item.
• Click on the Upload icon to upload images to the server for later use in your news articles.
• Click on the Add icon to add a new news item to the system.
  
  
  
  
  
• Enter the news Title.
• Enter the Short Content. The short content will be used as the news summary.
• Enter the full Content. The full content will be used when users click on a particular news item to view the full details.
• To insert images into a news item you will need to upload them first to the server by clicking on the Upload News Media icon. Your uploaded images will be displayed in the "News Media" tab and you can also view the actual URL for the image. You will need to insert the URL into the "Image URL" field that will be displayed after clicking on the Insert / edit Image icon in the Tiny MCE Editor menu.
• Click on the SUBMIT button to add a new News item to the system. The status of the new News item will be Hidden and you will need to change this to Active before it will display in the gallery.
  
   
• To configure how the system handles the News items in the gallery, click on the Configuration link.
  
  
   
• Number of News items per Page
  Enter the number of news to be listed on the News page.
• News Default Sort Field Name
  Select the default sort field name that will be used to sort the displayed news items on the News page.
• News Default Sort Order Direction
  Select the default sort order direction that will be used to sort the displayed news items on the News page.
• Latest News
  Select the latest news option that the system will use for the Latest News section on the home page.
   
• To go back to News Manager click on the "News Manager" tab.

1. 1. Use Gallery Navigation Menu Dropdown
   2. Use Gallery Navigation Menu Button with Rollover Option Enabled
   3. Use Gallery Navigation Menu Button with Rollover Option Disabled
      

1. Gallery Navigation Menu Button
   When this option is selected, system will use the Button Navigation Menu for the gallery navigation menu. Since you can't have sub-menu items when using this option, it is not recommended when you want to add many static information pages to your gallery.
   
   
   
   
   • You can change the default button images with your own by uploading your images to the "images/english/" folder to overwrite the existing button images. For other languages you must upload them to the "images/language-name" folder. When you add a new language to the system, a new folder will be created inside the images folder with the new language name.

   Add New Navigation Menu Button (Ent. version)
   

   • Click on the Add Menu Button Icon in the Gallery Navigation Menu Button Manager page.
     
     
      
   • Enter the Button Name.
   • Select the Mouse Out Button Image for the new navigation button. This button image will be used when the user moves their mouse off the button image.
   • Select the Mouse Over Button Image for the new navigation button. This button image will be used when the user moves their mouse over of the button image.
   • URL - You can either enter the URL directly into the input field or select the page in the next drop down list. The pages in the drop down list are all internal static pages that you have added in the Static Contents Manager and also the Stockbox default pages.
   • Click on the SUBMIT button to add the new navigation button to the system.
   
   
   
2. Gallery Navigation Menu Dropdown
   When this option is selected, you can group several navigation menu items into one dropdown menu.
   
   
   
   
   • The drop down navigation menu layout is controlled by the CSS file called gallery.css file. Look for the /*** start css_menu_dropdown ***/ section.
      
   • Using the Navigation Menu Dropdown option, you can categorize gallery menus into one menu group.

     
     
     The HOME, GALLERY, LIGHTBOX, PRODUCTS, MY ACCOUNT, SHOPPING CART, NEWS (Ent. version), PORTFOLIO (Ent. version) and ABOUT US menus items are installed automatically when the Stockbox system is installed on your server.
      

     • Menu Label
       The system uses this label in the menu navigation item label.
     • Parent Label
       When a particular menu label is under another parent label other than the TOP label, users must mouse over the parent label to see this sub menu item label.
     • URL Address
       The URL Address that links to this menu label.
     • Target
       Your web browser uses this option to open the URL in a new window, current window or parent window.
     • Position
       Position of menu item label.
     • Added Date
       The date that the label was added to the system.
     • Active
       The system only displays a menu item label when its status is Active.
        
     • To Edit a particular menu item label, click on the icon.
     • To Delete a particular menu item label, click on the icon.
     • To Add a new menu label to the system, click on the icon.
     • To View the navigation menu layout, click on the icon.

   Add New Navigation Menu

   • When adding a new navigation menu item, the system will ask you for the parent group (level). The "Top" is the main group and any menu item that is in the TOP group will be displayed when the gallery is displayed in your web browser. Other groups (levels) will be displayed when you mouse over the parent group label like the GALLERY menu in the above screen shot.

   

   • Group Label - Enter the group label for the new navigation menu item. The system will use this label in the navigation menu in the gallery. You can update it for the other languages (if applicable) later once it has been added to the system.
   • URL - You can either enter the URL directly into the input field or select the page in the next dropdown list. The pages in the dropdown list are all internal static pages that you have added in the Static Contents Manager and also the Stockbox default pages.
   • Target - Select the target command in the drop down list. The system will use this value for the target in the <a> tag.
     _self: Browser will open the new page in the current window.
     _parent: Browser will open the new page in the parent window.
     _top: Browser will open the new page at the top of window.
     _blank: Browser will open the new page in a new window.
   • Parent Group - Select the parent group for this new menu. If this menu is under any group besides the TOP group, then users must mouse over that navigation menu before being able to access this new navigation menu item.
   • When adding a new menu group label, the status will be "Hidden" until you change the status in the Gallery Navigation Menu Manager section.
   • Click on the SUBMIT button to add the new menu item.

1. Administrator Profile
   Any administrator can access this page to update their profile.
    
   • Click on the Administrator Admin Profile link in the main menu function.
   • Fill in all provided text fields.
   • Click on the SUBMIT button to save the changes.
     
     
     
      
2. Administrative Groups
   Use this feature to create new administrative groups for you gallery.
    
   • Click on the Administrator Administrative Groups link in the main menu.
   • By Default there are two user groups available, master and user. The Master group is used for the admin users and the user group is used for customers. It is not possible to delete these groups from the database.
   • To add more admin groups to Stockbox, check all boxes for the privileges that are needed and add a Group Name (do not leave spaces in the group name). Click on the Add button, to add the new group to the database.
   • To delete an admin group, click on the icon for the target admin group.
     
     
     
      
3. Administrative Users
   Use this feature to add more administrator's to the gallery system.
    
   • Click on the Administrator Administrative Users link in the main menu.
   • Fill in all provided text fields and click the Submit button to add the new admin user. The new admin user must be assigned to an administrative group. If you don't have any administrative groups configured, please add the new administrative group by clicking on the icon.
   • To delete an existing admin user, click on the icon for the target admin user.
     
     
     
      
4. Manage Blacklisted IP
   This feature allows you to manage your IP Blacklist. Using this feature you can allow or restrict one or multiple IP Addresses to access your Public Gallery Modules.
    
   • Blacklisted IP Address: Enter the IP address that you want to blacklist. Example: 127.0.0.1
   • Module: Choose the modules that you want to restrict access to from the Public Gallery by clicking on the respective checkboxes.
   • Click the Submit button to add your Blacklisted IP Address.
   • The icon shows that the related Module is blocked.
   • Click on the icon if you want to delete your Blacklisted IP Address.
     
     
     
     
     
5. Malicious Character Manager
   This feature allow the system to delete, replace, or return errors when users input malicious characters.
   
   
   • Click on the Administrator Malicious Characters link in the main menu
     
     
      
   • Delete Option
     When this option is set for a particular character, the system will delete the configured character from the input data before executing the user's requested action.
   • Replace
     When this option is set for a particular character, the system will replace the configured character with the new output character before executing the user's requested action.
   • Return Error
     When this option is set for a particular character, the system will return an error to the user's browser when it detects the malicious character that you configured in this section.
   
   
   
6. Password Requests
   The system will list all the password requests for the admin users. Anyone who requests the admin user password will be logged and their IP Address will display on this page. You can find out their location by clicking on the IP Address link.
   
    
7. Media Statistics (Ent. version)
   The Media Statistics feature provides you with traffic statistics for your gallery. In order for the system to log user's activities, you must enable the "Enable Media Stats Logs" option in the  Media Configuration.
   
   
   
8. Configuration
   
   
   • Enable Blacklisted IP Address Checking
     The system will activate the Blacklisted IP Address function when this option is enabled.
   • Enable Malicious Character Checking
     The system will activate the Malicious Character checking function when this option is enabled.
   • Allow Admin Users Access to New Private Categories
     When this option is enabled, the system will automatically add the admin users as Access Users to any newly created private categories.
     
     
     

1. PPP (Pay Per Purchase) order details
   PPP orders are orders that customers purchase and pay for via a payment gateway during the checkout process.  By viewing the order details, you will find all information that relates to the selected order id.
   
   
   
   
   
2. Subscription order details  (Ent. version)
   Subscription orders, are orders that customers placed using their pre-purchased subscription to pay for the order. Customers need to purchase a subscription that you offer on the Products Page in the gallery before using it to pay for a new order. Related order details section lists all orders that used this purchased subscription during the checkout.
   
   
   
   
   
3. Package order details (Ent. version)
   Package orders are orders that customers used their pre-purchased packages to pay for their purchase. The customers need to first purchase a package that you offer on the Products Page in the gallery before using it to pay for their order. The Related order details section lists all orders that used this purchased package during the checkout.
   
   
   
    
4. Virtual CD order details (Ent. version)
   Click on the Virtual CD Details link to view the image details.