Difference between revisions of "PT Poll Install v2"

Revision as of 21:00, 22 February 2013

Download

1. Download the PT Poll application from the the|commons projects SVN (http://community.paperthin.com/svn/pt_poll/tags/1.0/).
2. Extract the zip file and place the directory in the "/ADF/Apps/pt_poll/" 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("ptPoll");

• Reset the ADF for the server and site.

Element Import

• Import the following elements:
  • Poll-Question-Custom-Element.zip
  • Poll-Question-Gallery-Custom-Element.zip
  • Poll-Vote-Custom-Element.zip

Subsite Creation

• Create a new subsite called polls under the webadmin subsite

Poll Manager

1. Create a new page:
   1. Name: index
   2. Title: Poll Manager
2. Insert a Custom Script module onto the page.
3. Edit the Custom Script module and enter the explicit path:
   1. /apps/pt_poll/customcf/poll_dashboard.cfm
4. There will be a datasheet on the page click to define the datasheet
   1. Select the Poll Question element
   2. Add the ID, Title, Question, and Active flags
5. Click on "Edit Columns"
   1. Edit the ID column
      1. Change its name to: "Edit/Delete"
      2. Change its renderhandler to: /ADF/extensions/datasheet-modules/datasheet-action-edit-delete.cfm
6. Click to edit Layout
   1. Allow JavaScript data sorting: Unchecked

Vote Manager

1. Create a new page:
   1. Name: vote manager
   2. Title: Vote Manager
2. Insert a datasheet element into the page and define the datasheet.
   1. Select the Poll Vote element
   2. Add the UserID, QuestionID, Vote, Date
3. Click on "Edit Columns"
   1. Add the action column for delete and select the "delete-form-data.cfm" module.
4. Click to edit Layout
   1. Default Sorting: Date DESCENDING
   2. Results Per Page: 50

Poll Question Gallery Manager

1. Create a new page:
   1. Name: index
   2. Title: Poll Question Gallery Manager
2. Insert a Custom Script module onto the page.
3. Edit the Custom Script module and enter the explicit path:
   1. /ADF/extensions/customcf/genericElementManagement.cfm
   2. Add the Parameter:
      1. elementName=Poll Question Gallery
4. There will be a datasheet on the page click to define the datasheet
   1. Select the Poll Question Gallery element
   2. Add the Poll Name and Poll Question ID fields.
5. Click on "Edit Columns"
   1. Edit the Poll Question ID column
      1. Change its name to: "Edit/Delete"
      2. Change its renderhandler to: /ADF/extensions/datasheet-modules/datasheet-action-edit-delete.cfm
   2. Move to the first row in the datasheet.
6. Click to edit Layout
   1. Allow JavaScript data sorting: Unchecked

CCAPI Configuration

ccapi.cfm configuration

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

XML Configuration

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

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

Installing the Left Pane

The left pane allows you to see a quick breakdown of all the polls you have created. Also gives you a quick link to export the data.

1. Navigate to site administration
2. Click on Left Pane Settings
3. Click Add Panel
   1. Name: Polls
   2. Description: Polls LView
   3. Panel URL: http://[insert your site url here]/ADF/apps/pt_poll/customcf/lview.cfm?subsiteURL=[insert your root subsite here]

• Reset the ADF for the server and site.