This is the actual reference for configuration settings. The following explanations have been taken from help pages, forum posts, and comments in source code.
These are settings that have been created by the installer, derived from config-dist.php
. Most parameters are compulsory in order for Moodle to operate, so be careful when changing any of them. The parameters are listed in the order in which they appear by default in config.php
:
Parameter |
Description |
---|---|
|
The database system that is used. The four valid values are |
| |
|
The name of the database host. |
|
The name of the database. |
|
The username of the database account. |
|
The password of the database account. |
|
By default, all tables in Moodle are prefixed with |
|
Values that determine database behavior: |
|
This is the full web address (including |
|
This is the absolute directory name where Moodle's data dictionary is located. The directory has to be readable and writable, but must not be accessible via the Web. |
|
The admin pages in Moodle are located in the admin directory. If this has to be changed then specify the new directory here as some ISPs don't allow its usage. This approach can also potentially help secure the site from attacks. |
|
These are the permissions (in Unix format) that are applied for directories Moodle is creating. The default is |
Almost 400 parameters set in config.php
are not set by the installer, nor can they be modified via the Moodle administrator interface. These optional parameters allow you to modify the behavior of Moodle without the requirement to change any code.
We only cover a representative list of settings, ignoring those that are only relevant to developers and designers. We have also disregarded obsolete and obscure parameters, as well as ones that have a counterpart in the admin settings. Parameters have been listed in alphabetical order and some have been grouped together for simplicity. Available types are array (A), binary (B), numeric (N), list (L), and string (S):
Name |
Type |
Description |
---|---|---|
|
B |
Set to |
|
B |
Security setting for the AMF web service protocol. |
|
N |
Logging Apache: |
|
N |
Memory threshold over which Apache children will be reaped after they finish serving the request. |
|
N |
Default is |
|
A |
Adding entries to Server | File types, for instance
$CFG->customfiletypes = array( (object)array( 'extension' => 'mobi', 'icon' => 'document', 'type' => 'application/x-mobipocket-ebook', 'customdescription' => 'Kindle ebook' ) ); |
|
S |
You can replace the front page with your own version; https://moodle.org/ uses this approach. Only the center area will be replaced—not the header, footer, or blocks. |
|
S |
Enabling this will allow custom scripts (to be specified with the full path name) to replace existing Moodle scripts. For example, if Warning: Replacing standard Moodle scripts may pose a security risk and/or may not be compatible with upgrades. However, this is useful when having to patch a particular page without actually overwriting the core code. |
|
S |
Comma-separated list of user IDs that always see debug messages. |
|
A |
Default block variables for new courses—for instance, |
|
S |
The absolute directory name where Moodle has been installed. |
|
B |
This setting will prevent the |
|
B |
Disables the on-click plugin installation feature and hides it from the server administration user interface. |
|
B |
Prevents stats processing and hides the GUI. |
|
B |
Disables update deployment. Useful when deployment is done via Git checkouts. |
|
B |
Disables update notifications. Useful when deployment is done via Git checkouts. |
|
B |
Completely disables user creation when restoring a course. Enabling this setting results in the restore process stopping when a user attempts to restore a course requiring users to be created. |
|
S |
Divert all outgoing e-mails to this address to test and debug emailing features. |
|
S |
E-mail database connection errors to someone. If Moodle cannot connect to the database, then e-mail this address with a notice. |
|
S |
You can specify an alternative to dataroot. |
|
N |
Seconds for files to remain in caches (default is |
|
Same as | |
|
A |
Plugin settings have to specified as an array of arrays:
|
|
B |
If set, the My Moodle page cannot be customized by users. |
|
S |
To anonymize user names for all students. If set, then all non-teachers will always see this for every person. |
|
N |
If unlimitedgrades is set, you can specify a maximum value ( |
|
B |
This is for handling e-mail bounces. Used in conjunction with |
|
S |
|
|
B |
Allows user passwords to be included in backup files. Use only if you can guarantee that all your backup files remain private as password hashes can be unencrypted. |
|
B |
Keeps the temporary directories used by backup and restores them without being deleted at the end of the process. See also the Managing courses in bulk section in Chapter 4, Course Management. |
|
S |
Alternative directory to |
|
S |
Your e-mail domain. |
|
S |
|
|
N |
Default is |
|
N |
Number of days when the networking key expires. See Chapter 16, Moodle Networking, for details. |
|
B |
When working with production data on test servers, no e-mail or other messages should ever be sent to real users. |
|
S |
Location of the |
|
S |
Random string added to the |
|
B |
This setting will make some graphs (for instance, user logs) use lines instead of bars. |
|
B |
Disables editing of tasks in Server | Scheduled tasks. |
|
B |
Enable when setting up advanced reverse proxy load-balancing configurations and port forwarding. |
|
B |
Adds debug info to cron output. |
|
B |
Show executed SQL queries during cron execution |
|
B |
Disables automatic language update and lets translators (lang pack maintainers) keep their |
|
B |
Enable when using external SSL appliance for performance reasons. |
|
N |
E-mails to supports can be redirected to another user. |
|
S |
Sorts tags in a tag cloud by a specified field, |
|
S |
Adds an extra theme directory outside |
|
A |
Priority of themes from highest to lowest. Default is |
|
B |
Prevents theme caching. |
|
B |
Moodle will track the IP of the current user to make sure it hasn't changed during a session. This will prevent the possibility of sessions being hijacked via XSS, but it may break things for users using proxies that change all the time (such as AOL). |
|
S |
Alternative location for |
|
A |
The blocks in this list are protected from deletion—for example, |
|
S |
Password protection during the upgrade process. See https://docs.moodle.org/en/Upgrade_key for details. |
|
B |
Pretends a Moodle update is running. |
|
B | |
|
B |
For testing PayPal using the PayPal developer sandbox. |
|
B |
Use ZIP compression in backups instead of the default TGZ. |
3.139.70.21