more 0.11_02 commits
[bse.git] / site / docs / config.pod
CommitLineData
61551101
TC
1=head1 NAME
2
3config.pod - documents BSE configuration file options
4
5=head1 DESCRIPTION
6
7BSE historically used Constants.pm to keep most configuration
8information. The plan is to make sure any new configuration is kept
9in bse.cfg, and to slowly move most configuration information into
10bse.cfg.
11
12Keeping configuration information in Constants.pm makes it difficult
13to perform upgrades and makes it impossible to use tools such as
14mod_perl, at least if you want more than one site on the machine.
15
16=head1 CONFIGURATION ENTRIES
17
18=head2 [paths]
19
20Contains various file system paths.
21
22=over
23
24=item downloads
25
26This is where the files uploads with the file wizard are stored. It
27must be writable by the web server user.
28
29=item admin_templates
30
31Directory containing administrative templates. Note: this is not
32completely implemented for now, so assume the default. Default: admin
33directory under $TMPLDIR.
34
35=item templates
36
37Directory base for most templates. Note: this is not completely
38implemented for now, so assume the default. Default: $TMPLDIR.
39
40=back
41
42=head2 [extensions]
43
44This section is used by the file wizard to map uploaded file
45extensions to MIME content types. This can be used to extend
46BSE::FileEditor's internal extension map. It cannot override that
47map.
48
49The key for each entry is the extension, without the leading '.'.
50
51eg.
52
53 xls = application/msexcel
54
55=head2 [templates]
56
57Used for translating symbolic template names into full names under the
58template directory.
59
60In each case the default is the name with a C<.tmpl> extension.
61
62=over
63
64=item user/logon
65
66user logon page
67
68=item user/register
69
70user registration page
71
72=back
73
74=head2 [admin templates]
75
76Used for translating the names of administration templates into filenames.
77
78In each case the default is the name with a C<.tmpl> extension.
79
80=over
81
82=item filelist
83
84article file wizard
85
86=back
87
88=head2 [html]
89
90Minor html items.
91
92=over
93
94=item charset
95
96The value of the charset keyword when outputting HTML from a script.
97Set to the empty string to suppress the charset keyword. Default:
98iso-8859-1.
99
100=back
101
102=head2 [basic]
103
104=over
105
106=item cookie_lifetime
107
108The expiry time for cookies. This should be in the form supported by
109CGI.pm for the -expires parameter. Typically you want a plus ('+'), a
110number, and a time character (s - seconds, m - minutes, h - hours, d -
111days, M - months). Default: +3h
112
113=item minpassword
114
115Minimum password length in characters. Default: 4.
116
117=back
118
119=head2 [messages]
120
121This can be used to control translation of error messages. Each key
122has a prefix identifying the module that uses the error, followed by
123'/' followed by a specific identifier for the message.
124
125Message parameters, expressed as $I<digit>, are replaced with the
126parameters passed to the message. C<$$> is replaced with C<$>.
127
128Each message identifier below is documented with the id, when it
129occurs, the default message, and any parameters.
130
131=over
132
133=item user/needlogon
134
135the user attempted to logon without entering a logon name. Default:
136"Please enter a logon name". No parameters.
137
138=item user/needpass
139
140the user attempted to logon without entering a password. Default:
141"Please enter your password." No parameters.
142
143=item user/baduserpass
144
145the user's logon name or password was not found or did not match.
146Default: "Invalid user or password". No parameters.
147
148=item user/notloggedon
149
150the user attempted to logoff while not logged on. Default: "You
151aren't logged on". No parameters.
152
153=item user/optsoldpass
154
155the user entered a new password on the options page without entering
156their old password. Default: "You need to enter your old password to
157change your password". No parameters.
158
159=back
160
161=head1 AUTHOR
162
163Tony Cook <tony@develop-help.com>
164
165=cut