1e4ed4d0c73ba3c019fdd6e6db5cf071304554c0
[ikiwiki.git] / doc / plugins / websetup.mdwn
1 [[!template id=plugin name=websetup core=0 author="[[Joey]]"]]
2 [[!tag type/useful]]
3
4 This plugin allows wiki admins to configure the wiki using a web interface,
5 rather than editing the setup file directly. A "Wiki Setup" button is added to the
6 admins' preferences page.
7
8 Most settings can be modified using the web interface. Some settings are
9 not considered safe enough to be manipulated over the web; these are still
10 shown, by default, but cannot be modified. To hide them, set `websetup_show_unsafe` 
11 to false in the setup file. A few settings have too complex a data type
12 to be configured via the web.
13
14 The web interface can also be used to enable and disable plugins, with
15 limitations. The plugin for the [[revision_control_system|rcs]] being used
16 cannot be enabled/disabled, and no other rcs plugins can be enabled. A few
17 problematic/unsafe plugins are also blacklisted from being enabled. Other
18 plugins that should not be enabled/disabled via the web interface can be
19 listed in `websetup_force_plugins` in the setup file.