Application Initialisation
Overview
The first time a FarCry application starts it initialises a complex set of global constants required for the framework to correctly function. You can force a FarCry application to re-initialise by attaching the URL parameter &updateapp=1
Order of Initialisation
FarCry globals get initialised in a specific order. This order is specifically designed to allow the developer to override the behaviour of this initialisation through the use of plugins and/or the specific FarCry project.
- project ./www/Application.cfm
- farcry:farcryinit custom tag replaces the standard cfapplication tag and orchestrates the initialisation
- ColdFusion application specific variables; session timeouts, etc
- Project specific pathing and database information; nominated as attributes of farcryinit
- project ./config/_serverSpecificVars.cfm for server specific variables
- plugins ./config/_serverSpecificVars.cfm in order of plugins attribute of farcryinit
- security model initialisation
- Project specific last minute changes ./config/_serverSpecificVarsAfterInit.cfm
farcry:farcryinit custom tag
Sample usage:
<cfimport taglib="/farcry/core/tags/farcry/" prefix="farcry" /> <farcry:farcryInit name="projectName" projectURL="" dsn="projectDsn" dbType="mysql" plugins="farcrycms" />
Attributes:
Name |
Description |
Required |
Default Value |
Sample Value |
|---|---|---|---|---|
name |
<cfapplication> attribute |
YES |
N/A |
myProject |
sessionmanagement |
<cfapplication> attribute |
NO |
true |
true |
sessiontimeout |
<cfapplication> attribute |
NO |
#createTimeSpan(0,0,20,0)# |
#createTimeSpan(0,0,30,0)# |
applicationtimeout |
<cfapplication> attribute |
NO |
#createTimeSpan(0,0,20,0)# |
#createTimeSpan(0,0,30,0)# |
clientmanagement |
<cfapplication> attribute |
NO |
false |
true |
clientstorage |
<cfapplication> attribute |
NO |
registry |
registry |
loginstorage |
<cfapplication> attribute |
NO |
cookie |
cookie |
scriptprotect |
<cfapplication> attribute |
NO |
[empty string] |
??? |
setclientcookies |
<cfapplication> attribute |
NO |
true |
true |
setdomaincookies |
<cfapplication> attribute |
NO |
true |
true |
dsn |
datasource of project database |
NO |
#attributes.name# |
myProjectDsn |
dbtype |
db type (mysql, etc.) |
YES |
N/A |
mysql |
dbowner |
db owner, if any |
NO |
[empty string] |
dbo. |
projectDirectoryName |
name of project directory within /projects/ |
NO |
#attributes.name# |
myProjDir |
plugins |
comma-separated list of plugins |
NO |
farcrycms |
farcrycms,myplugin |
projectURL |
url to the project site |
NO |
[empty string] |
??? |
bObjectBroker |
enable/disable object broker |
NO |
true |
true |
ObjectBrokerMaxObjectsDefault |
max records for object broker to cache |
NO |
100 |
1000 |
bUseMediaArchive |
option to archive |
NO |
false |
true |