CMS Overview

The Cms module turns Modularous into a multi-locale public site: content models get URL prefixes, published paths live in a registry, and presentation is composed from stylesheets → layout shells → per-model page layouts.

Enable the stack with modularous.cms_features.enabled (and related toggles under Configuration).

Building blocks

Piece	Role
ParentSegment	Per model class + locale: shared public URL prefix
UrlRoute	Flat registry of published paths (page_public, redirect_source)
StyleSheet	Compiled CSS (+ framework links)
LayoutBuilder	Reusable HTML document shell; attaches StyleSheet(s)
PageLayout	Locale-agnostic presentation binding per model class; points at a LayoutBuilder
Page / CMR models	Content (IsCmr = parent segment + page layout)
Redirect	From/to path rules; synced into UrlRoute
Sitemap	Built from page_public UrlRoute rows; served at /sitemap.xml

How a public page request flows

flowchart LR
  Req["GET path"] --> Sys["System routes\nrobots sitemap preview css"]
  Req --> Host["Host routes/web.php"]
  Req --> Catch["CMS catch-all\nCmsPublicFrontController"]
  Catch --> Redir["VisitorRedirectMiddleware"]
  Redir --> Resolve["CmsPublicModelResolver\nvia UrlRoute"]
  Resolve --> Render["CmsController presentation\nStyleSheet + LayoutBuilder + PageLayout"]

1. Built-in system routes and host routes/web.php run before the catch-all — see Public routing.
2. Remaining paths hit the CMS catch-all; redirects may fire before page resolve — Redirects.
3. UrlRoute + ParentSegment gate resolve the model — Parent segments & URL routes.
4. Presentation layers (bottom → top): Stylesheets → Layout builders → Page layouts.
   • Themes: cms.layout_builder.{slug}.* under resources/views/cms/layout_builder/{slug}/ (blade_view_name often NULL).
   • Per-route bodies: {module}::{route}.page_layout.* under modules/{Module}/Resources/views/{route}/page_layout/ (blade_view_name often NULL).

Relationship map

flowchart TB
  SS["StyleSheet\nCSS bundles"] --> LB["LayoutBuilder\nshell"]
  LB --> PL["PageLayout\nper model class"]
  Model["Page / CMR model"] --> PL
  Model --> UR["UrlRoute\nnormalized_path"]
  PS["ParentSegment\nprefix per locale"] --> UR
  Redir["Redirect"] --> UR
  UR --> Sitemap["Sitemap XML"]

• Presentation stack: StyleSheet → LayoutBuilder → PageLayout (read the guides in that order).
• URLs live on ParentSegment + UrlRoute (and Redirect) — separate from Blade shells.
• Do not put Blade shells on ParentSegment — that split is intentional.

Guide index

Topic	Page
Catch-all, host web.php, excludes	Public routing
Prefixes + UrlRoute registry	Parent segments & URL routes
CSS compile + public .css route	Stylesheets
Document shell + Blade sources	Layout builders
Per-model presentation binding	Page layouts
Visitor redirects	Redirects
/sitemap.xml + robots	Sitemap & SEO
modularous.cms_* keys	Configuration