PT Page Rating Version 1.0 Install

Site Configuration

• Make sure the ADF is setup and running on the site. If the ADF is not setup, then follow the instructions for ADF Installation.
• Open the sites 'ADF.cfc' ( See Site Configuration (ADF.cfc) for more info) file in a text editor. Locate the Load the ADF Application into application space comment in the file. Add the following command under the comment section:

loadApp("ptPageRating");

• Reset the ADF for the server and site.

Element Import

• Import the following elements from the /ADF/apps/pt_page_rating/exported-objects/ folder:
  • PT-Page-Rating-Custom-Element.zip

CCAPI Configuration

ccapi.cfm configuration

1. Navigate to your ccapi.cfm page (or create one)
2. Add the PT Page Rating Element to the page
3. Click on the More under the PT Page Rating Element and select name
4. enter the name: ptPageRating
5. Submit the page

XML Configuration

1. Open the _cs_apps/config/ccapi.xml (or cfm) document
2. add the following:

<ptPageRating>
  <pageID>[ccapi.cfm page ID]</pageID>
  <subsiteID>[subsite ID ccapi.cfm lies in]</subsiteID>
  <elementType>custom</elementType>
  <controlName>ptPageRating</controlName>
</ptPageRating>

Subsites

It is highly recommended to create a Page Rating subsite for administrators. This allows security to be setup for the subsite to allow only administrators access for the webadmin.

Your site may already have a webadmin subsite. The steps below will add a pagerating subsite into the webadmin subsite.

Web Admin

1. Create a new subsite under the site root called webadmin.
2. Create a new subsite under webadmin called pagerating.
3. Configure the /webadmin/pagerating/ subsite Content Security to give 'No Rights' to 'Anonymous Users' and 'Authenticated Users'.
4. Configure the /webadmin/pagerating/ subsite Content Security to give permissions to the group of administrators who will manage the Comments.

Page Rating Manager

This page will be used to manage the Comments custom element data records for the site.

1. Create page with the name "index" and title is "Page Rating Manager" in the /webadmin/pagerating/ subsite.
2. Add a Datasheet element into the page.
   1. Define a View for the Datasheet Element called "All Page Ratings"
   2. Leave the View Source as the Default: Form Result/Custom Element Sheet
   3. Select the "PT Page Rating" Custom Element and select the following columns:
      1. ID, UserID, RatingPageID, Rating, and Date Added
   4. Edit the column for the "ID" field and make the following changes:
      1. Header: Edit/Delete
      2. Render Handler: /ADF/extensions/datasheet-modules/1.0/edit-delete.cfm
   5. Edit the column for the "UserID" field and make the following changes:
      1. Header: User
      2. Render Handler: /ADF/extensions/datasheet-modules/1.0/userID-to-name.cfm
   6. Edit the column for the "RatingPageID" field and make the following changes:
      1. Header: Rating Page
      2. Render Handler: /ADF/extensions/datasheet-modules/1.0/pageID-to-link.cfm
      3. Prevent Text from Wrapping: Unchecked
   7. Edit the Layout properties for the datasheet:
      1. Default Sorting: Date Added DESCENDING
      2. Results Per Page: 50
      3. Allow JavaScript data sorting: Uncheck
3. Publish the page.

Adding rating to your page

1. Navigate to your page
2. Add a custom script to the page (under Miscellaneous)
3. Specify the location of the custom script to be:
   • /ADF/apps/pt_page_rating/customcf/pageRating.cfm
4. Submit the page. You now have the app installed and running.