Jump to main content Jump to doc navigation

Use cases for overriding an option set are when you need to change things like switching remote from true to false. You can also use them more extensively like overriding all the Settings for a single Element without maintaining an entierly separate Option Set.

Overrides are located on the Overrides tab when editing a specific Element in the Fred Manager page.

Note: You must include all settings you want to show as controls in the Override panel. The best way to start your override is by copying the entire settings JSON node by clicking the Preview Option Set button and selecting the JSON object(s) and pasting into the overrides text area.

Override specific options

These options are only available through override, not when creating Option Set.

merge

When setting merge to true, the override will get recursively merged to current Option Set. Default value is false.

rteConfig

You can override or define new RTE Configs through this option.

Example

Assume you have an Intro plan with a background image and a call to action link. You want a version for both single-page sites with anchor link external URLs on the page, but also one which allows links to other Fred pages on your site. You don't need the scroll-to-link (see below) and you want to change the link object to be a MODX page select list.

Original Setting

{
    "settings": [
        {
            "name": "image",
            "label": "Background Image",
            "type": "image",
            "value": "assets/themes/starter/img/Fred-hero.jpg"
        },
        {
            "fred-import": "background_settings"
        },
        {
            "name": "linkscroll",
            "label": "Scroll Link",
            "type": "toggle",
            "value": true
        },
        {
            "name": "link",
            "label": "Link anchor or URL",
            "type": "text",
            "value": null
        }
    ]
}

Options Override

{
    "settings": [
        {
            "name": "image",
            "label": "Background Image",
            "type": "image",
            "value": "assets/themes/starter/img/Fred-hero.jpg"
        },
        {
            "fred-import": "background_settings"
        },
        {
            "name": "link",
            "label": "Link",
            "type": "page",
            "value": {
                "id": 1,
                "url": "[[~1]]"
            }
        }
    ]
}

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

  • modmore
  • STERC
  • Digital Penguin
  • Jens Wittmann – Gestaltung & Entwicklung
  • Fabian Christen
  • Dannevang Digital
  • Sepia River Studios
  • CrewMark
  • Chris Fickling
  • deJaya
  • eydolan
  • Following Sea
  • Lefthandmedia
  • Murray Wood
  • Anton Tarasov
  • Stéphane Jäggi
  • Raffy
  • Snow Creative
  • Nick Clark
  • A. Moreno
  • JT Skaggs
  • Helen
  • YJ
  • krisznet
  • Richard
  • Yanni

Budget

$311 per month—let's make that $500!

Learn more