Difference between revisions of "PT Poll Version 3.2 Install"

Revision as of 16:01, 31 January 2025

Back to PT Poll

IMPORTANT: v3.2 of this application requires ADF 2.7 or greater and CommonSpot 11.0, 10.9.1 or 10.8.2 or greater.

Download

1. Download the PT Poll application from the 'the|commons' projects (http://community.paperthin.com/projects/pt_poll/).
2. Extract the zip file and place the directory in the "/ADF/Apps/pt_poll/" directory.

Site Configuration

• Make sure ADF 2.7 or greater is set up and running on the site. If the ADF is not set up, follow the instructions for ADF Installation.
• Open the site's '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/ceManagement/ceManagement.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

IMPORTANT: The CCAPI configuration is no longer needed for ADF 2.7 and CommonSpot 11.0 or greater. Skip to the next section.

With the release of CommonSpot 11 and ADF 2.7, this app now uses the new ceRecordAPI to save data to Custom Elements. Using the CCAPI with CommonSpot 11.0 is still available but using the ceRecordAPI instead is highly recommended.

Note: If you are using this app with CommonSpot 10.9.1 or 10.8.3, please continue with the following CCAPI Configuration steps:

ccapiPoll conduit page configuration

1. Navigate to your ccapiPoll.cfm page (or create one)
2. Add the Poll Vote Element to the page
3. Click on 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.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.