Docs Developer
FNS_ConfigHost
A standalone FNS_ConfigRegistry host. Drop it into a component to give it roaming settings — its parameters save and reload with your config, with per-parameter and per-page exclusions.
⌨ Developer
Config Host
Every FNS tool that remembers its settings does so by carrying a small FNS_ConfigRegistry host. This is that host on its own, so a component outside the toolkit can have the same thing: its parameters are written into the shared settings file and restored on load.
It needs FNS_ConfigRegistry present — the host publishes into that registry, which owns the file. Without it the host simply stays idle.
Adopting it
Drag the COMP inside the component whose settings should roam, then set its Registration page:
| Par | Meaning |
|---|---|
Comp |
the component whose parameters are saved; defaults to .. |
Canonicalname |
the section name in the settings file; empty = the component's name |
Autoregister |
publish while the component exists |
Autoload |
restore saved values when it registers |
Persistpars |
save the component's custom parameters |
Excludepars / Excludepages |
leave named parameters or whole pages out |
Callback / Createcallbacks |
optional DAT for save/load hooks — the pulse writes a starter |
Promotepars mirrors the key parameters onto the parent as a bound Registry
page, so it can be configured without opening the host.
The one thing to get right
Canonicalname is the key your settings are stored under. Renaming it
orphans everything saved under the old name — the values are not lost from the
file, but the component stops seeing them. Choose it once.
Whether settings roam across all your projects or stay with one is decided by FNS_ConfigRegistry's scope, not here.