Skip to main content

Customize views

Without form_layout_partial:, decidim-toggle renders every form attribute through the default shell (all_fields + submit). For custom markup, provide a full tab layout partial.

Default vs custom​

Defaultform_layout_partial:
WhenSimple JSON-backed settingsTables, fieldsets, reused decidim-system partials, mixed markup
Locals—tab, organization
You renderNothing — toggle uses all_fieldsEntire tab inside decidim_toggle_settings_tab_form

Built-in examples: lib/decidim/toggle/organization_settings_tabs.rb and app/views/decidim_toggle/system/organizations/tabs/.

Custom tab layout​

<%# app/views/decidim/my_module/admin/_organization_settings_tab.html.erb %>
<%= decidim_toggle_settings_tab_form(organization, tab) do |tf| %>
  <fieldset>
    <legend class="form-legend">My module</legend>
    <%= tf.fields_for_names(:enabled) %>
  </fieldset>
<% end %>
tabs.add_tab :my_module,
             "My module",
             form: MyModule::AdminConfigForm,
             command: Decidim::Toggle::UpdateModuleConfigCommand,
             module_name: :my_module,
             form_layout_partial: "decidim/my_module/admin/organization_settings_tab"

decidim_toggle_settings_tab_form provides the PATCH form, hidden active-tab field, informative callouts, and save/cancel buttons. Do not drop the hidden decidim_toggle_active_tab field.

Use tf (Decidim::Toggle::SettingsFormBuilder) for fields — tf.all_fields, tf.fields_for_names(:enabled), or pass f: tf to existing partials.

Reuse decidim-system partials​

<%= decidim_toggle_settings_tab_form(organization, tab) do |tf| %>
  <%= render "decidim/system/organizations/smtp_settings", f: tf %>
<% end %>

See tabs/_emails_tab.html.erb and tabs/_file_upload_tab.html.erb in this gem.

See also​