Usage

Usage

The flow

Pages in the panel nav → a page row → its settings → Edit page content → the builder, full screen in a new tab.

Settings and content are deliberately separate screens. Slug and SEO are things you set once; content is what you come back to.

Page settings

• Title. Internal name, and the fallback for the meta title.
• A tab per locale, each holding:
  • Slug. Leave empty to generate one from the title.
  • Meta title and meta description.
  • Social share image. 1200 by 630 is the safe size.
  • Hide from search engines, which adds noindex and drops the URL from the sitemap.
  • Tell search engines not to follow its links, independent of the above.
  • Canonical URL. Empty means the page's own URL.

Above the tabs, page-wide: the title, and a Layout dropdown when layouts are registered. Both are shared across locales, because a layout is structure and the title is an internal name. See SEO for what each field does to the page.

Header buttons: Edit page content, View live (published pages only), Publish, Unpublish (published pages only) and Delete.

The builder

Full screen, outside the panel chrome.

Left rail switches between the section list and the inspector.

Sidebar shows one of two things:

• The section list: every section, labelled by its own heading rather than "Block 4". Hover a row for move up, move down and settings. Add section at the bottom opens the picker, grouped by category.
• The inspector for the selected section: its fields, with move, duplicate, hide, delete in the header and a back chevron to the list.

Middle is the live preview. It renders the real page through the public layout and the public stylesheet, so it is not an approximation. Click a section in the preview to select it.

Toolbar:

• Back arrow to the Pages list
• Status badge: Draft, Published, or Published with unpublished changes
• Desktop, tablet and mobile widths, at fixed sizes rather than whatever the pane happens to be
• Locale switcher
• Open the preview in a new tab, as a signed link that expires
• Publish

Draft and published

Editing writes the draft, always. The live page reads a separate column and cannot change until you press Publish. An unpublished page 404s on the public site, so a half-finished page can't leak.

Hiding a section keeps it in the editor and removes it from the public page. It's the reversible alternative to deleting.

Publishing also snapshots the tree into a revision, and the toolbar's share link opens the draft for someone with no panel login. Publishing covers both, plus unpublishing and restoring.

Layouts

A page can be wrapped in whichever shell suits it: a navbar and footer for marketing, a sidebar for documentation. Register them in the panel provider and the client picks one from a Layout dropdown in page settings, which hides itself when no layouts are registered. See Layouts.

Writing your own block

One PHP class and one Blade view, registered in your panel provider. Nothing inside the plugin changes.

Blocks covers the contract, a worked example, the shared controls a block can opt into, what the view receives, and the five things that bite people.

The blocks that ship

Hero, features, rich text, image, gallery, logo wall, testimonials, FAQ and call to action. DefaultBlocks::all() registers all nine; pass a subset to cherry-pick. Details and notes per block are on Blocks.

Working on the package itself

Only if you're changing Atelier, not when consuming it:

npm run build                    # rebuild the editor's own stylesheet
cd example && php artisan filament:assets

The editor's utilities ship compiled in resources/dist/atelier.css and are registered through FilamentAsset, so consumers never run a build.