Skip to main content

User Guide

Opening sSettings​

Open the Evolution CMS manager and choose Tools → Custom Settings. The module shows the configured settings tabs and a Configuration tab:

  • Settings tabs - edit the stored values.
  • Configuration - edit tabs, fields, labels, descriptions, and field types.

The interface uses evo-ui and Livewire, so tab switching and saves refresh only the module area.

Settings Screen​

The Settings screen shows one configuration tab at a time. Each field row has:

  • the field label;
  • the system key, for example [(sset_phone)];
  • the input control;
  • the field description below the input.

Use the descriptions to understand where a value appears on the site. Press Save after changing values.

Multilingual Text Fields​

With sLang installed, enable Multilingual field in a Text, Textarea, Textarea Mini or RichText field's configuration. Settings then displays a separate value for each configured sLang language, using keys such as @evoConfig('sset_adv_top_uk') and @evoConfig('sset_adv_top_en').

The initial value is copied to the default language. The unsuffixed key follows that language for compatibility. New languages appear automatically; removed languages and disabled multilingual fields retain their translated values. Without sLang, the field remains usable as a single value. Duplicate generated keys are rejected before configuration is saved.

Field Types​

Available field types:

TypeUse
TextShort values such as email, phone, URL, or ID.
TextareaLarge text, HTML snippets, or tracking scripts.
TextareaMiniShort multi-line values.
RichTextFormatted content edited with the manager rich editor.
DropDown List MenuOne value chosen from a compact dropdown list.
ListboxOne or many values selected from a taller list.
Radio OptionsOne value selected from visible options.
Checkbox GroupMany values selected from visible options.
ImageImage path selected through the manager helper.
FileFile path selected through the manager helper.
CheckboxEnabled or disabled flags.
DividerA visual separator; it does not store a value.

Checkbox values are saved as 1 or 0. Option-based fields use value/label rows. Use the plus button to add an option after the current row, the trash action to remove it, arrows for manual reorder, or the drag handle to reorder the option list.

Configuration Screen​

The Configuration screen changes the schema used by the Settings screen.

Tab rows contain:

  • a drag handle;
  • a tab key;
  • a translated tab label;
  • compact actions to add another tab, add a field, or remove the tab.

Field rows contain:

  • a drag handle;
  • the field label;
  • the system key chip;
  • the field description;
  • the type chip;
  • actions for settings, add-after, and delete.

Click the settings icon on a field to open the compact field settings modal.

Reordering​

Use the drag handle to reorder tabs or fields. Fields can move inside a tab or between tabs. Option rows inside field settings use the same EvoUI drag handle and also keep up/down arrows for precise movement.

System Keys​

Every value field creates an Evolution system setting:

field name: phone
system key: sset_phone
template tag: [(sset_phone)]

Changing a field name changes the system key after saving Configuration.

Saving And Permissions​

The Settings screen saves values. The Configuration screen saves the schema and syncs system settings. Configuration requires the Evolution settings permission.

If the schema file cannot be written, sSettings shows a writable-file error.

Troubleshooting​

  • If a field is missing, check the Configuration tab and save the schema.
  • If a value is not visible on the frontend, clear the Evolution cache after saving.
  • If Configuration is unavailable, confirm that your manager role has the settings permission.
  • If a label looks like sSettings::global.email, it is a translation key that has no matching translation in the active manager language.