Config.spec elements $Foswiki::cfg hash:
| Location | Example | Notes |
|---|---|---|
Under the {Extensions} namespace |
$Foswiki::cfg{Extensions}{BathPlugin}{PlugType} |
This is the recommended location, It is recommended for all new extensions, and strongly recommended for non-Plugin type extensions (Contribs, Skins, etc). |
Under the {Plugins} namespace |
$Foswiki::cfg{Plugins}{BathPlugin}{PlugType} |
This is traditionally where foswiki organizes all plugin settings. Foswiki automatically populates two settings for Plugins (and only plugins):
Config.spec file.We no longer recommend using this namespace for custom settings. |
| Under the root namespace | $Foswiki::cfg{BathPlugin} |
Not Recommended Historical extensions place settings under the root, it results in a very cluttered configuration. |
{Extensions}, even if it has a Plugin component.
{Plugins} space but this is no longer recommended.
---+ Extensions
---++ BathPlugin
$Foswiki::cfg{Plugins}{BathPlugin}{PlugType} = 'rubber';
$Foswiki::cfg{Extensions}{BathPlugin}{ToyType} = 'duckie';
$Foswiki::cfg{foobar} = 'some archaic root-level setting';