Skip to main content

Theme settings

Themes in Jadu Central can have multiple configuration settings defined in the settings section of the theme.yml file. Supported setting types include:

  • Text fields (text)
  • Dropdown select boxes (select)
  • File uploads (file)
  • Multi-line text areas (textarea)
  • Image uploads (image)
  • Radio button groups (radio)
  • On/off toggles (toggle)

Defining settings in theme.yml allows each theme to be customisable through the Jadu Central administrative interface. The different field types provide flexibility in the kinds of options that can be configured on a per-theme basis.

Text

AttributesDescriptionMandatory
labelThe label to be displayed next to the fieldyes
requiredWhether the field is requiredno
default-valueThe default value of the fieldno
notesHelp text provided for the fieldno

Select

AttributesDescriptionMandatory
labelThe label to be displayed next to the fieldyes
requiredWhether the field is requiredno
optionsAn array of options, each with a label and valueyes
notesHelp text provided for the fieldno

Options should be provided in the following format:

Example:

    options:
blue:
label: Education (Blue)
value: school-blue
green:
label: Education (Green)
value: school-green

File

AttributesDescriptionMandatory
labelThe label to be displayed next to the fieldyes
requiredWhether the field is requiredno
notesHelp text provided for the fieldno

Textarea

AttributesDescriptionMandatory
labelThe label to be displayed next to the fieldyes
requiredWhether the field is requiredno
notesHelp text provided for the fieldno

## Image

AttributesDescriptionMandatory
labelThe label to be displayed next to the fieldyes
requiredWhether the field is requiredno
notesHelp text provided for the fieldno

## Radio

AttributesDescriptionMandatory
labelThe label to be displayed next to the fieldyes
optionsAn array of options, each with a label and valueyes
notesHelp text provided for the fieldno
default-valueThe default value of the fieldno

Options should be provided in the following format:

Example:

    options:
blue:
label: Education (Blue)
value: school-blue
green:
label: Education (Green)
value: school-green

Toggle

AttributesDescriptionMandatory
labelThe label to be displayed next to the fieldyes
notesHelp text provided for the fieldno
default-valueThe default value of the fieldno