Page Operations
Browse Space
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 |