DokuWiki

It's better when it's simple

User Tools

Site Tools


config

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
config [2018-04-11 14:52] – [Available Options] andiconfig [2022-10-20 04:59] – Add dontlog phy25
Line 1: Line 1:
 ====== Configuring DokuWiki ====== ====== Configuring DokuWiki ======
-Many of DokuWiki's features can be configured through various config options. The easiest way to modify these options is using the [[plugin:config|Configuration Manager]] which allows wiki administrators to easily alter the wiki configuration settings online from the comfort of their favorite web browser.  
  
  
-To start the Configuration Manager log in as superuser and click the Admin button.+ 
 +To start the [[plugin:config|Configuration Manager]] log in as superuser and click the Admin button.
  
  
Line 12: Line 12:
 User names, (encrypted) passwords and Access Control rules are stored in the [[acl|users.auth.php and acl.auth.php]] files which can be found in the conf directory. User names, (encrypted) passwords and Access Control rules are stored in the [[acl|users.auth.php and acl.auth.php]] files which can be found in the conf directory.
  
-When uploading a new file within the mediamanager, you may encounter a ''"Upload denied. This file extension is forbidden!"'' message. This behavior is controlled within the ''conf/mime.conf'' file. To upload a new type of file, specify it within the [[mime|mime.conf]] file.+When uploading a new file within the mediamanager, you may encounter a ''"Upload denied. This file extension is forbidden!"'' message. This behavior is controlled within the ''conf/mime.conf'' file. To upload a new type of file, specify it within the [[mime|mime.local.conf]] file.
  
 Some automatic replacements are done when you edit your pages. Some generate tooltips, smileys or some special chars. This behavior is controlled by the [[abbreviations|acronyms.conf]], [[smileys|smileys.conf]] or [[entities|entities.conf]]. Some automatic replacements are done when you edit your pages. Some generate tooltips, smileys or some special chars. This behavior is controlled by the [[abbreviations|acronyms.conf]], [[smileys|smileys.conf]] or [[entities|entities.conf]].
Line 38: Line 38:
 | ''license.php''           | ''license.local.php''                              | [[config:license]]    | list of available licenses             | | ''license.php''           | ''license.local.php''                              | [[config:license]]    | list of available licenses             |
 | ''scheme.conf''           | ''scheme.local.conf''                              | [[urlschemes]]        | URL schemes to be recognized as links  | | ''scheme.conf''           | ''scheme.local.conf''                              | [[urlschemes]]        | URL schemes to be recognized as links  |
-| ''mediameta.php''                                                            | [[exif]]              | Metadata editable for images           |+| ''mediameta.php''         ''mediameta.local.php''                            | [[exif]]              | Metadata editable for images           |
 | ''wordblock.conf''        | ''wordblock.local.conf''                           | [[blacklist]]         | Spam blacklist                         | | ''wordblock.conf''        | ''wordblock.local.conf''                           | [[blacklist]]         | Spam blacklist                         |
 | ''plugins.required.php''  | ''plugins.local.php''\\ ''plugins.protected.php''  | see below             | Enabling/disabling plugins             | | ''plugins.required.php''  | ''plugins.local.php''\\ ''plugins.protected.php''  | see below             | Enabling/disabling plugins             |
 |                           | ''userscript.js''                                  | [[devel:javascript]]  | Custom JavaScript enhancements         | |                           | ''userscript.js''                                  | [[devel:javascript]]  | Custom JavaScript enhancements         |
 |                           | ''userstyle.css''                                  | [[devel:css]]         | Custom CSS enhancements                | |                           | ''userstyle.css''                                  | [[devel:css]]         | Custom CSS enhancements                |
 +| ''manifest.json''         | ''manifest.local.json''                            | [[devel:manifest]]    | PWA Manifest                           |
  
 ==== Theme configuration files ==== ==== Theme configuration files ====
Line 50: Line 51:
 ===== Enabling/disabling plugins ===== ===== Enabling/disabling plugins =====
  
-Installed plugins are enabled by default. They could be disabled using the [[plugin:extension|Extension Manager]] or [[plugin:plugin|Plugin Manager]] which writes to the ''plugins.local.php'' file. You can protect certain plugins by placing them in ''conf/plugins.protected.php''.+Installed plugins are enabled by default. They could be disabled using the [[plugin:extension|Extension Manager]] which writes to the ''plugins.local.php'' file. You can protect certain plugins by placing them in ''conf/plugins.protected.php''.
  
 By default DokuWiki loads its configuration files in the following order: By default DokuWiki loads its configuration files in the following order:
  
   - ''conf/plugins.php'' -- default plugins   - ''conf/plugins.php'' -- default plugins
-  - ''conf/plugins.local.php'' -- changed by plugin manager +  - ''conf/plugins.local.php'' -- changed by the extension manager 
-  - ''conf/plugins.required.php'' -- these core plugins cannot be controlled by plugin manager+  - ''conf/plugins.required.php'' -- these core plugins cannot be controlled by the extension manager
   - ''conf/plugins.protected.php'' -- overrides setting in the other files   - ''conf/plugins.protected.php'' -- overrides setting in the other files
  
Line 66: Line 67:
 Most of [[DokuWiki]]'s features can be configured through various config options. The easiest way to modify these options is using the [[plugin:config|Configuration Manager]]. Most of [[DokuWiki]]'s features can be configured through various config options. The easiest way to modify these options is using the [[plugin:config|Configuration Manager]].
  
-The available settings are listed below. Their default values are stored in a file called ''conf/dokuwiki.php''. If you want to modify a setting you should do this in a file called ''conf/local.php'' -- this makes sure your special configs are not overwritten by a later upgrade. The config manager will use this file as well.  The file ''conf/local.protected.php'' can be used for configuration settings which cannot be modified.+The available settings are listed below. Their default values are stored in a file called ''conf/dokuwiki.php''. If you want to modify a setting you should do this in a file called ''conf/local.php'' -- this makes sure your special configs are not overwritten by a later upgrade. The [[plugin:config|Config Manager]] will use this file as well.  The file ''conf/local.protected.php'' can be used for configuration settings which cannot be modified in the Config Manager.
  
 Here is a sample ''conf/local.php'': Here is a sample ''conf/local.php'':
Line 99: Line 100:
     * [[config:basedir]]     * [[config:basedir]]
     * [[config:baseurl]]     * [[config:baseurl]]
 +    * [[config:cookiedir]]
     * [[config:dmode]]     * [[config:dmode]]
     * [[config:fmode]]     * [[config:fmode]]
Line 136: Line 138:
     * [[config:remote]]     * [[config:remote]]
     * [[config:remoteuser]]     * [[config:remoteuser]]
 +    * [[config:remotecors]]
   * ** Anti-Spam Settings **   * ** Anti-Spam Settings **
     * [[config:usewordblock]]     * [[config:usewordblock]]
Line 163: Line 166:
     * [[config:registernotify]]     * [[config:registernotify]]
     * [[config:mailfrom]]     * [[config:mailfrom]]
 +    * [[config:mailreturnpath]]
     * [[config:mailprefix]]     * [[config:mailprefix]]
     * [[config:htmlmail]]     * [[config:htmlmail]]
 +    * [[config:dontlog]]
   * ** Syndication Settings **   * ** Syndication Settings **
     * [[config:sitemap]]     * [[config:sitemap]]
Line 170: Line 175:
     * [[config:rss_linkto]]     * [[config:rss_linkto]]
     * [[config:rss_content]]     * [[config:rss_content]]
-    * rss_media+    * [[config:rss_media]]
     * [[config:rss_update]]     * [[config:rss_update]]
     * [[config:rss_show_summary]]     * [[config:rss_show_summary]]
 +    * [[config:rss_show_deleted]]
   * ** Advanced options **   * ** Advanced options **
     * [[config:updatecheck]]     * [[config:updatecheck]]
Line 195: Line 201:
     * [[config:dnslookups]]     * [[config:dnslookups]]
     * [[config:jquerycdn]]     * [[config:jquerycdn]]
-    * [[config:proxy|proxy (host, port, user, pass, ssl)]] +    * [[config:proxy|proxy (host, port, user, pass, ssl, except)]] 
-    * [[config:safemodehack]] +    * [[config:trustedproxy]] 
-    * [[config:ftp|ftp (host, port, user, pass, root)]]+    * [[config:safemodehack]] (removed since release 2020 Hogfather) 
 +    * [[config:ftp|ftp (host, port, user, pass, root)]] (removed since release 2020 Hogfather) 
 +  * **Feature Flags** 
 +    * [[config:defer_js]]
config.txt · Last modified: 2024-02-27 19:32 by 182.177.27.17

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki