Skip to main content

Integrate your module

Three steps to ship a settings tab: register the tab, declare form attributes, optionally customize the view.

1. Add a tab

Register a form and command in your engine after decidim_toggle.organization_settings_tabs.

Add a settings tab

2. Define attributes and validation

Declare fields on your Decidim::Form — booleans, collections, translatable fields. Field labels live under decidim_toggle.system.<module_config_name> — see Labels.

Attributes · Labels · Informative callouts (optional)

3. Customize the form view (optional)

Default rendering uses all_fields. Override with form_layout_partial: when you need custom markup.

Customize views

Optional: JavaScript exposure

Expose selected settings to window.DecidimToggle on the participant and admin frontends.

JavaScript

See also