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!)
 
(55 intermediate revisions by 6 users 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
 
# Download the ADF (two options)
 
# Download the ADF (two options)
 
#* Latest zip archive (http://community.paperthin.com/projects/ADF/)
 
#* Latest zip archive (http://community.paperthin.com/projects/ADF/)
#* SVN (http://community.paperthin.com/svn/adf/)
+
#* SVN (http://community.paperthin.com/svn/ADF/)
# Copy the ADF directory to your server at the same level as the CommonSpot directory.  The name of the folder is "ADF" and must be all capital letters.  The ADF should not be created within a CommonSpot site directory.
+
# 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. 
 +
# Copy the contents of this zip file into the ADF directory.
 
# Create a ColdFusion Mapping ( /ADF ) to the ADF directory
 
# Create a ColdFusion Mapping ( /ADF ) to the ADF directory
 
# 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==
  
Starter Files are located in the ''/ADF/core/site-sample'' directory. This contains a starter 'custom-application.cfm', 'ADF.cfc', and 'ajaxProxy.cfm'. These files contain the basic initialization code for the ADF configuration into 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.   
  
  
# Copy the ''ADF.cfc'' and ''ajaxProxy.cfm'' into the sites ''/_cs_apps/'' directory.
+
<!--  (OLD) # Copy the ''ADF.cfc'', ''ajaxProxy.cfm'', and ''lightboxProxy.cfm'' into the sites ''/_cs_apps/'' directory. -->
 +
# Copy the ADF.cfc, ajaxProxy.cfm, and lightboxProxy.cfm from the ADF/core/site-sample into your site's /_cs_apps/ directory.
 
# Identify if your site is currently using a ''custom-application.cfm'' file.   
 
# 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 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''.
<code lang="html">
+
#* If not, then copy the ''custom-application.cfm'' to your site's root (ColdFusion restart is required).
<cfinclude template="/ADF/core/load_site_adf.cfm">
 
</code>
 
* If not, then copy the ''custom-application.cfm'' to your sites 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 the steps in "Set up the ADF" for each site utilizing the ADF
+
 
 +
'''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 ==
 
== Related Guides ==
* [[Site Configuration|Site Configuration]]
+
* [[Site Configuration (ADF.cfc)]]
* [[Create_New_App|Create New ADF Application]]
+
* [[ADF Applications|Create New ADF Application]]
 
* [[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!