Creator: Mark Hamstra (markh)

Need help installing this extra?

About ContextRouter

For new sites, use XRouting instead. That has the same features, and then some.

ContextRouter is a simple plug-and-play plugin allowing you to use different contexts, and, based on the http_host context settings you need to set anyway, it routes your front-end requests as required.

In essence it's like the Gateway plugin from the docs, except you don't have to manually edit the plugin: it takes the settings you have already configured in your context and routes based on that. 

ContextRouter looks at your contexts' http_host as well as a comma separated http_host_aliases setting for routing based on a full domain or subdomain.

See the Documentation for more Information.


December 5, 2018

Supported Database
MySQL, SQL Server


Supported Versions
2.0 - Current



Install the plugin and make sure your contexts have a http_host variable set. If it doesn't seem to route properly, try clearing the cache to update the context - http_host caching.

New in 1.2.0-pl

ContextRouter 1.2.0-pl, December 5th 2018

  • Work around modContext ACLs to prevent sites from becoming inaccessible when a non-authorized user causes the cache to be cleared [#5]
  • Allow using OnMODXInit instead of OnHandleRequest event
  • Minor codes style tweaks
  • License updated to MIT instead of GPL v2

      ContextRouter 1.1.0-pl

      • (pl2) Fix unproperly prefixed system settings.
      • Big refactoring, now has a class handling the thinking.
      • #2 Added includeWww option (ON by default) which optionally also looks out for www.* hosts.
      • #3 Added support for http_host_aliases context setting, which allows different http_host values routing to one context.

      Current releases

      View | Download
      December 5, 2018
      2.0 - Current