PT Sync Install 1.0 - Revision history

Mcarroll at 18:51, 21 December 2011

2011-12-21T18:51:13Z

Mcarroll at 18:49, 21 December 2011

2011-12-21T18:49:38Z

Mcarroll: /* Pages */

2011-12-21T18:48:28Z

‎Pages

Mcarroll at 18:48, 21 December 2011

2011-12-21T18:48:00Z

Mcarroll at 18:47, 21 December 2011

2011-12-21T18:47:07Z

Mcarroll: Created page with '== Overview == The PT Sync Application is built within the ADF. The ADF must be installed in the site to run the PT Sync, follow the ADF Installation instructions. == Downl…'

2011-12-21T18:46:20Z

Created page with '== Overview == The PT Sync Application is built within the ADF. The ADF must be installed in the site to run the PT Sync, follow the ADF Installation instructions. == Downl…'

New page

== Overview ==
The PT Sync Application is built within the ADF. The ADF must be installed in the site to run the PT Sync, follow the ADF [[Installation]] instructions.

== Download ==
Download the PT Sync Application from the Community Site or from the SVN Repository.

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

== 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:
<source lang="java">
loadApp("ptSync");
</source>
* '''Load the PT Sync Application into the source and destination site!'''
* [[Reset ADF|Reset the ADF]] for the server and site.

[[Category:PT Sync]]

← Older revision		Revision as of 18:51, 21 December 2011
Line 1:		Line 1:
	== Overview ==		== Overview ==
		+	The following guide will install the PT Sync Application for the source and destination sites.
		+
		+	Follow the instructions closely because some steps need to be completed on both the source and destination sites.
		+
	The PT Sync Application is built within the ADF. The ADF must be installed in the site to run the PT Sync, follow the ADF [[Installation]] instructions.		The PT Sync Application is built within the ADF. The ADF must be installed in the site to run the PT Sync, follow the ADF [[Installation]] instructions.

← Older revision		Revision as of 18:49, 21 December 2011
Line 58:		Line 58:

	[[Reset ADF\|Reset the ADF]] for the server and site.		[[Reset ADF\|Reset the ADF]] for the server and site.
		+
		+	== Mapping Manager ==
		+	The Sync Mappings are global custom elements. Managing data for these global custom elements can be configured easily through the use of Datasheets. The following sections will describe how to configure a CommonSpot page to manage the data for this element.
		+
		+	=== Steps ===
		+	#Create a new page with the title 'Sync Mappings' and name 'index' in the subsite ''/webadmin/sync/''.
		+	#In the main content of the page, add a Custom Script element.
		+	#From the Custom Script element interface, click the "Edit" icon.
		+	#Enter the following text into the Explicit Module path: /ADF/apps/pt_sync/customcf/sync_mapping_manager.cfm
		+	# From the Datasheet element interface, click the "Datasheet" icon.
		+	# From the "Datasheet Views" dialog, follow the "Click here to create a new datasheet view" link.
		+	# Enter the following information and then click "Next":
		+	## Name: All Sync Mappings
		+	## Private: unchecked
		+	## Default View: unchecked
		+	## Description: View to manage all of the photo sizes
		+	## Datasheet Source: Form Result/Custom Element Sheet
		+	# From the Datasheet Source dialog, choose the "Sync Mapping" custom element and click "Next".
		+	# From the Datasheet Columns dialog select the columns UUIDField, sourceCE, Is Active, and ID fields and move them to the Selected Columns list then click "Finish".
		+	# You will be directed to the Datasheet View page. Click "Close" to return to your page.
		+	# You will now see the datasheet element on this page. Click the Datasheet element interface icon again and choose "Edit Columns".
		+	# Add Action Columns for Edit and Delete.
		+	# Edit the "UUIDField" column.
		+	## Change the "Render Handler" to the following path:
		+	### /ADF/extensions/datasheet-modules/1.0/edit-delete.cfm
		+	# Edit the "SOURCECE" column.
		+	## Change the "Render Handler" to the following path:
		+	### /ADF/extensions/datasheet-modules/1.0/formID-to-CEName.cfm
		+	# Edit the "ID" column.
		+	## Change the "Header" text to "Automate Sync".
		+	## Change the "Render Handler" to the following path:
		+	### /ADF/apps/pt_sync/datasheet-modules/ds-auto-sync-actions.cfm
		+	# Save the form.
		+	# Publish this page.
		+
		+	== CommonSpot Hooks ==
		+	CommonSpot provides hooks for editing global custom element and post page approvals. The PT Sync application utilizes these hooks to call the sync processing functions when a global custom element is added/edited and a local custom element is added/edited with a page and the page is approved.
		+
		+	The following steps are to include the CommonSpot hook files into the '''source site''' (these files are not needed on the destination site).
		+
		+	=== Steps ===
		+	# Copy the following two files from the PT Sync app:
		+	## /pt_sync/site_files/post-approve.cfm
		+	## /pt_sync/site_files/post-save-form-hook.cfm
		+	# Paste these files directly within the site root.
		+	# In the PT Sync App, open the delete form data file within the app (/pt_sync/site_files/datasheet-modules/delete-form-data.cfm). Within the file, identify the snippet code block within the comments for "PT SYNC - SNIPPET START" and "PT SYNC - SNIPPET END".
		+	# Locate the delete form data datasheet module within the site (/datasheet-modules/delete-form-data.cfm). Insert the snippet code block within your sites delete form data. Make sure that the snippet code block is ABOVE the cfinclude to the cs-delete-form-data.cfm.
		+	## <cfinclude template="\commonspot\controls\datasheet\cs-delete-form-data.cfm">


	[[Category:PT Sync]]		[[Category:PT Sync]]

@@ Line 37: / Line 37: @@
 # Configure the ''/webadmin/sync/'' subsite Content Security to give permissions to the group of administrators who will manage the sync application.
-== Pages ==
+== App Configuration ==
 The PT Sync Configuration Page will be used to manage the ptSync Configuration custom element.
 '''Setup the App Configuration on the Source site!'''
-==== Steps ====
+=== Steps ===
 # Create a new page called 'Configuration Manager' in the ''/webadmin/sync/'' subsite.
 # In the main content of the page, add a Custom Script element.
@@ Line 51: / Line 49: @@
 # Publish the page.
-==== Create Sync Configuration Record ====
+=== Create Sync Configuration Record ===
 We are creating a single PT Sync Configuration element record to be used within the application.

@@ Line 36: / Line 36: @@
 # Configure the ''/webadmin/sync/'' subsite Content Security to give 'No Rights' to 'Anonymous Users' and 'Authenticated Users'.
 # Configure the ''/webadmin/sync/'' subsite Content Security to give permissions to the group of administrators who will manage the sync application.
 [[Category:PT Sync]]

← Older revision		Revision as of 18:47, 21 December 2011
Line 17:		Line 17:
	* [[Reset ADF\|Reset the ADF]] for the server and site.		* [[Reset ADF\|Reset the ADF]] for the server and site.

		+	== Import ==
		+	'''Only important these elements into the Source Site'''

		+	Create a new element category called "PT Sync Elements".
		+	Import Custom Elements in this order:

		+	# [[PT_Sync_Sync_Mapping_Element\|Sync Mapping]]
		+	# [[PT_Sync_Sync_Configuration_Element\|ptSync Configuration]]

		+	== Subsites ==
		+	It is '''highly recommended''' that a PT Sync webadmin subsite is created for the administrators. This configuration allows subsite security to be used to allow only Administrators access to the webadmin subsite.
		+
		+	Your site may already have a ''webadmin'' subsite. The steps below will add a ''sync'' subsite under the ''webadmin'' subsite.
		+
		+	=== Web Admin ===
		+	# Create a new subsite under the site root called ''webadmin''.
		+	# Create a new subsite under ''webadmin'' called ''sync''.
		+	# Configure the ''/webadmin/sync/'' subsite Content Security to give 'No Rights' to 'Anonymous Users' and 'Authenticated Users'.
		+	# Configure the ''/webadmin/sync/'' subsite Content Security to give permissions to the group of administrators who will manage the sync application.

	[[Category:PT Sync]]		[[Category:PT Sync]]