Dash

The editing interface, mounted as ordinary pages.

Updated
On this page

What it is

The dash is an addon mounted by a page whose view is @dash, at a slug of your choosing. It has no routes outside the page tree: the tree, the editor, history, users and system views are pages with views, so permissions, overrides and :block fragments work on them as they do on your own pages.

Editing

The editor shows the fields of the page's view, each rendered by its fieldtype. Edits autosave as a draft, and the live preview beside the editor reloads in place, so you browse the real site while you edit. Save publishes the draft and commits it through History, so every save is a git commit and the History tab can restore any earlier one.

Roles

The built-in admin and guest roles ship with core. A site defines its own roles and sets who may open a page with the page's access setting. What an editor sees adapts to their role.

Customising

Views and field templates are looked up site first, so site/views/@dash/... replaces any dash template, and site/fields/@phlat/{name}/render.latte replaces how a field renders. An addon can add its own panels as children of the dash section, and the toolbar is built from the page tree, so it needs no list to maintain. Pinned pages are shortcuts to a page's editor in the dash nav: the pinned field on the dash root pins pages for every user, and each user pins their own from a page's actions menu.

The views, fields and fieldtypes the dash edits are hand-authored files in the site, not configured in the dash.