Differences

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

--- config [2024-01-13 07:37] – [What can be configured] 2001:8f8:153d:6d24:6551:761c:8300:c0ac
+++ config [2024-02-27 19:32] (current) – [Configuration files] 182.177.27.17
@@ Line 4: / Line 4: @@
+===== What can be configured =====
+The "system" options of DokuWiki can be set in the [[plugin:config|{{https://raw.githubusercontent.com/dokuwiki/dokuwiki/master/lib/plugins/config/admin.svg?14}}]][[plugin:config|Configuration Manager]]. You need to login as superuser and click the Admin button to start it. The "default" values of the system are read from ''conf/dokuwiki.php'' file. To customize it, you can make changes in the Configuration Manager, which saves the changes to the file ''conf/local.php''. Alternatively, you edit it yourself or create it if it doesn't exist. To find what you can configure within that file, see the list of [[#available options]] below.
+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. These can be edited via the [[plugin:usermanager|{{https://raw.githubusercontent.com/dokuwiki/dokuwiki/master/lib/plugins/usermanager/admin.svg?14}}]][[plugin:usermanager|User Manager]] and the [[plugin:acl|{{https://raw.githubusercontent.com/dokuwiki/dokuwiki/master/lib/plugins/acl/admin.svg?14}}]][[plugin:acl|Access Control List Management]].
+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]].
 ===== Configuration files =====
-All configuration files are to be found in the ''conf/'' folder in your installation (or ''/etc/dokuwiki'' when installed from a Debian package).
+The configuration files are to be found in the ''conf/'' folder in your installation (or ''/etc/dokuwiki'' when installed from a Debian package).
 "Main files" usually ship with DokuWiki, whereas "local files" have to be created by the wiki admin.
@@ Line 16: / Line 26: @@
 Alternatively, instead of editing the ''*.conf'' files directly, you can install and use the [[plugin:confmanager|{{https://raw.githubusercontent.com/cosmocode/confmanager/master/admin.svg?16}}]][[plugin:confmanager|Configuration File Manager]].
-^ main file                 ^ local file                                         ^ type of config        ^ quick info                             ^
+^ main file                    ^ local file                                         ^ type of config        ^ quick info                             ^
-| ''dokuwiki.php''          | ''local.php''\\ ''local.protected.php''            | see below             | general wiki configuration             |
+| ''dokuwiki.php''             | ''local.php''\\ ''local.protected.php''            | see below             | general wiki configuration             |
-| ''acronyms.conf''         | ''acronyms.local.conf''                            | [[abbreviations]]     | automatic abbreviation hints           |
+| ''acronyms.conf''            | ''acronyms.local.conf''                            | [[abbreviations]]     | automatic abbreviation hints           |
-| ''entities.conf''         | ''entities.local.conf''                            | [[entities]]          | automatic text replacements            |
+| ''entities.conf''            | ''entities.local.conf''                            | [[entities]]          | automatic text replacements            |
-| ''interwiki.conf''        | ''interwiki.local.conf''                           | [[interwiki]]         | interwiki shortcut links               |
+| ''interwiki.conf''           | ''interwiki.local.conf''                           | [[interwiki]]         | interwiki shortcut links               |
-| ''mime.conf''             | ''mime.local.conf''                                | [[mime]]              | mime type settings for uploads         |
+| ''mime.conf''                | ''mime.local.conf''                                | [[mime]]              | mime type settings for uploads         |
-| ''smileys.conf''          | ''smileys.local.conf''                             | [[smileys]]           | image replacements                     |
+| ''smileys.conf''             | ''smileys.local.conf''                             | [[smileys]]           | image replacements                     |
-|                           | ''acl.auth.php''                                   | see [[acl]]           | Access Control settings                |
+|                              | ''acl.auth.php''                                   | see [[acl]]           | Access Control settings                |
-|                           | ''users.auth.php''                                 | see [[acl]]           | Users and passwords                    |
+|                              | ''users.auth.php''                                 | see [[acl]]           | Users and passwords                    |
-| ''license.php''           | ''license.local.php''                              | [[~:license]]    | list of available licenses             |
+| ''license.php''              | ''license.local.php''                              | [[~: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''         | ''mediameta.local.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             |
-| ''manifest.json''         | ''manifest.local.json''                            | [[devel:manifest]]    | PWA Manifest                           |
+| ''manifest.json''            | ''manifest.local.json''                            | [[devel:manifest]]    | PWA Manifest                           |
-| ''lib/tpl/<tpl>/style.ini'' | ''conf/tpl/<tpl>/style.ini'' | [[devel:style.ini]] | Style files and variables |
+| ''lib/tpl/<tpl>/style.ini''  | ''conf/tpl/<tpl>/style.ini''                       | [[devel:style.ini]]   | Style files and variables              |
-|                           | ''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                |
@@ Line 162: / Line 172: @@
     * [[~:htmlmail]]
     * [[~:dontlog]]
-    * [[~:logretain]] ([[devel:develonly]])
+    * [[~:logretain]]
   * ** Syndication Settings **
     * [[~:sitemap]]