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