ikiwiki/doc/plugins/websetup.mdwn

28 lines
1.3 KiB
Plaintext
Raw Normal View History

2008-08-03 05:54:19 +02:00
[[!template id=plugin name=websetup core=0 author="[[Joey]]"]]
2008-10-09 22:58:25 +02:00
[[!tag type/web]]
2008-08-03 05:54:19 +02:00
This plugin allows wiki admins to configure the wiki using a web interface,
rather than editing the setup file directly. A "Setup" button is added
2008-08-03 22:23:41 +02:00
to the admins' preferences page.
2008-08-03 05:54:19 +02:00
Warning: This plugin rewrites your setup file. Any comments or unusual
things (such as perl code) in the setup file will not be preserved. Also,
it will only work correctly with new format setup files, as introduced in
ikiwiki 2.60. Older setup files have a "wrappers" section, which will not
be properly preserved if this plugin is used.
2008-08-03 22:23:41 +02:00
Most settings can be modified using the web interface. Plugins can be
enabled and disabled using it too. Some settings are not considered safe
enough to be manipulated over the web; these are still shown, by default,
but cannot be modified. To hide them, set `websetup_show_unsafe` to false
in the setup file. A few settings have too complex a data type to be
configured via the web. To mark additional settings as unsafe, you can
list them in `websetup_unsafe`.
2008-08-03 05:54:19 +02:00
2008-08-03 22:23:41 +02:00
Plugins that should not be enabled/disabled via the web interface can be
2008-08-03 05:54:19 +02:00
listed in `websetup_force_plugins` in the setup file.
When the setup is saved, the setup file will be rewritten with the new
2012-12-02 16:49:13 +01:00
settings, and the wiki will be refreshed, or rebuilt, to make the setup
changes take effect.