File: config-dist.ini

package info (click to toggle)
phpwiki 1.3.14-3
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 15,716 kB
  • ctags: 23,548
  • sloc: php: 88,295; sql: 1,476; sh: 1,378; perl: 765; makefile: 602; awk: 28
file content (1314 lines) | stat: -rwxr-xr-x 55,569 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
; This is the main configuration file for PhpWiki.
; Note that certain characters are used as comment char and therefore 
; these entries must be in double-quotes. Such as ":", ";", "," and "|"
;
; <?php die(); ?> for security
;
; This file is divided into eight parts. 
; Each one has different configuration settings you can
; change; in all cases the default should work on your system,
; however, we recommend you tailor things to your particular setting.
; Here undefined definitions get defined by config-default.ini settings.

;=========================================================================
; Part Zero: Latest Development and Tricky Options
;=========================================================================
; If PHP needs help in finding where you installed the rest of the PhpWiki
; code, you can set the include_path here.
;
; Override PHP's include path so that it can find some needed additional libraries.
; You shouldn't need to do this unless your system include_path esp. your 
; system pear libs are broken or oudated. The PHPWIKI_DIR is automatically 
; put to the front and the local lib/pear path is automatically added to the end.
; But if you define it, be sure to include either the system pear path or 
; the phpwiki/lib/pear path to override your Pear_DB.
; Note that on Windows-based servers, you should use ; rather than :
; as the path separator.
;INCLUDE_PATH = ".:/usr/local/httpd/phpwiki:/usr/share/pear"

; Set DEBUG to 1 to view the XHTML and CSS validator icons, page
; processing timer, and possibly other debugging messages at the
; bottom of each page. 65 for a more verbose level with AUTH hints. 
; See lib/config.php for all supported values.
; Default: 0
;DEBUG = 1

; Graphical buttons on edit. Default: true
; Reportedly broken on MacOSX Safari
;ENABLE_EDIT_TOOLBAR = false

; Adds two additional buttons in EDIT_TOOLBAR, Search&Replace and Undo.
; Undo is experimental. Default: true
;JS_SEARCHREPLACE = true

; Note: Enable it for all users. Otherwise as per-user setting in UserPreferences.
; Default: false
;ENABLE_DOUBLECLICKEDIT = false

; Enable WYSIWYG editing. Converting back HTML to wikitext does not work in most engines. 
; Experimental!
;ENABLE_WYSIWYG = true

; Which backend? Must be seperately installed. See lib/WysiwygEdit/
;  Wikiwyg     http://openjsan.org/doc/i/in/ingy/Wikiwyg/
;  tinymce     http://tinymce.moxiecode.com/ 
;  FCKeditor   http://fckeditor.net/ 
;  spaw        http://sourceforge.net/projects/spaw 
;  htmlarea3   
;  htmlarea2   
;WYSIWYG_BACKEND = Wikiwyg

; Store all WYSIWYG pages as HTML? Will loose most link and plugin options.
; Not recommended, but presented here to test several WYSIWYG backends.
;WYSIWYG_DEFAULT_PAGETYPE_HTML = false

; Upload into seperate userdirs. If enabled (default since 1.3.13) the generated Upload: link 
; will include the username plus "/". This will make all uploaded links longer, but we 
; avoid nameclashes and you see who uploaded what file.
;UPLOAD_USERDIR = false

; SemanticWeb Units require the standard units executable, available in every distribution.
; On Windows the cygwin version works fine if e.g. the cygwin bin is in the webserver path.
; However if units fails, attribute comparisons will fail. Esp. getting the base unit and 
; base values for all attributes.
; So you might want to disable the unit strictness at all (area:=936km^2 < 1,000,000 ?). 
; Default: false
;DISABLE_UNITS = true

; For a non-standard path
;UNITS_EXE = /usr/bin/units

; Needed for inlined SVG and MathM, but conflicts with document.write(). 
; Experimental. Default: false. Problematic with MSIE6
; See http://hixie.ch/advocacy/xhtml
;ENABLE_XHTML_XML = true

; Needs babycart installed. See http://phpwiki.org/SpamAssassinIntegration
; Optionally define BABYCART_PATH. Default: /usr/local/bin/babycart
;ENABLE_SPAMASSASSIN = true

; Check for links to blocked external tld domains in new edits, against 
; multi.surbl.org and bl.spamcop.net.
;ENABLE_SPAMBLOCKLIST = true

; If more than this number of external links appear on non-authenticated 
; edits it will be rejected as spam.
;NUM_SPAM_LINKS = 20

; By setting DISABLE_UPLOAD_ONLY_ALLOWED_EXTENSIONS to true, you get
; back the old behaviour to check only *bad* extensions of uploaded
; files. However a server may treat other files with certain handlers,
; like executable scripts, so we disable now everything and enable
; only some extension.  See lib/plugin/UpLoad.php.
; Default: false
;DISABLE_UPLOAD_ONLY_ALLOWED_EXTENSIONS = false

; If GOOGLE_LINKS_NOFOLLOW is true, ref=nofollow is added to 
; all external links to discourage spam. You might want to turn it off,
; if you want to improve pageranks on external links.
; TODO: Add ref=nofollow only for external links added by anonymous users.
; All internal action links do contain ref=nofollow
;GOOGLE_LINKS_NOFOLLOW = false

; LiveSearch enables immediate title search results via XMLHttpRequest.
; Displays the results in a dropdown under the titlesearch inputbox
; while typing. (experimental, only with certain themes)
; You'll have to copy livesearch.js from http://blog.bitflux.ch/wiki/LiveSearch
; to themes/default/ and define ENABLE_LIVESEARCH in config.ini to true. 
; See themes/blog/themeinfo.php.
; We used the bitflux.ch library temporarily, but we changed to 
; the better moacdropdown. 
;ENABLE_LIVESEARCH = true

; ENABLE_ACDROPDOWN replaces now ENABLE_LIVESEARCH
; http://momche.net/publish/article.php?page=acdropdown
;ENABLE_ACDROPDOWN = false

; Experimental WikiPedia feature: Force Discussion/Article link at the topnavbar.
;ENABLE_DISCUSSION_LINK = true

; If set to true, add some anti-spam countermeasures based on captcha
; tests.  See http://www.captcha.net/ for more information on captcha.
;ENABLE_CAPTCHA = true 

; If USE_CAPTCHA_RANDOM_WORD is set to true,
; Captcha will use a random word, otherwise a dictionary word.
;USE_CAPTCHA_RANDOM_WORD = false

; USE_SAFE_DBSESSION should be enabled, if you encounter session problems, with 
; duplicate INSERT sess_id warnings at the bottom of the page. Reason is a 
; unreliable affected_rows implementation() in the sql backend. 
; Default is Disabled, using the fastest DbSession UPDATE method.
;USE_SAFE_DBSESSION = false

; If true don't use UserName/Blog/day/time pagenames for the ADMIN_USER, but 
; Blog/day/time only. Convenience for a single-user blog theme.
;BLOG_DEFAULT_EMPTY_PREFIX = true

; External Searchengine hits are detected automatically and will be 
; highlighted in the displayed page if enabled.
; Optionally the actionpage SearchHighlight is also prepended, which 
; prints a notice.
; Default: true
;ENABLE_SEARCHHIGHLIGHT = false

;==========================================================================
; Part One: Authentication and security settings.
;
; See Part Three for more.
;==========================================================================

; The name of your wiki.
;
; This is used to generate a keywords meta tag in the HTML templates,
; in bookmark titles for any bookmarks made to pages in your wiki,
; and during RSS generation for the title of the RSS channel.
;
; To use your own logo and signature files, name them PhpWikiLogo.png
; and PhpWikiSignature.png and put them into themes/default/images
; (substituting "PhpWiki" in the filename with the name you define
; here).
;
; It is recommended this be a relatively short WikiWord like the
; InterWiki monikers found in the InterWikiMap. (For examples, see
; lib/interwiki.map).
WIKI_NAME = PhpWiki

; Username and password of administrator.
;
; Set these to your preferences. For heaven's sake pick a good
; password and use the passencrypt.php tool to encrypt the password from
; prying eyes.
; http://wolfram.org/writing/howto/password.html
; 
; Logging into the wiki with the admin user and password allows you to lock,
; unlock, or remove pages and to perform other PhpWikiAdministration
; functions. On all other occasions you should simply log in with your
; regular WikiName.
; If your password contains special chars like ";" or ":" better quote it in double-quotes.
;ADMIN_USER = 

; You must set this! Username and password of the administrator.
; ADMIN_PASSWD is ignored on HttpAuth
;ADMIN_PASSWD =

; It is recommended that you use encrypted passwords to be stored in the 
; config.ini and the users homepages metadata.
; You might want to use the passencrypt.php utility to encode the
; admin password, in the event that someone gains ftp or ssh access to the
; server and directory containing phpwiki. 
; <i>SQL access passwords cannot be encrypted, besides using external DATABASE_DSN aliases within PDO.</i>
; 
; If true, all user passwords will be stored encrypted.
; You might have to set it to false, if your PHP doesn't support crypt().
; To use plain text passwords, in particular for the ADMIN_PASSWD, set
; ENCRYPTED_PASSWD to false.
ENCRYPTED_PASSWD = true

; Visitor Hostname Lookup
;
; If set, reverse dns lookups will be performed to attempt to convert
; the user's IP number into a host name, in the case where the http
; server does not do this.
ENABLE_REVERSE_DNS = true

; Private ZIP Dumps of All Wiki Pages
;
; If true, only the admin user can make zip dumps. Otherwise anyone
; may download all wiki pages as a single zip archive.
ZIPDUMP_AUTH = false

; The RawHtml plugin allows page authors to embed real, raw HTML into Wiki
; pages.  This is a possible security threat, as much HTML (or, rather,
; JavaScript) can be very risky.  If you are in a controlled environment,
; or you are using the two options below, however, it could be of use. 
ENABLE_RAW_HTML = true

; If this is set, only pages locked by the Administrator may contain the
; RawHtml plugin
ENABLE_RAW_HTML_LOCKEDONLY = true

; If this is set, all unsafe html code is stripped automatically (experimental!)
; See http://chxo.com/scripts/safe_html-test.php
ENABLE_RAW_HTML_SAFE = true

; Actions listed in this array will not be allowed.  The complete list
; of actions can be found in lib/main.php with the function
; getActionDescription. 
;
; browse, create, diff, dumphtml, dumpserial, edit, loadfile, lock, 
; remove, revert, xmlrpc, soap, unlock, upload, viewsource, zip, ziphtml, ...
;DISABLED_ACTIONS = "dumpserial : loadfile"

; If you enable this option, every page is moderated by the ModeratedPage
; actionpage plugin. Changing a moderated page will be delayed to be 
; granted by a moderator by email. Default: false to allow finer control.
;ENABLE_MODERATEDPAGE_ALL = true

; PhpWiki can generate an access_log (in "NCSA combined log" format)
; for you. If you want one, define this to the name of the log
; file. The server must have write access to the directory specified.
; Preferred is to use SQL access logging as below.
; Note that even you define ACCESS_LOG_SQL logs are written to this file also.
;
; Default: empty - no access log file will be generated.
;ACCESS_LOG = /var/tmp/wiki_access_log

; PhpWiki can read and/or write mod_log_sql accesslog tables for faster
; abuse detection and referer lists.
; See http://www.outoforder.cc/projects/apache/mod_log_sql/docs-2.0/#id2756178
;
; If defined (e.g. 1) read-access is done via SQL. 
; If flag 2 is set, phpwiki also writes. Default on SQL database.
; This must use DATABASE_TYPE = SQL or ADODB or PDO.
;   ACCESS_LOG_SQL = 0 ; disable SQL access logging
;   ACCESS_LOG_SQL = 1 ; phpwiki reads, apache mod_log_sql writes
;ACCESS_LOG_SQL = 2 ; read + write

; By default PhpWiki will try to have PHP compress its output
; before sending it to the browser, if you have a recent enough
; version of PHP and the browser and action supports it.
;
; Define COMPRESS_OUTPUT to false to prevent output compression.
; Define COMPRESS_OUTPUT to true to force output compression,
; even if we think your version of PHP does this in a buggy
; fashion.
; Leave it undefined to leave the choice up to PhpWiki. (Recommended)
;
; WARNING: Compressing the output has been reported to cause problems
; when PHP is running on MacOSX or on redirected requests.
; This setting should now be correctly determined automatically.
;COMPRESS_OUTPUT = false

; This controls how PhpWiki sets the HTTP cache control
; headers (Expires: and Cache-Control:) 
;
; Choose one of:
;
; NO_CACHE: This is roughly the old (pre 1.3.4) behavior.  PhpWiki will
;       instruct proxies and browsers never to cache PhpWiki output.
;       This was previously called 'NONE', but NONE was treated specially 
;       by parse_ini_config().
;
; STRICT: Cached pages will be invalidated whenever the database global
;       timestamp changes.  This should behave just like NO_CACHE (modulo
;       bugs in PhpWiki and your proxies and browsers), except that
;       things will be slightly more efficient.
;
; LOOSE: Cached pages will be invalidated whenever they are edited,
;       or, if the pages include plugins, when the plugin output could
;       concievably have changed.
;
;       Behavior should be much like STRICT, except that sometimes
;       wikilinks will show up as undefined (with the question mark)
;       when in fact they refer to (recently) created pages.
;       (Hitting your browsers reload or perhaps shift-reload button
;       should fix the problem.)
;
; ALLOW_STALE: Proxies and browsers will be allowed to used stale pages.
;       (The timeout for stale pages is controlled by CACHE_CONTROL_MAX_AGE.)
;
;       This setting will result in quirky behavior.  When you edit a
;       page your changes may not show up until you shift-reload the
;       page, etc...
;
;       This setting is generally not advisable, however it may be useful
;       in certain cases (e.g. if your wiki gets lots of page views,
;       and few edits by knowledgable people who won't freak over the quirks.)
;
; The recommended default is currently LOOSE.
;
CACHE_CONTROL = LOOSE

; Maximum page staleness, in seconds.
;
; This only has effect if CACHE_CONTROL is set to ALLOW_STALE.
CACHE_CONTROL_MAX_AGE = 600

; PhpWiki normally caches a preparsed version (i.e. mostly
; converted to HTML) of the most recent version of each page.
; (Parsing the wiki-markup takes a fair amount of CPU.)
; Define WIKIDB_NOCACHE_MARKUP to true to disable the
; caching of marked-up page content.
; Note that you can also disable markup caching on a per-page
; temporary basis by addinging a query arg of '?nocache=1'
; to the URL to the page or by adding a NoCache plugin line. 
; Use '?nocache=purge' to completely discard the cached version of the page.
; You can also purge the cached markup globally by using the
; "Purge Markup Cache" button on the PhpWikiAdministration page.
; Enable only for old php's with low memory or memory_limit=8MB.
; Default: false
;WIKIDB_NOCACHE_MARKUP = true

COOKIE_EXPIRATION_DAYS = 365
; Default path for the wikiuser cookie. You need to specify this more explicitly
; if you want to enable different users on different wikis on the same host.
;COOKIE_DOMAIN = "/"

; The login code now uses PHP's session support. Usually, the default
; configuration of PHP is to store the session state information in
; /tmp. That probably will work fine, but fails e.g. on clustered
; servers where each server has their own distinct /tmp (this is the
; case on SourceForge's project web server.) You can specify an
; alternate directory in which to store state information like so
; (whatever user your httpd runs as must have read/write permission
; in this directory)
;
; On USE_DB_SESSION = true you can ignore this.
;SESSION_SAVE_PATH = some_other_directory

; On USE_DB_SESSION = true or false you can force the behaviour 
; how to transport session data.
;USE_DB_SESSION = false 

;======================================================================
; Part Two: Database Selection
;======================================================================

; Select the database backend type:
;
;       SQL:   access one of several SQL databases using the PEAR DB library.
;       ADODB: uses the ADODB library for data access.     (most general)
;       PDO:   The new PHP5 dataobkject library. (experimental, no paging yet)
;       dba:   use one of the standard UNIX dbm libraries. Use BerkeleyDB (db3,4) (fastest)
;       file:  use a serialized file database. (easiest)
;       flatfile:  use a flat file database. (experimental, readable, slow)
;       cvs:   use a CVS server to store everything. (experimental, slowest, not recommended)
DATABASE_TYPE = dba
   
; Prefix for filenames or table names
;
; Currently you MUST EDIT THE SQL file too (in the schemas/
; directory because we aren't doing on the fly sql generation
; during the installation.
; Note: This prefix is NOT prepended to the default DBAUTH_
;       tables user, pref and member!
;DATABASE_PREFIX = phpwiki_

; For SQL based backends, specify the database as a DSN (Data Source Name),
; a kind of URL for databases.
;
; The most general form of a DSN looks like:
;
;       dbtype(dbsyntax)://username:password@protocol+hostspec/database?option=value&option2=value2
;
; For a MySQL database, the following should work:
;
;       mysql://user:password@host/databasename
;
; To connect over a unix socket, use something like
;
;       mysql://user:password@unix(/path/to/socket)/databasename
;
; Valid values for dbtype are mysql, pgsql, or sqlite.
;
DATABASE_DSN = "mysql://guest@unix(/var/lib/mysql/mysql.sock)/test"

; Keep persistent connections: (mysql_pconnect, ...)
; Recommended is false for bigger servers, and true for small servers 
; with not so many connections. postgresql: Please leave it false. Default: false
; Should really be set as database option in the DSN above.
DATABASE_PERSISTENT = false

; A table to store session information.  Only needed by SQL backends.
;
; A word of warning - any prefix defined above will be prepended to whatever
; is given here.
DATABASE_SESSION_TABLE = session

; For the file and dba backends, this specifies where the data files will be
; located.  Ensure that the user that the webserver runs as has write access
; to this directory.
;
; WARNING: leaving this as the default of '/tmp' will almost guarantee that
; you'll lose your wiki data at some stage.
DATABASE_DIRECTORY = /tmp

; For the dba backend, this defines which DBA variant you wish to use.
;       gdbm - commonly available, Fedora not. Not recommended anymore.
;       db2 - Berkeley DB v2; not supported by modern versions of PHP.
;       db3 - Berkeley DB v3; as per db2. The best on Windows.
;       db4 - Berkeley DB v4; current version, however PHP has some issues
;               with it's db4 support.
;       dbm - Older dba handler; suffers from limits on the size of data
;               items.
; Better not use other hacks such as inifile, flatfile or cdb.
DATABASE_DBA_HANDLER = db4

; How long will the system wait for a database operation to complete?
; Specified in seconds.
DATABASE_TIMEOUT = 12

; How often to try and optimise the database. Specified in seconds. 
; Set to 0 to disable optimisation completely. Default is 50 (seconds).
;
; This is a fairly crude way of doing things as it requires a page save
; to occur during the right minute for the optimisation to be triggered. 
;
; With most modern databases (eg. Postgres) and distributions (eg. Debian)
; the system maintenance scripts take care of this nightly, so you will want
; to set this parameter to 0 (disabled).
;DATABASE_OPTIMISE_FREQUENCY = 50

; Optional: Administrative SQL DB access (for action=upgrade)
; If action=upgrade detects (My)SQL problems, but has no ALTER permissions, 
; give here a database username which has the necessary ALTER or CREATE permissions.
; Of course you can fix your database manually. See lib/upgrade.php for known issues.
;DBADMIN_USER = root

; Optional: Administrative SQL DB access (for action=upgrade)
;DBADMIN_PASSWD = secret

; Store DB query results (esp. for page lists) in memory to avoid duplicate queries.
; Disable only for old php's with low memory or memory_limit=8MB.
; Requires at least memory_limit=16MB
; Default: true
;USECACHE = false

;========================================================================
; Section 3a: Page revisions
;
; The next section controls how many old revisions of each page are
; kept in the database.
;========================================================================

; There are two basic classes of revisions: major and minor. Which
; class a revision belongs in is determined by whether the author
; checked the "this is a minor revision" checkbox when they saved the
; page.
; 
; There is, additionally, a third class of revisions: author
; revisions. The most recent non-mergable revision from each distinct
; author is an author revision.
;
; The expiry parameters for each of those three classes of revisions
; can be adjusted seperately. For each class there are five
; parameters (usually, only two or three of the five are actually
; set) which control how long those revisions are kept in the
; database.
;
;   MAX_KEEP: If set, this specifies an absolute maximum for the
;             number of archived revisions of that class. This is
;             meant to be used as a safety cap when a non-zero
;             min_age is specified. It should be set relatively high,
;             and it's purpose is to prevent malicious or accidental
;             database overflow due to someone causing an
;             unreasonable number of edits in a short period of time.
;
;   MIN_AGE:  Revisions younger than this (based upon the supplanted
;             date) will be kept unless max_keep is exceeded. The age
;             should be specified in days. It should be a
;             non-negative, real number,
;
;   MIN_KEEP: At least this many revisions will be kept.
;
;   KEEP: No more than this many revisions will be kept.
;
;   MAX_AGE:  No revision older than this age will be kept.
;
; Definitions of terms used above:
;
; Supplanted date: Revisions are timestamped at the instant that they
; cease being the current revision. Revision age is computed using
; this timestamp, not the edit time of the page.
;
; Merging: When a minor revision is deleted, if the preceding
; revision is by the same author, the minor revision is merged with
; the preceding revision before it is deleted. Essentially: this
; replaces the content (and supplanted timestamp) of the previous
; revision with the content after the merged minor edit, the rest of
; the page metadata for the preceding version (summary, mtime, ...)
; is not changed.
;
; Let all revisions be stored. Default since 1.3.11
;MAJOR_MIN_KEEP = 2147483647
;MINOR_MIN_KEEP = 2147483647

; Keep up to 8 major edits, but keep them no longer than a month.
MAJOR_MAX_AGE = 32
MAJOR_KEEP = 8

; Keep up to 4 minor edits, but keep them no longer than a week.
MINOR_MAX_AGE = 7
MINOR_KEEP = 4

; Keep the latest contributions of the last 8 authors up to a year.
; Additionally, (in the case of a particularly active page) try to
; keep the latest contributions of all authors in the last week (even
; if there are more than eight of them,) but in no case keep more
; than twenty unique author revisions.
AUTHOR_MAX_AGE = 365
AUTHOR_KEEP = 8
AUTHOR_MIN_AGE = 7
AUTHOR_MAX_KEEP = 20

;========================================================================
; Part Three: User Authentication
;========================================================================
;
; New user authentication configuration:
; We support three basic authentication methods and a stacked array 
; of advanced auth methods to get and check the passwords:
;
; ALLOW_ANON_USER         default true
; ALLOW_ANON_EDIT         default true
; ALLOW_BOGO_LOGIN        default true
; ALLOW_USER_PASSWORDS    default true

; allow anon users to view or edit any existing pages
ALLOW_ANON_USER = true
; allow anon users to edit pages
ALLOW_ANON_EDIT = true

; If ALLOW_BOGO_LOGIN is true, users are allowed to login (with
; any/no password) using any userid which: 
;  1) is not the ADMIN_USER, and
;  2) is a valid WikiWord (matches $WikiNameRegexp.)
; If true, users may be created by themselves. Otherwise we need seperate auth. 
; If such a user will create a so called HomePage with his userid, he will 
; be able to store his preferences and password there.
ALLOW_BOGO_LOGIN = true

; True User Authentication:
; To require user passwords:
;   ALLOW_ANON_USER = false
;   ALLOW_ANON_EDIT = false
;   ALLOW_BOGO_LOGIN = false,
;   ALLOW_USER_PASSWORDS = true.
; Otherwise any anon or bogo user might login without any or a wrong password.
ALLOW_USER_PASSWORDS = true

; Many different methods can be used to check user's passwords:
;   BogoLogin:     WikiWord username, with no *actual* password checking,
;                   although the user will still have to enter one.
;   PersonalPage:  Store passwords in the users homepage metadata (simple)
;   Db:            Use DBAUTH_AUTH_* (see below) with PearDB or 
;                   ADODB only.
;   LDAP:          Authenticate against LDAP_AUTH_HOST with LDAP_BASE_DN
;   IMAP:          Authenticate against IMAP_AUTH_HOST (email account)
;   POP3:          Authenticate against POP3_AUTH_HOST (email account)
;   Session:       Get username and level from a PHP session variable. (e.g. for gforge)
;   File:          Store username:crypted-passwords in .htaccess like files. 
;                  Use Apache's htpasswd to manage this file.
;   HttpAuth:      Use the protection by the webserver (.htaccess/.htpasswd)
;                  Note that the ADMIN_USER should exist also.
;                  Using HttpAuth disables all other methods and no userauth sessions are used.
;		   With mod_ntlm and mod_auth_sspi use this. (automatic login with MSIE)
;
; Several of these methods can be used together, in the manner specified by
; USER_AUTH_POLICY, below.  To specify multiple authentication methods,
; separate the name of each one with colons.
; USER_AUTH_ORDER = "BogoLogin : PersonalPage"
;USER_AUTH_ORDER = "PersonalPage : Db"

; For "security" purposes, you can specify that a password be at least a
; certain number of characters long.  This applies even to the BogoLogin
; method. Default: 0 (to allow immediate passwordless BogoLogin)
;PASSWORD_LENGTH_MINIMUM = 6
    
; The following policies are available for user authentication:
;       first-only: use only the first method in USER_AUTH_ORDER
;       old:        ignore USER_AUTH_ORDER and try to use all available 
;                       methods as in the previous PhpWiki releases (slow)
;       strict:     check if the user exists for all methods: 
;                       on the first existing user, try the password. 
;                       dont try the other methods on failure then
;       stacked:    check the given user - password combination for all
;                       methods and return true on the first success.
USER_AUTH_POLICY = stacked

; Enable the new extended method of handling WikiUsers to support external auth and PAGEPERM.
; Servers with memory-limit problems might want to turn it off. It costs ~300KB
; Default: true
;ENABLE_USER_NEW = false

; Use access control lists (as in Solaris and Windows NTFS) per page and group, 
; not per user for the whole wiki.
; 
; We suspect ACL page permissions to degrade speed by 10%. 
; GROUP_METHOD=WIKIPAGE is slowest.
; Default: true
;ENABLE_PAGEPERM = false

; LDAP authentication options:
;
; The LDAP server to connect to.  Can either be a hostname, or a complete
; URL to the server (useful if you want to use ldaps or specify a different
; port number).
;LDAP_AUTH_HOST = "ldap://localhost:389"

; The organizational or domain BASE DN: e.g. "dc=mydomain,dc=com".
;
; Note: ou=Users and ou=Groups are used for GroupLdap Membership
; Better use LDAP_OU_USERS and LDAP_OU_GROUP with GROUP_METHOD=LDAP.
;LDAP_BASE_DN = "ou=Users,o=Development,dc=mycompany.com"

; Some LDAP servers need some more options, such as the Windows Active
; Directory Server.  Specify the options (as allowed by the PHP LDAP module)
; and their values as NAME=value pairs separated by colons.
;LDAP_SET_OPTION = "LDAP_OPT_PROTOCOL_VERSION=3:LDAP_OPT_REFERRALS=0"

; DN to initially bind to the LDAP server as. This is needed if the server doesn't 
; allow anonymous queries. (Windows Active Directory Server)
;LDAP_AUTH_USER = "CN=ldapuser,ou=Users,o=Development,dc=mycompany.com"

; Password to use to initially bind to the LDAP server, as the DN 
; specified in the LDAP_AUTH_USER option (above).
;LDAP_AUTH_PASSWORD = secret

; If you want to match usernames against an attribute other than uid,
; specify it here. uid is for real active users. cn for anything like test users,
; sAMAccountName often for Windows/Samba. 
; Default: uid. Use also "cn" or "sAMAccountName".
;LDAP_SEARCH_FIELD = sAMAccountName

; If you have an organizational unit for all users, define it here.
; This narrows the search, and is needed for LDAP group membership (if GROUP_METHOD=LDAP)
; Default: ou=Users
;LDAP_OU_USERS = ou=Users

; If you have an organizational unit for all groups, define it here.
; This narrows the search, and is needed for LDAP group membership (if GROUP_METHOD=LDAP)
; The entries in this ou must have a gidNumber and cn attribute.
; Default: ou=Groups
;LDAP_OU_GROUP = ou=Groups


; IMAP authentication options:
;
; The IMAP server to check usernames from.  Defaults to localhost.
;
; Some IMAP_AUTH_HOST samples:
;   "localhost", "localhost:143/imap/notls", 
;   "localhost:993/imap/ssl/novalidate-cert" (SuSE refuses non-SSL conections)
;IMAP_AUTH_HOST = "localhost:143/imap/notls"

; POP3 authentication options:
;
; Host to connect to.
;POP3_AUTH_HOST = "localhost:110"

; Port to connect. Deprecated: Use POP3_AUTH_HOST:<port> instead
;POP3_AUTH_PORT = 110

; File authentication options:
;
; File to read for authentication information.
; Popular choices are /etc/shadow and /etc/httpd/.htpasswd
;AUTH_USER_FILE = /etc/shadow

; Defines whether the user is able to change their own password via PHPWiki.
; Note that this means that the webserver user must be able to write to the
; file specified in AUTH_USER_FILE.
;AUTH_USER_FILE_STORABLE = false

; Session Auth:
; Name of the session variable which holds the already authenticated username.
; Sample: "userid", "user[username]", "user->username"
;AUTH_SESS_USER = userid

; Which level will the user be? 1 = Bogo or 2 = Pass
;AUTH_SESS_LEVEL = 2

; Group membership.  PhpWiki supports defining permissions for a group as
; well as for individual users.  This defines how group membership information
; is obtained.  Supported values are:
;
;       "NONE"          Disable group membership (Fastest). Note the required quoting.
;       WIKIPAGE        Define groups as list at "CategoryGroup". (Slowest, but easiest to maintain)
;       DB              Stored in an SQL database. Optionally external. See USERS/GROUPS queries
;       FILE            Flatfile. See AUTH_GROUP_FILE below.
;       LDAP            LDAP groups. See "LDAP authentication options" above and 
;                       lib/WikiGroup.php. (experimental)
GROUP_METHOD = WIKIPAGE

; Page where all groups are listed. Default: Translation of "CategoryGroup"
;CATEGORY_GROUP_PAGE = CategoryGroup

; For GROUP_METHOD = FILE, the file given below is referenced to obtain
; group membership information.  It should be in the same format as the
; standard unix /etc/groups(5) file.
;AUTH_GROUP_FILE = /etc/groups

; External database authentication and authorization.
;
; If USER_AUTH_ORDER includes Db, or GROUP_METHOD = DB, the options listed
; below define the SQL queries used to obtain the information out of the
; database, and (in some cases) store the information back to the DB.
;
; The options appropriate for each query are currently undocumented, and
; you should not be surprised if things change mightily in the future.
;
; A database DSN to connect to.  Defaults to the DSN specified for the Wiki
; as a whole.
;DBAUTH_AUTH_DSN = "mysql://wikiuser:@127.0.0.1/phpwiki"
;
; USER/PASSWORD queries
;
; For USER_AUTH_POLICY=strict and the Db method this is required:
;DBAUTH_AUTH_USER_EXISTS = "SELECT userid FROM pref WHERE userid='$userid'"

; Check to see if the supplied username/password pair is OK
;
; Plaintext Passwords:
; DBAUTH_AUTH_CHECK = "SELECT IF(TRIM(passwd)='$password',1,0) AS ok FROM pref WHERE TRIM(userid)='$userid'"
;
; Database-hashed passwords (more secure):
;DBAUTH_AUTH_CHECK = "SELECT IF(TRIM(passwd)=PASSWORD('$password'),1,0) AS ok FROM pref WHERE TRIM(userid)='$userid'"
DBAUTH_AUTH_CRYPT_METHOD = plain

; If you want to use Unix crypt()ed passwords, you can use DBAUTH_AUTH_CHECK
; to get the password out of the database with a simple SELECT query, and
; specify DBAUTH_AUTH_USER_EXISTS and DBAUTH_AUTH_CRYPT_METHOD:
;DBAUTH_AUTH_CHECK = "SELECT passwd FROM pref WHERE TRIM(userid)='$userid'"
; DBAUTH_AUTH_CRYPT_METHOD = crypt

; Update the user's authentication credential.  If this is not defined but
; DBAUTH_AUTH_CHECK is, then the user will be unable to update their
; password.
;
; Database-hashed passwords:
; DBAUTH_AUTH_UPDATE = "UPDATE pref SET passwd=PASSWORD('$password') WHERE userid='$userid'"
; Plaintext passwords:
;DBAUTH_AUTH_UPDATE = "UPDATE pref SET passwd='$password' WHERE userid='$userid'"

; Allow users to create their own account.
; with CRYPT_METHOD=crypt e.g:
; DBAUTH_AUTH_CREATE = "INSERT INTO pref (passwd,userid) VALUES ('$password','$userid')"
; with CRYPT_METHOD=plain:
;DBAUTH_AUTH_CREATE = "INSERT INTO pref (passwd,userid) VALUES (PASSWORD('$password'),'$userid')"

; USER/PREFERENCE queries
;
; If you choose to store your preferences in an external database, enable
; the following queries.  Note that if you choose to store user preferences
; in the 'user' table, only registered users get their prefs from the database,
; self-created users do not.  Better to use the special 'pref' table.
;
; The prefs field stores the serialized form of the user's preferences array,
; to ease the complication of storage.
;DBAUTH_PREF_SELECT = "SELECT prefs FROM pref WHERE userid='$userid'"

; Update the user's preferences
;DBAUTH_PREF_UPDATE = "UPDATE pref SET prefs='$pref_blob' WHERE userid='$userid'"
;DBAUTH_PREF_INSERT = "INSERT INTO pref (userid,prefs) VALUES ('$userid','$pref_blob')"

; USERS/GROUPS queries
;
; You can define 1:n or n:m user<=>group relations, as you wish.
;
; Sample configurations:
;  Only one group per user - 1:n: (Default)
;   DBAUTH_IS_MEMBER     = "SELECT userid FROM pref WHERE userid='$userid' AND groupname='$groupname'"
;   DBAUTH_GROUP_MEMBERS = "SELECT userid FROM pref WHERE groupname='$groupname'"
;   DBAUTH_USER_GROUPS   = "SELECT groupname FROM pref WHERE userid='$userid'"
;  Multiple groups per user - n:m:
;   DBAUTH_IS_MEMBER     = "SELECT userid FROM member WHERE userid='$userid' AND groupname='$groupname'"
;   DBAUTH_GROUP_MEMBERS = "SELECT DISTINCT userid FROM member WHERE groupname='$groupname'"
;   DBAUTH_USER_GROUPS   = "SELECT groupname FROM member WHERE userid='$userid'"

;========================================================================
; Part Four: Page appearance and layout
;========================================================================

; THEMES
;
; Most of the page appearance is controlled by files in the theme
; subdirectory.
;
; There are a number of pre-defined themes shipped with PhpWiki.
; Or you may create your own (e.g. by copying and then modifying one of
; stock themes.)
;
; The complete list of installed themes can be found by doing 'ls themes/'
; from the root of your PHPWiki installation.
; white on yellow with fat blue links:
THEME = default
; almost fully iconized classic grey MacOSX design:
;THEME = MacOSX
; as default, just some tricks to make the buttons smaller:
;THEME = smaller
; the popular wikipedia layout:
;THEME = MonoBook
; the popular Wordpress layout:
;THEME = Wordpress
; pure old-style c2wiki layout:
;THEME = Portland
; example with some sidebar boxes:
;THEME = Sidebar
; mozilla friendly, with lots of icons instead of buttons (i18n friendly):
;THEME = Crao
; default + rateit navbar:
;THEME = wikilens
; blogger style, rounded (experimental):
;THEME = blog
; minimalistic:
;THEME = shamino_com
; heavy space-y layout:
;THEME = SpaceWiki
; random heavy images:
;THEME = Hawaiian

; Select a valid charset name to be inserted into the xml/html pages,
; and to reference links to the stylesheets (css). For more info see:
; http://www.iana.org/assignments/character-sets. Note that PhpWiki
; has been extensively tested only with the latin1 (iso-8859-1)
; character set.
;
; If you change the default from iso-8859-1 with existing pages, 
; PhpWiki may not work properly and will require modifications in all existing pages. 
; You'll have to dump the old pages with the old charset
; and import it into the new one after having changed the charset.
; Currently we support utf-8 for zh and ja, euc-jp for ja (not enabled)
; and iso-8859-1 for all other langs. Changing languages (UserPreferences) 
; from one charset to another will not work!
;
; Character sets similar to iso-8859-1 may work with little or no
; modification depending on your setup. The database must also
; support the same charset, and of course the same is true for the
; web browser. euc-jp and utf-8 works ok, but only is mbstring is used.
CHARSET = iso-8859-1

; Most exotic charsets are not supported by htmlspecialchars, which prints a warning:
; "charset `bla' not supported, assuming iso-8859-1"
; Even on simple 8bit charsets, where just <>& need to be replaced.
; See php-src:/ext/standard/html.c
; We can ignore these warnings then.
;IGNORE_CHARSET_NOT_SUPPORTED_WARNING = true

; Select your language/locale - Default language is "" for auto-detection.
; Available languages:
; English  "en" (English    - HomePage)
; Dutch    "nl" (Nederlands - ThuisPagina)
; Spanish  "es" (Espaol    - PginaPrincipal)
; French   "fr" (Franais   - PageAccueil))
; German   "de" (Deutsch    - StartSeite)
; Swedish  "sv" (Svenska    - Framsida)
; Italian  "it" (Italiano   - PaginaPrincipale)
; Japanese "ja" (Japanese   - ۡڡ)
; Chinese  "zh" (Chinese    - ?)
;
; If you set DEFAULT_LANGUAGE to the empty string, the users 
; preferred language as determined by the browser setting will be used.
; Japanese requires CHARSET=euc-jp or utf-8, Chinese CHARSET=utf-8
;DEFAULT_LANGUAGE = en

; WIKI_PGSRC -- specifies the source for the initial page contents of
; the Wiki. The setting of WIKI_PGSRC only has effect when the wiki is
; accessed for the first time (or after clearing the database.)
; WIKI_PGSRC can either name a directory or a zip file. In either case
; WIKI_PGSRC is scanned for files -- one file per page.
;WIKI_PGSRC = pgsrc

; DEFAULT_WIKI_PGSRC is only used when the language is *not* the
; default (English) and when reading from a directory: in that case
; some English pages are inserted into the wiki as well.
; DEFAULT_WIKI_PGSRC defines where the English pages reside.
;DEFAULT_WIKI_PGSRC = pgsrc

; These are ':'-seperated pages which will get loaded untranslated from DEFAULT_WIKI_PGSRC.
;DEFAULT_WIKI_PAGES = "ReleaseNotes:SteveWainstead:TestPage"

;=========================================================================
; Part Five: Mark-up options.
;=========================================================================
;
; Allowed protocols for links - be careful not to allow "javascript:"
; URL of these types will be automatically linked.
; within a named link [name|uri] one more protocol is defined: phpwiki
; Separate each of the protocol names with a vertical pipe, and ensure there
; is no extraneous whitespace.
;ALLOWED_PROTOCOLS = "http|https|mailto|ftp|news|nntp|ssh|gopher"

; URLs ending with the following extension should be inlined as images.
; Specify as per ALLOWED_PROTOCOLS.
; Note that you can now also allow class|svg|svgz|vrml|swf ...,
; which will create embedded object instead of img. 
; Typical CGI extensions as pl or cgi maybe allowed too, 
; but those two will be enforced to img.
;INLINE_IMAGES = "png|jpg|jpeg|gif"

; Perl regexp for WikiNames ("bumpy words")
; (?<!..) & (?!...) used instead of '\b' because \b matches '_' as well
;WIKI_NAME_REGEXP = "(?<![[:alnum:]])(?:[[:upper:]][[:lower:]]+){2,}(?![[:alnum:]])"

; Defaults to '/', but '.' was also used.
;SUBPAGE_SEPARATOR = /

; InterWiki linking -- wiki-style links to other wikis on the web
;
; The map will be taken from a page name InterWikiMap.
; If that page is not found (or is not locked), or map
; data can not be found in it, then the file specified
; by INTERWIKI_MAP_FILE (if any) will be used.
;INTERWIKI_MAP_FILE = lib/interwiki.map

; Display a warning if the internal lib/interwiki.map is used, and 
; not the public InterWikiMap page. This file is not readable from outside.
;WARN_NONPUBLIC_INTERWIKIMAP = false

; Search term used for automatic page classification by keyword extraction.
;
; Any links on a page to pages whose names match this search 
; will be used keywords in the keywords html meta tag. This is an aid to
; classification by search engines. The value of the match is
; used as the keyword.
;
; The default behavior is to match Category* or Topic* links.
;KEYWORDS = "Category* OR Topic*"

; Author and Copyright Site Navigation Links
;
; These will be inserted as <link rel> tags in the html header of
; every page, for search engines and for browsers like Mozilla which
; take advantage of link rel site navigation.
;
; If you have your own copyright and contact information pages change
; these as appropriate.
;COPYRIGHTPAGE_TITLE = "GNU General Public License"
;COPYRIGHTPAGE_URL = "http://www.gnu.org/copyleft/gpl.html#SEC1"
; Other useful alternatives to consider:
; COPYRIGHTPAGE_TITLE = "GNU Free Documentation License"
; COPYRIGHTPAGE_URL = "http://www.gnu.org/copyleft/fdl.html"
; COPYRIGHTPAGE_TITLE = "Creative Commons License 2.0"
; COPYRIGHTPAGE_URL = "http://creativecommons.org/licenses/by/2.0/"
;  see http://creativecommons.org/learn/licenses/ for variations
;AUTHORPAGE_TITLE = The PhpWiki Programming Team
;AUTHORPAGE_URL = http://phpwiki.org/ThePhpWikiProgrammingTeam

; Allow full markup in headers to be parsed by the CreateToc plugin.
;
; If false you may not use WikiWords or [] links or any other markup in 
; headers in pages with the CreateToc plugin. But if false the parsing is 
; faster and more stable.
;TOC_FULL_SYNTAX = true

; If false the %color=... %% syntax will be disabled. Since 1.3.11
; Default: true
;ENABLE_MARKUP_COLOR = false

; Enable mediawiki-style {{TemplatePage|vars=value|...}} syntax. Since 1.3.11
; Default: undefined. Enabled automatically on the MonoBook theme if undefined.
;ENABLE_MARKUP_TEMPLATE = true

; Disable automatic linking of camelcase (wiki-)words to pages. 
; Internal page links must be forced with [ pagename ] then.
; Default: false
;DISABLE_MARKUP_WIKIWORD = true

; Enable <div> and <span> HTML blocks and attributes. Experimental. Not yet working.
;ENABLE_MARKUP_DIVSPAN = true

; Plugin shortcuts: Enable <xml> syntax mapped to a plugin invocation. (as in mediawiki)
; <name arg=value>body</name> or <name /> => <?plugin pluginname arg=value body ?>
; This breaks the InlineParser.
;PLUGIN_MARKUP_MAP = "html:RawHtml dot:GraphViz toc:CreateToc amath:AsciiMath richtable:RichTable include:IncludePage tex:TexToPng"

;==========================================================================
; Part Six: URL options.
;==========================================================================
;
; You can probably skip this section.

; The following section contains settings which you can use to tailor
; the URLs which PhpWiki generates.
;
; Any of these parameters which are left undefined will be deduced
; automatically. You need only set them explicitly if the
; auto-detected values prove to be incorrect.
;
; In most cases the auto-detected values should work fine, so
; hopefully you don't need to mess with this section.
;
; In case of local overrides of short placeholders, which themselves 
; include index.php, we check for most constants. See '/wiki'.
; We can override DATA_PATH and PHPWIKI_DIR to support multiple phpwiki 
; versions (for development), but most likely other values like 
; THEME, LANG and DbParams for a WikiFarm.

; Canonical name and httpd port of the server on which this PhpWiki
; resides.
;/
;SERVER_NAME = some.host.com
;SERVER_PORT = 80

; https needs a special setting
;SERVER_PROTOCOL = http 

; Relative URL (from the server root) of the PhpWiki
; script.
;SCRIPT_NAME = /some/where/index.php

; URL of the PhpWiki install directory.  (You only need to set this
; if you've moved index.php out of the install directory.)  This can
; be either a relative URL (from the directory where the top-level
; PhpWiki script is) or an absolute one.
;DATA_PATH = /home/user/phpwiki

; Path to the PhpWiki install directory.  This is the local
; filesystem counterpart to DATA_PATH.  (If you have to set
; DATA_PATH, your probably have to set this as well.)  This can be
; either an absolute path, or a relative path interpreted from the
; directory where the top-level PhpWiki script (normally index.php)
; resides.
;PHPWIKI_DIR = /home/user/public_html/phpwiki

; PhpWiki will try to use short urls to pages, eg 
; http://www.example.com/index.php/HomePage
; If you want to use urls like 
; http://www.example.com/index.php?pagename=HomePage
; then define 'USE_PATH_INFO' as false by uncommenting the line below.
; NB:  If you are using Apache >= 2.0.30, then you may need to to use
; the directive "AcceptPathInfo On" in your Apache configuration file
; (or in an appropriate <.htaccess> file) for the short urls to work:  
; See http://httpd.apache.org/docs-2.0/mod/core.html#acceptpathinfo
; 
; See also http://phpwiki.sourceforge.net/phpwiki/PrettyWiki for more ideas
; on prettifying your urls.
;
; Note that Google doesn't follow the default /index.php/PageName links.
; You must use either a PrettyWiki setup (see below), or force USE_PATH_INFO=false.
;
; Default: PhpWiki will try to divine whether use of PATH_INFO
; is supported in by your webserver/PHP configuration, and will
; use PATH_INFO if it thinks that is possible.
;USE_PATH_INFO = false

; VIRTUAL_PATH is the canonical URL path under which your your wiki
; appears. Normally this is the same as dirname(SCRIPT_NAME), however
; using, e.g. apaches mod_actions (or mod_rewrite), you can make it
; something different.
;
; If you do this, you should set VIRTUAL_PATH here.
;
; E.g. your phpwiki might be installed at at /scripts/phpwiki/index.php,
; but  * you've made it accessible through eg. /wiki/HomePage.
;
; One way to do this is to create a directory named 'wiki' in your
; server root. The directory contains only one file: an .htaccess
; file which reads something like:
;
;    Action x-phpwiki-page /scripts/phpwiki/index.php
;    SetHandler x-phpwiki-page
;    DirectoryIndex /scripts/phpwiki/index.php
;
; In that case you should set VIRTUAL_PATH to '/wiki'.
;
; (VIRTUAL_PATH is only used if USE_PATH_INFO is true.)
;/
;VIRTUAL_PATH = /SomeWiki

; Override the default uploads dir. We have to define the local file path,
; and the webpath (DATA_PATH). Ensure an ending slash on both. 
;UPLOAD_FILE_PATH = /var/www/htdocs/uploads/
;UPLOAD_DATA_PATH = /uploads/

; In case your system has no idea about /tmp, TEMP or TMPDIR, 
; better provide it here. E.g. needed for zipdumps.
;TEMP_DIR = /tmp

;===========================================================================
; Part Seven: Miscellaneous settings
;===========================================================================

; If you define this to true, (MIME-type) page-dumps (either zip dumps,
; or "dumps to directory" will be encoded using the quoted-printable
; encoding.  If you're actually thinking of mailing the raw page dumps,
; then this might be useful, since (among other things,) it ensures
; that all lines in the message body are under 80 characters in length.
;
; Also, setting this will cause a few additional mail headers
; to be generated, so that the resulting dumps are valid
; RFC 2822 e-mail messages.
;
; Probably you can just leave this set to false, in which case you get
; raw ('binary' content-encoding) page dumps.
STRICT_MAILABLE_PAGEDUMPS = false

; Here you can change the default dump directories.
; (Can be overridden by the directory argument)
DEFAULT_DUMP_DIR = /tmp/wikidump
HTML_DUMP_DIR    = /tmp/wikidumphtml

; Filename suffix used for XHTML page dumps.
; If you don't want any suffix just comment this out.
HTML_DUMP_SUFFIX = .html

; The maximum file upload size, in bytes.
; The default, 16777216, is 16MB.
MAX_UPLOAD_SIZE = 16777216

; If the last edit is older than MINOR_EDIT_TIMEOUT seconds, the
; default state for the "minor edit" checkbox on the edit page form
; will be off.
; The default, 604800, is one week (7 days): 7 * 24 * 3600
MINOR_EDIT_TIMEOUT = 604800

; Page name of RecentChanges page. Used for RSS Auto-discovery
;RECENT_CHANGES = RecentChange

; Disable HTTP redirects.
; (You probably don't need to touch this.)
;
; PhpWiki uses HTTP redirects for some of it's functionality.
; (e.g. after saving changes, PhpWiki redirects your browser to
; view the page you just saved.)
; Some web service providers (notably free European Lycos) don't seem to
; allow these redirects.  (On Lycos the result in an "Internal Server Error"
; report.)  In that case you can set DISABLE_HTTP_REDIRECT to true.
; (In which case, PhpWiki will revert to sneakier tricks to try to
; redirect the browser...)
;DISABLE_HTTP_REDIRECT = true

; If you get a crash at loading LinkIcons you might want to disable 
; the getimagesize() function, which crashes on certain php versions and 
; and some external images (png's, ..). 
;
; getimagesize() is only needed for spam prevention.
;
; Per default too small ploaded or external images are not displayed, 
; to prevent from external 1 pixel spam.
;DISABLE_GETIMAGESIZE = true

; A interim page which gets displayed on every edit attempt, if it exists.
;EDITING_POLICY = EditingPolicy

; Enable random quotes from a fortune directory when adding a new page.
; Usually at /usr/share/fortune or /usr/share/games/fortune
; If empty no quotes are inserted.
;FORTUNE_DIR = /usr/share/fortune

; Add additional EDIT_TOOLBAR buttons if defined:
; They need some time and memory.
; Insert a pagelink from this list:
;TOOLBAR_PAGELINK_PULLDOWN = *

; Insert a template from this list:
;TOOLBAR_TEMPLATE_PULLDOWN = Template*

; Overide the default localized stoplist.
;FULLTEXTSEARCH_STOPLIST = (A|An|And|But|By|For|From|In|Is|It|Of|On|Or|The|To|With)


;===========================================================================
; Optional Plugin Settings and external executables
;===========================================================================

; GoogleMaps and GooglePlugin
; For using the Google API and GoogleMaps
; http://www.google.com/apis/maps/signup.html
;GOOGLE_LICENSE_KEY = "..."

; On action=pdf or format=pdf: If enabled don't use the internal fpdf library.
; External PDF executable, %s is the xhtml filename
;USE_EXTERNAL_HTML2PDF = "htmldoc --quiet --format pdf14 --no-toc --no-title %s"

; On format=pdf with pagelist actionpages.
; The multifile variant: book (with index and toc) or webpage format
;EXTERNAL_HTML2PDF_PAGELIST = "htmldoc --quiet --book --format pdf14"
EXTERNAL_HTML2PDF_PAGELIST = "htmldoc --quiet --webpage --format pdf14"

; Optional: SPAMASSASSIN wrapper. Only used if ENABLE_SPAMASSASSIN = true
; http://www.cynistar.net/~apthorpe/code/babycart/babycart.html
BABYCART_PATH = /usr/local/bin/babycart

; wikilens RateIt widget
; style of the stars: empty = yellow, red or red
; RATEIT_IMGPREFIX = 
; RATEIT_IMGPREFIX = Star
;RATEIT_IMGPREFIX = BStar

; GraphViz plugin executable:
; http://www.graphviz.org/
;GRAPHVIZ_EXE = /usr/local/bin/dot

; Default GD2 truetype font. For text2png, GraphViz, VisualWiki
; You might need the full path to the .ttf file
;TTFONT = /System/Library/Frameworks/JavaVM.framework/Versions/1.3.1/Home/lib/fonts/LucidaSansRegular.ttf
;TTFONT = "C:\\WINDOWS\\Fonts\\Arial.ttf"
;TTFONT = luximr
;TTFONT = Helvetica

; VisualWiki Plugin needs graphviz
; Replaced by TTFONT
;VISUALWIKIFONT = Arial

; Disable user options
;VISUALWIKI_ALLOWOPTIONS = false

; PloticusPlugin executable and prefabs path:
; http://ploticus.sourceforge.net/doc/welcome.html
;PLOTICUS_EXE = /usr/local/bin/pl
;PLOTICUS_PREFABS = /usr/share/ploticus

; JabberPresence
; http://edgar.netflint.net/howto.php
;MY_JABBER_ID = 

; PhpWeather needs this external php project
; http://sourceforge.net/projects/phpweather/
;PHPWEATHER_BASE_DIR = 

; SyntaxHighlight plugin
; http://www.andre-simon.de/doku/highlight/highlight.html
;HIGHLIGHT_EXE = /usr/local/bin/highlight
;HIGHLIGHT_DATA_DIR = /usr/share/highlight

;===========================================================================
; Part Eight: PLUGINCACHED Pear/Cache Settings
;===========================================================================

; Cache_Container storage class: 'file' is the fastest. See pear/Cache/Container/
;PLUGIN_CACHED_DATABASE = file

; This is only used if database is set to file.
; The webserver must have write access to this dir!
;PLUGIN_CACHED_CACHE_DIR = /tmp/cache
; Every file name in the cache begins with this prefix
;PLUGIN_CACHED_FILENAME_PREFIX = phpwiki

; The maximum total space in bytes of all files in the cache. When
; highwater is exceeded, a garbage collection will start.  It will
; collect garbage till 'lowwater' is reached.  Default: 4 * Megabyte
;PLUGIN_CACHED_HIGHWATER = 4194304
; Default: 3 * Megabyte
;PLUGIN_CACHED_LOWWATER  = 3145728

; If an image has not been used for maxlifetime remove it from the
; cache. (Since there is also the highwater/lowwater mechanism and an
; image usually requires only 1kb you don't have to make it very
; small, I think.)  
; Default: 30 * Day (30 * 24*60*60)
;PLUGIN_CACHED_MAXLIFETIME = 2592000

; Number of characters allowed to be send as 
; parameters in the url before using sessions
; vars instead. 
; Usually send plugin arguments as URL, but when they become
; longer than maxarglen store them in session variables.
; Setting it to 3000 worked fine for me, 30000 completely
; crashed my linux, 1000 should be safe.
;PLUGIN_CACHED_MAXARGLEN = 1000

; Actually use the cache (should be always true unless you are
; debugging). If you want to avoid the usage of a cache but need
; WikiPlugins that nevertheless rely on a cache you might set
; 'PLUGIN_CACHED_USECACHE' to false. You still need to set
; 'PLUGIN_CACHED_CACHE_DIR' appropriately to allow image creation and
; you should set 'PLUGIN_CACHED_FORCE_SYNCMAP' to false.
;PLUGIN_CACHED_USECACHE = true

; Will prevent image creation for an image map 'on demand'. It is a
; good idea to set this to 'true' because it will also prevent the
; html part not to fit to the image of the map.  If you don't use a
; cache, you have to set it to 'false', maps will not work otherwise
; but strange effects may happen if the output of an image map
; producing WikiPlugin is not completely determined by its parameters.
; (As it is the case for a graphical site map.)
;PLUGIN_CACHED_FORCE_SYNCMAP = true

; If ImageTypes() does not exist (PHP < 4.0.2) allow the
; following image formats (IMG_PNG | IMG_GIF | IMG_JPG | IMG_WBMP)
; In principal all image types which are compiled into php: 
;   libgd, libpng, libjpeg, libungif, libtiff, libgd2, ...
;PLUGIN_CACHED_IMGTYPES = "png|gif|gd|gd2|jpeg|wbmp|xbm|xpm"