Contexts

Skip to end of metadata
Go to start of metadata


Contexts allow MODx configuration settings to be overridden, extended, isolated, or shared across domains, sub-domains, sub-sites, multi-sites, cultural-specific sections, specific web applications, etc.

You can easily create a context from the Contexts menu under Tools. The context will then show up in your resource tree. Resources can easily be dragged between contexts to move them from one context to another.

Note: there's nothing fundamentally different about resources in different contexts, except that they now inherit the configuration settings of the context they are in. So, if you create a new context, you'll have to override the context settings in the context for any real, distinguishable change to appear.

Creating a Context

First, go to the Contexts page, via System -> Contexts. Then, click on "Create New" in the grid. This will prompt you for a key and description. From there, right-click on your newly-created context, and click "Update Context".

This will bring you to a screen displaying the Context, and an empty grid of settings. From here you can add Context-specific settings that will override any System Settings. Your new context will be completely empty, requiring you to include any and all settings you will be using.

Note that new contexts don't automatically get "load" permission for Anonymous users in 2.2+ - you'll need to add that in manually.

When you create a new context besides the default "web" context, you may need to apply context settings to the web context as well.

Context Settings

You can create settings for any defined context by clicking on System -> Contexts, then right-click any context and select "Update Context".

Each context can have its own settings that override or extend the System Settings. Contextual settings can in turn be overridden or extended by User Settings. The hierarchy to remember is this:

System Setting -> Context Setting -> User Setting

See Also

Labels

context context Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.