# Brentwood — Client Documentation Coverage Map

**Purpose:** every client-facing custom feature built into the Brentwood College School
WordPress site, and which draft guide covers it. Drives the guide set in `guides/`.

**Audience:** the people who run the site day-to-day — Marketing/Communications (full editors),
department content owners (site editors), the blog manager, and teachers (own-profile only).

**Standard:** guides render inside wp-admin via `do_blocks()` with no theme, so guide bodies are
**core WordPress blocks only** + the house design kit (`bw-callout`, `bw-steps`, core `details`
tables). One guide per feature-area; one task per H2 heading, each phrased as the question a staff
member would actually ask. Verified against the live admin UI on this site (WordPress 7).

**Target for every guide:** `client:brentwood` (delivered to dev now, production after launch).

---

## 1. Custom content types (bespoke admin menus)

Each is a top-level admin menu with its own edit screen. Menu order in the sidebar is Staff (21) →
Livestreams (22) → Courses (23) → Brentwood 100 (24) → Landing Pages (24) → Careers (25).

| Feature | Menu label | What it is | Who edits | Guide |
|---|---|---|---|---|
| Staff profiles | **Staff** | One profile per faculty/staff member — name, photo, position, credentials, bio, department. Shown on faculty/section pages via the Team Modal / Instructors blocks. Teachers can be linked to their own profile to self-edit. | Marketing + teachers (own only) | `01-staff-profiles` |
| Courses | **Courses** | Course catalogue entries — flags for Advanced Placement / Elective, credit value, and Subject / Grade / Course-Category taxonomies. Displayed with the Course Table block. | Academic content owners | `02-courses` |
| Livestreams | **Livestreams** | Scheduled/archived YouTube livestreams — video ID, start date/time, length, "unlisted", "live only (no recording)". Listed via the Youtube List block. | Marketing / Comms | `03-livestreams` |
| Job postings | **Careers** | Open positions — an "Open message" line and an Apply-button link (email or URL). Displayed with the Brentwood Careers grid block. | HR / Marketing | `04-careers` |
| Brentwood 100 | **Brentwood 100** | Centenary mosaic items — badge number, tile style (Modal / Inline / Montage), tile span, caption, gallery. Rendered by the Brentwood 100 Grid block. | Marketing | `05-brentwood-100` |
| Landing pages | **Landing Pages** | Standalone campaign/landing pages, separate from the main Pages tree, with the same hero + block tools. | Marketing | `06-landing-pages` |

**Exact fields per type** are enumerated in each guide (read from `acf-json/group_bwm_*.json`).

---

## 2. Cross-cutting tools on every page & post

| Feature | Where | What it is | Guide |
|---|---|---|---|
| **Page Settings** panel | Edit screen of every page, post, staff, course, livestream, landing | The bespoke box that controls the **H1 title override**, the **hero** (7 types: Off, Home Video, Featured Image, Featured Gallery, Featured Carousel, Featured Video, Featured YouTube — each with focus/zoom/height controls), and the **footer background image**. This is the single most-used custom control. | `08-page-settings` |
| **Blog posts** | Posts | Standard posts plus a custom **Author** byline field (the name shown on the post, independent of the WordPress author), categories, hero (via Page Settings), and the Brentwood Blog listing block. | `07-blog-posts` |
| **Page SEO** | Yoast box on each edit screen | Per-page focus keyphrase, meta description, and social-share preview. (Global Yoast settings are intentionally hidden for editors — only the per-page box is exposed.) | `16-page-seo` |
| **Timetable** | **Timetable** admin page (ACF options page `timetable-management`) | Edits the interactive timetable: category panels (heading, body, images, "learn more" link) and the academic block-rotation table (day columns, period rows, block colours). | `09-timetable` |

---

## 3. The Brentwood block library (page-building blocks)

25 custom blocks ship in the child theme. The ones tied to a content type are documented **inside
that type's guide** (where the workflow makes sense). The general page-building blocks are split
across two block guides. Each block gets one addressable H2 ("How do I add …?"). Subagents verify
each block's real behaviour from `blocks/<name>/block.json` + `render.php` before writing.

**Documented within a content-type guide (not the block guides):**
- Brentwood Team Modal, Brentwood Instructors → `01-staff-profiles`
- Brentwood Course Table → `02-courses`
- Brentwood Youtube List → `03-livestreams`
- Brentwood Careers → `04-careers`
- Brentwood 100 Grid → `05-brentwood-100`
- Brentwood Blog → `07-blog-posts`

**Images & media blocks →** `10-blocks-images-media`:
Brentwood Images (card-gallery), Brentwood Image Gallery, Brentwood Hero Card,
Brentwood Hero (Manual) (video-hero), Brentwood Video Text, Brentwood Youtube List *(cross-ref)*.
*(**Brentwood Media Grid** (media-grid) is intentionally NOT documented — verified migration-generated
with no client-facing editor UI, so not genuinely insertable. Moved to the "no guide" list, §7.)*

**Content & layout blocks →** `11-blocks-content-layout`:
Brentwood FAQ Accordion, Brentwood Accordion (table-accordion), Brentwood Testimonial,
Brentwood Tagline Text, Brentwood Table Link, Brentwood Sub Page Link (page-links),
Brentwood Interlinking, Brentwood Curve Divider, Brentwood Calendar, Brentwood Search,
Brentwood Library Search.

> **Subagent note:** confirm each block is genuinely client-insertable. If any is a render-only
> helper, deprecated, or effectively internal, drop its section and record it in the "No guide"
> table below with the reason — don't invent a use for it.

---

## 4. Forms

| Feature | What it is | Guide |
|---|---|---|
| **Gravity Forms** | Two live forms — **Admissions Inquiries (migrated)** (id 1) and **Contact Information** (id 2). Covers viewing/exporting entries, notifications, and editing fields. | `12-forms` |

Kadence Forms and Kadence Queries exist in the stack but are **intentionally hidden** from editors
(the site standardised on Gravity Forms). → No guide (see §7).

---

## 5. Users, roles & access

| Feature | What it is | Guide |
|---|---|---|
| **Users & roles** | The custom role model: **Editor** (= administrator without the clutter — can also add/manage users), **Site Editor** (create/publish only their own content), **Blog Manager** (all blog posts), **Author** (blog posts only, own drafts), **Teacher** (own staff profile only), Subscriber. Adding users, changing roles, deactivating — plus the built-in guardrails (non-admins can't create or touch administrators). | `13-users-roles` |
| **Signing in** | Sign in with a Brentwood Google account (Workspace SSO, `@brentwood.ca` only), password fallback, and getting back in if locked out. | `14-signing-in` |
| **Your own staff profile** (teachers) | The teacher self-service flow: log in → land on your own staff profile editor → nothing else. What a teacher can change and how they save. | `15-your-staff-profile` |

---

## 6. Site structure

| Feature | What it is | Guide |
|---|---|---|
| **Site menus** (mega-menus, header, footer) | Built as Kadence **Elements** (Header: Inner Subnav; Footer; nine Mega Menus — Why Brentwood, Admissions, Student Life, Academics, Athletics, Arts, Brentwood Family, Giving, Regatta). Editors can update menu links/labels. Kept practical — everyday link edits, not structural rebuilds (advanced). | `17-site-menus` |
| **Redirects** | The Redirection plugin (editors have access) — point old/broken URLs at the right page after the migration. | `18-redirects` *(short, advanced)* |

---

## 7. Internal / dev-only — **NO GUIDE** (deliberately excluded)

Not client-facing; documented here only so the exclusion is a decision, not an oversight.

| Item | Why no guide |
|---|---|
| WP Engine mu-plugin neutralization (`bw-wpe-*`, drop-in disabling) | Under-the-hood migration compatibility; no client control surface. |
| Footer readability gradient / "red line" removal | Automatic theme CSS behaviour; nothing to edit. |
| Editor customizer-CSS stripping, title-override ACF↔meta bridge | Internal plumbing (the H1 override **field** is covered in `08-page-settings`). |
| `migration/`, `_imp_hero/`, retina-backup, build/import scripts | Dev-only migration tooling. |
| `bw-dev` tooling | Developer tooling. |
| **bw-lead-ai** plugin | Separate product, being configured separately — out of scope for this client-features doc set. |
| Kadence Blocks / Forms / Queries, Kadence element internals beyond menu edits | Kadence Forms/Queries are hidden from editors by design; generic Kadence block usage is vendor documentation, not a bespoke Brentwood feature. |
| Custom SVGs, Lottie, Vector, Custom Icons (Kadence asset CPTs) | Design-asset plumbing; not part of day-to-day content editing. |

---

## Draft guide index

| # | File | Title (working) | Priority |
|---|---|---|---|
| 00 | `00-getting-started.html` | Getting started with your Brentwood website | high |
| 01 | `01-staff-profiles.html` | Managing staff profiles | high |
| 02 | `02-courses.html` | Managing courses | high |
| 03 | `03-livestreams.html` | Managing livestreams | med |
| 04 | `04-careers.html` | Posting jobs (Careers) | med |
| 05 | `05-brentwood-100.html` | Managing the Brentwood 100 | med |
| 06 | `06-landing-pages.html` | Building landing pages | med |
| 07 | `07-blog-posts.html` | Writing & publishing blog posts | high |
| 08 | `08-page-settings.html` | Page settings: titles, heroes & footer image | high |
| 09 | `09-timetable.html` | Editing the timetable | med |
| 10 | `10-blocks-images-media.html` | Adding images & video (Brentwood blocks) | high |
| 11 | `11-blocks-content-layout.html` | Adding content blocks (Brentwood blocks) | high |
| 12 | `12-forms.html` | Managing forms & inquiries | high |
| 13 | `13-users-roles.html` | Managing users & roles | high |
| 14 | `14-signing-in.html` | Signing in | med |
| 15 | `15-your-staff-profile.html` | Updating your own staff profile (teachers) | med |
| 16 | `16-page-seo.html` | Managing page SEO | med |
| 17 | `17-site-menus.html` | Editing the site menus | low/advanced |
| 18 | `18-redirects.html` | Fixing broken links with redirects | low/advanced |
| 19 | `19-blocks-at-a-glance.html` | Brentwood blocks at a glance | high |

**Companion files:** `SHOTS.md` (screenshot manifest, assembled from each guide's inline
`BWG-SHOT` markers) and `KEYWORDS.md` (per-heading hidden search keywords).