Documenting plugin configuration

This commit sponsored by David Krupicz.  Thanks, David!
This commit is contained in:
Christopher Allan Webber 2013-05-08 10:57:23 -05:00
parent d3604e2920
commit f65bf89836

View File

@ -32,3 +32,19 @@ Please check the release notes for updates!
:members: get_config, register_routes, register_template_path, :members: get_config, register_routes, register_template_path,
register_template_hooks, get_hook_templates, register_template_hooks, get_hook_templates,
hook_handle, hook_runall, hook_transform hook_handle, hook_runall, hook_transform
Configuration
-------------
Your plugin may define its own configuration defaults.
Simply add to the directory of your plugin a config_spec.ini file. An
example might look like::
[plugin_spec]
some_string = string(default="blork")
some_int = integer(default=50)
This means that when people enable your plugin in their config you'll
be able to provide defaults as well as type validation.