Difference between revisions of "PT Page Rating Version 1.0 Install"

From ADF Docs
Jump to: navigation, search
(Subsites)
(Steps)
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
== Download ==
 +
# Download the PT Page Rating application from the the|commons projects SVN (http://community.paperthin.com/svn/pt_page_rating/).
 +
# Extract the zip file and place the directory in the "/ADF/Apps/pt_page_rating/" directory.
 +
 
== Site Configuration ==
 
== 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]].
 
* Make sure the ADF is setup and running on the site. If the ADF is not setup, then follow the instructions for ADF [[Installation]].
Line 30: Line 34:
 
</ptPageRating>
 
</ptPageRating>
 
</pre>
 
</pre>
 
== 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 ===
 
# Create a new subsite under the site root called ''webadmin''.
 
# Create a new subsite under ''webadmin'' called ''pagerating''.
 
# Configure the ''/webadmin/pagerating/'' subsite Content Security to give 'No Rights' to 'Anonymous Users' and 'Authenticated Users'. 
 
# 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.
 
 
# Create page with the name "index" and title is "Page Rating Manager" in the ''/webadmin/pagerating/'' subsite.
 
# Add a Datasheet element into the page.
 
## Define a View for the Datasheet Element called "All Page Ratings"
 
## Leave the View Source as the Default: Form Result/Custom Element Sheet
 
## Select the "PT Page Rating" Custom Element and select the following columns:
 
### ID, UserID, RatingPageID, Rating, and Date Added
 
## Edit the column for the "ID" field and make the following changes:
 
### Header: Edit/Delete
 
### Render Handler: /ADF/extensions/datasheet-modules/1.0/edit-delete.cfm
 
 
 
 
## Edit the Layout properties for the datasheet:
 
### Default Sorting: DateTimePosted DESCENDING
 
### Results Per Page: 50
 
### Allow JavaScript data sorting: Uncheck
 
# Publish the page.
 
  
 
== Adding rating to your page ==
 
== Adding rating to your page ==

Latest revision as of 13:53, 13 September 2012

Download

  1. Download the PT Page Rating application from the the|commons projects SVN (http://community.paperthin.com/svn/pt_page_rating/).
  2. Extract the zip file and place the directory in the "/ADF/Apps/pt_page_rating/" directory.

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");

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>

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.