The "config" Directory
This directory contains the majority of Mura's configuration files. There are a handful of editable files outlined below.
| Directory | Editable | Description |
|---|---|---|
| {context}/config/appcfc/ | No | The files contained in this directory are included in Mura's main Application.cfc file. See The "appcfc" Directory section for details. |
| {context}/config/setup/ | No | This directory contains files required during the installation process. |
| {context}/config/templates/ | No | This directory contains "templates" used to create core files such as the settings.ini.cfm, robots.txt, and some site files such as the SitecontentRenderer.cfc, and Site eventHandler.cfc. These files are typically only used during the installation process. |
| {context}/config/.gitignore | No | The Mura Team uses Git for distributed version control, and this is the site .gitignore file used to specify intentionally untracked files. |
| {context}/config/Application.cfc | No | This particular file merely prevents users from navigating to any of the .cfm or .cfc files directly via the browser. |
| {context}/config/applicationSettings.cfm | No | This file is included in the main Application.cfc file, and contains the main application settings and variables. |
| {context}/config/buildMainMappings.cfm | No | This file included in the main Application.cfc file, and contains code to create the CFML mappings used by Mura in the mappings.cfm file. |
| {context}/config/buildPluginCFApplication.cfm | No | This file creates the {context}/plugins/cfapplication.cfm file. It also scans plugins and parses their config.xml.cfm files for custom tag paths and ORM settings, then adds the information collected to the cfapplication.cfm file. |
| {context}/config/buildPluginMappings.cfm | No | This file creates the {context}/plugins/mappings.cfm file, and creates a CFML mapping for each plugin. It also scans plugins and parses their config.xml.cfm files for any defined mappings, and then adds them to the mappings.cfm file. |
| {context}/config/cfapplication.cfm | Yes | Experienced developers may add custom Application.cfc variables here. |
| {context}/config/error.html | No* | This is the default file used to display an error message to site visitors by Mura when debuggingenabled is set to false in the settings.ini.cfm file and a server-side error occurs during the request. Visit the Custom Error Page section of the Theme Developer's Guide for more information. |
| {context}/config/lockdown.cfm | No* | This file is used to display a login screen when the Site Mode (found under Site Settings > Edit Site > Basic Tab) is set to either Development or Maintenance. |
| {context}/config/mappings.cfm | Yes | Experienced developers may add custom ColdFusion/CFML mappings here. |
| {context}/config/settings.cfm | No | This file is sometimes used as an "include" file for plugins. It contains Mura's onSessionStart variables, onApplicationStart variables, and onRequestStart variables. |
| {context}/config/settings.ini.cfm | Yes | This is an extremely important file, and contains many configuration settings for Mura. View the settings.ini.cfm reference guide for details. |