config-dist.php 12.8 KB
Newer Older
gustav_delius's avatar
gustav_delius committed
1
2
3
4
5
6
7
8
9
10
11
12
<?PHP // $Id$
///////////////////////////////////////////////////////////////////////////
//                                                                       //
// Moodle configuration file                                             //
//                                                                       //
// This file should be renamed "config.php" in the top-level directory   //
//                                                                       //
///////////////////////////////////////////////////////////////////////////
//                                                                       //
// NOTICE OF COPYRIGHT                                                   //
//                                                                       //
// Moodle - Modular Object-Oriented Dynamic Learning Environment         //
moodler's avatar
moodler committed
13
//          http://moodle.org                                            //
gustav_delius's avatar
gustav_delius committed
14
//                                                                       //
moodler's avatar
moodler committed
15
// Copyright (C) 1999-2004  Martin Dougiamas  http://dougiamas.com       //
gustav_delius's avatar
gustav_delius committed
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
//                                                                       //
// This program is free software; you can redistribute it and/or modify  //
// it under the terms of the GNU General Public License as published by  //
// the Free Software Foundation; either version 2 of the License, or     //
// (at your option) any later version.                                   //
//                                                                       //
// This program is distributed in the hope that it will be useful,       //
// but WITHOUT ANY WARRANTY; without even the implied warranty of        //
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         //
// GNU General Public License for more details:                          //
//                                                                       //
//          http://www.gnu.org/copyleft/gpl.html                         //
//                                                                       //
///////////////////////////////////////////////////////////////////////////
unset($CFG);  // Ignore this line

//=========================================================================
// 1. DATABASE SETUP
//=========================================================================
// First, you need to configure the database where all Moodle data       //
// will be stored.  This database must already have been created         //
// and a username/password created to access it.                         //
//                                                                       //
//   mysql      - the prefix is optional, but useful when installing     //
//                into databases that already contain tables.            //
//
//   postgres7  - the prefix is REQUIRED, regardless of whether the      //
//                database already contains tables.                      //
//                                                                       //
// A special case exists when using PostgreSQL databases via sockets.    //
// Define dbhost as follows, leaving dbname, dbuser, dbpass BLANK!:      //
//    $CFG->dbhost = " user='muser' password='mpass' dbname='mdata'";    //
48
//
gustav_delius's avatar
gustav_delius committed
49
50

$CFG->dbtype    = 'mysql';       // mysql or postgres7 (for now)
51
$CFG->dbhost    = 'localhost';   // eg localhost or db.isp.com
gustav_delius's avatar
gustav_delius committed
52
53
54
55
56
$CFG->dbname    = 'moodle';      // database name, eg moodle
$CFG->dbuser    = 'username';    // your database username
$CFG->dbpass    = 'password';    // your database password
$CFG->prefix    = 'mdl_';        // Prefix to use for all table names

moodler's avatar
moodler committed
57
$CFG->dbpersist = false;         // Should database connections be reused?
58
59
                 // "false" is the most stable setting
                 // "true" can improve performance sometimes
moodler's avatar
moodler committed
60

gustav_delius's avatar
gustav_delius committed
61
62
63
64
65

//=========================================================================
// 2. WEB SITE LOCATION
//=========================================================================
// Now you need to tell Moodle where it is located. Specify the full
66
67
// web address to where moodle has been installed.  If your web site
// is accessible via multiple URLs then choose the most natural one
gustav_delius's avatar
gustav_delius committed
68
69
70
71
72
73
74
75
76
77
78
// that your students would use.  Do not include a trailing slash

$CFG->wwwroot   = 'http://example.com/moodle';


//=========================================================================
// 3. SERVER FILES LOCATION
//=========================================================================
// Next, specify the full OS directory path to this same location
// Make sure the upper/lower case is correct.  Some examples:
//
79
//    $CFG->dirroot = 'c:\program files\easyphp\www\moodle';    // Windows
gustav_delius's avatar
gustav_delius committed
80
//    $CFG->dirroot = '/var/www/html/moodle';     // Redhat Linux
81
//    $CFG->dirroot = '/home/example/public_html/moodle'; // Cpanel host
gustav_delius's avatar
gustav_delius committed
82

83
$CFG->dirroot   = '/home/example/public_html/moodle';
gustav_delius's avatar
gustav_delius committed
84
85
86
87
88
89


//=========================================================================
// 4. DATA FILES LOCATION
//=========================================================================
// Now you need a place where Moodle can save uploaded files.  This
90
91
// directory should be readable AND WRITEABLE by the web server user
// (usually 'nobody' or 'apache'), but it should not be accessible
gustav_delius's avatar
gustav_delius committed
92
93
94
95
96
97
98
99
100
101
102
103
104
105
// directly via the web.
//
// - On hosting systems you might need to make sure that your "group" has
//   no permissions at all, but that "others" have full permissions.
//
// - On Windows systems you might specify something like 'c:\moodledata'

$CFG->dataroot  = '/home/example/moodledata';


//=========================================================================
// 5. DATA FILES PERMISSIONS
//=========================================================================
// The following parameter sets the permissions of new directories
106
// created by Moodle within the data directory.  The format is in
gustav_delius's avatar
gustav_delius committed
107
// octal format (as used by the Unix utility chmod, for example).
108
// The default is usually OK, but you may want to change it to 0750
gustav_delius's avatar
gustav_delius committed
109
110
111
112
// if you are concerned about world-access to the files (you will need
// to make sure the web server process (eg Apache) can access the files.
// NOTE: the prefixed 0 is important, and don't use quotes.

113
$CFG->directorypermissions = 02777;
gustav_delius's avatar
gustav_delius committed
114
115
116
117
118


//=========================================================================
// 6. DIRECTORY LOCATION  (most people can just ignore this setting)
//=========================================================================
119
120
121
122
// A very few webhosts use /admin as a special URL for you to access a
// control panel or something.  Unfortunately this conflicts with the
// standard location for the Moodle admin pages.  You can fix this by
// renaming the admin directory in your installation, and putting that
gustav_delius's avatar
gustav_delius committed
123
124
125
126
127
128
// new name here.  eg "moodleadmin".  This will fix admin links in Moodle.

$CFG->admin = 'admin';


//=========================================================================
129
// 7. OTHER MISCELLANEOUS SETTINGS (ignore these for new installations)
130
131
//=========================================================================
//
132
133
134
// These are additional tweaks for which no GUI exists in Moodle yet.
//
//
135
// Prevent users from updating their profile images
136
//      $CFG->disableuserimages = true;
137
//
138
139
140
// Prevent scheduled backups from operating (and hide the GUI for them)
// Useful for webhost operators who have alternate methods of backups
//      $CFG->disablescheduledbackups = true;
141
142
143
144
145
//
// Restrict certain usernames from doing things that may mess up a site
// This is especially useful for demonstration teacher accounts
//      $CFG->restrictusers = 'teacher,fred,jim';
//
moodler's avatar
moodler committed
146
// Turning this on will make Moodle filter more than usual, including
147
148
// forum subjects, activity names and so on (in ADDITION to the normal
// texts like forum postings, journals etc).  This is mostly only useful
moodler's avatar
moodler committed
149
150
// when using the multilang filter.   This feature may not be complete.
//      $CFG->filterall = true;
moodler's avatar
moodler committed
151
152
153
//
// Setting this to true will enable admins to edit any post at any time
//      $CFG->admineditalways = true;
154
//
155
156
// These variables define DEFAULT block variables for new courses
// If this one is set it overrides all others and is the only one used.
157
158
159
//      $CFG->defaultblocks_override = 'participants,activity_modules,search_forums,admin,course_list:news_items,calendar_upcoming,recent_activity';
//
// These variables define the specific settings for defined course formats.
160
161
// They override any settings defined in the formats own config file.
//      $CFG->defaultblocks_site = 'site_main_menu,admin,course_list:course_summary,calendar_month';
162
163
164
165
//      $CFG->defaultblocks_social = 'participants,search_forums,calendar_month,calendar_upcoming,social_activities,recent_activity,admin,course_list';
//      $CFG->defaultblocks_topics = 'participants,activity_modules,search_forums,admin,course_list:news_items,calendar_upcoming,recent_activity';
//      $CFG->defaultblocks_weeks = 'participants,activity_modules,search_forums,admin,course_list:news_items,calendar_upcoming,recent_activity';
//
166
167
// These blocks are used when no other default setting is found.
//      $CFG->defaultblocks = 'participants,activity_modules,search_forums,admin,course_list:news_items,calendar_upcoming,recent_activity';
168
//
moodler's avatar
moodler committed
169
//
170
// This setting will put Moodle in Unicode mode.  It's very new and
171
172
173
// most likely doesn't work yet.   THIS IS FOR DEVELOPERS ONLY, IT IS
// NOT RECOMMENDED FOR PRODUCTION SITES
//      $CFG->unicode = true;
174
//
175
176
177
// Seconds for files to remain in caches. Decrease this if you are worried
// about students being served outdated versions of uploaded files.
//      $CFG->filelifetime = 86400;
178
// 
179
180
181
182
183
184
// If this setting is set to true, then 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 coming using proxies that change all the time,
// like AOL.
//      $CFG->tracksessionip = true;
185
186
187
//
//
// The following lines are for handling email bounces.
188
189
190
//      $CFG->handlebounces = true;
//      $CFG->minbounces = 10;
//      $CFG->bounceratio = .20;
191
192
193
// The next lines are needed both for bounce handling and any other email to module processing.
// mailprefix must be EXACTLY four characters.
// Uncomment and customise this block for Postfix 
194
195
196
//      $CFG->mailprefix = 'mdl+'; // + is the separator for Exim and Postfix.
//      $CFG->mailprefix = 'mdl-'l // - is the separator for qmail 
//      $CFG->maildomain = 'youremaildomain.com';
197
198
199
200
//
// The following setting will tell Moodle to respect your PHP session 
// settings. Use this if you want to control session configuration
// from php.ini, httpd.conf or .htaccess files. 
201
//      $CFG->respectsessionsettings = true;
202
203
204
205
//
// This setting will cause the userdate() function not to fix %d in 
// date strings, and just let them show with a zero prefix.
//      $CFG->nofixday = true;
206
207
208
//
// This setting will make some graphs (eg user logs) use lines instead of bars
//      $CFG->preferlinegraphs = true;
209
210
211
//
// Enabling this will make most text-based filters only match the first time
// a phrase occurs in a given text.  Otherwise all are matched.
212
//      $CFG->filtermatchonepertext = true;
213
214
215
216
//
// Enabling this will make most text-based filters only match the first time
// a phrase occurs in a given page.  Otherwise all are matched.
//      $CFG->filtermatchoneperpage = true;
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
//
// Performance profiling 
// 
//   If you set Debug to "Yes" in the Configuration->Variables page some
//   performance profiling data will show up on your footer (in default theme).
//   With these settings you get more granular control over the capture
//   and printout of the data
//
//   Capture performance profiling data
//   define('MDL_PERF'  , true);
//
//   Capture additional data from DB
//   define('MDL_PERFDB'  , true);
//
//   Print to log (for passive profiling of production servers)
//   define('MDL_PERFTOLOG'  , true);
//
//   Print to footer (works with the default theme)
//   define('MDL_PERFTOFOOT', true);
//
gustav_delius's avatar
gustav_delius committed
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253

//=========================================================================
// ALL DONE!  To continue installation, visit your main page with a browser
//=========================================================================
if (file_exists("$CFG->dirroot/lib/setup.php"))  {       // Do not edit
    include_once("$CFG->dirroot/lib/setup.php");
} else {
    if ($CFG->dirroot == dirname(__FILE__)) {
        echo "<p>Could not find this file: $CFG->dirroot/lib/setup.php</p>";
        echo "<p>Are you sure all your files have been uploaded?</p>";
    } else {
        echo "<p>Error detected in config.php</p>";
        echo "<p>Error in: \$CFG->dirroot = '$CFG->dirroot';</p>";
        echo "<p>Try this: \$CFG->dirroot = '".dirname(__FILE__)."';</p>";
    }
    die;
}
254
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
gustav_delius's avatar
gustav_delius committed
255
256
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>