PT Photo Gallery Overview

About Photo Gallery App

The Photo Gallery application is built in the Application Development Framework (ADF).

Overview

The Photo Gallery provides the ability to set dimension requirements for the uploaded image and to resize according to the sizes selected for the category.

A Photo Category is associated with Photo Size elements. The selections are the dimensions required for the initial upload and the resize processing dimensions. The fields in the element define the category title and the directory to store the category's upload images.

The Photo Size element provides a collection of predefined dimensions and directory names. Elements are selected and associated with the Photo Category.

The Photo element stores the information for the uploaded photo. This element stores the path to the original photo and the category for the photo. Combining these fields, we are able to return the size breakdowns for the photo category.

Requirements

ADF Library components that are required for the Photo Gallery:

• ceData_1_0
• csData_1_0
• scripts_1_0
• CCAPI
• utils_1_0
• forms_1_0

ADF must be configured correctly for your site. Site Configuration (ADF.cfc) has instructions for configuration.

Elements

This image represents the element relationships used in the Photo Gallery application.

Contents

The CS Photo Gallery contains the following:

• Custom Coding - various components and scripts.
• Custom Elements:
  • Photo - Custom Element
  • Photo Category - Custom Element
  • Photo Size - Custom Element

• Custom Fields:
  • Photo Image Gallery Checkbox Field
  • Photo Upload
  • Photo Size Select Metadata Form Field
  • Photo Chooser
  • Photo Image
  • General Chooser
  • Custom Hidden Field
  • Custom Element Select Field

Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types

Pre-installation Considerations

Application Development Framework (ADF) must be setup and configured on the server for the site that will be implementing the Photo Gallery application. For detailed instructions, see the Application Development Framework (ADF) wiki page for Site Configurations.

This installation guide assumes that you have no Custom Elements/Metadata Forms with the names above. Before the installation of CS Photo Gallery, remove any Custom Elements/Metadata Forms with the names contained in the "Contents" section above. (If you do not remove existing elements with these names, you may have difficulties during the installation.)

Installation Guides

Current Release v2.0:

• Version 2.0 Install Guide
• Version 2.0 Upgrade Guide

Previous Versions:

• v1.3
  • Install v1.3
  • Upgrade Guide for v1.3

DELETE

Each of the following steps should be completed fully and in the order presented:

1. Extract Photo Gallery Application
2. ADF Configuration for the Photo Gallery
3. Styles
4. Import Elements
5. Site Configuration
6. Build Templates/Pages

Getting Started

• Getting Started - Guide to set up the photo sizes and categories.

Features

The photo gallery application provides the following features:

• Gallery Element
• Upload Link Custom Field Type
• Integration with CS Image Gallery
• Customize Photo Manager Styles
• Photo Size Types
• Photo Cropper Custom Field

Known Issues/Bugs

Found a bug? View the Known Issues/Bugs wiki page. Your issue not on the list? Post it so the issue can be addressed.