Difference between revisions of "ADF Installation"

From ADF Docs
Jump to: navigation, search
(Set up the ADF to work with a site)
(ADF 2.5 and above!)
 
(26 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
 +
'''IMPORTANT:''' ADF 2.5 or above requires CommonSpot 10.6.1 or 10.5.2 or above.
 +
 
== Get the code and configure CF/Web ==
 
== Get the code and configure CF/Web ==
 
The following steps outline how to download the ADF and configure CommonSpot and your sites to use the ADF
 
The following steps outline how to download the ADF and configure CommonSpot and your sites to use the ADF
Line 9: Line 12:
 
# Create a Website Mapping ( /ADF ) to the ADF directory
 
# Create a Website Mapping ( /ADF ) to the ADF directory
  
 
+
'''Note:''' At this point the ADF has been set up for the server.
'''Note: At this point the ADF has been set up for the server.'''
 
  
 
==Set up the ADF to work with a site==
 
==Set up the ADF to work with a site==
Line 23: Line 25:
 
#* If not, then copy the ''custom-application.cfm'' to your site's root (ColdFusion restart is required).
 
#* If not, then copy the ''custom-application.cfm'' to your site's root (ColdFusion restart is required).
 
# [[Reset ADF|Reset the ADF]] for the Server and Site.
 
# [[Reset ADF|Reset the ADF]] for the Server and Site.
 +
# Register the ADF Script Resources with CommonSpot (for ADF 2.0 and above only!)
 +
## Run the [[Register All Scripts|Register ALL Scripts]] tool.
 
# You are good!
 
# You are good!
  
  
'''Note: You will need to repeat these steps for each 'site' utilizing the ADF.'''
+
'''Note:''' You will need to repeat these steps for each 'site' utilizing the ADF.
  
REMEMBER: When ready to go LIVE the ADF setup on each server (Authoring and each ROPS) should all mirror each other. Also, the copying of the ADF files is a manual process between servers.
+
'''REMEMBER:''' When going LIVE the '''ADF''' setup on each server (Authoring and each ROPS) should mirror each other.
 +
Copying '''ADF''' files between servers is a manual process. At this time CommonSpot does NOT have a UI for this.
  
 
== Related Guides ==
 
== Related Guides ==
Line 35: Line 40:
 
* [[Add_New_Library_Component|Add New Component to Library]]
 
* [[Add_New_Library_Component|Add New Component to Library]]
 
* [[Load_ADF_Components_into_Site|Load ADF Components into Site]]
 
* [[Load_ADF_Components_into_Site|Load ADF Components into Site]]
 
+
=== ADF 2.0 and above! ===
 +
* [[ADF Scripts and CommonSpot Registered Resources]]
 +
* [[Register All Scripts|Register ALL ADF Scripts as CommonSpot Resources]]
 +
=== ADF 2.5 and above! ===
 +
* [http://community.paperthin.com/projects/ADF/docs/release-notes/Release-Notes-v2-5.cfm v2.5 Release Notes]
 +
* [[ADF AjaxProxy CSRF Safe Mode]]
  
 
[[Category: Installing the ADF]][[Category: How-to Guide]]
 
[[Category: Installing the ADF]][[Category: How-to Guide]]

Latest revision as of 14:57, 4 March 2020

IMPORTANT: ADF 2.5 or above requires CommonSpot 10.6.1 or 10.5.2 or above.

Get the code and configure CF/Web

The following steps outline how to download the ADF and configure CommonSpot and your sites to use the ADF

  1. Download the ADF (two options)
  2. Create a directory on your server named "ADF" at the same level as CommonSpot. The name of the folder is "ADF" and must be all capital letters. The ADF should not be created within a CommonSpot site directory.
  3. Copy the contents of this zip file into the ADF directory.
  4. Create a ColdFusion Mapping ( /ADF ) to the ADF directory
  5. Create a Website Mapping ( /ADF ) to the ADF directory

Note: At this point the ADF has been set up for the server.

Set up the ADF to work with a site

Starter Files are located in the /ADF/core/site-sample directory. This contains a starter 'custom-application.cfm', 'ADF.cfc', 'ajaxProxy.cfm', and 'lightboxProxy.cfm'. These files contain the basic initialization code for the ADF configuration into a site.


  1. Copy the ADF.cfc, ajaxProxy.cfm, and lightboxProxy.cfm from the ADF/core/site-sample into your site's /_cs_apps/ directory.
  2. Identify if your site is currently using a custom-application.cfm file.
    • If your site is running a custom-application.cfm file, then add a cfinclude tag with the template path /ADF/core/load_site_adf.cfm into the top of your sites custom-application.cfm.
    • If not, then copy the custom-application.cfm to your site's root (ColdFusion restart is required).
  3. Reset the ADF for the Server and Site.
  4. Register the ADF Script Resources with CommonSpot (for ADF 2.0 and above only!)
    1. Run the Register ALL Scripts tool.
  5. You are good!


Note: You will need to repeat these steps for each 'site' utilizing the ADF.

REMEMBER: When going LIVE the ADF setup on each server (Authoring and each ROPS) should mirror each other.
Copying ADF files between servers is a manual process. At this time CommonSpot does NOT have a UI for this.

Related Guides

ADF 2.0 and above!

ADF 2.5 and above!