PT Profile v2 Install
Contents
Extract Photo Gallery Application
Download the Profile Application from the Community Site Project or from the SVN Repository.
Extract the zip files into the following directory: /ADF/apps/pt_profile/
ADF Configuration
The Profile Application is built within the ADF. The ADF must be installed in the site to run the Profile Application, follow the ADF Installation instructions.
- Open the sites 'ADF.cfc' ( See Site Configuration (ADF.cfc) for more details) file (/_cs_apps/ADF.cfc) in a text editor. Locate the Load the ADF Application into application space comment in the file. Add (or uncomment) the following command under the comment section:
loadApp("ptProfile");
- Reset the ADF for the server and site.
Import Elements
The Profile App has several Custom Components defined within CommonSpot. These components are available in the Profiles's "exported-objects" folder located at the root of the Profile application directory (e.g. /ADF/apps/pt_profile/exported-objects/)
To import these objects, you will need to be an administrator for your site.
Optional: You may want to create a new category within the CommonSpot Element Gallery for 'PT Profile Elements'.
Import
Import Custom Elements in this order:
- Profile (Profile-Custom-Element.zip)
- Profile Gallery (Profile-Gallery-Custom-Element.zip)
Import Metadata form:
- Profiles (profiles-Metadata-Form.zip)
Verify Imports
The imported components' render handlers and custom field types must be verified. During the import process, the render handler and custom field types paths may have been changed to reflect the current site's path.
Review and update these paths to reference the ADF path. In most cases, this will just require to be unlocked and a change in the path from the site name to 'ADF'. Check the paths for the custom field types that were imported with the custom elements by unlocking them and fixing the explicit paths to point to "/ADF/extensions/".
If the custom elements that are imported contain custom field types that are already in the site, the naming convention for the custom field type will be unique. To resolve this, unlock the field types and elements, and reassign the element field type to the pre-existing field type.
Example: The Photo Category custom element contains two uses of the General Chooser field type, if the General Chooser field type is already installed on the site then the import process will attempt to import another General Chooser but with a new name such as "General Chooser_import_1250003208472." To resolve this issue, open the custom element and assign the field type (General Chooser_import_1250003208472) to the field type with the simple name General Chooser. Note that when you assign the existing general chooser you will need to click on the "properties" tab and enter "photoSizeGC" as the bean name. After reassigning the field type, delete the new imported field from the list of custom field types.
Site Configuration
Configuration Fields
Subsites
Web Admin
- Create a new subsite under the site root called webadmin.
- Create a new subsite under /webadmin/ called profiles.
- Configure the /webadmin/profiles/ subsite Content Security to give 'No Rights' to 'Anonymous Users' and 'Authenticated Users'.
- Configure the /webadmin/profiles/ subsite Content Security to give permissions to the group of administrators who will manage the Photos.
- Create a new subsite under /webadmin/profiles/ called forms.
CCAPI
Setup
- Create a new page called 'ccapi' under the root subsite and from the base plus one template. When creating the page, disable the standard metadata 'Include In' fields for 'Page Indexes' and 'Full Text and Search Element Results'. This page may already exist within your site, if it does, then continue to the next steps.
Configuration
Photo Upload
Photo Display
Update Photo Gallery Site Config
Photo Admin Manager
Photo Admin Datasheet
Photo Category Admin Datasheet
Photo Size Admin Datasheet
Reset the ADF
Reset the ADF for the server and site.