Customizing an Application at the Site Level - Revision history

Rwest at 05:09, 15 April 2010

2010-04-15T05:09:35Z

Rwest at 04:22, 5 April 2010

2010-04-05T04:22:36Z

Rwest: moved Application Site Customization to Customizing an Application at the Site Level: Trying to remove ambiguous title

2010-04-05T03:52:45Z

moved Application Site Customization to Customizing an Application at the Site Level: Trying to remove ambiguous title

Renee.mckechnie at 00:57, 20 December 2009

2009-12-20T00:57:48Z

WikiSysop: Created page with '== Application Site Customization == See Custom Application Site Level Customization wiki page for more detailed information on si…'

2009-11-22T06:00:58Z

Created page with '== Application Site Customization == See Custom Application Site Level Customization wiki page for more detailed information on si…'

New page

== Application Site Customization ==
See [[Custom_Application_Site_Level_Customization|Custom Application Site Level Customization]] wiki page for more detailed information on site customization.

# Locate the ''_cs_apps'' directory on the site.
# Verify that the ADF application directory exists in ''_cs_apps'', if not then create. For example, the Profile Application will have the directory ''_cs_apps/pt_profile''.
# Place an [[Site_Application_Bean_Config|Site Application Bean Config]] file in the ADF application directory in the site "_cs_apps" directory.
# Update the [[Site_Application_Bean_Config|Site Application Bean Config]] variables for site name and application name.
# Ensure that the ''appComPath'' variable is correct.
# Update the [[App Bean Config|App Bean Config]] of the site app to use any components at the site level, or server app level.
# Update the sites ''ADF.cfc'' to load the new application name into application scope via the ''loadApp'' function. See the [[Site_Configuration#ADF_Applications|Site Configuration - ADF Applications]] wiki page for more details.
# For example, if we created a site customization for the Profile Application for ''SITE01'', then the ''loadApp'' function will reference the application as:
loadApp("ptProfile", "pt_profile_SITE01");

@@ Line 22: / Line 22: @@
 == Best Practices ==
 * It is a good idea to keep the arguments and return variables the same in the method you modify.  The goal of the override should be to change the internals of the function, not the function itself
 [[Category: How-to Guide]][[Category: Customization]]

@@ Line 1: / Line 1: @@
-== Application Site Customization ==
+== Overview ==
-See the [[Custom_Application_Site_Level_Customization|Custom Application Site Level Customization]] wiki page for more detailed information on site customization.
+Most ADF Applications contain [[Application Components]] which control a lot of the functionality for the Application.  In most cases, the Application Components control everything from storing/retrieving data from a Custom Element to rendering data on a page.
-# Locate the ''_cs_apps'' directory on the site.
+While building an [[ADF Application]] it can be difficult to think about all of the ways your application will be used and what customizations will be needed for each site that uses your applications.  Luckily, customizing (or extending, overriding) applications at the site level is very easy.
-# Verify that the ADF application directory exists in ''_cs_apps''; if not, create.  For example, the Profile Application will have the directory ''_cs_apps/pt_profile''.
-# Place an [[Site_Application_Bean_Config|Site Application Bean Config]] file in the ADF application directory in the site "_cs_apps" directory.
+The general concept: You download an application from the [[http://community.paperthin.com/projects/browse.cfm CommonSpot Community Site] and there is a change in one of the components that you need to make.  Instead of modifying the component (for example /ADF/apps/pt_profile/components/profileService.cfc) directly within the /ADF/apps/appName/components/ directory - you would make a copy of that file and make the modification within the copy
-# Update the [[Site_Application_Bean_Config|Site Application Bean Config]] variables for site name and application name.
-# Ensure that the ''appComPath'' variable is correct.
+== Step by Step ==
-# Update the [[App Bean Config|App Bean Config]] of the site app to use any components at the site level, or server app level.
+Using the example from above:
-# Update the sites ''ADF.cfc'' to load the new application name into application scope via the ''loadApp'' function.  See the [[Site_Configuration#ADF_Applications|Site Configuration - ADF Applications]] wiki page for more details.
+# In the site where you will make the modification create a directory within the sites /_cs_apps/ directory that mimics the name of the Application you will be customizing (for example: /mySite/_cs_apps/pt_profile/)
-# For example, if we created a site customization for the Profile Application for ''SITE01'', then the ''loadApp'' function will reference the application as:
+  Note: it is important to name the directory the SAME as the original app directory
-  loadApp("ptProfile", "pt_profile_SITE01");
+# Create a /components/ directory in the newly created [[Site Level Application Directory]] (e.g. /mySite/_cs_apps/pt_profile/components/)
 [[Category: How-to Guide]][[Category: Customization]]

← Older revision	Revision as of 03:52, 5 April 2010
(No difference)