xref: /dokuwiki/conf/dokuwiki.php (revision d963b0cfaf3c28112ccbb75e349eed423fad8789)
1<?php
2/**
3 * This is DokuWiki's Main Configuration file
4 *
5 * All the default values are kept here, you should not modify it but use
6 * a local.php file instead to override the settings from here.
7 *
8 * This is a piece of PHP code so PHP syntax applies!
9 *
10 * For help with the configuration see http://www.splitbrain.org/dokuwiki/wiki:config
11 */
12
13
14/* Datastorage and Permissions */
15
16$conf['fmode']       = 0644;              //set file creation mode
17$conf['dmode']       = 0755;              //set directory creation mode
18$conf['lang']        = 'en';              //your language
19$conf['basedir']     = '';                //absolute dir from serveroot - blank for autodetection
20$conf['baseurl']     = '';                //URL to server including protocol - blank for autodetect
21$conf['savedir']     = './data';          //where to store all the files
22$conf['allowdebug']  = 0;                 //allow debug output, enable if needed 0|1
23
24/* Display Options */
25
26$conf['start']       = 'start';           //name of start page
27$conf['title']       = 'DokuWiki';        //what to show in the title
28$conf['template']    = 'default';         //see lib/tpl directory
29$conf['license']     = 'cc-by-nc-sa';     //see conf/license.php
30$conf['fullpath']    = 0;                 //show full path of the document or relative to datadir only? 0|1
31$conf['recent']      = 20;                //how many entries to show in recent
32$conf['breadcrumbs'] = 10;                //how many recent visited pages to show
33$conf['youarehere']  = 0;                 //show "You are here" navigation? 0|1
34$conf['typography']  = 1;                 //smartquote conversion 0=off, 1=doublequotes, 2=all quotes
35$conf['htmlok']      = 0;                 //may raw HTML be embedded? This may break layout and XHTML validity 0|1
36$conf['phpok']       = 0;                 //may PHP code be embedded? Never do this on the internet! 0|1
37$conf['dformat']     = '%Y/%m/%d %H:%M';  //dateformat accepted by PHPs strftime() function
38$conf['signature']   = ' --- //[[@MAIL@|@NAME@]] @DATE@//'; //signature see wiki:config for details
39$conf['toptoclevel'] = 1;                 //Level starting with and below to include in AutoTOC (max. 5)
40$conf['tocminheads'] = 3;                 //Minimum amount of headlines that determines if a TOC is built
41$conf['maxtoclevel'] = 3;                 //Up to which level include into AutoTOC (max. 5)
42$conf['maxseclevel'] = 3;                 //Up to which level create editable sections (max. 5)
43$conf['camelcase']   = 0;                 //Use CamelCase for linking? (I don't like it) 0|1
44$conf['deaccent']    = 1;                 //deaccented chars in pagenames (1) or romanize (2) or keep (0)?
45$conf['useheading']  = 0;                 //use the first heading in a page as its name
46$conf['refcheck']    = 1;                 //check for references before deleting media files
47$conf['refshow']     = 0;                 //how many references should be shown, 5 is a good value
48$conf['showuseras']  = 'loginname';       // 'loginname' users login name
49                                          // 'username' users full name
50                                          // 'email' e-mail address (will be obfuscated as per mailguard)
51                                          // 'email_link' e-mail address as a mailto: link (obfuscated)
52
53/* Antispam Features */
54
55$conf['usewordblock']= 1;                 //block spam based on words? 0|1
56$conf['indexdelay']  = 60*60*24*5;        //allow indexing after this time (seconds) default is 5 days
57$conf['relnofollow'] = 1;                 //use rel="nofollow" for external links?
58$conf['mailguard']   = 'hex';             //obfuscate email addresses against spam harvesters?
59                                          //valid entries are:
60                                          //  'visible' - replace @ with [at], . with [dot] and - with [dash]
61                                          //  'hex'     - use hex entities to encode the mail address
62                                          //  'none'    - do not obfuscate addresses
63$conf['iexssprotect']= 1;                 // check for JavaScript and HTML in uploaded files 0|1
64
65/* Authentication Options - read http://www.splitbrain.org/dokuwiki/wiki:acl */
66
67$conf['useacl']      = 0;                //Use Access Control Lists to restrict access?
68$conf['autopasswd']  = 1;                //autogenerate passwords and email them to user
69$conf['authtype']    = 'plain';          //which authentication backend should be used
70$conf['passcrypt']   = 'smd5';           //Used crypt method (smd5,md5,sha1,ssha,crypt,mysql,my411)
71$conf['defaultgroup']= 'user';           //Default groups new Users are added to
72$conf['superuser']   = '!!not set!!';    //The admin can be user or @group or comma separated list user1,@group1,user2
73$conf['manager']     = '!!not set!!';    //The manager can be user or @group or comma separated list user1,@group1,user2
74$conf['profileconfirm'] = 1;             //Require current password to confirm changes to user profile
75$conf['disableactions'] = '';            //comma separated list of actions to disable
76$conf['sneaky_index']   = 0;             //check for namespace read permission in index view (0|1) (1 might cause unexpected behavior)
77$conf['auth_security_timeout'] = 900;    //time (seconds) auth data is considered valid, set to 0 to recheck on every page view
78$conf['securecookie'] = 1;               //never send HTTPS cookies via HTTP
79
80$conf['xmlrpc']      = 0;                //Enable/disable XML-RPC interface
81$conf['xmlrpcuser']  = '!!not set!!';    //Restrict XML-RPC access to this groups/users
82
83/* Advanced Options */
84
85$conf['updatecheck'] = 1;                //automatically check for new releases?
86$conf['userewrite']  = 0;                //this makes nice URLs: 0: off 1: .htaccess 2: internal
87$conf['useslash']    = 0;                //use slash instead of colon? only when rewrite is on
88$conf['usedraft']    = 1;                //automatically save a draft while editing (0|1)
89$conf['sepchar']     = '_';              //word separator character in page names; may be a
90                                         //  letter, a digit, '_', '-', or '.'.
91$conf['canonical']   = 0;                //Should all URLs use full canonical http://... style?
92$conf['autoplural']  = 0;                //try (non)plural form of nonexisting files?
93$conf['compression'] = 'gz';             //compress old revisions: (0: off) ('gz': gnuzip) ('bz2': bzip)
94                                         //  bz2 generates smaller files, but needs more cpu-power
95$conf['cachetime']   = 60*60*24;         //maximum age for cachefile in seconds (defaults to a day)
96$conf['locktime']    = 15*60;            //maximum age for lockfiles (defaults to 15 minutes)
97$conf['fetchsize']   = 0;                //maximum size (bytes) fetch.php may download from extern, disabled by default
98$conf['notify']      = '';               //send change info to this email (leave blank for nobody)
99$conf['registernotify'] = '';            //send info about newly registered users to this email (leave blank for nobody)
100$conf['mailfrom']    = '';               //use this email when sending mails
101$conf['gzip_output'] = 0;                //use gzip content encodeing for the output xhtml (if allowed by browser)
102$conf['gdlib']       = 2;                //the GDlib version (0, 1 or 2) 2 tries to autodetect
103$conf['im_convert']  = '';               //path to ImageMagicks convert (will be used instead of GD)
104$conf['jpg_quality'] = '70';             //quality of compression when scaling jpg images (0-100)
105$conf['subscribers'] = 0;                //enable change notice subscription support
106$conf['compress']    = 1;                //Strip whitespaces and comments from Styles and JavaScript? 1|0
107$conf['hidepages']   = '';               //Regexp for pages to be skipped from RSS, Search and Recent Changes
108$conf['send404']     = 0;                //Send a HTTP 404 status for non existing pages?
109$conf['sitemap']     = 0;                //Create a google sitemap? How often? In days.
110$conf['rss_type']    = 'rss1';           //type of RSS feed to provide, by default:
111                                         //  'rss'  - RSS 0.91
112                                         //  'rss1' - RSS 1.0
113                                         //  'rss2' - RSS 2.0
114                                         //  'atom' - Atom 0.3
115                                         //  'atom1' - Atom 1.0
116$conf['rss_linkto'] = 'diff';            //what page RSS entries link to:
117                                         //  'diff'    - page showing revision differences
118                                         //  'page'    - the revised page itself
119                                         //  'rev'     - page showing all revisions
120                                         //  'current' - most recent revision of page
121$conf['rss_content'] = 'abstract';       // what to put in the items by deafult?
122                                         //  'abstract' - plain text, first paragraph or so
123                                         //  'diff'     - plain text unified diff wrapped in <pre> tags
124                                         //  'htmldiff' - diff as HTML table
125                                         //  'html'     - the full page rendered in XHTML
126$conf['rss_update'] = 5*60;              //Update the RSS feed every n minutes (defaults to 5 minutes)
127$conf['recent_days'] = 7;                //How many days of recent changes to keep. (days)
128$conf['rss_show_summary'] = 1;           //Add revision summary to title? 0|1
129$conf['broken_iua']  = 0;                //Platform with broken ignore_user_abort (IIS+CGI) 0|1
130$conf['xsendfile']   = 0;                //Use X-Sendfile (1 = lighttpd, 2 = standard)
131$conf['renderer_xhtml'] = 'xhtml';       //renderer to use for main page generation
132$conf['rememberme'] = 1;                 //Enable/disable remember me on login
133
134//Set target to use when creating links - leave empty for same window
135$conf['target']['wiki']      = '';
136$conf['target']['interwiki'] = '';
137$conf['target']['extern']    = '';
138$conf['target']['media']     = '';
139$conf['target']['windows']   = '';
140
141//Proxy setup - if your Server needs a proxy to access the web set these
142$conf['proxy']['host'] = '';
143$conf['proxy']['port'] = '';
144$conf['proxy']['user'] = '';
145$conf['proxy']['pass'] = '';
146$conf['proxy']['ssl']  = 0;
147
148/* Safemode Hack */
149
150$conf['safemodehack'] = 0;               //read http://www.dokuwiki.org/config:safemodehack !
151$conf['ftp']['host'] = 'localhost';
152$conf['ftp']['port'] = '21';
153$conf['ftp']['user'] = 'user';
154$conf['ftp']['pass'] = 'password';
155$conf['ftp']['root'] = '/home/user/htdocs';
156
157