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