dropbits Documentation

Layout compose

Each section has a small Layout handle. Arming Layout on a widget shows that widget’s sticky bar only (exclusive with Content on the same or another widget — one arm at a time). Region + is available whenever you are logged in with edit chrome — including empty pages with no widgets yet.

You rearrange widgets in page content regions only — header, global nav, and other site chrome are not drag targets.

Widget types (common)

TypeUse for
HeroTitle / subtitle over a photo or slideshow — landing tops.
RichtextBody copy, headings, links, embedded images.
ListingRows from an entity (articles, events, …) — not a handmade grid of pages.
Navigation (Cards)In-page link tiles to other pages. Same Navigation widget as the header menu, with template Cards — pick pages in the tree; not a listing of records and not pasted HTML.

Pack types (contact, …) appear in + after you enable the pack.

Add a block

  1. In a region, click + (empty regions show a short label: Hero / Left / Main / Right).
  2. Pick a type.
  3. For Listing, choose an entity from the site list.
  4. Arm Content on that section to fill fields.

Reorder / move / remove

On a Layout-armed section bar:

  • ↑ / ↓ — reorder within the region
  • Region — move to another page region
  • Bleed — full-bleed when the theme supports it
  • ✕ — remove from the page (confirm)
  • Done — disarm Layout (also: second click on ⊞, or Esc)

Locked page parts show a lock affordance and disable destructive moves.

Listing bar (Template / Filter / Fields)

Arm ⊞ on a listing. Controls that apply to this widget only (except schema):

ControlWhat it does
TemplateHow the list looks (cards / table / default, etc.).
Sort / Guest sortDefault sort; whether guests can change sort.
PagePage length for a guest pager.
SearchGuest search box (?q=).
DetailLink each row to a detail page; optional Detail page slug and Detail tpl.
CTALabel for the detail link when used.
FilterWhich rows this listing shows (field conditions). Does not change other listings.
FieldsWhich entity fields appear in the list (and on detail when Detail is on). Does not change the entity schema.
Edit schemaOpens the site-wide entity schema (same as Hub → Entities).

Create / edit rows: Entities & records.

Richtext bar

With ✎ on a richtext section:

ControlWhat it does
SavePersist the field.
DoneFinish editing this section (disarm Content).
CancelDiscard changes to this field only.
Insert imageEmbed from the media picker.
ClassApply a theme CSS class to the selection.

Links and text selection stay usable until you arm ✎. Prefer theme classes over pasting layout HTML.

Header menu and footer (when the theme wires them as Navigation) use the same Content-handle tree editor as the main nav — not a hub slide. See Pages & navigation.

See also