Differences

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

--- plugin:config [2016-03-17 12:56] – [Description] 85.155.19.59
+++ plugin:config [2023-08-24 23:01] (current) – Klap-in
@@ Line 1: / Line 1: @@
 ====== Configuration Manager Plugin ======
 ---- plugin ----
 description: Manage your wiki's configuration settings (bundled with DokuWiki)
@@ Line 15: / Line 16: @@
 ===== Description =====
 {{ :plugin:configmanager.png?350|The Configuration Manager - Field colors: blue = default, white = local change, light red = protected setting}}
 The Config Manager allows wiki [[config:superuser|administrators]] to easily alter the wiki [[:config|configuration]] settings online from the comfort of their favorite web browser. This plugin manages basic DokuWiki configurations as well as [[devel:configuration|other settings]] for installed [[:plugins]] and currently used [[:template]].
@@ Line 20: / Line 22: @@
 ===== Usage =====
-The Config Manager is accessible from the admin screen (Login as superuser, click "Admin" and choose "Configuration Settings").
+The Config Manager is accessible from the admin screen (Login as superuser, click "Admin" and choose "{{https://raw.githubusercontent.com/dokuwiki/dokuwiki/master/lib/plugins/config/admin.svg?14}} Configuration Settings").
 Settings are shown with different backgrounds to highlight their current status.
@@ Line 29: / Line 31: @@
 Modify settings to your needs and save it by using the ''Save'' button at bottom of the page, by pressing 'Enter' in a textbox or by using the [[:accesskey]] of your browser: ''<accesskey> + S''
-====How is your config saved ====
+==== How is your config saved ====
 On saving changed settings this plugin will copy the current local settings file (''conf/local.php'') to ''conf/local.php.bak'' and save the updated settings to ''conf/local.php''.  It will never make any changes to the default settings stored in ''conf/dokuwiki.php''.  However, any settings found in ''conf/local.php'' will override the default settings as explained in the [[:config|configuration options page]].
@@ Line 55: / Line 58: @@
 This way, it is ensured that any values previously set from ''conf/dokuwiki.php'' and ''conf/local.php'' will be overridden by protected values from ''conf/local.protected.php''. Any settings found in ''conf/local.protected.php'' will be displayed by the plugin surrounded in light-red to indicate their protected status. Editing of protected values is disabled.
-The loading order of configuration files is controlled by the global ''$config_cascade'' variable in the DokuWiki release 2009-02-14 and above.
+The loading order of configuration files is controlled by the global ''[[devel:preload|$config_cascade]]'' variable.
+=== Example ===
-===Example===
 <code php conf/local.protected.php>
 <?php
@@ Line 65: / Line 69: @@
  */
 $conf['useacl'] = 1;
-</code>
-==For 2008-05-05 release and below==
-Meanwhile, in the release 2008-05-05 and below this plugin used to add the following line to the bottom of ''conf/local.php'' to load protected settings.
-<code php>
-@include(DOKU_CONF.'local.protected.php');
 </code>
@@ Line 84: / Line 81: @@
 When this happens, the save button won't be shown.
-===== User Questions =====
 ==== Triangle, Exclamation and Padlock Mark ====
 Some fields in the configuration page show:
-  * A yellow warning sign, or
+  * A yellow warning sign ({{:config:warning.png?nolink|}}) , or
-  * An exclamation mark in a red circle, or
+  * An exclamation mark in a red circle ({{:config:danger.png?nolink|}}), or
-  * The drawing of a padlock
+  * The drawing of a padlock ({{:config:security.png?nolink|}})
-These are the meanings of these three simbols:\\
+These are the meanings of these three symbols:\\
-**Yellow Mark** ⇒ changing this option may result in undesirable behaviors.\\
+{{:config:warning.png?nolink|}} **Yellow Mark** ⇒ changing this option may result in undesirable behaviors.\\
-**Red circle** ⇒ changing this option could make your wiki and the configuration menu inaccessible.\\
+{{:config:danger.png?nolink|}} **Red circle** ⇒ changing this option could make your wiki and the configuration menu inaccessible.\\
-**Padlock** ⇒ changing this option could present a security risk.\\
+{{:config:security.png?nolink|}} **Padlock** ⇒ changing this option could present a security risk.\\
 Please, keep attention when you change these fields.
-==== Path Strings ====
-I have an issue with the configuration data of the "source"-plugin that probably affects other plugins with path strings as well:
-When putting a path string to the "location" field, e.g. \\
-<code php>
-E:\
-</code>
-it will be saved like this to the local.php: \\
-<code php>
-$conf['plugin']['source']['location'] = 'E:\\'
-</code>
-With this content the "source"-plugin will work.\\
-Re-opening the configuration manager page the content of the "location" field is auto-filled from the local.php with \\
-<code php>
-'E:\'
-</code>
-Saving now the configuration once more (by only changing any arbitrary other parameter to force saving) the value in the local.php becomes
-<code php>
-$conf['plugin']['source']['location'] = '\'E:\\\''
-</code>
-and the "source"-plugin fails. For non-path strings there seems to be no such problem so the issue must be related to this double-backslash. Can you help?\\
-P.S.: Sorry, I couldn't find any other appropriate place to report about this.
-> There is a link to where to report [[https://github.com/splitbrain/dokuwiki/issues|bugs]] right at the top of every page here. [[https://www.google.com/search?q=dokuwiki+bugs|Googling "DokuWiki bugs"]] also gives satisfactory results. --- [[user>ach|Anika Henke]] //2015-09-05 14:45//