]> CyberLeo.Net >> Repos - SourceForge/phpwiki.git/blob - config/config-dist.ini
Connect the rest of PhpWiki to the IniConfig system. Also the keyword regular expres...
[SourceForge/phpwiki.git] / config / config-dist.ini
1 ; This is the main configuration file for PhpWiki.
2 ;
3 ; This file is divided into seven parts: Parts Zero, One, Two, Three,
4 ; Four, Five and Six. Each one has different configuration settings you can
5 ; change; in all cases the default should work on your system,
6 ; however, we recommend you tailor things to your particular setting.
7
8 ;=========================================================================
9 ; Part Zero: Tricky Options
10 ;=========================================================================
11 ;
12 ; If PHP needs help in finding where you installed the rest of the PhpWiki
13 ; code, you can set the include_path here.
14 ;
15 ; Define PHP's include path so that it can find the PHP source code
16 ; for this PhpWiki.
17
18 ; You shouldn't need to do this unless you've moved index.php out
19 ; of the PhpWiki install directory.
20 ;
21 ; Note that on Windows-based servers, you should use ; rather than :
22 ; as the path separator.
23 ;INCLUDE_PATH = .:/usr/local/httpd/phpwiki
24
25 ; Set DEBUG to 1 to view the XHTML and CSS validator icons, page
26 ; processing timer, and possibly other debugging messages at the
27 ; bottom of each page.
28 ;DEBUG = true
29
30 ; Enable the new method of handling WikiUsers.  This is currently an
31 ; experimental feature, although it is considered fairly stable.  It's best
32 ; to leave it on, and only disable it if you have problems with it.
33 ENABLE_USER_NEW = true
34
35 ; Experimental edit feature
36 ;JS_SEARCHREPLACE = false
37
38 ;==========================================================================
39 ; Part One: Authentication and security settings.
40 ;
41 ; See Part Three for more.
42 ;==========================================================================
43 ;
44 ; The name of your wiki.
45 ;
46 ; This is used to generate a keywords meta tag in the HTML templates,
47 ; in bookmark titles for any bookmarks made to pages in your wiki,
48 ; and during RSS generation for the <title> of the RSS channel.
49 ;
50 ; To use your own logo and signature files, name them PhpWikiLogo.png
51 ; and PhpWikiSignature.png and put them into themes/default/images
52 ; (substituting "PhpWiki" in the filename with the name you define
53 ; here).
54 ;
55 ; It is recommended this be a relatively short WikiWord like the
56 ; InterWiki monikers found in the InterWikiMap. (For examples, see
57 ; lib/interwiki.map).
58 WIKI_NAME = PhpWiki
59
60 ; Visitor Hostname Lookup
61 ;
62 ; If set, reverse dns lookups will be performed to attempt to convert
63 ; the user's IP number into a host name, in the case where the http
64 ; server does not do this.
65 ENABLE_REVERSE_DNS = true
66
67 ; Username and password of administrator.
68 ;
69 ; Set these to your preferences. For heaven's sake pick a good
70 ; password and use the passencrypt.php tool to encrypt the password from
71 ; prying eyes.
72 ; http://wolfram.org/writing/howto/password.html
73
74 ; Logging into the wiki with the admin user and password allows you to lock,
75 ; unlock, or remove pages and to perform other PhpWikiAdministration
76 ; functions. On all other occasions you should simply log in with your
77 ; regular WikiName.
78 ;ADMIN_USER = 
79 ;ADMIN_PASSWD =
80
81 ; It is recommended that you use the passencrypt.php utility to encode the
82 ; admin password, in the event that someone gains ftp or ssh access to the
83 ; server and directory containing phpwiki. Once you have pasted the
84 ; encrypted password into ADMIN_PASSWD, uncomment this next line.
85 ENCRYPTED_PASSWD = true
86
87 ; Private ZIP Dumps of All Wiki Pages
88 ;
89 ; If true, only the admin user can make zip dumps. Otherwise anyone
90 ; may download all wiki pages as a single zip archive.
91 ZIPDUMP_AUTH = false
92
93 ; The RawHtml plugin allows page authors to embed real, raw HTML into Wiki
94 ; pages.  This is a possible security threat, as much HTML (or, rather,
95 ; JavaScript) can be very risky.  If you are in a controlled environment,
96 ; however, it could be of use.
97 ENABLE_RAW_HTML = false;
98
99 ; If you define this to true, (MIME-type) page-dumps (either zip dumps,
100 ; or "dumps to directory" will be encoded using the quoted-printable
101 ; encoding.  If you're actually thinking of mailing the raw page dumps,
102 ; then this might be useful, since (among other things,) it ensures
103 ; that all lines in the message body are under 80 characters in length.
104 ;
105 ; Also, setting this will cause a few additional mail headers
106 ; to be generated, so that the resulting dumps are valid
107 ; RFC 2822 e-mail messages.
108 ;
109 ; Probably you can just leave this set to false, in which case you get
110 ; raw ('binary' content-encoding) page dumps.
111 STRICT_MAILABLE_PAGEDUMPS = false
112
113 ; Here you can change the filename suffix used for XHTML page dumps.
114 ; If you don't want any suffix just comment this out.
115 HTML_DUMP_SUFFIX = .html
116
117 ; The maximum file upload size, in bytes.
118 ; The default, 16777216, is 16MB.
119 MAX_UPLOAD_SIZE = 16777216
120
121 ; If the last edit is older than MINOR_EDIT_TIMEOUT seconds, the
122 ; default state for the "minor edit" checkbox on the edit page form
123 ; will be off.
124 ; The default, 604800, is one week (7 days)
125 MINOR_EDIT_TIMEOUT = 604800
126
127 ; Actions listed in this array will not be allowed.  The complete list
128 ; of actions can be found in lib/main.php with the function
129 ; getActionDescription.
130 ; DISABLED_ACTIONS = "dumpserial : loadfile"
131
132 ; PhpWiki can generate an access_log (in "NCSA combined log" format)
133 ; for you. If you want one, define this to the name of the log
134 ; file. The server must have write access to the directory specified.
135 ;ACCESS_LOG = /var/tmp/wiki_access_log
136
137 ; By default PhpWiki will try to have PHP compress its output
138 ; before sending it to the browser (if you have a recent enough
139 ; version of PHP and the browser supports it.)
140 ; Define COMPRESS_OUTPUT to false to prevent output compression.
141 ; Define COMPRESS_OUTPUT to true to force output compression,
142 ; even if we think your version of PHP does this in a buggy
143 ; fashion.
144 ; Leave it undefined to leave the choice up to PhpWiki.
145 ;
146 ; WARNING: Compressing the output has been reported to cause serious problems
147 ; when PHP is running as a CGI.
148 ;COMPRESS_OUTPUT = false
149
150 ; This controls how PhpWiki sets the HTTP cache control
151 ; headers (Expires: and Cache-Control:) 
152 ;
153 ; Choose one of:
154 ;
155 ; NONE: This is roughly the old (pre 1.3.4) behavior.  PhpWiki will
156 ;       instruct proxies and browsers never to cache PhpWiki output.
157 ;
158 ; STRICT: Cached pages will be invalidated whenever the database global
159 ;       timestamp changes.  This should behave just like NONE (modulo
160 ;       bugs in PhpWiki and your proxies and browsers), except that
161 ;       things will be slightly more efficient.
162 ;
163 ; LOOSE: Cached pages will be invalidated whenever they are edited,
164 ;       or, if the pages include plugins, when the plugin output could
165 ;       concievably have changed.
166 ;
167 ;       Behavior should be much like STRICT, except that sometimes
168 ;       wikilinks will show up as undefined (with the question mark)
169 ;       when in fact they refer to (recently) created pages.
170 ;       (Hitting your browsers reload or perhaps shift-reload button
171 ;       should fix the problem.)
172 ;
173 ; ALLOW_STALE: Proxies and browsers will be allowed to used stale pages.
174 ;       (The timeout for stale pages is controlled by CACHE_CONTROL_MAX_AGE.)
175 ;
176 ;       This setting will result in quirky behavior.  When you edit a
177 ;       page your changes may not show up until you shift-reload the
178 ;       page, etc...
179 ;
180 ;       This setting is generally not advisable, however it may be useful
181 ;       in certain cases (e.g. if your wiki gets lots of page views,
182 ;       and few edits by knowledgable people who won't freak over the quirks.)
183 ;
184 ; The recommended default is currently LOOSE.
185 ;
186 CACHE_CONTROL = LOOSE
187
188 ; Maximum page staleness, in seconds.
189 ;
190 ; This only has effect if CACHE_CONTROL is set to ALLOW_STALE.
191 CACHE_CONTROL_MAX_AGE = 600
192
193 ; PhpWiki normally caches a preparsed version (i.e. mostly
194 ; converted to HTML) of the most recent version of each page.
195 ; (Parsing the wiki-markup takes a fair amount of CPU.)
196 ;
197 ; Define WIKIDB_NOCACHE_MARKUP to true to disable the
198 ; caching of marked-up page content.
199 ;
200 ; Note that you can also disable markup caching on a per-page
201 ; temporary basis by addinging a query arg of '?nocache=1'
202 ; to the URL to the page.  (Use '?nocache=purge' to completely
203 ; discard the cached version of the page.)
204 ;
205 ; You can also purge the cached markup globally by using the
206 ; "Purge Markup Cache" button on the PhpWikiAdministration page.
207 ;WIKIDB_NOCACHE_MARKUP = true
208
209 ;======================================================================
210 ; Part Two: Database Selection
211 ;======================================================================
212
213 ; Select the database type:
214 ;
215 ;       ADODB: uses the ADODB library for data access.  Reportedly only
216 ;               works for MySQL backends.
217 ;       SQL: access one of several (currently only PostgreSQL, MySQL,
218 ;               and SQLite) SQL databases using the PEAR DB library.
219 ;       dba: use one of the standard UNIX dbm libraries.
220 ;       file: use a flat file database.
221 ;       cvs: use a CVS server to store everything.
222 DATABASE_TYPE = dba
223    
224 ; prefix for filenames or table names
225 ;
226 ; currently you MUST EDIT THE SQL file too (in the schemas/
227 ; directory because we aren't doing on the fly sql generation
228 ; during the installation.
229 ;DATABASE_PREFIX = phpwiki_
230
231 ; For SQL based backends, specify the database as a DSN (Data Source Name),
232 ; a kind of URL for databases.
233 ;
234 ; The most general form of a DSN looks like:
235 ;
236 ;       dbtype(dbsyntax)://username:password@protocol+hostspec/database
237 ;
238 ; For a MySQL database, the following should work:
239 ;
240 ;       mysql://user:password@host/databasename
241 ;
242 ; To connect over a unix socket, use something like
243 ;
244 ;       mysql://user:password@unix(/path/to/socket)/databasename
245 ;
246 ; Valid values for dbtype are mysql, pgsql, or sqlite.
247 ;
248 DATABASE_DSN = "mysql://guest@unix(/var/lib/mysql/mysql.sock)/test"
249
250 ; A table to store session information.  Only needed by SQL backends.
251 ;
252 ; A word of warning - any prefix defined above will be prepended to whatever
253 ; is given here.
254 DATABASE_SESSION_TABLE = session
255
256 ; For the file and dba backends, this specifies where the data files will be
257 ; located.  Ensure that the user that the webserver runs as has write access
258 ; to this directory.
259 ;
260 ; WARNING: leaving this as the default of '/tmp' will almost guarantee that
261 ; you'll lose your wiki data at some stage.
262 DATABASE_DIRECTORY = /tmp
263
264 ; For the dba backend, this defines which DBA variant you wish to use.
265 ;       gdbm - commonly available
266 ;       db2 - Berkeley DB v2; not supported by modern versions of PHP
267 ;       db3 - Berkeley DB v3; as per db2
268 ;       db4 - Berkeley DB v4; current version, however PHP has some issues
269 ;               with it's db4 support.
270 ;       dbm - Older dba handler; suffers from limits on the size of data
271 ;               items
272 DATABASE_DBA_HANDLER = db4
273
274 ; How long will the system wait for a database operation to complete?
275 ; Specified in seconds.
276 DATABASE_TIMEOUT = 20
277
278 ; The login code now uses PHP's session support. Usually, the default
279 ; configuration of PHP is to store the session state information in
280 ; /tmp. That probably will work fine, but fails e.g. on clustered
281 ; servers where each server has their own distinct /tmp (this is the
282 ; case on SourceForge's project web server.) You can specify an
283 ; alternate directory in which to store state information like so
284 ; (whatever user your httpd runs as must have read/write permission
285 ; in this directory):
286 ;SESSION_SAVE_PATH = some_other_directory
287
288 ;========================================================================
289 ; Section 3a: Page revisions
290 ;
291 ; The next section controls how many old revisions of each page are
292 ; kept in the database.
293 ;========================================================================
294 ;
295 ; There are two basic classes of revisions: major and minor. Which
296 ; class a revision belongs in is determined by whether the author
297 ; checked the "this is a minor revision" checkbox when they saved the
298 ; page.
299
300 ; There is, additionally, a third class of revisions: author
301 ; revisions. The most recent non-mergable revision from each distinct
302 ; author is an author revision.
303 ;
304 ; The expiry parameters for each of those three classes of revisions
305 ; can be adjusted seperately. For each class there are five
306 ; parameters (usually, only two or three of the five are actually
307 ; set) which control how long those revisions are kept in the
308 ; database.
309 ;
310 ;   MAX_KEEP: If set, this specifies an absolute maximum for the
311 ;             number of archived revisions of that class. This is
312 ;             meant to be used as a safety cap when a non-zero
313 ;             min_age is specified. It should be set relatively high,
314 ;             and it's purpose is to prevent malicious or accidental
315 ;             database overflow due to someone causing an
316 ;             unreasonable number of edits in a short period of time.
317 ;
318 ;   MIN_AGE:  Revisions younger than this (based upon the supplanted
319 ;             date) will be kept unless max_keep is exceeded. The age
320 ;             should be specified in days. It should be a
321 ;             non-negative, real number,
322 ;
323 ;   MIN_KEEP: At least this many revisions will be kept.
324 ;
325 ;   KEEP: No more than this many revisions will be kept.
326 ;
327 ;   MAX_AGE:  No revision older than this age will be kept.
328 ;
329 ; Definitions of terms used above:
330 ;
331 ; Supplanted date: Revisions are timestamped at the instant that they
332 ; cease being the current revision. Revision age is computed using
333 ; this timestamp, not the edit time of the page.
334 ;
335 ; Merging: When a minor revision is deleted, if the preceding
336 ; revision is by the same author, the minor revision is merged with
337 ; the preceding revision before it is deleted. Essentially: this
338 ; replaces the content (and supplanted timestamp) of the previous
339 ; revision with the content after the merged minor edit, the rest of
340 ; the page metadata for the preceding version (summary, mtime, ...)
341 ; is not changed.
342 ;
343 ; Keep up to 8 major edits, but keep them no longer than a month.
344 MAJOR_MAX_AGE = 32
345 MAJOR_KEEP = 8
346
347 ; Keep up to 4 minor edits, but keep them no longer than a week.
348 MINOR_MAX_AGE = 7
349 MINOR_KEEP = 4
350
351 ; Keep the latest contributions of the last 8 authors up to a year.
352 ; Additionally, (in the case of a particularly active page) try to
353 ; keep the latest contributions of all authors in the last week (even
354 ; if there are more than eight of them,) but in no case keep more
355 ; than twenty unique author revisions.
356 AUTHOR_MAX_AGE = 365
357 AUTHOR_KEEP = 8
358 AUTHOR_MIN_AGE = 7
359 AUTHOR_MAX_KEEP = 20
360
361 ;========================================================================
362 ; Part Three: User Authentication
363 ;========================================================================
364 ;
365 ; New user authentication configuration:
366 ; We support three basic authentication methods and a stacked array 
367 ; of advanced auth methods to get and check the passwords:
368 ;
369 ; ALLOW_ANON_USER         default true
370 ; ALLOW_ANON_EDIT         default true
371 ; ALLOW_BOGO_LOGIN        default true
372 ; ALLOW_USER_PASSWORDS    default true
373
374 ; allow anon users to view existing pages
375 ALLOW_ANON_USER = true
376 ; allow anon users to edit pages
377 ALLOW_ANON_EDIT = true
378
379 ; If ALLOW_BOGO_LOGIN is true, users are allowed to login (with
380 ; any/no password) using any userid which: 
381 ;  1) is not the ADMIN_USER, and
382 ;  2) is a valid WikiWord (matches $WikiNameRegexp.)
383 ; If true, users may be created by themselves. Otherwise we need seperate auth. 
384 ; If such a user will create a so called HomePage with his userid, he will 
385 ; be able to store his preferences and password there.
386 ALLOW_BOGO_LOGIN = true
387
388 ; True User Authentication:
389 ; To require user passwords:
390 ;   ALLOW_ANON_USER = false
391 ;   ALLOW_ANON_EDIT = false
392 ;   ALLOW_BOGO_LOGIN = false,
393 ;   ALLOW_USER_PASSWORDS = true.
394 ; Otherwise any anon or bogo user might login without any or a wrong password.
395 ALLOW_USER_PASSWORDS = true
396
397 ; Many different methods can be used to check user's passwords:
398 ;   BogoLogin:     WikiWord username, with no *actual* password checking,
399 ;                   although the user will still have to enter one.
400 ;   PersonalPage:  Store passwords in the users homepage metadata (simple)
401 ;   Db:            Use $DBAuthParams[] (see below) with the PearDB or 
402 ;                   ADODB only.
403 ;   LDAP:          Authenticate against LDAP_AUTH_HOST with LDAP_BASE_DN
404 ;   IMAP:          Authenticate against IMAP_AUTH_HOST (email account)
405 ;   POP3:          Authenticate against POP3_AUTH_HOST (email account)
406 ;   File:          Store username:crypted-passwords in .htaccess like files. 
407 ;                  Use Apache's htpasswd to manage this file.
408 ;   HttpAuth:      Use the protection by the webserver (.htaccess) or 
409 ;                  enforce it
410 ;
411 ; Several of these methods can be used together, in the manner specified by
412 ; USER_AUTH_POLICY, below.  To specify multiple authentication methods,
413 ; separate the name of each one with colons.
414 USER_AUTH_ORDER = PersonalPage : Db
415
416 ; For "security" purposes, you can specify that a password be at least a
417 ; certain number of characters long.  This applies even to the BogoLogin
418 ; method.
419 PASSWORD_LENGTH_MINIMUM = 2
420     
421 ; The following policies are available for user authentication:
422 ;       first-only: use only the first method in USER_AUTH_ORDER
423 ;       old:        ignore USER_AUTH_ORDER and try to use all available 
424 ;                       methods as in the previous PhpWiki releases (slow)
425 ;       strict:     check if the user exists for all methods: 
426 ;                       on the first existing user, try the password. 
427 ;                       dont try the other methods on failure then
428 ;       stacked:    check the given user - password combination for all
429 ;                       methods and return true on the first success.
430 USER_AUTH_POLICY = old
431
432 ; LDAP authentication options:
433 ;
434 ; The LDAP server to connect to.  Can either be a hostname, or a complete
435 ; URL to the server (useful if you want to use ldaps or specify a different
436 ; port number).
437 LDAP_AUTH_HOST = ldap://localhost:389
438
439 ; The organizational or domain BASE DN: e.g. "dc=mydomain,dc=com".
440 ;
441 ; Note: ou=Users and ou=Groups are used for GroupLdap Membership
442 LDAP_BASE_DN = "ou=Users,o=Development,dc=mycompany.com"
443
444 ; Some LDAP servers need some more options, such as the Windows Active
445 ; Directory Server.  Specify the options (as allowed by the PHP LDAP module)
446 ; and their values as NAME=value pairs separated by colons.
447 ; LDAP_SET_OPTION = LDAP_OPT_PROTOCOL_VERSION=3:LDAP_OPT_REFERRALS=0
448
449 ; DN to bind to the LDAP server as.
450 ; LDAP_AUTH_USER = CN=ldapuser,CN=Users,DC=uai,DC=int
451
452 ; Password to use to bind to the LDAP server, as the DN specified in
453 ; the LDAP_AUTH_USER option (above).
454 ; LDAP_AUTH_PASSWORD = s3kr1t
455
456 ; If you want to match usernames against an attribute other than uid,
457 ; specify it here.
458 ; LDAP_SEARCH_FIELD = sAMAccountName
459
460 ; IMAP authentication options:
461 ;
462 ; The IMAP server to check usernames from.  Defaults to localhost.
463 ;
464 ; Some IMAP_AUTH_HOST samples:
465 ;   "localhost", "localhost:143/imap/notls", 
466 ;   "localhost:993/imap/ssl/novalidate-cert" (SuSE refuses non-SSL conections)
467 ; IMAP_AUTH_HOST = localhost:143/imap/notls
468
469 ; POP3 authentication options:
470 ;
471 ; Host to connect to.
472 ; POP3_AUTH_HOST = localhost
473
474 ; Port to connect to.
475 ; POP3_AUTH_HOST = 110
476
477 ; File authentication options:
478 ;
479 ; File to read for authentication information.
480 ; Popular choices are /etc/shadow and /etc/httpd/.htpasswd
481 ; AUTH_USER_FILE = /etc/shadow
482
483 ; Defines whether the user is able to change their own password via PHPWiki.
484 ; Note that this means that the webserver user must be able to write to the
485 ; file specified in AUTH_USER_FILE.
486 ; AUTH_USER_FILE_STORABLE = false
487
488 ; Session Auth:
489 ; Name of the session variable which holds the already authenticated username
490 ; AUTH_SESS_USER = userid
491 ; Which level will the user be? 1 = Bogo or 2 = Pass
492 ; AUTH_SESS_LEVEL = 2
493
494 ; Group membership.  PHPWiki supports defining permissions for a group as
495 ; well as for individual users.  This defines how group membership information
496 ; is obtained.  Supported values are:
497 ;
498 ;       NONE            group membership is not supported.
499 ;       WIKIPAGE        Defined in the metadata of a wiki page.
500 ;       DB              Stored in an ADODB or PearDB database.
501 ;       FILE            Flatfile.
502 ;       LDAP            Query LDAP to find the information.
503 GROUP_METHOD = WIKIPAGE
504
505 ; For GROUP_METHOD = FILE, the file given below is referenced to obtain
506 ; group membership information.  It should be in the same format as the
507 ; standard unix /etc/groups(5) file.
508 ; AUTH_GROUP_FILE = /etc/groups
509
510 ; External database authentication and authorization.
511 ;
512 ; If USER_AUTH_ORDER includes Db, or GROUP_METHOD = DB, the options listed
513 ; below define the SQL queries used to obtain the information out of the
514 ; database, and (in some cases) store the information back to the DB.
515 ;
516 ; The options appropriate for each query are currently undocumented, and
517 ; you should not be surprised if things change mightily in the future.
518 ;
519 ; A database DSN to connect to.  Defaults to the DSN specified for the Wiki
520 ; as a whole.
521 ; DBAUTH_AUTH_DSN = mysql://localhost/phpwiki
522 ;
523 ; USER/PASSWORD queries
524 ;
525 ; Check to see if the supplied username/password pair is OK
526 ;
527 ; plaintext passwords:
528 ; DBAUTH_AUTH_CHECK = SELECT IF(passwd="$password",1,0) as ok FROM user WHERE userid="$userid"
529 ;
530 ; database-hashed passwords (more secure):
531 ; DBAUTH_AUTH_CHECK = SELECT IF(passwd=PASSWORD("$password"),1,0) as ok FROM user WHERE userid="$userid"
532
533 ; If you want to use Unix crypt()ed passwords, you can use DBAUTH_AUTH_CHECK
534 ; to get the password out of the database with a simple SELECT query, and
535 ; specify DBAUTH_AUTH_USER_EXISTS and DBAUTH_AUTH_CRYPT_METHOD:
536 ; DBAUTH_AUTH_CHECK = SELECT password AS password FROM user where userid="$userid"
537 ; DBAUTH_AUTH_USER_EXISTS = SELECT userid FROM user WHERE userid="$userid"
538 ; DBAUTH_AUTH_CRYPT_METHOD = crypt
539 ;
540 ; Update the user's authentication credential.  If this is not defined but
541 ; DBAUTH_AUTH_CHECK is, then the user will be unable to update their
542 ; password.
543 ;
544 ; Plaintext passwords:
545 ; DBAUTH_AUTH_UPDATE = UPDATE user SET passwd="$password" WHERE userid="$userid"
546 ; Database-hashed passwords:
547 ; DBAUTH_AUTH_UPDATE = UPDATE user SET passwd=PASSWORD("$password") WHERE userid="$userid"
548 ;
549 ; Allow the user to create their own account.
550 ; DBAUTH_AUTH_CREATE = INSERT INTO user SET passwd=PASSWORD("$password"),userid="$userid"
551
552 ; USER/PREFERENCE queries
553 ;
554 ; If you choose to store your preferences in an external database, enable
555 ; the following queries.  Note that if you choose to store user preferences
556 ; in the 'user' table, only registered users get their prefs from the database,
557 ; self-created users do not.  Better to use the special 'pref' table.
558 ;
559 ; The prefs field stores the serialized form of the user's preferences array,
560 ; to ease the complication of storage.
561 ; DBAUTH_PREF_SELECT = SELECT prefs FROM user WHERE userid="$userid"
562 ; DBAUTH_PREF_SELECT = SELECT prefs FROM pref WHERE userid="$userid"
563
564 ; Update the user's preferences
565 ; DBAUTH_PREF_UPDATE = UPDATE user SET prefs="$pref_blob" WHERE userid="$userid"
566 ; DBAUTH_PREF_UPDATE = REPLACE INTO pref SET prefs="$pref_blob",userid="$userid"
567
568 ; USERS/GROUPS queries
569 ;
570 ; You can define 1:n or n:m user<=>group relations, as you wish.
571 ;
572 ; Sample configurations:
573 ;  only one group per user (1:n):
574 ;   DBAUTH_IS_MEMBER = SELECT user FROM user WHERE user="$userid" AND group="$groupname"
575 ;   DBAUTH_GROUP_MEMBERS = SELECT user FROM user WHERE group="$groupname"
576 ;   DBAUTH_USER_GROUPS = SELECT group FROM user WHERE user="$userid"
577 ;  multiple groups per user (n:m):
578 ;   DBAUTH_IS_MEMBER = SELECT userid FROM member WHERE userid="$userid" AND groupname="$groupname"
579 ;   DBAUTH_GROUP_MEMBERS = SELECT DISTINCT userid FROM member WHERE groupname="$groupname"
580 ;   DBAUTH_USER_GROUPS = SELECT groupname FROM member WHERE userid="$userid"
581
582 ; Old settings, only needed for ENABLE_USER_NEW = false
583 ;
584 ; The wiki can be protected by HTTP Auth. Use the username and password 
585 ; from there, but this is not sufficient. Try the other methods also.
586 ALLOW_HTTP_AUTH_LOGIN = false
587
588 ; If ALLOW_USER_LOGIN is true, any defined internal and external
589 ; authentication method is tried. If not, we don't care about
590 ; passwords, but listen to the next two constants. Note that external
591 ; authentication is not supported at this time, you will likely have
592 ; to patch code yourself to get PhpWiki to recognise userids and
593 ; passwords from an external source.
594 ALLOW_USER_LOGIN = false
595
596 ; also only if ENABLE_USER_NEW = false:
597 ; ALLOW_LDAP_LOGIN = false
598 ; ALLOW_IMAP_LOGIN = false
599
600 ; A interim page which gets displayed on every edit attempt
601 EDITING_POLICY = EditingPolicy
602
603 ;========================================================================
604 ; Part Four: Page appearance and layout
605 ;========================================================================
606
607 ; THEMES
608 ;
609 ; Most of the page appearance is controlled by files in the theme
610 ; subdirectory.
611 ;
612 ; There are a number of pre-defined themes shipped with PhpWiki.
613 ; Or you may create your own (e.g. by copying and then modifying one of
614 ; stock themes.)
615 ;
616 ; The complete list of installed themes can be found by doing 'ls themes/'
617 ; from the root of your PHPWiki installation.
618 THEME = default
619
620 ; Select a valid charset name to be inserted into the xml/html pages,
621 ; and to reference links to the stylesheets (css). For more info see:
622 ; <http://www.iana.org/assignments/character-sets>. Note that PhpWiki
623 ; has been extensively tested only with the latin1 (iso-8859-1)
624 ; character set.
625 ;
626 ; If you change the default from iso-8859-1 PhpWiki may not work
627 ; properly and will require code modifications, at the very least you
628 ; will have to convert the files in pgsrc or locale/xx/pgsrc to
629 ; match!
630 ;
631 ; Character sets similar to iso-8859-1 may work with little or no
632 ; modification depending on your setup. The database must also
633 ; support the same charset, and of course the same is true for the
634 ; web browser. (Some work is in progress hopefully to allow more
635 ; flexibility in this area in the future).
636 CHARSET = iso-8859-1
637
638 ; Select your language/locale - default language is "en" for English.
639 ; Other languages available:
640 ; English "en"  (English    - HomePage)
641 ; Dutch   "nl" (Nederlands - ThuisPagina)
642 ; Spanish "es" (Español    - PáginaPrincipal)
643 ; French  "fr" (Français   - Accueil)
644 ; German  "de" (Deutsch    - StartSeite)
645 ; Swedish "sv" (Svenska    - Framsida)
646 ; Italian "it" (Italiano   - PaginaPrincipale)
647 ; Japanese "ja" (Japanese   - ¥Û¡¼¥à¥Ú¡¼¥¸)
648 ;
649 ; If you set DEFAULT_LANGUAGE to the empty string, your system's
650 ; default language (as determined by the applicable environment
651 ; variables) will be used.
652 ;
653 DEFAULT_LANGUAGE = en
654
655 ; WIKI_PGSRC -- specifies the source for the initial page contents of
656 ; the Wiki. The setting of WIKI_PGSRC only has effect when the wiki is
657 ; accessed for the first time (or after clearing the database.)
658 ; WIKI_PGSRC can either name a directory or a zip file. In either case
659 ; WIKI_PGSRC is scanned for files -- one file per page.
660 WIKI_PGSRC = pgsrc
661
662 ; DEFAULT_WIKI_PGSRC is only used when the language is *not* the
663 ; default (English) and when reading from a directory: in that case
664 ; some English pages are inserted into the wiki as well.
665 ; DEFAULT_WIKI_PGSRC defines where the English pages reside.
666 ;
667 ; FIXME: is this really needed?  Can't we just copy these pages into
668 ; the localized pgsrc?
669 DEFAULT_WIKI_PGSRC = pgsrc
670 ; These are the pages which will get loaded from DEFAULT_WIKI_PGSRC.
671 DEFAULT_WIKI_PAGES = ReleaseNotes:SteveWainstead:TestPage
672
673 ;=========================================================================
674 ; Part Five: Mark-up options.
675 ;=========================================================================
676 ;
677 ; allowed protocols for links - be careful not to allow "javascript:"
678 ; URL of these types will be automatically linked.
679 ; within a named link [name|uri] one more protocol is defined: phpwiki
680 ; Separate each of the protocol names with a vertical pipe, and ensure there
681 ; is no extraneous whitespace.
682 ALLOWED_PROTOCOLS = http|https|mailto|ftp|news|nntp|ssh|gopher
683
684 ; URLs ending with the following extension should be inlined as images.
685 ; Specify as per ALLOWED_PROTOCOLS
686 INLINE_IMAGES = png|jpg|gif
687
688 ; Perl regexp for WikiNames ("bumpy words")
689 ; (?<!..) & (?!...) used instead of '\b' because \b matches '_' as well
690 WIKI_NAME_REGEXP = "(?<![[:alnum:]])(?:[[:upper:]][[:lower:]]+){2,}(?![[:alnum:]])"
691
692 ; Defaults to '/', but '.' was also used.
693 SUBPAGE_SEPARATOR = /
694
695 ; InterWiki linking -- wiki-style links to other wikis on the web
696 ;
697 ; The map will be taken from a page name InterWikiMap.
698 ; If that page is not found (or is not locked), or map
699 ; data can not be found in it, then the file specified
700 ; by INTERWIKI_MAP_FILE (if any) will be used.
701 INTERWIKI_MAP_FILE = lib/interwiki.map
702
703 ; Display a warning if the internal lib/interwiki.map is used, and 
704 ; not the public InterWikiMap page. This file is not readable from outside.
705 WARN_NONPUBLIC_INTERWIKIMAP = false
706
707 ; Regexp used for automatic keyword extraction.
708 ;
709 ; Any links on a page to pages whose names match this regexp will
710 ; be used keywords in the keywords meta tag.  (This is an aid to
711 ; classification by search engines.)  The value of the match is
712 ; used as the keyword.
713 ;
714 ; The default behavior is to match Category* and Topic* links.
715 KEYWORDS = Category:Topic
716 ;KEYWORD_LINK_REGEXP = "(?<=^\'. join(\'|^\', $keywords) . \')[[:upper:]].*$"
717
718 ; Author and Copyright Site Navigation Links
719 ;
720 ; These will be inserted as <link rel> tags in the html header of
721 ; every page, for search engines and for browsers like Mozilla which
722 ; take advantage of link rel site navigation.
723 ;
724 ; If you have your own copyright and contact information pages change
725 ; these as appropriate.
726 COPYRIGHTPAGE_TITLE = GNU General Public License
727 COPYRIGHTPAGE_URL = http://www.gnu.org/copyleft/gpl.html#SEC1
728 AUTHORPAGE_TITLE = The PhpWiki Programming Team
729 AUTHORPAGE_URL = http://phpwiki.sourceforge.net/phpwiki/ThePhpWikiProgrammingTeam
730
731
732 ;==========================================================================
733 ; Part Six: URL options.
734 ;==========================================================================
735 ;
736 ; You can probably skip this section.
737
738 ; The following section contains settings which you can use to tailor
739 ; the URLs which PhpWiki generates.
740 ;
741 ; Any of these parameters which are left undefined will be deduced
742 ; automatically. You need only set them explicitly if the
743 ; auto-detected values prove to be incorrect.
744 ;
745 ; In most cases the auto-detected values should work fine, so
746 ; hopefully you don't need to mess with this section.
747 ;
748 ; In case of local overrides of short placeholders, which themselves 
749 ; include index.php, we check for most constants. See '/wiki'.
750 ; We can override DATA_PATH and PHPWIKI_DIR to support multiple phpwiki 
751 ; versions (for development), but most likely other values like 
752 ; THEME, LANG and DbParams for a WikiFarm.
753
754 ; Canonical name and httpd port of the server on which this PhpWiki
755 ; resides.
756 ;/
757 ;SERVER_NAME = some.host.com
758 ;SERVER_PORT = 80
759
760 ; Relative URL (from the server root) of the PhpWiki
761 ; script.
762 ;SCRIPT_NAME = /some/where/index.php
763
764 ; URL of the PhpWiki install directory.  (You only need to set this
765 ; if you've moved index.php out of the install directory.)  This can
766 ; be either a relative URL (from the directory where the top-level
767 ; PhpWiki script is) or an absolute one.
768 ;DATA_PATH = /home/user/phpwiki
769
770 ; Path to the PhpWiki install directory.  This is the local
771 ; filesystem counterpart to DATA_PATH.  (If you have to set
772 ; DATA_PATH, your probably have to set this as well.)  This can be
773 ; either an absolute path, or a relative path interpreted from the
774 ; directory where the top-level PhpWiki script (normally index.php)
775 ; resides.
776 ;PHPWIKI_DIR = /home/user/public_html/phpwiki
777
778 ; PhpWiki will try to use short urls to pages, eg 
779 ; http://www.example.com/index.php/HomePage
780 ; If you want to use urls like 
781 ; http://www.example.com/index.php?pagename=HomePage
782 ; then define 'USE_PATH_INFO' as false by uncommenting the line below.
783 ; NB:  If you are using Apache >= 2.0.30, then you may need to to use
784 ; the directive "AcceptPathInfo On" in your Apache configuration file
785 ; (or in an appropriate <.htaccess> file) for the short urls to work:  
786 ; See http://httpd.apache.org/docs-2.0/mod/core.html#acceptpathinfo
787
788 ; See also http://phpwiki.sourceforge.net/phpwiki/PrettyWiki for more ideas
789 ; on prettifying your urls.
790 ;
791 ; Default: PhpWiki will try to divine whether use of PATH_INFO
792 ; is supported in by your webserver/PHP configuration, and will
793 ; use PATH_INFO if it thinks that is possible.
794 ;USE_PATH_INFO = false
795
796 ; VIRTUAL_PATH is the canonical URL path under which your your wiki
797 ; appears. Normally this is the same as dirname(SCRIPT_NAME), however
798 ; using, e.g. apaches mod_actions (or mod_rewrite), you can make it
799 ; something different.
800 ;
801 ; If you do this, you should set VIRTUAL_PATH here.
802 ;
803 ; E.g. your phpwiki might be installed at at /scripts/phpwiki/index.php,
804 ; but  * you've made it accessible through eg. /wiki/HomePage.
805 ;
806 ; One way to do this is to create a directory named 'wiki' in your
807 ; server root. The directory contains only one file: an .htaccess
808 ; file which reads something like:
809 ;
810 ;    Action x-phpwiki-page /scripts/phpwiki/index.php
811 ;    SetHandler x-phpwiki-page
812 ;    DirectoryIndex /scripts/phpwiki/index.php
813 ;
814 ; In that case you should set VIRTUAL_PATH to '/wiki'.
815 ;
816 ; (VIRTUAL_PATH is only used if USE_PATH_INFO is true.)
817 ;/
818 ;VIRTUAL_PATH = /SomeWiki
819
820 ;===========================================================================
821 ; Part Seven: Miscellaneous settings
822 ;===========================================================================
823
824 ; Disable HTTP redirects.
825 ;
826 ; (You probably don't need to touch this.)
827 ;
828 ; PhpWiki uses HTTP redirects for some of it's functionality.
829 ; (e.g. after saving changes, PhpWiki redirects your browser to
830 ; view the page you just saved.)
831 ;
832 ; Some web service providers (notably free European Lycos) don't seem to
833 ; allow these redirects.  (On Lycos the result in an "Internal Server Error"
834 ; report.)  In that case you can set DISABLE_HTTP_REDIRECT to true.
835 ; (In which case, PhpWiki will revert to sneakier tricks to try to
836 ; redirect the browser...)
837 ;DISABLE_HTTP_REDIRECT = true