PT Comments v2.2 Install - Revision history

Gcronkright at 19:00, 5 May 2016

2016-05-05T19:00:03Z

Gcronkright at 18:59, 5 May 2016

2016-05-05T18:59:51Z

Gcronkright: /* Adding comments to your page */

2016-05-05T18:58:27Z

‎Adding comments to your page

Gcronkright: /* Adding comments to your page */

2016-05-05T18:57:52Z

‎Adding comments to your page

Gcronkright: /* Import */

2016-05-05T18:56:13Z

‎Import

Gcronkright: /* Import */

2016-05-05T18:55:48Z

‎Import

Gcronkright: /* ADF Configuration */

2016-05-05T18:53:53Z

‎ADF Configuration

Gcronkright: /* Download */

2016-05-05T18:51:53Z

‎Download

Gcronkright at 18:50, 5 May 2016

2016-05-05T18:50:49Z

Gcronkright: Created page with "Back to PT Comments == Download == Download the Comments Application from the Community Site or from the [http://community.paperthin.com/svn/pt_comments/trunk..."

2016-05-05T18:49:20Z

Created page with "Back to PT Comments == Download == Download the Comments Application from the Community Site or from the [http://community.paperthin.com/svn/pt_comments/trunk..."

New page

Back to [[PT_Comments|PT Comments]]

== Download ==
Download the Comments Application from the Community Site or from the [http://community.paperthin.com/svn/pt_comments/trunk/ SVN Repository].

Extract the zip files into the following directory:
'''/ADF/apps/pt_comments/'''

== ADF 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' ([[Site Configuration (ADF.cfc)|See Site Configuration (ADF.cfc) for more info]]) file (located in your site's /_cs_apps/ directory) 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("ptComments");

* [[Reset ADF|Reset the ADF]] for the server and site.

== Import Elements ==
The Comments Application has a single Global Custom Element defined within CommonSpot. The element has been exported and is available in the Comments's "exported-objects" folder located at the root of the Comments application directory (e.g. /ADF/apps/pt_comments/exported-objects/)

Optional: You may want to create a new category within the CommonSpot Element Gallery for 'Comments Elements'.

To import these objects, you will need to be an administrator for your site. If you are not a site administrator, consult your Server administrator for more information.

=== Import ===

Import the Custom Element:

# Comments (Comments-Custom-Element.zip)

=== Verify Import ===

The render handler path for the imported "comments" element must be verified that it has the correct path. During the import process, the render handler path may have been changed to reflect the current site's path.

Review and update the path to reference the ADF path. In most cases, this will just require the element to be unlocked and a change in the path from the site name to 'ADF'. Check the path for the [[PT_Comments#Contents|custom field types that were imported]] with the custom element by unlocking it and fixing the explicit path to point to "/ADF/extensions/".

== Subsites ==
It is '''highly recommended''' that a Comments subsite is created 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 ''comments'' subsite into the ''webadmin'' subsite.

=== Web Admin ===
# Create a new subsite under the site root called ''webadmin''.
# Create a new subsite under ''webadmin'' called ''comments''.
# Configure the ''/webadmin/comments/'' subsite Content Security to give 'No Rights' to 'Anonymous Users' and 'Authenticated Users'.
# Configure the ''/webadmin/comments/'' subsite Content Security to give permissions to the group of administrators who will manage the Comments.

== Comments 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 "Comments Manager" in the ''/webadmin/comments/'' subsite.
# Add a Datasheet element into the page.
## Define a View for the Datasheet Element called "All Comments"
## Leave the View Source as the Default: Form Result/Custom Element Sheet
## Select the "Comments" Custom Element and select the following columns:
### UID, DateTimePosted, and Name
## Edit the column for the "UID" 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.

== Site Configuration ==

=== Installing cfformprotect ===
CF Form Protect helps to protect your form from spam. It allows the comments that users enter to have some verification of who is entering the data and makes sure that robots do not submit bogus comments.

# Copy cffp.ini.cfm from /ADF/thirdParty/cfformprotect/ into your /_cs_apps/config directory
# Edit the parameters as you see fit. Please note the email settings.

=== Adding comments to your page ===
The comments element, which will be configured in a step below, requires a variable called "request.comments.contentDataPageID". This variable does not exist and will throw an error unless one of two things are done. First, you can add a script to the page directly above where you place the comments element. The script (pageComments.cfm) will define the variable needed by the comments element.

Alternatively, you can add the following line of code:

<cfset request.comments.contentDataPageID = request.page.id>

to a template-basepage.head file in the site's /templates directory. If you add the line of code to your template-basepage.head file, then it is not necessary to place a custom script element on every page where you wish to use comments. Adding this code to your template-basepage.head is the preferred installation method. If your site does not have a template-basepage.head file, you may create one. The Commonspot developer's guide explains the requirements for creating the .head file.

# Edit your page
# '''Optional''' -- Add a custom script to your page
#* /ADF/apps/pt_comments/customcf/pageComments.cfm
# Add the comments element to your page
# Update the render mode on this element
## Select "Display existing element data (content reuse)"
## Select "Render results dynamically based on a filter, or display all records."
## click on filter
## select "Subset of records"
## in the dropdown select Comments.contentDataPageID
## Set the comparison to equals
## click the ... next to the value
## enter: request.comments.contentDataPageID
## Sort Order: dateTimePosted ASCENDING
## click save
# submit your page

* [[Reset ADF|Reset the ADF]] for the server and site.

[[Category:Comments]]

@@ Line 1: / Line 1: @@
 Back to [[PT_Comments|PT Comments]]
-  NOTE: v2.2 of this application is compatible with both '''ADF 1.8.x''' and '''ADF 2.0''' .
+  NOTE: v2.2 of this application is compatible with both '''ADF 1.8.x''' and '''ADF 2.0'''.
 == Download ==

@@ Line 1: / Line 1: @@
 Back to [[PT_Comments|PT Comments]]
-  NOTE: v2.2 of this application can work with both '''ADF 1.8.x''' and '''ADF 2.0'''
+  NOTE: v2.2 of this application is compatible with both '''ADF 1.8.x''' and '''ADF 2.0''' .
 == Download ==

@@ Line 31: / Line 31: @@
 # Comments (Comments-Custom-Element.zip)
-  Note: For CommonSpot 9 or earlier import the .zip archive in the /exported-objects/cs9-or-earlier/ directory
+  Note: For CommonSpot 9 or earlier import the .zip archives located in the '''/exported-objects/cs9-or-earlier/''' directory
 === Verify Import ===

← Older revision		Revision as of 18:55, 5 May 2016
Line 30:		Line 30:

	# Comments (Comments-Custom-Element.zip)		# Comments (Comments-Custom-Element.zip)
		+
		+	Note: For CommonSpot 9 or earlier import the .zip archive in the /exported-objects/cs9-or-earlier/ directory

	=== Verify Import ===		=== Verify Import ===

← Older revision		Revision as of 18:50, 5 May 2016
Line 1:		Line 1:
	Back to [[PT_Comments\|PT Comments]]		Back to [[PT_Comments\|PT Comments]]
		+
		+	NOTE: v2.2 of this application can work with both '''ADF 1.8.x''' and '''ADF 2.0'''

	== Download ==		== Download ==

@@ Line 79: / Line 79: @@
 The comments element, which will be configured in a step below, requires a variable called "request.comments.contentDataPageID". This variable does not exist and will throw an error unless one of two things are done.  First, you can add a script to the page directly above where you place the comments element.   The script (pageComments.cfm) will define the variable needed by the comments element.
-Alternatively, you can add the following line of code:
+Alternatively, you can add the following line of code to the template-basepage.head file in the site's /templates directory:
   <cfset request.comments.contentDataPageID = request.page.id>
-to a template-basepage.head file in the site's /templates directory.  If you add the line of code to your template-basepage.head file, then it is not necessary to place a custom script element on every page where you wish to use comments.  Adding this code to your template-basepage.head is the preferred installation method.  If your site does not have a template-basepage.head file, you may create one.  The Commonspot developer's guide explains the requirements for creating the .head file.
+If you add the line of code to your template-basepage.head file, then it is not necessary to place a custom script element on every page where you wish to use comments.  Adding this code to your template-basepage.head is the preferred installation method.  If your site does not have a template-basepage.head file, you may create one.  The Commonspot developer's guide explains the requirements for creating the .head file.
 # Edit your page

@@ Line 11: / Line 11: @@
 == ADF 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' ([[Site Configuration (ADF.cfc)|See Site Configuration (ADF.cfc) for more info]]) file (located in your site's /_cs_apps/ directory) 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:
+* Open the sites 'ADF.cfc' ([[Site Configuration (ADF.cfc)|See Site Configuration (ADF.cfc) for more info]]) file (located in your site's /_cs_apps/ directory) in a text editor.
   loadApp("ptComments");

@@ Line 4: / Line 4: @@
 == Download ==
-Download the Comments Application from the Community Site or from the [http://community.paperthin.com/svn/pt_comments/trunk/ SVN Repository].
+Download the Comments Application from the Community Site or from the [http://community.paperthin.com/svn/pt_comments/tags/2.2/ SVN Repository].
 Extract the zip files into the following directory:
 '''/ADF/apps/pt_comments/'''
 == ADF Configuration ==