Configuration file: Difference between revisions
Helen Foster (talk | contribs) (Enabling debugging) |
|||
(9 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
{{Installing Moodle}} | |||
The name for Moodle's configuration file is config.php. The file is located in the moodle directory. It is not included in the Moodle download packages and is created by the installation process from the template file config-dist.php (which is included in Moodle packages). | The name for Moodle's configuration file is config.php. The file is located in the moodle directory. It is not included in the Moodle download packages and is created by the installation process from the template file config-dist.php (which is included in Moodle packages). | ||
== | ==config-dist.php== | ||
Although the installation process creates the config.php file for you, there may be times when you want to do this yourself. | Although the installation process creates the config.php file for you, there may be times when you want to do this yourself. A sample config file, called config-dist.php, is shipped with Moodle. | ||
To get started simply copy config-dist.php to config.php, then edit config.php with you favourite editor. The file is very well commented. The important options (which you must supply) are all nearer the top. Other less common options are further down. | |||
==Setting $CFG->wwwroot correctly== | |||
This setting must be a fixed URL (a string constant) that points to your site. Do not try to set this with any PHP code that can generate a variable URL. This is not supported, can cause strange problems and will stop command line scripts working completely. If your site is accessed from different IP addresses this should be done with a split DNS, see [[Masquerading]] | |||
$CFG-> | |||
==Enabling password salting== | ==Enabling password salting== | ||
Line 50: | Line 28: | ||
==Changing default theme directory location== | ==Changing default theme directory location== | ||
The location of theme | The location of theme directories may be altered, using the variables ''$CFG->themewww'' and ''$CFG->themedir''. Themes placed in the directory specified by these variables will then be available for selection using the theme selector. | ||
For example, should you wish to place themes in a subdirectory called 'my_moodle_themes', your config.php might look like this: | For example, should you wish to place themes in a subdirectory called 'my_moodle_themes', your config.php might look like this: | ||
Line 60: | Line 38: | ||
</pre> | </pre> | ||
== | ==Disabling update notifications== | ||
See [[Notifications]]. | |||
==Enabling debugging== | |||
See [[Debugging]]. | |||
==See also== | ==See also== | ||
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=137889 Moodle Salting] forum discussion | * Using Moodle [http://moodle.org/mod/forum/discuss.php?d=137889 Moodle Salting] forum discussion | ||
[[de:Konfigurationsdatei]] | [[de:Konfigurationsdatei]] | ||
[[fr:Fichier de configuration]] | [[fr:Fichier de configuration]] | ||
[[ja:設定ファイル]] | [[ja:設定ファイル]] |
Latest revision as of 22:19, 11 December 2012
The name for Moodle's configuration file is config.php. The file is located in the moodle directory. It is not included in the Moodle download packages and is created by the installation process from the template file config-dist.php (which is included in Moodle packages).
config-dist.php
Although the installation process creates the config.php file for you, there may be times when you want to do this yourself. A sample config file, called config-dist.php, is shipped with Moodle.
To get started simply copy config-dist.php to config.php, then edit config.php with you favourite editor. The file is very well commented. The important options (which you must supply) are all nearer the top. Other less common options are further down.
Setting $CFG->wwwroot correctly
This setting must be a fixed URL (a string constant) that points to your site. Do not try to set this with any PHP code that can generate a variable URL. This is not supported, can cause strange problems and will stop command line scripts working completely. If your site is accessed from different IP addresses this should be done with a split DNS, see Masquerading
Enabling password salting
See Password salting.
Including passwords in backups
Hashed user passwords are no longer saved in backup files containing user data in Moodle 1.8.11 and 1.9.7 onwards.
If you really need passwords to be saved (in the rare case of restoring a backup with user data to a different site), the following line may be added to config.php:
$CFG->includeuserpasswordsinbackups
Changing default block layout for new courses
See Block layout.
Changing default theme directory location
The location of theme directories may be altered, using the variables $CFG->themewww and $CFG->themedir. Themes placed in the directory specified by these variables will then be available for selection using the theme selector.
For example, should you wish to place themes in a subdirectory called 'my_moodle_themes', your config.php might look like this:
$CFG->wwwroot = 'http://my.moodle.site.edu'; $CFG->dirroot = '/var/www/my.moodle.site.edu/public_html'; $CFG->themewww = $CFG->wwwroot . '/my_moodle_themes'; $CFG->themedir = $CFG->dirroot . '/my_moodle_themes';
Disabling update notifications
See Notifications.
Enabling debugging
See Debugging.
See also
- Using Moodle Moodle Salting forum discussion