| 1 | #!perl |
1 | #!perl |
| 2 | ################################################################################ |
2 | ################################################################################ |
| 3 | # WeBWorK Online Homework Delivery System |
3 | # WeBWorK Online Homework Delivery System |
| 4 | # Copyright © 2000-2003 The WeBWorK Project, http://openwebwork.sf.net/ |
4 | # Copyright © 2000-2006 The WeBWorK Project, http://openwebwork.sf.net/ |
| 5 | # $CVSHeader: webwork-modperl/conf/global.conf.dist,v 1.84 2004/07/04 02:08:28 dpvc Exp $ |
5 | # $CVSHeader: webwork2/conf/global.conf.dist,v 1.166 2006/05/16 21:06:47 sh002i Exp $ |
| 6 | # |
6 | # |
| 7 | # This program is free software; you can redistribute it and/or modify it under |
7 | # This program is free software; you can redistribute it and/or modify it under |
| 8 | # the terms of either: (a) the GNU General Public License as published by the |
8 | # the terms of either: (a) the GNU General Public License as published by the |
| 9 | # Free Software Foundation; either version 2, or (at your option) any later |
9 | # Free Software Foundation; either version 2, or (at your option) any later |
| 10 | # version, or (b) the "Artistic License" which comes with this package. |
10 | # version, or (b) the "Artistic License" which comes with this package. |
| … | |
… | |
| 17 | |
17 | |
| 18 | # This file is used to set up the default WeBWorK course environment for all |
18 | # This file is used to set up the default WeBWorK course environment for all |
| 19 | # requests. Values may be overwritten by the course.conf for a specific course. |
19 | # requests. Values may be overwritten by the course.conf for a specific course. |
| 20 | # All package variables set in this file are added to the course environment. |
20 | # All package variables set in this file are added to the course environment. |
| 21 | # If you wish to set a variable here but omit it from the course environment, |
21 | # If you wish to set a variable here but omit it from the course environment, |
| 22 | # use the "my" keyword. The following variables are available to this file: |
22 | # use the "my" keyword. The $webwork_dir variable is set in the WeBWorK Apache |
| 23 | # |
23 | # configuration file (webwork.apache-config) and is available for use here. In |
| 24 | # $webworkRoot directory that contains the WeBWorK distribution |
24 | # addition, the $courseName variable holds the name of the current course. |
| 25 | # corresponds to the directory !WEBWORK_ROOT! in the stanza below |
|
|
| 26 | # $webworkURLRoot base URL handled by Apache::WeBWorK |
|
|
| 27 | # corresponds to url /webwork2 in the stanza below |
|
|
| 28 | # $pgRoot directory that contains the PG distribution |
|
|
| 29 | # corresponds to the directory !PG_ROOT! below |
|
|
| 30 | # $courseName name of the course being used (e.g. mth101) |
|
|
| 31 | # |
|
|
| 32 | # Stanza placed in the httpd.conf directory |
|
|
| 33 | # <Location /webwork2> |
|
|
| 34 | # SetHandler perl-script |
|
|
| 35 | # PerlHandler Apache::WeBWorK |
|
|
| 36 | # |
|
|
| 37 | # PerlSetVar webwork_root !WEBWORK_ROOT! |
|
|
| 38 | # PerlSetVar pg_root !PG_ROOT! |
|
|
| 39 | # <Perl> |
|
|
| 40 | # use lib '!WEBWORK_ROOT!/lib'; |
|
|
| 41 | # use lib '!PG_ROOT!/lib'; |
|
|
| 42 | # </Perl> |
|
|
| 43 | # </Location> |
|
|
| 44 | |
25 | |
| 45 | ################################################################################ |
26 | ################################################################################ |
| 46 | # The following two variables must match the first and second entries of the |
27 | # Seed variables |
| 47 | # AliasMatch statement placed in the httpd.conf file |
|
|
| 48 | ################################################################################ |
28 | ################################################################################ |
| 49 | |
29 | |
|
|
30 | # Set these variables to correspond to your configuration and preferences. You |
|
|
31 | # will need to restart the webserver to reset the variables in this section. |
| 50 | |
32 | |
| 51 | # The AliasMatch directive directs to files stored in the html directory of each course. |
33 | # URL of WeBWorK handler. |
| 52 | # AliasMatch ^/webwork2_course_files/([^/]*)/(.*) !COURSES_ROOT!/$1/html/$2 |
34 | $webwork_url = "/webwork2"; |
| 53 | # URL ---------> html directory of the course |
|
|
| 54 | # |
|
|
| 55 | # $1 matches the courseName $2 matches any subdirectories of the course html directory |
|
|
| 56 | # !COURSES_ROOT! matches $courseDirsRoot |
|
|
| 57 | |
35 | |
| 58 | my $courseURLRoot = "/webwork2_course_files/$courseName"; |
36 | # Root directory of PG. |
|
|
37 | $pg_dir = "/opt/pg"; |
| 59 | |
38 | |
| 60 | my $courseDirsRoot = "!WEBWORK_ROOT!/courses/"; |
39 | # URL and path to htdocs directory. |
| 61 | |
|
|
| 62 | |
|
|
| 63 | # This alias directive redirects /webwork2_files to the toplevel material in the global webwork2/htdocs directory |
|
|
| 64 | # Alias /webwork2_files/ !WEBWORK_ROOT!/htdocs/ |
|
|
| 65 | |
|
|
| 66 | my $webworkLocalDocsURL = "/webwork2_files"; |
40 | $webwork_htdocs_url = "/webwork2_files"; |
| 67 | my $webworkLocalDocsDir = "$webworkRoot/htdocs"; |
41 | $webwork_htdocs_dir = "$webwork_dir/htdocs"; |
| 68 | ################################################################################ |
|
|
| 69 | # System-wide locations (directories and URLs) |
|
|
| 70 | ################################################################################ |
|
|
| 71 | |
42 | |
| 72 | # The root directory, set by webwork_root variable in Apache configuration. |
43 | # URL and path to courses directory. |
| 73 | $webworkDirs{root} = "$webworkRoot"; |
44 | $webwork_courses_url = "/webwork2_course_files"; |
|
|
45 | $webwork_courses_dir = "$webwork_dir/courses"; |
| 74 | |
46 | |
| 75 | # Location of system-wide data files. |
|
|
| 76 | $webworkDirs{DATA} = "$webworkDirs{root}/DATA"; |
|
|
| 77 | |
|
|
| 78 | # Used for temporary storage of uploaded files. |
|
|
| 79 | $webworkDirs{uploadCache} = "$webworkDirs{DATA}/uploads"; |
|
|
| 80 | |
|
|
| 81 | # Location of utility programs. |
|
|
| 82 | $webworkDirs{bin} = "$webworkDirs{root}/bin"; |
|
|
| 83 | |
|
|
| 84 | # Location of configuration files, templates, snippets, etc. |
|
|
| 85 | $webworkDirs{conf} = "$webworkDirs{root}/conf"; |
|
|
| 86 | |
|
|
| 87 | # Location of course directories. |
|
|
| 88 | $webworkDirs{courses} = "$courseDirsRoot"; |
|
|
| 89 | |
|
|
| 90 | # Contains the WeBWorK libraries. (FIXME: not used) |
|
|
| 91 | #$webworkDirs{lib} = "$webworkDirs{root}/lib"; |
|
|
| 92 | |
|
|
| 93 | # Contains log files. |
|
|
| 94 | $webworkDirs{logs} = "$webworkDirs{root}/logs"; |
|
|
| 95 | |
|
|
| 96 | # Location of PG macros. (FIXME: not used) |
|
|
| 97 | #$webworkDirs{macros} = "$pgRoot/macros"; |
|
|
| 98 | |
|
|
| 99 | # Contains non-web-accessible temporary files, such as TeX working directories. |
|
|
| 100 | $webworkDirs{tmp} = "$webworkDirs{root}/tmp"; |
|
|
| 101 | |
|
|
| 102 | ##### The following locations are web-accessible. |
|
|
| 103 | |
|
|
| 104 | # The root URL (usually /webwork2), set by <Location> in Apache configuration. |
|
|
| 105 | $webworkURLs{root} = "$webworkURLRoot"; |
|
|
| 106 | |
|
|
| 107 | # Location of system-wide web-accessible files, such as equation images, and |
|
|
| 108 | # help files. |
|
|
| 109 | $webworkDirs{htdocs} = "$webworkLocalDocsDir"; |
|
|
| 110 | $webworkURLs{htdocs} = "$webworkLocalDocsURL"; |
|
|
| 111 | |
|
|
| 112 | # The URL of the static WeBWorK home page (FIXME: not used) |
|
|
| 113 | #$webworkURLs{home} = "$webworkURLs{htdocs}/index.html"; |
|
|
| 114 | |
|
|
| 115 | # Location of web-accessible temporary files, such as equation images. |
|
|
| 116 | $webworkDirs{htdocs_temp} = "$webworkDirs{htdocs}/tmp"; |
|
|
| 117 | $webworkURLs{htdocs_temp} = "$webworkURLs{htdocs}/tmp"; |
|
|
| 118 | |
|
|
| 119 | # Location of cached equation images. |
|
|
| 120 | $webworkDirs{equationCache} = "$webworkDirs{htdocs_temp}/equations"; |
|
|
| 121 | $webworkURLs{equationCache} = "$webworkURLs{htdocs_temp}/equations"; |
|
|
| 122 | |
|
|
| 123 | # Contains context-sensitive help files. |
|
|
| 124 | $webworkDirs{local_help} = "$webworkDirs{htdocs}/helpFiles"; |
|
|
| 125 | $webworkURLs{local_help} = "$webworkURLs{htdocs}/helpFiles"; |
|
|
| 126 | |
|
|
| 127 | # URL of general WeBWorK documentation. |
|
|
| 128 | $webworkURLs{docs} = "http://webhost.math.rochester.edu/webworkdocs/docs"; |
|
|
| 129 | |
|
|
| 130 | # URL of WeBWorK 1.x profLogin.pl script, for access to old professor pages. |
|
|
| 131 | # Note that both systems must share a single "courses" directory for this to be |
|
|
| 132 | # useful. Leave this blank to disable |
|
|
| 133 | $webworkURLs{oldProf} = "/webwork1/profLogin.pl"; |
|
|
| 134 | |
|
|
| 135 | # URL of WeBWorK Bugzilla database. |
|
|
| 136 | $webworkURLs{bugReporter} = "http://bugs.webwork.rochester.edu/enter_bug.cgi?product=WeBWorK%20mod_perl"; |
|
|
| 137 | |
|
|
| 138 | # Location of jsMath script, used for the jsMath display mode. |
|
|
| 139 | $webworkURLs{jsMath} = "$webworkURLs{htdocs}/jsMath/jsMath.js"; |
|
|
| 140 | |
|
|
| 141 | # Location of ASCIIMathML script, used for the asciimath display mode. |
|
|
| 142 | $webworkURLs{asciimath} = "$webworkURLs{htdocs}/ASCIIMathML/ASCIIMathML.js"; |
|
|
| 143 | |
|
|
| 144 | ################################################################################ |
47 | ################################################################################ |
| 145 | # Defaults for course-specific locations (directories and URLs) |
48 | # Paths to external programs |
| 146 | ################################################################################ |
49 | ################################################################################ |
| 147 | |
50 | |
| 148 | # The root directory of the current course. (The ID of the current course is |
51 | # system utilties |
| 149 | # available in $courseName.) |
52 | $externalPrograms{mkdir} = "/bin/mkdir"; |
| 150 | $courseDirs{root} = "$webworkDirs{courses}/$courseName"; |
53 | $externalPrograms{mv} = "/bin/mv"; |
|
|
54 | $externalPrograms{mysql} = "/usr/bin/mysql"; |
|
|
55 | $externalPrograms{tar} = "/usr/bin/tar"; |
| 151 | |
56 | |
| 152 | # Location of course-specific data files, such as WW1 (GDBM) database files. |
57 | # equation rendering/hardcopy utiltiies |
| 153 | $courseDirs{DATA} = "$courseDirs{root}/DATA"; |
58 | $externalPrograms{latex} = "/usr/bin/latex"; |
|
|
59 | $externalPrograms{pdflatex} = "/usr/bin/pdflatex --shell-escape"; # --shell-escape allows pdflatex to handle .eps files |
|
|
60 | $externalPrograms{dvipng} = "/usr/bin/dvipng"; |
|
|
61 | $externalPrograms{tth} = "/usr/bin/tth"; |
| 154 | |
62 | |
| 155 | # Location of authentication data files when using a WW1 (GDBM) database. |
63 | # NetPBM - basic image manipulation utilities |
| 156 | $courseDirs{auth_DATA} = "$courseDirs{DATA}/.auth"; |
64 | # most sites only need to configure $netpbm_prefix. |
|
|
65 | my $netpbm_prefix = "/usr/bin"; |
|
|
66 | $externalPrograms{giftopnm} = "$netpbm_prefix/giftopnm"; |
|
|
67 | $externalPrograms{ppmtopgm} = "$netpbm_prefix/ppmtopgm"; |
|
|
68 | $externalPrograms{pnmtops} = "$netpbm_prefix/pnmtops"; |
|
|
69 | $externalPrograms{pnmtopng} = "$netpbm_prefix/pnmtopng"; |
|
|
70 | $externalPrograms{pngtopnm} = "$netpbm_prefix/pngtopnm"; |
| 157 | |
71 | |
| 158 | # Location of course HTML files, passed to PG. |
72 | # image conversions utiltiies |
| 159 | $courseDirs{html} = "$courseDirs{root}/html"; |
73 | # the source file is given on stdin, and the output expected on stdout. |
| 160 | $courseURLs{html} = "/webwork2_course_files/$courseName"; |
|
|
| 161 | #$courseURLs{root} = $courseURLs{html}; # FIXME: not used |
|
|
| 162 | |
|
|
| 163 | # Location of course image files, passed to PG. |
|
|
| 164 | $courseDirs{html_images} = "$courseDirs{html}/images"; |
|
|
| 165 | |
|
|
| 166 | # Location of web-accessible, course-specific temporary files, like static and |
|
|
| 167 | # dynamically-generated PG graphics. |
|
|
| 168 | $courseDirs{html_temp} = "$courseDirs{html}/tmp"; |
|
|
| 169 | $courseURLs{html_temp} = "$courseURLs{html}/tmp"; |
|
|
| 170 | |
|
|
| 171 | # Location of course-specific logs, like the transaction log. |
|
|
| 172 | $courseDirs{logs} = "$courseDirs{root}/logs"; |
|
|
| 173 | |
|
|
| 174 | # Location of scoring files. |
|
|
| 175 | $courseDirs{scoring} = "$courseDirs{root}/scoring"; |
|
|
| 176 | |
|
|
| 177 | # Location of PG templates and set definition files. |
|
|
| 178 | $courseDirs{templates} = "$courseDirs{root}/templates"; |
|
|
| 179 | |
|
|
| 180 | # Location of course-specific macro files. |
|
|
| 181 | $courseDirs{macros} = "$courseDirs{templates}/macros"; |
|
|
| 182 | |
|
|
| 183 | # Location of mail-merge templates. |
|
|
| 184 | $courseDirs{email} = "$courseDirs{templates}/email"; |
|
|
| 185 | |
|
|
| 186 | ################################################################################ |
|
|
| 187 | # System-wide files |
|
|
| 188 | ################################################################################ |
|
|
| 189 | |
|
|
| 190 | # Location of this file. |
|
|
| 191 | $webworkFiles{environment} = "$webworkDirs{conf}/global.conf"; |
|
|
| 192 | |
|
|
| 193 | # Flat-file database used to protect against MD5 hash collisions. TeX equations |
|
|
| 194 | # are hashed to determine the name of the image file. There is a tiny chance of |
|
|
| 195 | # a collision between two TeX strings. This file allows for that. However, this |
|
|
| 196 | # is slow, so most people chose not to worry about it. Set this to "" if you |
|
|
| 197 | # don't want to use the equation cache file. |
|
|
| 198 | $webworkFiles{equationCacheDB} = ""; # "$webworkDirs{DATA}/equationcache"; |
|
|
| 199 | |
|
|
| 200 | ##### Hardcopy snippets are used in constructing a TeX file for hardcopy output. |
|
|
| 201 | ##### They should contain TeX code unless otherwise noted. |
|
|
| 202 | |
|
|
| 203 | # The preamble is the first thing in the TeX file. |
|
|
| 204 | $webworkFiles{hardcopySnippets}{preamble} = "$webworkDirs{conf}/snippets/hardcopyPreamble.tex"; |
|
|
| 205 | |
|
|
| 206 | # The setHeader preceeds each set. It is a PG file. |
|
|
| 207 | $webworkFiles{hardcopySnippets}{setHeader} = "$webworkDirs{conf}/snippets/setHeader.pg"; # hardcopySetHeader.pg", |
|
|
| 208 | |
|
|
| 209 | # The problem divider goes between problems. |
|
|
| 210 | $webworkFiles{hardcopySnippets}{problemDivider} = "$webworkDirs{conf}/snippets/hardcopyProblemDivider.tex"; |
|
|
| 211 | |
|
|
| 212 | # The set footer goes after each set. Is is a PG file. |
|
|
| 213 | $webworkFiles{hardcopySnippets}{setFooter} = "$webworkDirs{conf}/snippets/hardcopySetFooter.pg"; |
|
|
| 214 | |
|
|
| 215 | # The set divider goes between sets (in multiset output). |
|
|
| 216 | $webworkFiles{hardcopySnippets}{setDivider} = "$webworkDirs{conf}/snippets/hardcopySetDivider.tex"; |
|
|
| 217 | |
|
|
| 218 | # The user divider does between users (in multiuser output). |
|
|
| 219 | $webworkFiles{hardcopySnippets}{userDivider} = "$webworkDirs{conf}/snippets/hardcopyUserDivider.tex"; |
|
|
| 220 | |
|
|
| 221 | # The postabmle is the last thing in the TeX file. |
|
|
| 222 | $webworkFiles{hardcopySnippets}{postamble} = "$webworkDirs{conf}/snippets/hardcopyPostamble.tex"; |
|
|
| 223 | |
|
|
| 224 | ##### Screen snippets are used when displaying problem sets on the screen. |
|
|
| 225 | |
|
|
| 226 | # The set header is displayed on the problem set page. It is a PG file. |
|
|
| 227 | $webworkFiles{screenSnippets}{setHeader} = "$webworkDirs{conf}/snippets/setHeader.pg"; # screenSetHeader.pg" |
|
|
| 228 | |
|
|
| 229 | ################################################################################ |
|
|
| 230 | # Course-specific files |
|
|
| 231 | ################################################################################ |
|
|
| 232 | |
|
|
| 233 | # The course configuration file. |
|
|
| 234 | $courseFiles{environment} = "$courseDirs{root}/course.conf"; |
|
|
| 235 | |
|
|
| 236 | # The message of the day, displayed after login. (FIXME: not used) |
|
|
| 237 | #$courseFiles{motd} = "$courseDirs{templates}/motd.txt"; |
|
|
| 238 | |
|
|
| 239 | # File contents are displayed after login, on the problem sets page. Path given |
|
|
| 240 | # here is relative to the templates directory. |
|
|
| 241 | $courseFiles{course_info} = "course_info.txt"; |
|
|
| 242 | |
|
|
| 243 | # File contents are displayed on the login page. Path given here is relative to |
|
|
| 244 | # the templates directory. |
|
|
| 245 | $courseFiles{login_info} = "login_info.txt"; |
|
|
| 246 | |
|
|
| 247 | # Additional library buttons can be added to the Library Browser (SetMaker.pm) |
|
|
| 248 | # by adding the libraries you want to the following line. For each key=>value |
|
|
| 249 | # in the list, if a directory (or link to a directory) with name 'key' appears |
|
|
| 250 | # in the templates directory, then a button with name 'value' will be placed at |
|
|
| 251 | # the top of the problem browser. (No button will appear if there is no |
|
|
| 252 | # directory or link with the given name in the templates directory.) For |
|
|
| 253 | # example, |
|
|
| 254 | # |
74 | # |
| 255 | # $courseFiles{problibs} = {rochester => "Rochester", asu => "ASU"}; |
75 | # Note on conversions pipelines: |
| 256 | # |
76 | # we used to use `pnmdepth 1' instead of ppmtopgm as it creates a |
| 257 | # would add two buttons, one for the Rochester library and one for the ASU |
77 | # monochrome image (1 bit) rather than a greyscale image (8 bits). |
| 258 | # library, provided templates/rochester and templates/asu exists. |
78 | # However, this was causing improper display of some sort in PDFs. |
| 259 | # |
79 | $externalPrograms{gif2eps} = "$externalPrograms{giftopnm} | $externalPrograms{ppmtopgm} | $externalPrograms{pnmtops} -noturn 2>/dev/null"; |
| 260 | $courseFiles{problibs} = {}; |
80 | $externalPrograms{png2eps} = "$externalPrograms{pngtopnm} | $externalPrograms{ppmtopgm} | $externalPrograms{pnmtops} -noturn 2>/dev/null"; |
| 261 | |
81 | $externalPrograms{gif2png} = "$externalPrograms{giftopnm} | $externalPrograms{pnmtopng}"; |
| 262 | ################################################################################ |
|
|
| 263 | # Logs |
|
|
| 264 | ################################################################################ |
|
|
| 265 | |
|
|
| 266 | # FIXME: take logs out of %webworkFiles/%courseFiles and give them their own |
|
|
| 267 | # top-level hash. |
|
|
| 268 | |
|
|
| 269 | # Logs data about how long it takes to process problems. (Do not confuse this |
|
|
| 270 | # with the /other/ timing log which can be set by WeBWorK::Timing and is used |
|
|
| 271 | # for benchmarking system performance in general. At some point, this timing |
|
|
| 272 | # mechanism will be deprecated in favor of the WeBWorK::Timing mechanism.) |
|
|
| 273 | $webworkFiles{logs}{timing} = "$webworkDirs{logs}/timing.log"; |
|
|
| 274 | |
|
|
| 275 | # The transaction log contains data from each recorded answer submission. This |
|
|
| 276 | # is useful if the database becomes corrupted. |
|
|
| 277 | $webworkFiles{logs}{transaction} = "$courseDirs{logs}/transaction.log"; |
|
|
| 278 | |
|
|
| 279 | # The past answer list stores a history of all users' submitted answers. (FIXME: not used) |
|
|
| 280 | $webworkFiles{logs}{pastAnswerList} = "$courseDirs{logs}/past_answers.log"; |
|
|
| 281 | |
|
|
| 282 | # The answer log stores a history of all users' submitted answers. |
|
|
| 283 | $courseFiles{logs}{answer_log} = "$courseDirs{logs}/answer_log"; |
|
|
| 284 | |
82 | |
| 285 | ################################################################################ |
83 | ################################################################################ |
| 286 | # Mail settings |
84 | # Mail settings |
| 287 | ################################################################################ |
85 | ################################################################################ |
| 288 | |
86 | |
| … | |
… | |
| 293 | # When connecting to the above server, WeBWorK will send this address in the |
91 | # When connecting to the above server, WeBWorK will send this address in the |
| 294 | # MAIL FROM command. This has nothing to do with the "From" address on the mail |
92 | # MAIL FROM command. This has nothing to do with the "From" address on the mail |
| 295 | # message. It can really be anything, but some mail servers require it contain |
93 | # message. It can really be anything, but some mail servers require it contain |
| 296 | # a valid mail domain, or at least be well-formed. |
94 | # a valid mail domain, or at least be well-formed. |
| 297 | $mail{smtpSender} = 'webwork@yourserver.yourschool.edu'; |
95 | $mail{smtpSender} = 'webwork@yourserver.yourschool.edu'; |
| 298 | |
96 | |
| 299 | # AllowedRecipients defines addresses that the PG system is allowed to send mail |
97 | # AllowedRecipients defines addresses that the PG system is allowed to send mail |
| 300 | # to. this prevents subtle PG exploits. This should be set in course.conf to the |
98 | # to. this prevents subtle PG exploits. This should be set in course.conf to the |
| 301 | # addresses of professors of each course. Sending mail from the PG system (i.e. |
99 | # addresses of professors of each course. Sending mail from the PG system (i.e. |
| 302 | # questionaires, essay questions) will fail if this is not set somewhere (either |
100 | # questionaires, essay questions) will fail if this is not set somewhere (either |
| 303 | # here or in course.conf). |
101 | # here or in course.conf). |
| 304 | $mail{allowedRecipients} = [ |
102 | $mail{allowedRecipients} = [ |
| 305 | #'prof1@yourserver.yourdomain.edu', |
103 | #'prof1@yourserver.yourdomain.edu', |
| 306 | #'prof2@yourserver.yourdomain.edu', |
104 | #'prof2@yourserver.yourdomain.edu', |
| 307 | ]; |
105 | ]; |
| 308 | |
106 | |
| 309 | # If defined, feedbackRecipients overrides the list of recipients for feedback |
107 | # By default, feeback is sent to all users who have permission to |
| 310 | # email. It's appropriate to set this in the course.conf for specific courses, |
108 | # receive_feedback. If this list is non-empty, feedback is also sent to the |
| 311 | # but probably not in global.conf. if not defined, mail is sent to all |
109 | # addresses specified here. |
| 312 | # professors and TAs for a given course |
110 | # |
|
|
111 | # * If you want to disable feedback altogether, leave this empty and set |
|
|
112 | # submit_feeback => $nobody in %permissionLevels below. This will cause the |
|
|
113 | # feedback button to go away as well. |
|
|
114 | # |
|
|
115 | # * If you want to send email ONLY to addresses in this list, set |
|
|
116 | # receive_feedback => $nobody in %permissionLevels below. |
|
|
117 | # |
|
|
118 | # It's often useful to set this in the course.conf to change the behavior of |
|
|
119 | # feedback for a specific course. |
|
|
120 | # |
|
|
121 | # Items in this list may be bare addresses, or RFC822 mailboxes, like: |
|
|
122 | # 'Joe User <joe.user@example.com>' |
|
|
123 | # The advantage of this form is that the resulting email will include the name |
|
|
124 | # of the recipient in the "To" field of the email. |
|
|
125 | # |
| 313 | $mail{feedbackRecipients} = [ |
126 | $mail{feedbackRecipients} = [ |
| 314 | #'prof1@yourserver.yourdomain.edu', |
127 | #'prof1@yourserver.yourdomain.edu', |
| 315 | #'prof2@yourserver.yourdomain.edu', |
128 | #'prof2@yourserver.yourdomain.edu', |
| 316 | ]; |
129 | ]; |
| 317 | |
130 | |
|
|
131 | # Feedback subject line -- the following escape sequences are recognized: |
|
|
132 | # |
|
|
133 | # %c = course ID |
|
|
134 | # %u = user ID |
|
|
135 | # %s = set ID |
|
|
136 | # %p = problem ID |
|
|
137 | # %x = section |
|
|
138 | # %r = recitation |
|
|
139 | # %% = literal percent sign |
|
|
140 | # |
|
|
141 | $mail{feedbackSubjectFormat} = "[WWfeedback] course:%c user:%u set:%s prob:%p sec:%x rec:%r"; |
|
|
142 | |
| 318 | # feedbackVerbosity: |
143 | # feedbackVerbosity: |
| 319 | # 0: send only the feedback comment and context link |
144 | # 0: send only the feedback comment and context link |
| 320 | # 1: as in 0, plus user, set, problem, and PG data |
145 | # 1: as in 0, plus user, set, problem, and PG data |
| 321 | # 2: as in 1, plus the problem environment (debugging data) |
146 | # 2: as in 1, plus the problem environment (debugging data) |
| 322 | $mail{feedbackVerbosity} = 1; |
147 | $mail{feedbackVerbosity} = 1; |
| 323 | |
148 | |
| 324 | # Defines the size of the Mail Merge editor window |
149 | # Defines the size of the Mail Merge editor window |
| 325 | # FIXME: should this be here? it's UI, not mail |
150 | # FIXME: should this be here? it's UI, not mail |
| 326 | # FIXME: replace this with the auto-size method that TWiki uses |
151 | # FIXME: replace this with the auto-size method that TWiki uses |
| 327 | $mail{editor_window_rows} = 15; |
152 | $mail{editor_window_rows} = 15; |
| 328 | $mail{editor_window_columns} = 100; |
153 | $mail{editor_window_columns} = 100; |
| 329 | |
154 | |
| 330 | ################################################################################ |
155 | ################################################################################ |
| 331 | # Paths to external programs |
156 | # System-wide locations (directories and URLs) |
| 332 | ################################################################################ |
157 | ################################################################################ |
| 333 | |
158 | |
| 334 | $externalPrograms{mkdir} = "/bin/mkdir"; |
159 | # The root directory, set by webwork_root variable in Apache configuration. |
| 335 | $externalPrograms{mysql} = "/usr/local/bin/mysql"; |
160 | $webworkDirs{root} = "$webwork_dir"; |
| 336 | |
161 | |
| 337 | $externalPrograms{latex} = "/usr/local/bin/latex"; |
162 | # Location of system-wide data files. |
| 338 | $externalPrograms{pdflatex} = "/usr/local/bin/pdflatex"; |
163 | $webworkDirs{DATA} = "$webworkDirs{root}/DATA"; |
| 339 | $externalPrograms{dvipng} = "/usr/local/bin/dvipng"; |
|
|
| 340 | $externalPrograms{tth} = "/usr/local/bin/tth"; |
|
|
| 341 | |
164 | |
| 342 | # These image conversion utilities are included in the WeBWorK distribution. |
165 | # Used for temporary storage of uploaded files. |
| 343 | $externalPrograms{gif2eps} = "$webworkDirs{bin}/gif2eps"; |
166 | $webworkDirs{uploadCache} = "$webworkDirs{DATA}/uploads"; |
| 344 | $externalPrograms{png2eps} = "$webworkDirs{bin}/png2eps"; |
|
|
| 345 | $externalPrograms{gif2png} = "$webworkDirs{bin}/gif2png"; |
|
|
| 346 | |
167 | |
| 347 | ################################################################################ |
168 | # Location of utility programs. |
| 348 | # Site defaults (FIXME: what other things could be "site defaults"?) |
169 | $webworkDirs{bin} = "$webworkDirs{root}/bin"; |
| 349 | ################################################################################ |
|
|
| 350 | |
170 | |
| 351 | # Status strings -- lists valid status values and their names. If your site uses |
171 | # Location of configuration files, templates, snippets, etc. |
| 352 | # additional values, add them here. |
172 | $webworkDirs{conf} = "$webworkDirs{root}/conf"; |
| 353 | $siteDefaults{status} = { |
173 | |
| 354 | A => "Audit", |
174 | # Location of theme templates. |
| 355 | audit => "Audit", |
175 | $webworkDirs{templates} = "$webworkDirs{conf}/templates"; |
| 356 | D => "Drop", |
176 | |
| 357 | drop => "Drop", |
177 | # Location of course directories. |
| 358 | withdraw => "Drop", |
178 | $webworkDirs{courses} = "$webwork_courses_dir" || "$webworkDirs{root}/courses"; |
| 359 | C => "Enrolled", |
179 | |
| 360 | current => "Enrolled", |
180 | # Contains log files. |
| 361 | enrolled => "Enrolled", |
181 | $webworkDirs{logs} = "$webworkDirs{root}/logs"; |
|
|
182 | |
|
|
183 | # Contains non-web-accessible temporary files, such as TeX working directories. |
|
|
184 | $webworkDirs{tmp} = "$webworkDirs{root}/tmp"; |
|
|
185 | |
|
|
186 | # The (absolute) destinations of symbolic links that are OK for the FileManager to follow. |
|
|
187 | # (any subdirectory of these is a valid target for a symbolic link.) |
|
|
188 | # For example: |
|
|
189 | # $webworkDirs{valid_symlinks} = ["$webworkDirs{courses}/modelCourse/templates","/ww2/common/sets"]; |
|
|
190 | $webworkDirs{valid_symlinks} = []; |
|
|
191 | |
|
|
192 | ##### The following locations are web-accessible. |
|
|
193 | |
|
|
194 | # The root URL (usually /webwork2), set by <Location> in Apache configuration. |
|
|
195 | $webworkURLs{root} = "$webwork_url"; |
|
|
196 | |
|
|
197 | # Location of system-wide web-accessible files, such as equation images, and |
|
|
198 | # help files. |
|
|
199 | $webworkDirs{htdocs} = "$webwork_htdocs_dir" || "$webworkDirs{root}/htdocs"; |
|
|
200 | $webworkURLs{htdocs} = "$webwork_htdocs_url"; |
|
|
201 | |
|
|
202 | # Location of web-accessible temporary files, such as equation images. |
|
|
203 | $webworkDirs{htdocs_temp} = "$webworkDirs{htdocs}/tmp"; |
|
|
204 | $webworkURLs{htdocs_temp} = "$webworkURLs{htdocs}/tmp"; |
|
|
205 | |
|
|
206 | # Location of cached equation images. |
|
|
207 | $webworkDirs{equationCache} = "$webworkDirs{htdocs_temp}/equations"; |
|
|
208 | $webworkURLs{equationCache} = "$webworkURLs{htdocs_temp}/equations"; |
|
|
209 | |
|
|
210 | # Contains context-sensitive help files. |
|
|
211 | $webworkDirs{local_help} = "$webworkDirs{htdocs}/helpFiles"; |
|
|
212 | $webworkURLs{local_help} = "$webworkURLs{htdocs}/helpFiles"; |
|
|
213 | |
|
|
214 | # URL of general WeBWorK documentation. |
|
|
215 | $webworkURLs{docs} = "http://webhost.math.rochester.edu/webworkdocs/docs"; |
|
|
216 | |
|
|
217 | # URL of WeBWorK 1.x profLogin.pl script, for access to old professor pages. |
|
|
218 | # Note that both systems must share a single "courses" directory for this to be |
|
|
219 | # useful. Leave this blank to disable |
|
|
220 | $webworkURLs{oldProf} = "/webwork1/profLogin.pl"; |
|
|
221 | |
|
|
222 | # URL of WeBWorK Bugzilla database. |
|
|
223 | $webworkURLs{bugReporter} = "http://bugs.webwork.rochester.edu/"; |
|
|
224 | |
|
|
225 | # Location of CSS |
|
|
226 | $webworkURLs{stylesheet} = "$webworkURLs{htdocs}/css/ur.css"; |
|
|
227 | |
|
|
228 | # Location of jsMath script, used for the jsMath display mode. |
|
|
229 | $webworkURLs{jsMath} = "$webworkURLs{htdocs}/jsMath/jsMath-ww.js"; |
|
|
230 | |
|
|
231 | # Location of ASCIIMathML script, used for the asciimath display mode. |
|
|
232 | $webworkURLs{asciimath} = "$webworkURLs{htdocs}/ASCIIMathML/ASCIIMathML.js"; |
|
|
233 | |
|
|
234 | ################################################################################ |
|
|
235 | # Defaults for course-specific locations (directories and URLs) |
|
|
236 | ################################################################################ |
|
|
237 | |
|
|
238 | # The root directory of the current course. (The ID of the current course is |
|
|
239 | # available in $courseName.) |
|
|
240 | $courseDirs{root} = "$webworkDirs{courses}/$courseName"; |
|
|
241 | |
|
|
242 | # Location of course-specific data files, such as WW1 (GDBM) database files. |
|
|
243 | $courseDirs{DATA} = "$courseDirs{root}/DATA"; |
|
|
244 | |
|
|
245 | # Location of course HTML files, passed to PG. |
|
|
246 | $courseDirs{html} = "$courseDirs{root}/html"; |
|
|
247 | $courseURLs{html} = "$webwork_courses_url/$courseName"; |
|
|
248 | |
|
|
249 | # Location of course image files, passed to PG. |
|
|
250 | $courseDirs{html_images} = "$courseDirs{html}/images"; |
|
|
251 | |
|
|
252 | # Location of web-accessible, course-specific temporary files, like static and |
|
|
253 | # dynamically-generated PG graphics. |
|
|
254 | $courseDirs{html_temp} = "$courseDirs{html}/tmp"; |
|
|
255 | $courseURLs{html_temp} = "$courseURLs{html}/tmp"; |
|
|
256 | |
|
|
257 | # Location of course-specific logs, like the transaction log. |
|
|
258 | $courseDirs{logs} = "$courseDirs{root}/logs"; |
|
|
259 | |
|
|
260 | # Location of scoring files. |
|
|
261 | $courseDirs{scoring} = "$courseDirs{root}/scoring"; |
|
|
262 | |
|
|
263 | # Location of PG templates and set definition files. |
|
|
264 | $courseDirs{templates} = "$courseDirs{root}/templates"; |
|
|
265 | |
|
|
266 | # Location of course-specific macro files. |
|
|
267 | $courseDirs{macros} = "$courseDirs{templates}/macros"; |
|
|
268 | |
|
|
269 | # Location of mail-merge templates. |
|
|
270 | $courseDirs{email} = "$courseDirs{templates}/email"; |
|
|
271 | |
|
|
272 | # Location of temporary editing files. |
|
|
273 | $courseDirs{tmpEditFileDir} = "$courseDirs{templates}/tmpEdit"; |
|
|
274 | |
|
|
275 | ################################################################################ |
|
|
276 | # System-wide files |
|
|
277 | ################################################################################ |
|
|
278 | |
|
|
279 | # Location of this file. |
|
|
280 | $webworkFiles{environment} = "$webworkDirs{conf}/global.conf"; |
|
|
281 | |
|
|
282 | # Flat-file database used to protect against MD5 hash collisions. TeX equations |
|
|
283 | # are hashed to determine the name of the image file. There is a tiny chance of |
|
|
284 | # a collision between two TeX strings. This file allows for that. However, this |
|
|
285 | # is slow, so most people chose not to worry about it. Set this to "" if you |
|
|
286 | # don't want to use the equation cache file. |
|
|
287 | $webworkFiles{equationCacheDB} = ""; # "$webworkDirs{DATA}/equationcache"; |
|
|
288 | |
|
|
289 | ##### Hardcopy snippets are used in constructing a TeX file for hardcopy output. |
|
|
290 | ##### They should contain TeX code unless otherwise noted. |
|
|
291 | |
|
|
292 | # The preamble is the first thing in the TeX file. |
|
|
293 | $webworkFiles{hardcopySnippets}{preamble} = "$webworkDirs{conf}/snippets/hardcopyPreamble.tex"; |
|
|
294 | |
|
|
295 | # The setHeader preceeds each set. It is a PG file. |
|
|
296 | $webworkFiles{hardcopySnippets}{setHeader} = "$webworkDirs{conf}/snippets/setHeader.pg"; # hardcopySetHeader.pg", |
|
|
297 | |
|
|
298 | # The problem divider goes between problems. |
|
|
299 | $webworkFiles{hardcopySnippets}{problemDivider} = "$webworkDirs{conf}/snippets/hardcopyProblemDivider.tex"; |
|
|
300 | |
|
|
301 | # The set footer goes after each set. Is is a PG file. |
|
|
302 | $webworkFiles{hardcopySnippets}{setFooter} = "$webworkDirs{conf}/snippets/hardcopySetFooter.pg"; |
|
|
303 | |
|
|
304 | # The set divider goes between sets (in multiset output). |
|
|
305 | $webworkFiles{hardcopySnippets}{setDivider} = "$webworkDirs{conf}/snippets/hardcopySetDivider.tex"; |
|
|
306 | |
|
|
307 | # The user divider does between users (in multiuser output). |
|
|
308 | $webworkFiles{hardcopySnippets}{userDivider} = "$webworkDirs{conf}/snippets/hardcopyUserDivider.tex"; |
|
|
309 | |
|
|
310 | # The postabmle is the last thing in the TeX file. |
|
|
311 | $webworkFiles{hardcopySnippets}{postamble} = "$webworkDirs{conf}/snippets/hardcopyPostamble.tex"; |
|
|
312 | |
|
|
313 | ##### Screen snippets are used when displaying problem sets on the screen. |
|
|
314 | |
|
|
315 | # The set header is displayed on the problem set page. It is a PG file. |
|
|
316 | $webworkFiles{screenSnippets}{setHeader} = "$webworkDirs{conf}/snippets/setHeader.pg"; # screenSetHeader.pg" |
|
|
317 | |
|
|
318 | # A PG template for creation of new problems. |
|
|
319 | $webworkFiles{screenSnippets}{blankProblem} = "$webworkDirs{conf}/snippets/blankProblem.pg"; # screenSetHeader.pg" |
|
|
320 | |
|
|
321 | # A site info "message of the day" file |
|
|
322 | $webworkFiles{site_info} = "$webworkDirs{htdocs}/site_info.txt"; |
|
|
323 | |
|
|
324 | ################################################################################ |
|
|
325 | # Course-specific files |
|
|
326 | ################################################################################ |
|
|
327 | |
|
|
328 | # The course configuration file. |
|
|
329 | $courseFiles{environment} = "$courseDirs{root}/course.conf"; |
|
|
330 | |
|
|
331 | # The course simple configuration file (holds web-based configuratoin). |
|
|
332 | $courseFiles{simpleConfig} = "$courseDirs{root}/simple.conf"; |
|
|
333 | |
|
|
334 | # File contents are displayed after login, on the problem sets page. Path given |
|
|
335 | # here is relative to the templates directory. |
|
|
336 | $courseFiles{course_info} = "course_info.txt"; |
|
|
337 | |
|
|
338 | # File contents are displayed on the login page. Path given here is relative to |
|
|
339 | # the templates directory. |
|
|
340 | $courseFiles{login_info} = "login_info.txt"; |
|
|
341 | |
|
|
342 | # Additional library buttons can be added to the Library Browser (SetMaker.pm) |
|
|
343 | # by adding the libraries you want to the following line. For each key=>value |
|
|
344 | # in the list, if a directory (or link to a directory) with name 'key' appears |
|
|
345 | # in the templates directory, then a button with name 'value' will be placed at |
|
|
346 | # the top of the problem browser. (No button will appear if there is no |
|
|
347 | # directory or link with the given name in the templates directory.) For |
|
|
348 | # example, |
|
|
349 | # |
|
|
350 | # $courseFiles{problibs} = {rochester => "Rochester", asu => "ASU"}; |
|
|
351 | # |
|
|
352 | # would add two buttons, one for the Rochester library and one for the ASU |
|
|
353 | # library, provided templates/rochester and templates/asu exists either as |
|
|
354 | # subdirectories or links to other directories. |
|
|
355 | # |
|
|
356 | $courseFiles{problibs} = { |
|
|
357 | # rochesterLibrary => "Rochester", |
|
|
358 | # asuLibrary => "Arizona State", |
|
|
359 | # dcdsLibrary => "Detroit CDS", |
|
|
360 | # dartmouthLibrary => "Dartmouth", |
|
|
361 | # indianaLibrary => "Indiana", |
|
|
362 | # osuLibrary => "Ohio State", |
|
|
363 | # capaLibrary => "CAPA", |
| 362 | }; |
364 | }; |
| 363 | |
365 | |
| 364 | ################################################################################ |
366 | ################################################################################ |
| 365 | # Frontend options |
|
|
| 366 | ################################################################################ |
|
|
| 367 | |
|
|
| 368 | %templates = ( |
|
|
| 369 | system => "$webworkDirs{conf}/templates/ur.template", |
|
|
| 370 | ); |
|
|
| 371 | |
|
|
| 372 | ################################################################################ |
|
|
| 373 | # Database options |
367 | # Database options |
| 374 | ################################################################################ |
368 | ################################################################################ |
|
|
369 | |
|
|
370 | # these variables are used by database.conf. we define them here so that editing |
|
|
371 | # database.conf isn't necessary. |
|
|
372 | $database_dsn = "dbi:mysql:webwork"; |
|
|
373 | $database_username = "webworkWrite"; |
|
|
374 | $database_password = ""; |
|
|
375 | $database_debug = 0; |
|
|
376 | |
|
|
377 | # Variables for sql_moodle database layout. |
|
|
378 | $moodle_dsn = "dbi:mysql:moodle"; |
|
|
379 | $moodle_dsn = "dbi:mysql:moodle_sam"; |
|
|
380 | $mooble_table_prefix = "mdl_"; |
|
|
381 | $moodle_username = $database_username; |
|
|
382 | $moodle_password = $database_password; |
| 375 | |
383 | |
| 376 | # Several database are defined in the file conf/database.conf and stored in the |
384 | # Several database are defined in the file conf/database.conf and stored in the |
| 377 | # hash %dbLayouts. |
385 | # hash %dbLayouts. |
| 378 | include "conf/database.conf"; |
386 | include "conf/database.conf"; |
| 379 | |
387 | |
| 380 | # Select the default database layout. This can be overridden in the course.conf |
388 | # Select the default database layout. This can be overridden in the course.conf |
| 381 | # file of a particular course. If you choose "gdbm", WeBWorK will be able to |
389 | # file of a particular course. The only database layout supported in WW 2.1.4 |
| 382 | # use courses from WeBWorK 1 without first adding course.conf files to them. |
390 | # and up is "sql_single". |
| 383 | # However, the recommended database layout for new courses is "sql". This can |
391 | $dbLayoutName = "sql_single"; |
| 384 | # be set when creating a course. |
|
|
| 385 | $dbLayoutName = "sql"; # or: "gdbm" |
|
|
| 386 | |
392 | |
| 387 | # This sets the symbol "dbLayout" as an alias for the selected database layout. |
393 | # This sets the symbol "dbLayout" as an alias for the selected database layout. |
| 388 | *dbLayout = $dbLayouts{$dbLayoutName}; |
394 | *dbLayout = $dbLayouts{$dbLayoutName}; |
| 389 | |
395 | |
| 390 | ################################################################################ |
396 | ################################################################################ |
| … | |
… | |
| 393 | |
399 | |
| 394 | # The directory containing the problem library files. Set to "" if no problem |
400 | # The directory containing the problem library files. Set to "" if no problem |
| 395 | # library is installed. |
401 | # library is installed. |
| 396 | $problemLibrary{root} = ""; |
402 | $problemLibrary{root} = ""; |
| 397 | |
403 | |
|
|
404 | # Problem Library version |
|
|
405 | # Version 1 is in use. Version 2 will be released soon. |
|
|
406 | $problemLibrary{version} = "1"; |
|
|
407 | |
| 398 | # The name of the SQL database containing problem metadata |
408 | # The name of the SQL database containing problem metadata |
| 399 | $problemLibrary{sourceSQL} = "ProblemLibrary"; |
409 | $problemLibrary{sourceSQL} = "ProblemLibrary"; |
| 400 | |
410 | |
| 401 | # The user name to use when connecting to the problem library database |
411 | # The user name to use when connecting to the problem library database |
| 402 | $problemLibrary{userSQL} = "webworkRead"; |
412 | $problemLibrary{userSQL} = "webworkRead"; |
| 403 | |
413 | |
| 404 | # The password to use when connecting to the problem library database |
414 | # The password to use when connecting to the problem library database |
| 405 | $problemLibrary{passwordSQL} = ""; |
415 | $problemLibrary{passwordSQL} = ""; |
| 406 | |
416 | |
| 407 | ################################################################################ |
417 | ################################################################################ |
|
|
418 | # Logs |
|
|
419 | ################################################################################ |
|
|
420 | |
|
|
421 | # FIXME: take logs out of %webworkFiles/%courseFiles and give them their own |
|
|
422 | # top-level hash. |
|
|
423 | |
|
|
424 | # Logs data about how long it takes to process problems. (Do not confuse this |
|
|
425 | # with the /other/ timing log which can be set by WeBWorK::Timing and is used |
|
|
426 | # for benchmarking system performance in general. At some point, this timing |
|
|
427 | # mechanism will be deprecated in favor of the WeBWorK::Timing mechanism.) |
|
|
428 | $webworkFiles{logs}{timing} = "$webworkDirs{logs}/timing.log"; |
|
|
429 | |
|
|
430 | # Logs courses created via the web-based Course Administration module. |
|
|
431 | $webworkFiles{logs}{hosted_courses} = "$webworkDirs{logs}/hosted_courses.log"; |
|
|
432 | |
|
|
433 | # The transaction log contains data from each recorded answer submission. This |
|
|
434 | # is useful if the database becomes corrupted. |
|
|
435 | $webworkFiles{logs}{transaction} = "$courseDirs{logs}/transaction.log"; |
|
|
436 | |
|
|
437 | # The answer log stores a history of all users' submitted answers. |
|
|
438 | $courseFiles{logs}{answer_log} = "$courseDirs{logs}/answer_log"; |
|
|
439 | |
|
|
440 | # Log logins. |
|
|
441 | $courseFiles{logs}{login_log} = "$courseDirs{logs}/login.log"; |
|
|
442 | |
|
|
443 | # Log for almost every click. By default it is the empty string, which |
|
|
444 | # turns this log off. If you want it turned on, we suggest |
|
|
445 | # "$courseDirs{logs}/activity.log" |
|
|
446 | # When turned on, this log can get quite large. |
|
|
447 | $courseFiles{logs}{activity_log} = ''; |
|
|
448 | |
|
|
449 | ################################################################################ |
|
|
450 | # Site defaults (FIXME: what other things could be "site defaults"?) |
|
|
451 | ################################################################################ |
|
|
452 | |
|
|
453 | # Set the default timezone of courses on this server. To get a list of valid |
|
|
454 | # timezones, run: |
|
|
455 | # |
|
|
456 | # perl -MDateTime::TimeZone -e 'print join "\n", DateTime::TimeZone::all_names' |
|
|
457 | # |
|
|
458 | # To get a list of valid timezone "links" (deprecated names), run: |
|
|
459 | # |
|
|
460 | # perl -MDateTime::TimeZone -e 'print join "\n", DateTime::TimeZone::links' |
|
|
461 | # |
|
|
462 | # If left blank, the system timezone will be used. This is usually what you |
|
|
463 | # want. You might want to set this if your server is NOT in the same timezone as |
|
|
464 | # your school. If just a few courses are in a different timezone, set this in |
|
|
465 | # course.conf for the affected courses instead. |
|
|
466 | # |
|
|
467 | $siteDefaults{timezone} = ""; |
|
|
468 | |
|
|
469 | # The default_templates_course is used by default to create a new course. |
|
|
470 | # The contents of the templates directory are copied from this course |
|
|
471 | # to the new course being created. |
|
|
472 | $siteDefaults{default_templates_course} ="modelCourse"; |
|
|
473 | |
|
|
474 | ################################################################################ |
|
|
475 | # Theme |
|
|
476 | ################################################################################ |
|
|
477 | |
|
|
478 | $defaultTheme = "math"; |
|
|
479 | $defaultThemeTemplate = "system"; |
|
|
480 | |
|
|
481 | ################################################################################ |
|
|
482 | # Authentication system |
|
|
483 | ################################################################################ |
|
|
484 | |
|
|
485 | # FIXME This mechanism is a little awkward and probably should be merged with |
|
|
486 | # the dblayout selection system somehow. |
|
|
487 | |
|
|
488 | # Select the authentication module to use for normal logins. |
|
|
489 | # |
|
|
490 | # If this value is a string, the given authentication module will be used |
|
|
491 | # regardless of the database layout. If it is a hash, the database layout name |
|
|
492 | # will be looked up in the hash and the resulting value will be used as the |
|
|
493 | # authentication module. The special hash key "*" is used if no entry for the |
|
|
494 | # current database layout is found. |
|
|
495 | # |
|
|
496 | $authen{user_module} = { |
|
|
497 | sql_moodle => "WeBWorK::Authen::Moodle", |
|
|
498 | "*" => "WeBWorK::Authen", |
|
|
499 | }; |
|
|
500 | |
|
|
501 | # Select the authentication module to use for proctor logins. |
|
|
502 | # |
|
|
503 | # A string or a hash is accepted, as above. |
|
|
504 | # |
|
|
505 | $authen{proctor_module} = "WeBWorK::Authen::Proctor"; |
|
|
506 | |
|
|
507 | ################################################################################ |
| 408 | # Authorization system |
508 | # Authorization system |
| 409 | ################################################################################ |
509 | ################################################################################ |
| 410 | |
510 | |
| 411 | # This lets you specify a minimum permission level needed to perform certain |
511 | # this section lets you define which groups of users can perform which actions. |
| 412 | # actions. In the current system, >=10 will allow a professor to perform the |
|
|
| 413 | # action, >=5 will allow a TA to, and >=0 will allow a student to perform an |
|
|
| 414 | # action (almost never what you want). |
|
|
| 415 | |
512 | |
| 416 | my $student = 0; |
513 | # this hash maps a numeric permission level to the name of a role. the number |
| 417 | my $ta = 5; |
514 | # assigned to a role is significant -- roles with higher numbers are considered |
|
|
515 | # "more privileged", and are included when that role is listed for a privilege |
|
|
516 | # below. |
|
|
517 | # |
|
|
518 | %userRoles = ( |
|
|
519 | guest => -5, |
|
|
520 | student => 0, |
|
|
521 | proctor => 2, |
|
|
522 | ta => 5, |
| 418 | my $professor = 10; |
523 | professor => 10, |
|
|
524 | ); |
| 419 | |
525 | |
|
|
526 | # this hash maps operations to the roles that are allowed to perform those |
|
|
527 | # operations. the role listed and any role with a higher permission level (in |
|
|
528 | # the %userRoles hash) will be allowed to perform the operation. If the role |
|
|
529 | # is undefined, no users will be allowed to perform the operation. |
|
|
530 | # |
| 420 | %permissionLevels = ( |
531 | %permissionLevels = ( |
|
|
532 | login => "guest", |
| 421 | report_bugs => $student, |
533 | report_bugs => "student", |
|
|
534 | submit_feedback => "student", |
|
|
535 | change_password => "student", |
|
|
536 | change_email_address => "student", |
|
|
537 | |
|
|
538 | proctor_quiz => "proctor", |
|
|
539 | view_proctored_tests => "ta", |
|
|
540 | |
| 422 | view_multiple_sets => $ta, |
541 | view_multiple_sets => "ta", |
| 423 | view_unopened_sets => $ta, |
542 | view_unopened_sets => "ta", |
| 424 | view_unpublished_sets => $ta, |
543 | view_unpublished_sets => "ta", |
| 425 | view_answers => $ta, |
544 | view_answers => "ta", |
|
|
545 | |
| 426 | become_student => $professor, |
546 | become_student => "professor", |
| 427 | access_instructor_tools => $ta, |
547 | access_instructor_tools => "ta", |
| 428 | create_and_delete_problem_sets => $professor, |
|
|
| 429 | modify_problem_sets => $professor, |
|
|
| 430 | assign_problem_sets => $professor, |
|
|
| 431 | modify_student_data => $professor, |
|
|
| 432 | score_sets => $professor, |
548 | score_sets => "professor", |
| 433 | send_mail => $professor, |
549 | send_mail => "professor", |
|
|
550 | receive_feedback => "ta", |
|
|
551 | |
|
|
552 | create_and_delete_problem_sets => "professor", |
|
|
553 | assign_problem_sets => "professor", |
|
|
554 | modify_problem_sets => "professor", |
|
|
555 | modify_student_data => "professor", |
| 434 | modify_classlist_files => $professor, |
556 | modify_classlist_files => "professor", |
| 435 | modify_set_def_files => $professor, |
557 | modify_set_def_files => "professor", |
| 436 | modify_scoring_files => $professor, |
558 | modify_scoring_files => "professor", |
|
|
559 | modify_problem_template_files => "professor", |
|
|
560 | manage_course_files => "professor", |
|
|
561 | |
| 437 | create_and_delete_courses => $professor, |
562 | create_and_delete_courses => "professor", |
| 438 | fix_course_databases => $professor, |
563 | fix_course_databases => "professor", |
|
|
564 | |
|
|
565 | ##### Behavior of the interactive problem processor ##### |
|
|
566 | |
|
|
567 | show_correct_answers_before_answer_date => "ta", |
|
|
568 | show_solutions_before_answer_date => "ta", |
|
|
569 | avoid_recording_answers => "ta", |
|
|
570 | # Below this level, old answers are never initially shown |
|
|
571 | can_show_old_answers_by_default => "student", |
|
|
572 | # at this level, we look at showOldAnswers for default value |
|
|
573 | # even after the due date |
|
|
574 | can_always_use_show_old_answers_default => "professor", |
|
|
575 | check_answers_before_open_date => "ta", |
|
|
576 | check_answers_after_open_date_with_attempts => "ta", |
|
|
577 | check_answers_after_open_date_without_attempts => "guest", |
|
|
578 | check_answers_after_due_date => "guest", |
|
|
579 | check_answers_after_answer_date => "guest", |
|
|
580 | record_answers_when_acting_as_student => undef, |
|
|
581 | # "record_answers_when_acting_as_student" takes precedence |
|
|
582 | # over the following for professors acting as students: |
|
|
583 | record_answers_before_open_date => undef, |
|
|
584 | record_answers_after_open_date_with_attempts => "student", |
|
|
585 | record_answers_after_open_date_without_attempts => undef, |
|
|
586 | record_answers_after_due_date => undef, |
|
|
587 | record_answers_after_answer_date => undef, |
|
|
588 | dont_log_past_answers => "professor", |
|
|
589 | # does the user get to see a dump of the problem? |
|
|
590 | view_problem_debugging_info => "ta", |
|
|
591 | |
|
|
592 | ##### Behavior of the Hardcopy Processor ##### |
|
|
593 | |
|
|
594 | download_hardcopy_multiuser => "ta", |
|
|
595 | download_hardcopy_multiset => "ta", |
|
|
596 | download_hardcopy_format_pdf => "guest", |
|
|
597 | download_hardcopy_format_tex => "ta", |
|
|
598 | ); |
|
|
599 | |
|
|
600 | # This is the default permission level given to new students and students with |
|
|
601 | # invalid or missing permission levels. |
|
|
602 | $default_permission_level = $userRoles{student}; |
|
|
603 | |
|
|
604 | ################################################################################ |
|
|
605 | # Status system |
|
|
606 | ################################################################################ |
|
|
607 | |
|
|
608 | # This is the default status given to new students and students with invalid |
|
|
609 | # or missing statuses. |
|
|
610 | $default_status = "Enrolled"; |
|
|
611 | |
|
|
612 | # The first abbreviation in the abbreviations list is the canonical |
|
|
613 | # abbreviation, and will be used when setting the status value in a user record |
|
|
614 | # or an exported classlist file. |
|
|
615 | # |
|
|
616 | # Results are undefined if more than one status has the same abbreviation. |
|
|
617 | # |
|
|
618 | # The four behaviors that are controlled by status are: |
|
|
619 | # allow_course_access => is this user allowed to log in? |
|
|
620 | # include_in_assignment => is this user included when assigning as set to "all" users? |
|
|
621 | # include_in_stats => is this user included in statistical reports? |
|
|
622 | # include_in_email => is this user included in emails sent to the class? |
|
|
623 | # include_in_scoring => is this user included in score reports? |
|
|
624 | |
|
|
625 | %statuses = ( |
|
|
626 | Enrolled => { |
|
|
627 | abbrevs => [qw/ C c current enrolled /], |
|
|
628 | behaviors => [qw/ allow_course_access include_in_assignment include_in_stats |
|
|
629 | include_in_email include_in_scoring /], |
|
|
630 | }, |
|
|
631 | Audit => { |
|
|
632 | abbrevs => [qw/ A a audit /], |
|
|
633 | behaviors => [qw/ allow_course_access include_in_assignment include_in_stats |
|
|
634 | include_in_email /], |
|
|
635 | }, |
|
|
636 | Drop => { |
|
|
637 | abbrevs => [qw/ D d drop withdraw /], |
|
|
638 | behaviors => [qw/ /], |
|
|
639 | }, |
| 439 | ); |
640 | ); |
| 440 | |
641 | |
| 441 | ################################################################################ |
642 | ################################################################################ |
| 442 | # Session options |
643 | # Session options |
| 443 | ################################################################################ |
644 | ################################################################################ |
| 444 | |
645 | |
| 445 | # $sessionKeyTimeout defines seconds of inactivity before a key expires |
646 | # $sessionKeyTimeout defines seconds of inactivity before a key expires |
| 446 | $sessionKeyTimeout = 60*30; |
647 | $sessionKeyTimeout = 60*30; |
| 447 | |
648 | |
| 448 | # $sessionKeyLength defines the length (in characters) of the session key |
649 | # $sessionKeyLength defines the length (in characters) of the session key |
| 449 | $sessionKeyLength = 40; |
650 | $sessionKeyLength = 32; |
| 450 | |
651 | |
| 451 | # @sessionKeyChars lists the legal session key characters |
652 | # @sessionKeyChars lists the legal session key characters |
| 452 | @sessionKeyChars = ('A'..'Z', 'a'..'z', '0'..'9', '.', '^', '/', '!', '*'); |
653 | @sessionKeyChars = ('A'..'Z', 'a'..'z', '0'..'9'); |
| 453 | |
654 | |
| 454 | # Practice users are users who's names start with $practiceUser |
655 | # Practice users are users who's names start with $practiceUser |
| 455 | # (you can comment this out to remove practice user support) |
656 | # (you can comment this out to remove practice user support) |
| 456 | $practiceUserPrefix = "practice"; |
657 | $practiceUserPrefix = "practice"; |
| 457 | |
658 | |
| 458 | # There is a practice user who can be logged in multiple times. He's |
659 | # There is a practice user who can be logged in multiple times. He's |
| 459 | # commented out by default, though, so you don't hurt yourself. It is |
660 | # commented out by default, though, so you don't hurt yourself. It is |
| 460 | # kindof a backdoor to the practice user system, since he doesn't have a |
661 | # kindof a backdoor to the practice user system, since he doesn't have a |
| 461 | # password. Come to think of it, why do we even have this?! |
662 | # password. Come to think of it, why do we even have this?! |
| 462 | #$debugPracticeUser = "practice666"; |
663 | #$debugPracticeUser = "practice666"; |
|
|
664 | |
|
|
665 | # Option for gateway tests; $gatewayGracePeriod is the time in seconds |
|
|
666 | # after the official due date during which we'll still grade the test |
|
|
667 | $gatewayGracePeriod = 120; |
| 463 | |
668 | |
| 464 | ################################################################################ |
669 | ################################################################################ |
| 465 | # PG subsystem options |
670 | # PG subsystem options |
| 466 | ################################################################################ |
671 | ################################################################################ |
| 467 | |
672 | |
| … | |
… | |
| 503 | |
708 | |
| 504 | # Only the local renderer is supported in this version. |
709 | # Only the local renderer is supported in this version. |
| 505 | $pg{renderer} = "WeBWorK::PG::Local"; |
710 | $pg{renderer} = "WeBWorK::PG::Local"; |
| 506 | |
711 | |
| 507 | # The remote renderer connects to an XML-RPC PG rendering server. |
712 | # The remote renderer connects to an XML-RPC PG rendering server. |
| 508 | #$pg{renderer} = "WeBWorK::PG::Remote"' |
713 | #$pg{renderer} = "WeBWorK::PG::Remote"; |
| 509 | |
714 | |
| 510 | ##### Renderer-dependent options |
715 | ##### Renderer-dependent options |
| 511 | |
716 | |
| 512 | # The remote renderer has one option: |
717 | # The remote renderer has one option: |
| 513 | $pg{renderers}{"WeBWorK::PG::Remote"} = { |
718 | $pg{renderers}{"WeBWorK::PG::Remote"} = { |
| … | |
… | |
| 532 | # USE DvipngDepths; |
737 | # USE DvipngDepths; |
| 533 | # CREATE TABLE depths (md5 CHAR(33) NOT NULL, depth SMALLINT, PRIMARY KEY (md5)); |
738 | # CREATE TABLE depths (md5 CHAR(33) NOT NULL, depth SMALLINT, PRIMARY KEY (md5)); |
| 534 | # GRANT ALL ON DvipngDepths.* TO webworkWrite; |
739 | # GRANT ALL ON DvipngDepths.* TO webworkWrite; |
| 535 | # |
740 | # |
| 536 | # In the last statement, "webworkWrite" should match the user below. |
741 | # In the last statement, "webworkWrite" should match the user below. |
|
|
742 | # FIXME: this database can become a table in the 'webwork' database |
| 537 | dvipng_depth_db => { |
743 | dvipng_depth_db => { |
| 538 | dbsource => 'dbi:mysql:DvipngDepths', |
744 | dbsource => 'dbi:mysql:DvipngDepths', |
| 539 | user => $dbLayouts{sql}->{password}->{params}->{usernameRW}, |
745 | user => $dbLayouts{sql_single}->{password}->{params}->{usernameRW}, |
| 540 | passwd => $dbLayouts{sql}->{password}->{params}->{passwordRW}, |
746 | passwd => $dbLayouts{sql_single}->{password}->{params}->{passwordRW}, |
| 541 | }, |
747 | }, |
| 542 | }; |
748 | }; |
| 543 | |
749 | |
|
|
750 | $pg{displayModeOptions}{jsMath} = { |
|
|
751 | reportMissingFonts => 0, # set to 1 to allow the missing font message |
|
|
752 | missingFontMessage => undef, # set to an HTML string to replace the missing font message |
|
|
753 | noImageFonts => 0, # set to 1 if you didn't install the jsMath image fonts |
|
|
754 | processDoubleClicks => 1, # set to 0 to disable double-click on math to get TeX source |
|
|
755 | }; |
|
|
756 | |
| 544 | ##### Directories used by PG |
757 | ##### Directories used by PG |
| 545 | |
758 | |
| 546 | # The root of the PG directory tree (from pg_root in Apache config). |
759 | # The root of the PG directory tree (from pg_root in Apache config). |
| 547 | $pg{directories}{root} = "$pgRoot"; |
760 | $pg{directories}{root} = "$pg_dir"; |
| 548 | $pg{directories}{lib} = "$pg{directories}{root}/lib"; |
761 | $pg{directories}{lib} = "$pg{directories}{root}/lib"; |
| 549 | $pg{directories}{macros} = "$pg{directories}{root}/macros"; |
762 | $pg{directories}{macros} = "$pg{directories}{root}/macros"; |
|
|
763 | |
|
|
764 | # |
|
|
765 | # The macro file search path. Each directory in this list is seached |
|
|
766 | # (in this order) by loadMacros() when it looks for a .pl file. |
|
|
767 | # |
|
|
768 | $pg{directories}{macrosPath} = [ |
|
|
769 | ".", # search the problem file's directory |
|
|
770 | $courseDirs{macros}, |
|
|
771 | $pg{directories}{macros}, |
|
|
772 | ]; |
| 550 | |
773 | |
| 551 | ##### "Special" PG environment variables. (Stuff that doesn't fit in anywhere else.) |
774 | ##### "Special" PG environment variables. (Stuff that doesn't fit in anywhere else.) |
| 552 | |
775 | |
| 553 | # Users for whom to print the file name of the PG file being processed. |
776 | # Users for whom to print the file name of the PG file being processed. |
| 554 | $pg{specialPGEnvironmentVars}{PRINT_FILE_NAMES_FOR} = [ "professor", ]; |
777 | $pg{specialPGEnvironmentVars}{PRINT_FILE_NAMES_FOR} = [ "professor", ]; |
| … | |
… | |
| 560 | $pg{specialPGEnvironmentVars}{CAPA_GraphicsDirectory} = "$courseDirs{html}/CAPA_Graphics/", |
783 | $pg{specialPGEnvironmentVars}{CAPA_GraphicsDirectory} = "$courseDirs{html}/CAPA_Graphics/", |
| 561 | $pg{specialPGEnvironmentVars}{CAPA_Graphics_URL} = "$courseURLs{html}/CAPA_Graphics/", |
784 | $pg{specialPGEnvironmentVars}{CAPA_Graphics_URL} = "$courseURLs{html}/CAPA_Graphics/", |
| 562 | |
785 | |
| 563 | # Size in pixels of dynamically-generated images, i.e. graphs. |
786 | # Size in pixels of dynamically-generated images, i.e. graphs. |
| 564 | $pg{specialPGEnvironmentVars}{onTheFlyImageSize} = 400, |
787 | $pg{specialPGEnvironmentVars}{onTheFlyImageSize} = 400, |
|
|
788 | |
|
|
789 | # To disable the Parser-based versions of num_cmp and fun_cmp, and use the |
|
|
790 | # original versions instead, set this value to 1. |
|
|
791 | $pg{specialPGEnvironmentVars}{useOldAnswerMacros} = 0; |
|
|
792 | |
|
|
793 | # Strings to insert at the start and end of the body of a problem |
|
|
794 | # (at beginproblem() and ENDDOCUMENT) in various modes. More display modes |
|
|
795 | # can be added if different behaviours are desired (e.g., HTML_dpng, |
|
|
796 | # HTML_asciimath, etc.). These parts are not used in the Library browser. |
|
|
797 | |
|
|
798 | $pg{specialPGEnvironmentVars}{problemPreamble} = { TeX => '', HTML=> '' }; |
|
|
799 | $pg{specialPGEnvironmentVars}{problemPostamble} = { TeX => '', HTML=>'' }; |
|
|
800 | |
|
|
801 | # To have the problem body indented and boxed, uncomment: |
|
|
802 | |
|
|
803 | # $pg{specialPGEnvironmentVars}{problemPreamble}{HTML} = '<BLOCKQUOTE> |
|
|
804 | # <TABLE BORDER=1 CELLSPACING=1 CELLPADDING=15 BGCOLOR=#E8E8E8><TR><TD>'; |
|
|
805 | # $pg{specialPGEnvironmentVars}{problemPostamble}{HTML} = '</TD></TR></TABLE> |
|
|
806 | # </BLOCKQUOTE>'; |
| 565 | |
807 | |
| 566 | ##### PG modules to load |
808 | ##### PG modules to load |
| 567 | |
809 | |
| 568 | # The first item of each list is the module to load. The remaining items are |
810 | # The first item of each list is the module to load. The remaining items are |
| 569 | # additional packages to import. |
811 | # additional packages to import. |
| … | |
… | |
| 571 | ${pg}{modules} = [ |
813 | ${pg}{modules} = [ |
| 572 | [qw(DynaLoader)], |
814 | [qw(DynaLoader)], |
| 573 | [qw(Exporter)], |
815 | [qw(Exporter)], |
| 574 | [qw(GD)], |
816 | [qw(GD)], |
| 575 | |
817 | |
| 576 | [qw(AlgParser AlgParserWithImplicitExpand Expr ExprWithImplicitExpand)], |
818 | [qw(AlgParser AlgParserWithImplicitExpand Expr ExprWithImplicitExpand utf8)], |
| 577 | [qw(AnswerHash AnswerEvaluator)], |
819 | [qw(AnswerHash AnswerEvaluator)], |
| 578 | [qw(WWPlot)], # required by Circle (and others) |
820 | [qw(WWPlot)], # required by Circle (and others) |
| 579 | [qw(Circle)], |
821 | [qw(Circle)], |
| 580 | [qw(Complex)], |
822 | [qw(Complex)], |
| 581 | [qw(Complex1)], |
823 | [qw(Complex1)], |
| … | |
… | |
| 592 | [qw(PGrandom)], |
834 | [qw(PGrandom)], |
| 593 | [qw(Regression)], |
835 | [qw(Regression)], |
| 594 | [qw(Select)], |
836 | [qw(Select)], |
| 595 | [qw(Units)], |
837 | [qw(Units)], |
| 596 | [qw(VectorField)], |
838 | [qw(VectorField)], |
|
|
839 | [qw(Parser Value)], |
|
|
840 | [qw(Parser::Legacy)], |
|
|
841 | [qw(Apache::Log)], |
| 597 | ]; |
842 | ]; |
| 598 | |
843 | |
| 599 | ##### Answer evaluatior defaults |
844 | ##### Answer evaluatior defaults |
| 600 | |
845 | |
| 601 | $pg{ansEvalDefaults} = { |
846 | $pg{ansEvalDefaults} = { |
| … | |
… | |
| 614 | numZeroLevelDefault => 1E-14, |
859 | numZeroLevelDefault => 1E-14, |
| 615 | numZeroLevelTolDefault => 1E-12, |
860 | numZeroLevelTolDefault => 1E-12, |
| 616 | useBaseTenLog => 0, |
861 | useBaseTenLog => 0, |
| 617 | defaultDisplayMatrixStyle => "[s]", |
862 | defaultDisplayMatrixStyle => "[s]", |
| 618 | }; |
863 | }; |
|
|
864 | |
|
|
865 | ################################################################################ |
|
|
866 | # Compatibility |
|
|
867 | ################################################################################ |
|
|
868 | |
|
|
869 | # Define the old names for the various "root" variables. |
|
|
870 | $webworkRoot = $webworkDirs{root}; |
|
|
871 | $webworkURLRoot = $webworkURLs{root}; |
|
|
872 | $pgRoot = $pg{directories}{root}; |