# Brentwood Dev — Adi's work log, 15 June 2026

For Rian — summary of today's changes on brentwooddev (written by Claude on
Adi's behalf). Everything is live on https://brentwooddev.demoing.info and all
custom code is in the **kadence-child theme** — your **bw-dev plugin was not
modified** (the one new tie-in to it is described in §2 and done entirely from
the theme).

Today was mostly about the **hero card** and **hero media** controls, plus one
bigger structural decision (§1) that I'd like you to sign off on.

## 1. Hero text card is now BLOCK-ONLY (please review)

We were authoring hero text two ways — the **"Hero card text"** ACF field +
**"Show hero card"** toggle in the Page Hero box, *and* the **Brentwood Hero
Card block**. Two doors to one thing confused editing, so per Adi's call we
consolidated to the **block only**:

- Removed the **"Hero card text"** and **"Show hero card"** fields from the
  Page Hero box. (Their stored data was left in the database, not deleted.)
- The page template now renders the hero **media only**; the white text card
  comes from the **Brentwood Hero Card block** placed first in the content.
- **New pages are auto-seeded** with an empty Hero Card block, ready to fill
  in (headings, buttons, tables, links — any block). Pages that don't want a
  card just delete the block and build with Kadence rows.

**Impact to be aware of:** ~**100 existing pages** previously got their card
(and their H1) from the old automatic card. They now show **media only, no
card / no H1** until someone adds a Hero Card block by hand. That's intentional
— Adi wants cards added by a human (they need real formatting), not
auto-generated — and we **deferred the H1 question** for now (a later
improvement will detect pages with no heading and supply one).

- **4 pages still have leftover "Hero card text"** to re-add by hand: **Home
  (859)** — already has a block, nothing lost; **Application Process (912)**,
  **Arts (865)**, **Campus (1042)**. The old text is still in the DB for
  reference if you want it.
- Code: `inc/brentwood-hero.php` (auto-card removed), `inc/brentwood-blocks.php`
  (new-page seeding), `acf-json/group_bwm_page_hero.json` (fields removed).

## 2. "Page Title Override" is now editable inside the Hero Card block

The card's H1 **is** your BW Dev *Page Title Override* — now editable right on
the card, labelled "Page title override". It's a **second door** to the same
value:

- Edit the H1 on the card → your **Page Title Override box updates**, and
  vice-versa (they stay in sync; saving from either side writes the same value,
  no clobber).
- Blank = falls back to the page title (shown as a placeholder).
- Done entirely from the child theme (block editor JS + a sanitised REST
  binding to the existing `_bw_dev_title_override` meta). The bw-dev plugin
  file was not touched.

**⚠️ Heads-up / decision needed:** this deepens our use of the bw-dev Title
Override module — which is in tension with **meeting item #2 below** (move the
overrides into Yoast SEO titles and *disable* the bw-dev module). If we still
plan to retire that module, this "edit in the block" convenience would need a
different home. Worth a quick decision before we go further either way.

## 3. Hero Gallery — per-image focus + zoom; "Dual Image" retired

- Each gallery image now has its own **focus point (drag-the-dot) + zoom**,
  same control as the carousel — useful for aiming at faces/subjects.
- Removed the **"Featured Dual Image"** hero type. A **2-column Featured
  Gallery** gives the identical side-by-side look with less duplication, so the
  extra option was just confusing (0 pages were using Dual). Existing gallery
  pages were migrated to the new per-image format automatically.

## 4. Carousel — selectable slider height

- New **"Carousel height"** setting: presets **320 / 380 / 440 / 490 / 560 /
  768 px**, plus **Custom…** for any value. Default stays **380px** (so nothing
  changed on existing carousels). Mobile scales down proportionally.
- This matches the live site, where most carousels are 380px but a few (e.g.
  /clubs/brain/brain-media) are taller (~490px).

## 5. Hero Card "dash" (the grey separator)

- Saved the live site's **dash.svg** into the theme (`assets/dash.svg`) and the
  block now uses it, with a **Left / Center / Right alignment** option.
- Default is now **left**, matching brentwood.ca (it had been centered).

## 6. Earlier today — carousel + focus polish

- Carousel now has **dot indicators + a bottom timer bar** showing time to the
  next slide, like the live site.
- Added the **visual focus-point picker** (drag a dot on an image preview) for
  carousel slides and the Featured Image hero, with the admin preview shown at
  the real front-end crop ratio.

## Still pending (carried from the 12 June meeting agenda)

1. **Delete** the brentwood-migration plugin files (one command when approved).
2. **Copy the ~127 Laravel title overrides into Yoast SEO titles + disable the
   bw-dev Title Override module.** → See the ⚠️ in §2 — this now interacts with
   today's "edit override in the block" work; needs a decision.
3. **H1 on non-hero pages** — partially settled today: we went block-only and
   deferred automatic H1 handling to a later "no-heading detection" improvement.

— Adi (assembled by Claude, 2026-06-15)