Compare commits
43
Commits
bd035501b7
..
main
| Author | SHA1 | Date | |
|---|---|---|---|
 Keith Solomon
|
06e09e8285 | ||
|
Keith Solomon
|
01072f6788 | ||
|
Keith Solomon
|
842818ec7e | ||
|
Keith Solomon
|
7c1c145846 | ||
|
Keith Solomon
|
aabed2b437 | ||
|
Keith Solomon
|
e5301f34c4 | ||
|
Keith Solomon
|
18dde4c9f4 | ||
|
Keith Solomon
|
1c5c727691 | ||
|
Keith Solomon
|
3a07eb384f | ||
|
Keith Solomon
|
cb883ca869 | ||
|
Keith Solomon
|
3c786ee9d9 | ||
|
Keith Solomon
|
c20510814e | ||
|
Keith Solomon
|
a816e56cfa | ||
|
Keith Solomon
|
c1ac1d659b | ||
|
Keith Solomon
|
379dee3ea6 | ||
|
Keith Solomon
|
54d79cdcdf | ||
|
Keith Solomon
|
619409eabb | ||
|
Keith Solomon
|
e7de88551d | ||
|
Keith Solomon
|
f8247ff7af | ||
|
Keith Solomon
|
2441cef539 | ||
|
Keith Solomon
|
75055e6f6e | ||
|
Keith Solomon
|
63df8e9a88 | ||
|
Keith Solomon
|
704b0dc266 | ||
|
Keith Solomon
|
b7477306d8 | ||
|
Keith Solomon
|
02a8379de2 | ||
|
Keith Solomon
|
f0b5bf75a5 | ||
|
Keith Solomon
|
60d764045f | ||
|
Keith Solomon
|
9c4553f3d0 | ||
|
Keith Solomon
|
b0bad0d273 | ||
|
Keith Solomon
|
9c3a645368 | ||
|
Keith Solomon
|
d2b2a04b56 | ||
|
Keith Solomon
|
7663ca63f6 | ||
|
Keith Solomon
|
415934e0bf | ||
 Keith SolomonandClaude
|
dae3e7fd68 | ||
|
Keith SolomonandClaude
|
2c917edf20 | ||
|
Keith Solomon
|
0be6800d88 | ||
|
Keith Solomon
|
61f959e1a2 | ||
|
Keith Solomon
|
a13a3adeef | ||
|
Keith Solomon
|
8c52946340 | ||
|
Keith Solomon
|
a628973ed8 | ||
|
Keith Solomon
|
b32abfb8f6 | ||
|
Keith Solomon
|
07fea9e57b | ||
|
Keith Solomon
|
c8832f49b2 |
@@ -0,0 +1,123 @@
|
|||||||
|
{
|
||||||
|
"key": "group_services_list",
|
||||||
|
"title": "Services List",
|
||||||
|
"fields": [
|
||||||
|
{
|
||||||
|
"key": "field_services_items",
|
||||||
|
"label": "Items",
|
||||||
|
"name": "items",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "repeater",
|
||||||
|
"instructions": "Add 2, 3, or 4 cards. The grid layout adapts to the count.",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"layout": "block",
|
||||||
|
"pagination": 0,
|
||||||
|
"min": 0,
|
||||||
|
"max": 0,
|
||||||
|
"collapsed": "",
|
||||||
|
"button_label": "Add Service",
|
||||||
|
"rows_per_page": 20,
|
||||||
|
"sub_fields": [
|
||||||
|
{
|
||||||
|
"key": "field_services_item_image",
|
||||||
|
"label": "Image",
|
||||||
|
"name": "image",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "image",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"return_format": "array",
|
||||||
|
"library": "all",
|
||||||
|
"min_width": "",
|
||||||
|
"min_height": "",
|
||||||
|
"min_size": "",
|
||||||
|
"max_width": "",
|
||||||
|
"max_height": "",
|
||||||
|
"max_size": "",
|
||||||
|
"mime_types": "",
|
||||||
|
"allow_in_bindings": 0,
|
||||||
|
"preview_size": "medium",
|
||||||
|
"parent_repeater": "field_services_items"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "field_services_item_heading",
|
||||||
|
"label": "Heading",
|
||||||
|
"name": "heading",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "text",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"default_value": "",
|
||||||
|
"maxlength": "",
|
||||||
|
"allow_in_bindings": 0,
|
||||||
|
"placeholder": "",
|
||||||
|
"prepend": "",
|
||||||
|
"append": "",
|
||||||
|
"parent_repeater": "field_services_items"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "field_services_item_description",
|
||||||
|
"label": "Description",
|
||||||
|
"name": "description",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "wysiwyg",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"default_value": "",
|
||||||
|
"allow_in_bindings": 0,
|
||||||
|
"tabs": "all",
|
||||||
|
"toolbar": "full",
|
||||||
|
"media_upload": 1,
|
||||||
|
"delay": 0,
|
||||||
|
"parent_repeater": "field_services_items"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"location": [
|
||||||
|
[
|
||||||
|
{
|
||||||
|
"param": "block",
|
||||||
|
"operator": "==",
|
||||||
|
"value": "acf\/services-list"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"menu_order": 0,
|
||||||
|
"position": "normal",
|
||||||
|
"style": "default",
|
||||||
|
"label_placement": "top",
|
||||||
|
"instruction_placement": "label",
|
||||||
|
"hide_on_screen": "",
|
||||||
|
"active": true,
|
||||||
|
"description": "Service cards row. Card count (2-4) determines the layout.",
|
||||||
|
"show_in_rest": 0,
|
||||||
|
"display_title": "",
|
||||||
|
"allow_ai_access": false,
|
||||||
|
"ai_description": "",
|
||||||
|
"modified": 1784992250
|
||||||
|
}
|
||||||
@@ -0,0 +1,166 @@
|
|||||||
|
{
|
||||||
|
"key": "group_team_grid",
|
||||||
|
"title": "Team Grid",
|
||||||
|
"fields": [
|
||||||
|
{
|
||||||
|
"key": "field_6a650dee2a34c",
|
||||||
|
"label": "Single Open Mode",
|
||||||
|
"name": "single",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "true_false",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"message": "Check to allow only one bio open at a time",
|
||||||
|
"default_value": 0,
|
||||||
|
"allow_in_bindings": 0,
|
||||||
|
"ui": 0,
|
||||||
|
"ui_on_text": "",
|
||||||
|
"ui_off_text": ""
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "field_team_grid_members",
|
||||||
|
"label": "Members",
|
||||||
|
"name": "members",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "repeater",
|
||||||
|
"instructions": "Add team members. Click a card to expand the bio.",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"layout": "block",
|
||||||
|
"pagination": 0,
|
||||||
|
"min": 0,
|
||||||
|
"max": 0,
|
||||||
|
"collapsed": "",
|
||||||
|
"button_label": "Add Team Member",
|
||||||
|
"rows_per_page": 20,
|
||||||
|
"sub_fields": [
|
||||||
|
{
|
||||||
|
"key": "field_team_grid_member_image",
|
||||||
|
"label": "Image",
|
||||||
|
"name": "image",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "image",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"return_format": "array",
|
||||||
|
"library": "all",
|
||||||
|
"min_width": "",
|
||||||
|
"min_height": "",
|
||||||
|
"min_size": "",
|
||||||
|
"max_width": "",
|
||||||
|
"max_height": "",
|
||||||
|
"max_size": "",
|
||||||
|
"mime_types": "",
|
||||||
|
"allow_in_bindings": 0,
|
||||||
|
"preview_size": "medium",
|
||||||
|
"parent_repeater": "field_team_grid_members"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "field_team_grid_member_name",
|
||||||
|
"label": "Name",
|
||||||
|
"name": "name",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "text",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"default_value": "",
|
||||||
|
"maxlength": "",
|
||||||
|
"allow_in_bindings": 0,
|
||||||
|
"placeholder": "",
|
||||||
|
"prepend": "",
|
||||||
|
"append": "",
|
||||||
|
"parent_repeater": "field_team_grid_members"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "field_team_grid_member_title",
|
||||||
|
"label": "Title",
|
||||||
|
"name": "title",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "text",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"default_value": "",
|
||||||
|
"maxlength": "",
|
||||||
|
"allow_in_bindings": 0,
|
||||||
|
"placeholder": "",
|
||||||
|
"prepend": "",
|
||||||
|
"append": "",
|
||||||
|
"parent_repeater": "field_team_grid_members"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "field_team_grid_member_bio",
|
||||||
|
"label": "Bio",
|
||||||
|
"name": "bio",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "wysiwyg",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"default_value": "",
|
||||||
|
"tabs": "visual",
|
||||||
|
"toolbar": "basic",
|
||||||
|
"media_upload": 0,
|
||||||
|
"delay": 0,
|
||||||
|
"allow_in_bindings": 0,
|
||||||
|
"parent_repeater": "field_team_grid_members"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"location": [
|
||||||
|
[
|
||||||
|
{
|
||||||
|
"param": "block",
|
||||||
|
"operator": "==",
|
||||||
|
"value": "acf\/team-grid"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"menu_order": 0,
|
||||||
|
"position": "normal",
|
||||||
|
"style": "default",
|
||||||
|
"label_placement": "top",
|
||||||
|
"instruction_placement": "label",
|
||||||
|
"hide_on_screen": "",
|
||||||
|
"active": true,
|
||||||
|
"description": "Team grid block. Each member is a card with photo, name, title, and a collapsible bio.",
|
||||||
|
"show_in_rest": 0,
|
||||||
|
"display_title": "",
|
||||||
|
"allow_ai_access": false,
|
||||||
|
"ai_description": "",
|
||||||
|
"modified": 1785007821
|
||||||
|
}
|
||||||
@@ -0,0 +1,626 @@
|
|||||||
|
# Services Content Blocks Implementation Plan
|
||||||
|
|
||||||
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||||
|
|
||||||
|
**Goal:** Build the missing content-area components for the Mapping services page (and any other service sub-page), matching `Mapping-Services.png`. The hero, header, and footer are already in place and must not be touched.
|
||||||
|
|
||||||
|
**Architecture:** One new ACF block (`services-list`) that renders a row of cards. Card count is editor-driven (2, 3, or 4); card size and grid layout adapt to the count. The orange horizontal line that bisects the images is rendered by the block itself as a full-bleed SVG background. The closing "At CWC, mapping is about more than data…" block reuses the existing `pull-quote` block — no new build needed. Editor composes the page in Gutenberg by adding `Services List` and `Pull Quote` blocks to any service sub-page; `page.php` already calls `the_content()`, so no template change is required.
|
||||||
|
|
||||||
|
**Tech Stack:** WordPress 6.x, PHP 8.x, Tailwind CSS v4, Playwright, axe-core, PHPCS (WordPress standard).
|
||||||
|
|
||||||
|
## Global Constraints
|
||||||
|
|
||||||
|
- Tabs for PHP indentation (project standard).
|
||||||
|
- `static/dist/theme.css` is committed (not gitignored) per project convention.
|
||||||
|
- PHPCS uses the WordPress coding standard; `composer lint` must pass for all touched files.
|
||||||
|
- All design colors use the project's existing CSS custom properties from `styles/base/colors.css`. No hardcoded hex values for theme colors.
|
||||||
|
- Reuse the existing post-title accent pattern (blue heading + orange `::after` underline from `.post-title h1` in `styles/base/misc.css`) for consistency. Do not introduce a new accent style.
|
||||||
|
- Reuse the existing `pull-quote` block for the closing statement — no duplicate block.
|
||||||
|
- Page template `page.php` is not modified. The page-children block is not used.
|
||||||
|
- This work does **not** edit `header.php`, `footer.php`, `views/partials/page-hero.php`, or `views/partials/page-hero-services.php`.
|
||||||
|
- Tailwind v4 picks up class names from source files at build time. The dynamic `lg:grid-cols-N` class needs to literally appear in the source PHP for Tailwind to emit the rule.
|
||||||
|
- The `static/img/services-list-line.svg` is a fixed asset; do not make it editor-uploadable.
|
||||||
|
- All commits follow the project's emoji-prefixed commit-message style (e.g. `✨ feat: …`).
|
||||||
|
|
||||||
|
## File Structure
|
||||||
|
|
||||||
|
| File | Responsibility | Created/Modified |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `views/blocks/services-list/services-list.php` | Block template (PHP) — renders the row of cards. | Create |
|
||||||
|
| `views/blocks/services-list/services-list.css` | Block styles (CSS) — layout, headings, bisecting line. | Create |
|
||||||
|
| `views/blocks/services-list/block.json` | Block registration metadata (name, category, icon, render template). | Create |
|
||||||
|
| `acf/group_services_list.json` | ACF field group for the `acf/services-list` block. | Create |
|
||||||
|
| `static/img/services-list-line.svg` | Decorative orange horizontal line SVG that bisects the images. | Create |
|
||||||
|
| `styles/blocks/index.css` | Import the new block's CSS. | Modify |
|
||||||
|
| `tests/services-page.spec.js` | Playwright tests for the rendered block. | Create |
|
||||||
|
| `static/dist/theme.css` | Rebuilt via `npm run build`. | Modified |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 1: ACF Field Group
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `acf/group_services_list.json`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Produces: ACF group with `key: "group_services_list"`, location scoped to `block == acf/services-list`, fields: `items` (repeater) → `image`, `heading`, `description`.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Create the ACF field group JSON file**
|
||||||
|
|
||||||
|
Create the file `acf/group_services_list.json` with the following exact content:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"key": "group_services_list",
|
||||||
|
"title": "Services List",
|
||||||
|
"fields": [
|
||||||
|
{
|
||||||
|
"key": "field_services_items",
|
||||||
|
"label": "Items",
|
||||||
|
"name": "items",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "repeater",
|
||||||
|
"instructions": "Add 2, 3, or 4 cards. The grid layout adapts to the count.",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"layout": "block",
|
||||||
|
"pagination": 0,
|
||||||
|
"min": 0,
|
||||||
|
"max": 0,
|
||||||
|
"collapsed": "",
|
||||||
|
"button_label": "Add Service",
|
||||||
|
"rows_per_page": 20,
|
||||||
|
"sub_fields": [
|
||||||
|
{
|
||||||
|
"key": "field_services_item_image",
|
||||||
|
"label": "Image",
|
||||||
|
"name": "image",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "image",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"return_format": "array",
|
||||||
|
"library": "all",
|
||||||
|
"min_width": "",
|
||||||
|
"min_height": "",
|
||||||
|
"min_size": "",
|
||||||
|
"max_width": "",
|
||||||
|
"max_height": "",
|
||||||
|
"max_size": "",
|
||||||
|
"mime_types": "",
|
||||||
|
"allow_in_bindings": 0,
|
||||||
|
"preview_size": "medium"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "field_services_item_heading",
|
||||||
|
"label": "Heading",
|
||||||
|
"name": "heading",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "text",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"default_value": "",
|
||||||
|
"maxlength": "",
|
||||||
|
"allow_in_bindings": 0,
|
||||||
|
"placeholder": "",
|
||||||
|
"prepend": "",
|
||||||
|
"append": ""
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "field_services_item_description",
|
||||||
|
"label": "Description",
|
||||||
|
"name": "description",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "textarea",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"default_value": "",
|
||||||
|
"placeholder": "",
|
||||||
|
"maxlength": "",
|
||||||
|
"rows": 4,
|
||||||
|
"new_lines": ""
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"location": [
|
||||||
|
[
|
||||||
|
{
|
||||||
|
"param": "block",
|
||||||
|
"operator": "==",
|
||||||
|
"value": "acf/services-list"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"menu_order": 0,
|
||||||
|
"position": "normal",
|
||||||
|
"style": "default",
|
||||||
|
"label_placement": "top",
|
||||||
|
"instruction_placement": "label",
|
||||||
|
"hide_on_screen": "",
|
||||||
|
"active": true,
|
||||||
|
"description": "Service cards row. Card count (2-4) determines the layout.",
|
||||||
|
"show_in_rest": 0,
|
||||||
|
"display_title": "",
|
||||||
|
"allow_ai_access": false,
|
||||||
|
"ai_description": "",
|
||||||
|
"modified": 1753305600
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2: Verify the JSON parses**
|
||||||
|
|
||||||
|
Run: `node -e "JSON.parse(require('fs').readFileSync('acf/group_services_list.json','utf8')); console.log('OK')"`
|
||||||
|
Expected: prints `OK` and exits 0.
|
||||||
|
|
||||||
|
- [ ] **Step 3: Commit**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add acf/group_services_list.json
|
||||||
|
git commit -m "✨ feat: Add ACF field group for services-list block"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 2: Decorative SVG Asset
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `static/img/services-list-line.svg`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Produces: A 1600×8 viewBox SVG with a 2px-tall orange `#F26B53` rectangle, `preserveAspectRatio="none"`. Reference URL: `/wp-content/themes/community-works-collaborative/static/img/services-list-line.svg`.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Create the SVG asset**
|
||||||
|
|
||||||
|
Create the file `static/img/services-list-line.svg` with the following exact content:
|
||||||
|
|
||||||
|
```svg
|
||||||
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1600 8" preserveAspectRatio="none">
|
||||||
|
<rect x="0" y="3" width="1600" height="2" fill="#F26B53" />
|
||||||
|
</svg>
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2: Verify the SVG is well-formed**
|
||||||
|
|
||||||
|
Run: `node -e "const fs=require('fs'); const s=fs.readFileSync('static/img/services-list-line.svg','utf8'); if(!s.includes('viewBox=\"0 0 1600 8\"')||!s.includes('fill=\"#F26B53\"')) { process.exit(1); } console.log('OK')"`
|
||||||
|
Expected: prints `OK` and exits 0.
|
||||||
|
|
||||||
|
- [ ] **Step 3: Commit**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add static/img/services-list-line.svg
|
||||||
|
git commit -m "✨ feat: Add services-list decorative line SVG"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 3: Block Registration JSON
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `views/blocks/services-list/block.json`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Produces: `block.json` declaring `acf/services-list` as the block name, `services-list.php` as the render template, `grid-view` icon, `common` category. `regACFBlocks()` in `functions.php` will pick this up automatically — no PHP registration code change required.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Create the block.json file**
|
||||||
|
|
||||||
|
Create the file `views/blocks/services-list/block.json` with the following exact content:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "acf/services-list",
|
||||||
|
"title": "Services List",
|
||||||
|
"description": "A row of service cards. Card count (2, 3, or 4) determines the layout.",
|
||||||
|
"category": "common",
|
||||||
|
"icon": "grid-view",
|
||||||
|
"keywords": ["services", "cards", "mapping"],
|
||||||
|
"acf": {
|
||||||
|
"mode": "preview",
|
||||||
|
"renderTemplate": "services-list.php"
|
||||||
|
},
|
||||||
|
"supports": {
|
||||||
|
"anchor": true,
|
||||||
|
"align": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2: Verify the JSON parses**
|
||||||
|
|
||||||
|
Run: `node -e "JSON.parse(require('fs').readFileSync('views/blocks/services-list/block.json','utf8')); console.log('OK')"`
|
||||||
|
Expected: prints `OK` and exits 0.
|
||||||
|
|
||||||
|
- [ ] **Step 3: Commit**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add views/blocks/services-list/block.json
|
||||||
|
git commit -m "✨ feat: Add services-list block.json registration"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 4: Block CSS
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `views/blocks/services-list/services-list.css`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Produces: BEM-styled CSS for `.services-list`, `__line`, `__grid`, `__card`, `__media`, `__heading`, `__desc`. Reuses `text-cwc-blue-01` and `var(--color-secondary)` from existing tokens. Renders the bisecting line via `background-image: url('/wp-content/themes/community-works-collaborative/static/img/services-list-line.svg')`.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Create the block CSS file**
|
||||||
|
|
||||||
|
Create the file `views/blocks/services-list/services-list.css` with the following exact content:
|
||||||
|
|
||||||
|
```css
|
||||||
|
/* Services List block */
|
||||||
|
|
||||||
|
.services-list {
|
||||||
|
--services-line-top: 25%;
|
||||||
|
|
||||||
|
&__line {
|
||||||
|
position: absolute;
|
||||||
|
inset-inline: 0;
|
||||||
|
top: var(--services-line-top);
|
||||||
|
height: 8px;
|
||||||
|
pointer-events: none;
|
||||||
|
z-index: 1;
|
||||||
|
background-image: url('/wp-content/themes/community-works-collaborative/static/img/services-list-line.svg');
|
||||||
|
background-repeat: no-repeat;
|
||||||
|
background-position: center center;
|
||||||
|
background-size: 100% 100%;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__grid {
|
||||||
|
position: relative;
|
||||||
|
z-index: 2;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__card {
|
||||||
|
@apply flex flex-col;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__media {
|
||||||
|
@apply overflow-hidden rounded-md bg-gray-100;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__img {
|
||||||
|
@apply w-full h-full object-cover;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__heading {
|
||||||
|
@apply text-cwc-blue-01 text-24px font-bold leading-none mt-6 mb-4;
|
||||||
|
|
||||||
|
&::after {
|
||||||
|
background: var(--color-secondary);
|
||||||
|
content: "";
|
||||||
|
display: block;
|
||||||
|
height: 4px;
|
||||||
|
margin-top: 0.45rem;
|
||||||
|
width: 3rem;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
&__desc {
|
||||||
|
@apply text-gray-600 text-16px font-light leading-snug;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (max-width: 1023px) {
|
||||||
|
.services-list__line {
|
||||||
|
display: none;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2: Verify the CSS contains the expected classes**
|
||||||
|
|
||||||
|
The brief uses CSS-nesting shorthand (`&__line`, `&__grid`, etc.) for 6 of the 7 BEM children, and a literal selector (`.services-list__line`) for the one inside the `@media` block. A naive grep for the literal class names will undercount. Use:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
grep -cE "&__(line|grid|card|media|img|heading|desc)|services-list__(line|grid|card|media|img|heading|desc)" views/blocks/services-list/services-list.css
|
||||||
|
```
|
||||||
|
|
||||||
|
Expected: `8` (7 nested `&__` selectors + 1 literal `.services-list__line` inside the `@media` block).
|
||||||
|
|
||||||
|
- [ ] **Step 3: Commit**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add views/blocks/services-list/services-list.css
|
||||||
|
git commit -m "✨ feat: Add services-list block CSS"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 5: Block Template (PHP)
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `views/blocks/services-list/services-list.php`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Consumes: `get_field( 'items' )` → array of items each with `image` (array: `url`, `alt`), `heading` (string), `description` (string).
|
||||||
|
- Produces: A `<section class="services-list ...">` element containing the bisecting `__line` div, a `container` with a grid div, and a `<article class="services-list__card">` per item. Computes the dynamic `lg:grid-cols-N` class from item count.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Create the block PHP template**
|
||||||
|
|
||||||
|
Create the file `views/blocks/services-list/services-list.php` with the following exact content (tabs for indentation):
|
||||||
|
|
||||||
|
```php
|
||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* Block Name: Services List
|
||||||
|
*
|
||||||
|
* A row of service cards. Card count (2, 3, or 4) determines the layout.
|
||||||
|
*
|
||||||
|
* @package CWC
|
||||||
|
*/
|
||||||
|
|
||||||
|
namespace CWC;
|
||||||
|
|
||||||
|
$items = get_field( 'items' );
|
||||||
|
|
||||||
|
if ( empty( $items ) ) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
$count = count( $items );
|
||||||
|
$grid_cols = max( 2, min( 4, (int) $count ) );
|
||||||
|
$grid_class = 'lg:grid-cols-' . $grid_cols;
|
||||||
|
$line_url = '/wp-content/themes/community-works-collaborative/static/img/services-list-line.svg';
|
||||||
|
|
||||||
|
$classes = 'services-list mx-break-out relative ' . $grid_class;
|
||||||
|
$wrapper = blockWrapperAttributes( $classes, $is_preview );
|
||||||
|
?>
|
||||||
|
|
||||||
|
<section <?php echo wp_kses_post( $wrapper ); ?>>
|
||||||
|
<div class="services-list__line" aria-hidden="true" style="background-image: url('<?php echo esc_url( $line_url ); ?>');"></div>
|
||||||
|
|
||||||
|
<div class="container">
|
||||||
|
<div class="services-list__grid grid grid-cols-1 <?php echo esc_attr( $grid_class ); ?> gap-8 lg:gap-12">
|
||||||
|
<?php foreach ( $items as $item ) : ?>
|
||||||
|
<article class="services-list__card">
|
||||||
|
<?php if ( ! empty( $item['image'] ) ) : ?>
|
||||||
|
<figure class="services-list__media aspect-square">
|
||||||
|
<img
|
||||||
|
class="services-list__img"
|
||||||
|
src="<?php echo esc_url( $item['image']['url'] ); ?>"
|
||||||
|
alt="<?php echo esc_attr( $item['image']['alt'] ?? '' ); ?>"
|
||||||
|
loading="lazy"
|
||||||
|
/>
|
||||||
|
</figure>
|
||||||
|
<?php endif; ?>
|
||||||
|
|
||||||
|
<?php if ( ! empty( $item['heading'] ) ) : ?>
|
||||||
|
<h3 class="services-list__heading">
|
||||||
|
<?php echo wp_kses_post( $item['heading'] ); ?>
|
||||||
|
</h3>
|
||||||
|
<?php endif; ?>
|
||||||
|
|
||||||
|
<?php if ( ! empty( $item['description'] ) ) : ?>
|
||||||
|
<div class="services-list__desc">
|
||||||
|
<?php echo wp_kses_post( $item['description'] ); ?>
|
||||||
|
</div>
|
||||||
|
<?php endif; ?>
|
||||||
|
</article>
|
||||||
|
<?php endforeach; ?>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2: Lint the PHP file with PHPCS**
|
||||||
|
|
||||||
|
Run: `composer exec phpcs -- views/blocks/services-list/services-list.php`
|
||||||
|
Expected: exits 0 with no errors. If there are pre-existing project-wide issues unrelated to this file, fix only the ones in this file.
|
||||||
|
|
||||||
|
- [ ] **Step 3: Verify the dynamic grid class is in the source**
|
||||||
|
|
||||||
|
Run: `grep -E "lg:grid-cols-\$grid_cols|lg:grid-cols-' \. \$grid_cols" views/blocks/services-list/services-list.php`
|
||||||
|
Expected: at least one match (Tailwind must see the literal class name in the source to emit the rule).
|
||||||
|
|
||||||
|
- [ ] **Step 4: Commit**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add views/blocks/services-list/services-list.php
|
||||||
|
git commit -m "✨ feat: Add services-list block PHP template"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 6: CSS Import Wiring
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Modify: `styles/blocks/index.css`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Consumes: `views/blocks/services-list/services-list.css` (from Task 4).
|
||||||
|
- Produces: A new `@import` line at the end of `styles/blocks/index.css` so Tailwind's build picks up the block's CSS.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Add the import to the block index CSS**
|
||||||
|
|
||||||
|
Append the following line at the end of `styles/blocks/index.css`:
|
||||||
|
|
||||||
|
```css
|
||||||
|
@import '../../views/blocks/services-list/services-list.css';
|
||||||
|
```
|
||||||
|
|
||||||
|
After the edit, the file should end with:
|
||||||
|
|
||||||
|
```
|
||||||
|
@import '../../views/blocks/contact-info/contact-info.css';
|
||||||
|
@import '../../views/blocks/services-list/services-list.css';
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2: Verify the import is present**
|
||||||
|
|
||||||
|
Run: `grep -c "services-list/services-list.css" styles/blocks/index.css`
|
||||||
|
Expected: `1`.
|
||||||
|
|
||||||
|
- [ ] **Step 3: Commit**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add styles/blocks/index.css
|
||||||
|
git commit -m "🔧 chore: Import services-list block CSS into theme"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 7: Build the CSS
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Modify: `static/dist/theme.css`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Consumes: The new import in `styles/blocks/index.css` (from Task 6) and the block CSS (from Task 4).
|
||||||
|
- Produces: A rebuilt `static/dist/theme.css` that includes the `.services-list*` rules and the dynamic `lg:grid-cols-2`, `lg:grid-cols-3`, `lg:grid-cols-4` utilities.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Run the production Tailwind build**
|
||||||
|
|
||||||
|
Run: `npm run build`
|
||||||
|
Expected: completes with no errors. The output file `static/dist/theme.css` is updated in place.
|
||||||
|
|
||||||
|
- [ ] **Step 2: Verify the services-list CSS classes are in the built output**
|
||||||
|
|
||||||
|
The build unwraps CSS-nesting `&__heading` into `__heading.services-list` (no literal `.services-list__heading` is emitted). Use a fixed-string search that matches the un-nested form:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
grep -cF "__heading.services-list" static/dist/theme.css
|
||||||
|
```
|
||||||
|
|
||||||
|
Expected: `1` or more. (Note: on Windows Git-Bash, prefer `grep -F` because POSIX `\\:` escapes are stripped before reaching grep.)
|
||||||
|
|
||||||
|
- [ ] **Step 3: Verify the dynamic grid classes are in the built output**
|
||||||
|
|
||||||
|
Same Windows-shell caveat. Use fixed-string search:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
grep -cF "lg\:grid-cols-2" static/dist/theme.css
|
||||||
|
grep -cF "lg\:grid-cols-3" static/dist/theme.css
|
||||||
|
grep -cF "lg\:grid-cols-4" static/dist/theme.css
|
||||||
|
```
|
||||||
|
|
||||||
|
Expected: each returns `1` or more.
|
||||||
|
|
||||||
|
- [ ] **Step 4: Commit the rebuilt dist**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add -f static/dist/theme.css
|
||||||
|
git commit -m "🎨 build: Rebuild dist with services-list block styles"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 8: Playwright Tests
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `tests/services-page.spec.js`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Consumes: The rendered `views/blocks/services-list/services-list.php` template (Tasks 4 + 5) on the WordPress page `/services/mapping/`.
|
||||||
|
- Produces: Three tests:
|
||||||
|
1. Card count, image, and heading visibility per block (expects 2 + 4 cards across two block instances).
|
||||||
|
2. Bisecting `__line` is present and `aria-hidden="true"`.
|
||||||
|
3. No axe-core a11y violations scoped to `.services-list`.
|
||||||
|
|
||||||
|
> **Prerequisite:** the test depends on the mapping page being composed in Gutenberg with two `Services List` blocks (2 items + 4 items) and a `Pull Quote` block. That composition is the editor's responsibility and is not part of this plan. The tests should be authored against the *intended* state, not a placeholder state.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Create the test spec file**
|
||||||
|
|
||||||
|
Create the file `tests/services-page.spec.js` with the following exact content:
|
||||||
|
|
||||||
|
```js
|
||||||
|
import { test, expect } from "@playwright/test";
|
||||||
|
import AxeBuilder from "@axe-core/playwright";
|
||||||
|
|
||||||
|
test.describe("Services List block on /services/mapping/", () => {
|
||||||
|
test("renders the heading and image for each card", async ({ page }) => {
|
||||||
|
await page.goto("/services/mapping/");
|
||||||
|
|
||||||
|
const blocks = page.locator(".services-list");
|
||||||
|
await expect(blocks).toHaveCount(2);
|
||||||
|
|
||||||
|
await expect(blocks.nth(0).locator(".services-list__card")).toHaveCount(2);
|
||||||
|
await expect(blocks.nth(1).locator(".services-list__card")).toHaveCount(4);
|
||||||
|
|
||||||
|
const firstCard = blocks.nth(0).locator(".services-list__card").first();
|
||||||
|
await expect(firstCard.locator(".services-list__media img")).toBeVisible();
|
||||||
|
await expect(firstCard.locator(".services-list__heading")).toBeVisible();
|
||||||
|
});
|
||||||
|
|
||||||
|
test("bisecting line is present and aria-hidden", async ({ page }) => {
|
||||||
|
await page.goto("/services/mapping/");
|
||||||
|
const line = page.locator(".services-list__line").first();
|
||||||
|
await expect(line).toBeAttached();
|
||||||
|
await expect(line).toHaveAttribute("aria-hidden", "true");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("no axe violations on the services-list block", async ({ page }) => {
|
||||||
|
await page.goto("/services/mapping/");
|
||||||
|
const results = await new AxeBuilder({ page })
|
||||||
|
.include(".services-list")
|
||||||
|
.analyze();
|
||||||
|
expect(results.violations).toEqual([]);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2: Run the tests**
|
||||||
|
|
||||||
|
Run: `npx playwright test tests/services-page.spec.js`
|
||||||
|
Expected: all 3 tests pass. If tests fail because the mapping page has not yet been composed in the editor, that's an expected prerequisite — note the prerequisite in the final report and skip the test run.
|
||||||
|
|
||||||
|
- [ ] **Step 3: Commit**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add tests/services-page.spec.js
|
||||||
|
git commit -m "✅ test: Add Playwright tests for services-list block"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Self-Review Notes
|
||||||
|
|
||||||
|
- **Spec coverage:**
|
||||||
|
- One new ACF block (`services-list`) — covered by Tasks 1, 3, 4, 5.
|
||||||
|
- Repeater of `items` with `image` / `heading` / `description` — covered by Task 1.
|
||||||
|
- Card count drives grid columns (2/3/4) — covered by Task 5 (PHP computes the class) and Task 7 (Tailwind emits the rule).
|
||||||
|
- Orange bisecting line, full-bleed, behind the cards, hidden on mobile — covered by Tasks 2 (SVG), 4 (CSS with `inset-inline: 0`, `z-index: 1` on line, `z-index: 2` on grid, media query to hide on `<lg`).
|
||||||
|
- Reuse `pull-quote` for closing — explicitly out of scope (no code change needed).
|
||||||
|
- Page template not modified — confirmed; `page.php` is not in any file list.
|
||||||
|
- `header.php` / `footer.php` / page hero not touched — confirmed.
|
||||||
|
- Reuse existing design tokens (`text-cwc-blue-01`, `var(--color-secondary)`, brand orange `#F26B53`) — confirmed in Tasks 4 and 2.
|
||||||
|
- Playwright tests covering count, image, heading, line, a11y — covered by Task 8.
|
||||||
|
- Dist rebuild — covered by Task 7.
|
||||||
|
- **Placeholder scan:** No TBDs. Every step has a concrete file path, exact content, exact command, and expected output. The only conditional is in Task 8 Step 2 — explicitly called out as a prerequisite (editor must compose the page in Gutenberg), not a placeholder.
|
||||||
|
- **Type consistency:** ACF field `name: "items"` is used in Task 5 (`get_field( 'items' )`). Sub-field names `image`, `heading`, `description` are used in Task 1 (defined) and Task 5 (consumed). Class names `services-list`, `__line`, `__grid`, `__card`, `__media`, `__img`, `__heading`, `__desc` are used in Task 4 (defined in CSS) and Task 5 (rendered in markup) and Task 8 (asserted in tests) — consistent.
|
||||||
|
- **Ambiguity check:** "Editor adds 2 instances of the block on the mapping page" is the chosen approach (per spec §1 and design Q&A). "Bisecting line" is a single orange SVG, 8px tall, positioned at `top: 25%` of the block wrapper, hidden on mobile. Both are explicit.
|
||||||
@@ -0,0 +1,620 @@
|
|||||||
|
# Team Grid Block Implementation Plan
|
||||||
|
|
||||||
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||||
|
|
||||||
|
**Goal:** Build a new `team-grid` ACF block for the Team page (and any other page that needs a team grid) that renders a responsive grid of team members. Each member shows their photo (rounded rectangle), name, and title. The bio is collapsed by default and expands vertically with a smooth animation when the photo, name, or title is clicked.
|
||||||
|
|
||||||
|
**Architecture:** One new ACF block (`acf/team-grid`) with a single repeater of `members` (image, name, title, bio). The block uses native HTML `<details>`/`<summary>` for the click-to-expand interaction, animated with the `grid-template-rows: 0fr → 1fr` CSS pattern (no JavaScript). The block has no built-in background — the editor wraps it in an existing Section block when a dark/light background is needed. The page template is unchanged; the editor adds the block to the Team page in Gutenberg.
|
||||||
|
|
||||||
|
**Tech Stack:** WordPress 6.x, PHP 8.x, Tailwind CSS v4, Playwright, axe-core, PHPCS (WordPress standard).
|
||||||
|
|
||||||
|
## Global Constraints
|
||||||
|
|
||||||
|
- Tabs for PHP indentation (project standard).
|
||||||
|
- `static/dist/theme.css` is committed (not gitignored) per project convention.
|
||||||
|
- PHPCS uses the WordPress coding standard; `composer lint` must pass for all touched files.
|
||||||
|
- All design colors use the project's existing CSS custom properties from `styles/base/colors.css`. No hardcoded hex values for theme colors.
|
||||||
|
- Reuse existing design tokens where possible (e.g. `text-cwc-blue-01`, `var(--color-secondary)`).
|
||||||
|
- The headshot uses `rounded-md` to match other image cards in the project.
|
||||||
|
- All commits follow the project's emoji-prefixed commit-message style (e.g. `✨ feat: …`).
|
||||||
|
- This work does **not** edit `header.php`, `footer.php`, `views/partials/page-hero.php`, or `views/partials/page-hero-services.php`.
|
||||||
|
- `page.php` is not modified.
|
||||||
|
- No JavaScript files are added.
|
||||||
|
- Reuse the same `regACFBlocks()` auto-registration pattern as `services-list`.
|
||||||
|
- Tailwind v4 picks up class names from source files at build time. The dynamic class names used in the CSS (`grid-cols-1`, `sm:grid-cols-2`, `lg:grid-cols-3`, `w-32 h-32`, etc.) must all be literal in the source for the build to emit them.
|
||||||
|
|
||||||
|
## File Structure
|
||||||
|
|
||||||
|
| File | Responsibility | Created/Modified |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `views/blocks/team-grid/team-grid.php` | Block template (PHP) — renders the grid. | Create |
|
||||||
|
| `views/blocks/team-grid/team-grid.css` | Block styles (CSS) — layout, photo, summary, animation. | Create |
|
||||||
|
| `views/blocks/team-grid/block.json` | Block registration metadata. | Create |
|
||||||
|
| `acf/group_team_grid.json` | ACF field group for the `acf/team-grid` block. | Create |
|
||||||
|
| `styles/blocks/index.css` | Import the new block's CSS. | Modify |
|
||||||
|
| `tests/team-page.spec.js` | Playwright tests for the rendered block. | Create |
|
||||||
|
| `static/dist/theme.css` | Rebuilt via `npm run build`. | Modified |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 1: ACF Field Group
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `acf/group_team_grid.json`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Produces: ACF group with `key: "group_team_grid"`, location scoped to `block == acf/team-grid`, fields: `members` (repeater) → `image`, `name`, `title`, `bio`.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Create the ACF field group JSON file**
|
||||||
|
|
||||||
|
Create the file `acf/group_team_grid.json` with the following exact content:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"key": "group_team_grid",
|
||||||
|
"title": "Team Grid",
|
||||||
|
"fields": [
|
||||||
|
{
|
||||||
|
"key": "field_team_grid_members",
|
||||||
|
"label": "Members",
|
||||||
|
"name": "members",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "repeater",
|
||||||
|
"instructions": "Add team members. Click a card to expand the bio.",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"layout": "block",
|
||||||
|
"pagination": 0,
|
||||||
|
"min": 0,
|
||||||
|
"max": 0,
|
||||||
|
"collapsed": "",
|
||||||
|
"button_label": "Add Team Member",
|
||||||
|
"rows_per_page": 20,
|
||||||
|
"sub_fields": [
|
||||||
|
{
|
||||||
|
"key": "field_team_grid_member_image",
|
||||||
|
"label": "Image",
|
||||||
|
"name": "image",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "image",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"return_format": "array",
|
||||||
|
"library": "all",
|
||||||
|
"min_width": "",
|
||||||
|
"min_height": "",
|
||||||
|
"min_size": "",
|
||||||
|
"max_width": "",
|
||||||
|
"max_height": "",
|
||||||
|
"max_size": "",
|
||||||
|
"mime_types": "",
|
||||||
|
"allow_in_bindings": 0,
|
||||||
|
"preview_size": "medium"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "field_team_grid_member_name",
|
||||||
|
"label": "Name",
|
||||||
|
"name": "name",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "text",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"default_value": "",
|
||||||
|
"maxlength": "",
|
||||||
|
"allow_in_bindings": 0,
|
||||||
|
"placeholder": "",
|
||||||
|
"prepend": "",
|
||||||
|
"append": ""
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "field_team_grid_member_title",
|
||||||
|
"label": "Title",
|
||||||
|
"name": "title",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "text",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"default_value": "",
|
||||||
|
"maxlength": "",
|
||||||
|
"allow_in_bindings": 0,
|
||||||
|
"placeholder": "",
|
||||||
|
"prepend": "",
|
||||||
|
"append": ""
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "field_team_grid_member_bio",
|
||||||
|
"label": "Bio",
|
||||||
|
"name": "bio",
|
||||||
|
"aria-label": "",
|
||||||
|
"type": "wysiwyg",
|
||||||
|
"instructions": "",
|
||||||
|
"required": 0,
|
||||||
|
"conditional_logic": 0,
|
||||||
|
"wrapper": {
|
||||||
|
"width": "",
|
||||||
|
"class": "",
|
||||||
|
"id": ""
|
||||||
|
},
|
||||||
|
"default_value": "",
|
||||||
|
"tabs": "visual",
|
||||||
|
"toolbar": "basic",
|
||||||
|
"media_upload": 0,
|
||||||
|
"delay": 0,
|
||||||
|
"allow_in_bindings": 0
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"location": [
|
||||||
|
[
|
||||||
|
{
|
||||||
|
"param": "block",
|
||||||
|
"operator": "==",
|
||||||
|
"value": "acf/team-grid"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
],
|
||||||
|
"menu_order": 0,
|
||||||
|
"position": "normal",
|
||||||
|
"style": "default",
|
||||||
|
"label_placement": "top",
|
||||||
|
"instruction_placement": "label",
|
||||||
|
"hide_on_screen": "",
|
||||||
|
"active": true,
|
||||||
|
"description": "Team grid block. Each member is a card with photo, name, title, and a collapsible bio.",
|
||||||
|
"show_in_rest": 0,
|
||||||
|
"display_title": "",
|
||||||
|
"allow_ai_access": false,
|
||||||
|
"ai_description": "",
|
||||||
|
"modified": 1753401600
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2: Verify the JSON parses**
|
||||||
|
|
||||||
|
Run: `node -e "JSON.parse(require('fs').readFileSync('acf/group_team_grid.json','utf8')); console.log('OK')"`
|
||||||
|
Expected: prints `OK` and exits 0.
|
||||||
|
|
||||||
|
- [ ] **Step 3: Commit**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add acf/group_team_grid.json
|
||||||
|
git commit -m "✨ feat: Add ACF field group for team-grid block"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 2: Block Registration JSON
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `views/blocks/team-grid/block.json`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Produces: `block.json` declaring `acf/team-grid` as the block name, `team-grid.php` as the render template, `groups` icon, `common` category. `regACFBlocks()` in `functions.php` will pick this up automatically.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Create the block.json file**
|
||||||
|
|
||||||
|
Create the file `views/blocks/team-grid/block.json` with the following exact content:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "acf/team-grid",
|
||||||
|
"title": "Team Grid",
|
||||||
|
"description": "A responsive grid of team members. Click a card to expand the bio.",
|
||||||
|
"category": "common",
|
||||||
|
"icon": "groups",
|
||||||
|
"keywords": ["team", "people", "staff", "bio"],
|
||||||
|
"acf": {
|
||||||
|
"mode": "preview",
|
||||||
|
"renderTemplate": "team-grid.php"
|
||||||
|
},
|
||||||
|
"supports": {
|
||||||
|
"anchor": true,
|
||||||
|
"align": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2: Verify the JSON parses**
|
||||||
|
|
||||||
|
Run: `node -e "JSON.parse(require('fs').readFileSync('views/blocks/team-grid/block.json','utf8')); console.log('OK')"`
|
||||||
|
Expected: prints `OK` and exits 0.
|
||||||
|
|
||||||
|
- [ ] **Step 3: Commit**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add views/blocks/team-grid/block.json
|
||||||
|
git commit -m "✨ feat: Add team-grid block.json registration"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 3: Block CSS
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `views/blocks/team-grid/team-grid.css`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Produces: BEM-styled CSS for `.team-grid`, `__inner`, `__card`, `__details`, `__summary`, `__photo`, `__name`, `__title`, `__bio-wrap`, `__bio-inner`, `__bio`. Reuses `text-cwc-blue-01` for the name. Implements the `grid-template-rows: 0fr → 1fr` animation for the bio.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Create the block CSS file**
|
||||||
|
|
||||||
|
Create the file `views/blocks/team-grid/team-grid.css` with the following exact content:
|
||||||
|
|
||||||
|
```css
|
||||||
|
/* Team Grid block */
|
||||||
|
|
||||||
|
.team-grid {
|
||||||
|
&__card {
|
||||||
|
@apply flex flex-col;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__details {
|
||||||
|
@apply flex flex-col;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__summary {
|
||||||
|
@apply flex flex-col items-center text-center cursor-pointer list-none;
|
||||||
|
|
||||||
|
&::-webkit-details-marker {
|
||||||
|
display: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
&::marker {
|
||||||
|
display: none;
|
||||||
|
content: '';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
&__photo {
|
||||||
|
@apply w-32 h-32 sm:w-40 sm:h-40 lg:w-48 lg:h-48 object-cover rounded-md mb-4;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__name {
|
||||||
|
@apply text-cwc-blue-01 text-22px font-bold leading-tight mb-1;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__title {
|
||||||
|
@apply text-gray-600 text-16px font-light italic mb-3;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__bio-wrap {
|
||||||
|
display: grid;
|
||||||
|
grid-template-rows: 0fr;
|
||||||
|
transition: grid-template-rows 300ms ease;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__details[open] &__bio-wrap {
|
||||||
|
grid-template-rows: 1fr;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__bio-inner {
|
||||||
|
overflow: hidden;
|
||||||
|
min-height: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__bio {
|
||||||
|
@apply text-gray-700 text-16px font-light leading-snug pt-2;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2: Verify the BEM children are present**
|
||||||
|
|
||||||
|
Run: `grep -cE "&__(card|details|summary|photo|name|title|bio-wrap|bio-inner|bio)\b" views/blocks/team-grid/team-grid.css`
|
||||||
|
Expected: `9` (one match per BEM child).
|
||||||
|
|
||||||
|
- [ ] **Step 3: Commit**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add views/blocks/team-grid/team-grid.css
|
||||||
|
git commit -m "✨ feat: Add team-grid block CSS"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 4: Block Template (PHP)
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `views/blocks/team-grid/team-grid.php`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Consumes: `get_field( 'members' )` → array of members each with `image` (array: `url`, `alt`), `name` (string), `title` (string), `bio` (wysiwyg HTML).
|
||||||
|
- Produces: A `<section class="team-grid ...">` element with a `__inner` grid div, and an `<article class="team-grid__card">` per member. Each card contains a `<details>` with a `<summary>` (photo + name + title) and a `__bio-wrap` containing the bio.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Create the block PHP template**
|
||||||
|
|
||||||
|
Create the file `views/blocks/team-grid/team-grid.php` with the following exact content (tabs for indentation):
|
||||||
|
|
||||||
|
```php
|
||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* Block Name: Team Grid
|
||||||
|
*
|
||||||
|
* A responsive grid of team members. Each card uses a native <details>
|
||||||
|
* element so the bio expands when the photo, name, or title is clicked.
|
||||||
|
*
|
||||||
|
* @package CWC
|
||||||
|
*/
|
||||||
|
|
||||||
|
namespace CWC;
|
||||||
|
|
||||||
|
$members = get_field( 'members' );
|
||||||
|
|
||||||
|
if ( empty( $members ) ) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
$classes = 'team-grid container my-section mx-auto';
|
||||||
|
$wrapper = blockWrapperAttributes( $classes, $is_preview );
|
||||||
|
?>
|
||||||
|
|
||||||
|
<section <?php echo wp_kses_post( $wrapper ); ?>>
|
||||||
|
<div class="team-grid__inner grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-8 lg:gap-12">
|
||||||
|
<?php foreach ( $members as $member ) : ?>
|
||||||
|
<article class="team-grid__card">
|
||||||
|
<details class="team-grid__details">
|
||||||
|
<summary class="team-grid__summary">
|
||||||
|
<?php if ( ! empty( $member['image'] ) ) : ?>
|
||||||
|
<img
|
||||||
|
class="team-grid__photo"
|
||||||
|
src="<?php echo esc_url( $member['image']['url'] ); ?>"
|
||||||
|
alt="<?php echo esc_attr( $member['image']['alt'] ?? '' ); ?>"
|
||||||
|
loading="lazy"
|
||||||
|
/>
|
||||||
|
<?php endif; ?>
|
||||||
|
|
||||||
|
<?php if ( ! empty( $member['name'] ) ) : ?>
|
||||||
|
<h3 class="team-grid__name">
|
||||||
|
<?php echo wp_kses_post( $member['name'] ); ?>
|
||||||
|
</h3>
|
||||||
|
<?php endif; ?>
|
||||||
|
|
||||||
|
<?php if ( ! empty( $member['title'] ) ) : ?>
|
||||||
|
<p class="team-grid__title">
|
||||||
|
<?php echo wp_kses_post( $member['title'] ); ?>
|
||||||
|
</p>
|
||||||
|
<?php endif; ?>
|
||||||
|
</summary>
|
||||||
|
|
||||||
|
<div class="team-grid__bio-wrap">
|
||||||
|
<div class="team-grid__bio-inner">
|
||||||
|
<?php if ( ! empty( $member['bio'] ) ) : ?>
|
||||||
|
<div class="team-grid__bio">
|
||||||
|
<?php echo wp_kses_post( $member['bio'] ); ?>
|
||||||
|
</div>
|
||||||
|
<?php endif; ?>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</details>
|
||||||
|
</article>
|
||||||
|
<?php endforeach; ?>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2: Lint the PHP file with PHPCS**
|
||||||
|
|
||||||
|
Run: `composer exec phpcs -- views/blocks/team-grid/team-grid.php`
|
||||||
|
Expected: exits 0 with no errors. If PHPCS reports alignment warnings on the assignment block (similar to the Task 5 services-list fix), run `composer exec phpcbf -- views/blocks/team-grid/team-grid.php` to auto-fix, then re-run PHPCS to confirm exit 0. Whitespace-only changes are acceptable; do not modify logic.
|
||||||
|
|
||||||
|
- [ ] **Step 3: Verify the dynamic utility classes are in the source**
|
||||||
|
|
||||||
|
Run: `grep -E "grid-cols-1|sm:grid-cols-2|lg:grid-cols-3|w-32|w-40|w-48" views/blocks/team-grid/team-grid.php`
|
||||||
|
Expected: at least 3 matches (Tailwind v4 must see the literal class names in the source to emit the rules).
|
||||||
|
|
||||||
|
- [ ] **Step 4: Commit**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add views/blocks/team-grid/team-grid.php
|
||||||
|
git commit -m "✨ feat: Add team-grid block PHP template"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 5: CSS Import Wiring
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Modify: `styles/blocks/index.css`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Consumes: `views/blocks/team-grid/team-grid.css` (from Task 3).
|
||||||
|
- Produces: A new `@import` line at the end of `styles/blocks/index.css` so Tailwind's build picks up the block's CSS.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Add the import to the block index CSS**
|
||||||
|
|
||||||
|
Append the following line at the end of `styles/blocks/index.css`:
|
||||||
|
|
||||||
|
```css
|
||||||
|
@import '../../views/blocks/team-grid/team-grid.css';
|
||||||
|
```
|
||||||
|
|
||||||
|
After the edit, the file should end with:
|
||||||
|
|
||||||
|
```
|
||||||
|
@import '../../views/blocks/services-list/services-list.css';
|
||||||
|
@import '../../views/blocks/team-grid/team-grid.css';
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2: Verify the import is present**
|
||||||
|
|
||||||
|
Run: `grep -cF "team-grid/team-grid.css" styles/blocks/index.css`
|
||||||
|
Expected: `1`.
|
||||||
|
|
||||||
|
- [ ] **Step 3: Commit**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add styles/blocks/index.css
|
||||||
|
git commit -m "🔧 chore: Import team-grid block CSS into theme"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 6: Build the CSS
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Modify: `static/dist/theme.css`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Consumes: The new import in `styles/blocks/index.css` (from Task 5) and the block CSS (from Task 3).
|
||||||
|
- Produces: A rebuilt `static/dist/theme.css` that includes the `.team-grid*` rules and the responsive `grid-cols-1 sm:grid-cols-2 lg:grid-cols-3` utilities.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Run the production Tailwind build**
|
||||||
|
|
||||||
|
Run: `npm run build`
|
||||||
|
Expected: completes with no errors.
|
||||||
|
|
||||||
|
- [ ] **Step 2: Verify the team-grid CSS classes are in the built output**
|
||||||
|
|
||||||
|
Tailwind v4 with `--optimize` **preserves** CSS-nesting rather than unwrapping `&__name` into `__name.team-grid`. Use fixed-string search (Windows-safe) that matches the preserved form:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
grep -cF "&__name" static/dist/theme.css
|
||||||
|
```
|
||||||
|
|
||||||
|
Expected: `1` or more (the `&__name` rule is nested inside `.team-grid { ... }` in the dist).
|
||||||
|
|
||||||
|
- [ ] **Step 3: Verify the responsive grid utilities are in the built output**
|
||||||
|
|
||||||
|
Same Windows-safe form:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
grep -cF "sm\:grid-cols-2" static/dist/theme.css
|
||||||
|
grep -cF "lg\:grid-cols-3" static/dist/theme.css
|
||||||
|
```
|
||||||
|
|
||||||
|
Expected: each returns `1` or more.
|
||||||
|
|
||||||
|
- [ ] **Step 4: Commit the rebuilt dist**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add -f static/dist/theme.css
|
||||||
|
git commit -m "🎨 build: Rebuild dist with team-grid block styles"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task 7: Playwright Tests
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `tests/team-page.spec.js`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
- Consumes: The rendered `views/blocks/team-grid/team-grid.php` template (Tasks 3 + 4) on the WordPress page `/team/`.
|
||||||
|
- Produces: Three tests:
|
||||||
|
1. Photo, name, and title visible for the first card.
|
||||||
|
2. Bio is closed by default; clicking the summary opens the details and reveals the bio; clicking again closes it.
|
||||||
|
3. No axe-core a11y violations scoped to `.team-grid`.
|
||||||
|
|
||||||
|
> **Prerequisite:** the test depends on the Team page being composed in Gutenberg with at least one `Team Grid` block containing one or more members. That composition is the editor's responsibility and is not part of this plan. The tests should be authored against the intended state, not a placeholder state.
|
||||||
|
|
||||||
|
- [ ] **Step 1: Create the test spec file**
|
||||||
|
|
||||||
|
Create the file `tests/team-page.spec.js` with the following exact content:
|
||||||
|
|
||||||
|
```js
|
||||||
|
import { test, expect } from "@playwright/test";
|
||||||
|
import AxeBuilder from "@axe-core/playwright";
|
||||||
|
|
||||||
|
test.describe("Team Grid block on /team/", () => {
|
||||||
|
test("renders the photo, name, and title for each member", async ({ page }) => {
|
||||||
|
await page.goto("/team/");
|
||||||
|
|
||||||
|
const cards = page.locator(".team-grid__card");
|
||||||
|
await expect(cards.first()).toBeVisible();
|
||||||
|
|
||||||
|
const firstCard = cards.first();
|
||||||
|
await expect(firstCard.locator(".team-grid__photo")).toBeVisible();
|
||||||
|
await expect(firstCard.locator(".team-grid__name")).toBeVisible();
|
||||||
|
await expect(firstCard.locator(".team-grid__title")).toBeVisible();
|
||||||
|
});
|
||||||
|
|
||||||
|
test("bio is hidden by default and expands on summary click", async ({ page }) => {
|
||||||
|
await page.goto("/team/");
|
||||||
|
|
||||||
|
const firstDetails = page.locator(".team-grid__details").first();
|
||||||
|
// Bio is closed by default.
|
||||||
|
await expect(firstDetails).not.toHaveAttribute("open", "");
|
||||||
|
|
||||||
|
// Click the summary; the details should open and the bio should be visible.
|
||||||
|
await firstDetails.locator(".team-grid__summary").click();
|
||||||
|
await expect(firstDetails).toHaveAttribute("open", "");
|
||||||
|
await expect(firstDetails.locator(".team-grid__bio")).toBeVisible();
|
||||||
|
|
||||||
|
// Click again; the details should close.
|
||||||
|
await firstDetails.locator(".team-grid__summary").click();
|
||||||
|
await expect(firstDetails).not.toHaveAttribute("open", "");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("no axe violations on the team-grid block", async ({ page }) => {
|
||||||
|
await page.goto("/team/");
|
||||||
|
const results = await new AxeBuilder({ page })
|
||||||
|
.include(".team-grid")
|
||||||
|
.analyze();
|
||||||
|
expect(results.violations).toEqual([]);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2: Run the tests**
|
||||||
|
|
||||||
|
Run: `npx playwright test tests/team-page.spec.js`
|
||||||
|
Expected: all 3 tests pass. If tests fail because the Team page has not yet been composed in the editor, that's an expected prerequisite — note the prerequisite in the final report and skip the test run.
|
||||||
|
|
||||||
|
- [ ] **Step 3: Commit**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd "C:/Users/ksolo/Herd/community-works-collaborative/wp-content/themes/community-works-collaborative"
|
||||||
|
git add tests/team-page.spec.js
|
||||||
|
git commit -m "✅ test: Add Playwright tests for team-grid block"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Self-Review Notes
|
||||||
|
|
||||||
|
- **Spec coverage:**
|
||||||
|
- One new ACF block (`team-grid`) — covered by Tasks 1, 2, 3, 4.
|
||||||
|
- Repeater of `members` with `image` / `name` / `title` / `bio` — covered by Task 1.
|
||||||
|
- Responsive grid `grid-cols-1 sm:grid-cols-2 lg:grid-cols-3` — covered by Task 4 (PHP) and Task 6 (Tailwind emits the rules).
|
||||||
|
- Rounded-rectangle headshots via `rounded-md` — covered by Task 3 (CSS).
|
||||||
|
- Native `<details>`/`<summary>` click-to-expand — covered by Task 4 (PHP) and Task 3 (CSS).
|
||||||
|
- `grid-template-rows: 0fr → 1fr` animation — covered by Task 3 (CSS).
|
||||||
|
- No built-in background — explicitly out of scope (Section block wrapper, editor's responsibility).
|
||||||
|
- Page template not modified — confirmed; `page.php` is not in any file list.
|
||||||
|
- `header.php` / `footer.php` / page hero not touched — confirmed.
|
||||||
|
- Reuse existing design tokens (`text-cwc-blue-01`, `rounded-md`) — covered by Tasks 1, 3, 4.
|
||||||
|
- Playwright tests covering photo + name + title, summary click toggles, and a11y — covered by Task 7.
|
||||||
|
- Dist rebuild — covered by Task 6.
|
||||||
|
- **Placeholder scan:** No TBDs. Every step has a concrete file path, exact content, exact command, and expected output. The only conditional is in Task 7 Step 2 — explicitly called out as a prerequisite (editor must compose the page in Gutenberg), not a placeholder.
|
||||||
|
- **Type consistency:** ACF field `name: "members"` is used in Task 4 (`get_field( 'members' )`). Sub-field names `image`, `name`, `title`, `bio` are used in Task 1 (defined) and Task 4 (consumed). Class names `team-grid`, `__inner`, `__card`, `__details`, `__summary`, `__photo`, `__name`, `__title`, `__bio-wrap`, `__bio-inner`, `__bio` are used in Task 3 (defined in CSS) and Task 4 (rendered in markup) and Task 7 (asserted in tests) — consistent.
|
||||||
|
- **Ambiguity check:** "Rounded rectangle" is concretely specified as `rounded-md`. "Opens vertically" is concretely specified as `grid-template-rows: 0fr → 1fr` with 300ms transition. "Responsive grid" is concretely specified as `grid-cols-1 sm:grid-cols-2 lg:grid-cols-3`. "No built-in background" is concretely scoped to the Section block wrapper (editor's responsibility, not this block's). All are explicit.
|
||||||
@@ -0,0 +1,313 @@
|
|||||||
|
# Services Content Blocks Design
|
||||||
|
|
||||||
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||||
|
|
||||||
|
**Goal:** Build the missing content-area components for the Mapping services page (and any other service sub-page), matching `Mapping-Services.png`. The hero, header, and footer are already in place and must not be touched.
|
||||||
|
|
||||||
|
**Architecture:** One new ACF block (`services-list`) that renders a row of cards. Card count is editor-driven (2, 3, or 4); card size and grid layout adapt to the count. The orange horizontal line that bisects the images is rendered by the block itself as a full-bleed SVG background. The closing "At CWC, mapping is about more than data…" block reuses the existing `pull-quote` block — no new build needed. Editor composes the page in Gutenberg by adding `Services List` and `Pull Quote` blocks to any service sub-page; `page.php` already calls `the_content()`, so no template change is required.
|
||||||
|
|
||||||
|
**Tech Stack:** WordPress 6.x, PHP 8.x, Tailwind CSS v4, Playwright, axe-core, PHPCS (WordPress standard).
|
||||||
|
|
||||||
|
## Global Constraints
|
||||||
|
|
||||||
|
- Tabs for PHP indentation (project standard).
|
||||||
|
- `static/dist/theme.css` is committed (not gitignored) per project convention.
|
||||||
|
- PHPCS uses the WordPress coding standard; `composer lint` must pass for all touched files.
|
||||||
|
- All design colors use the project's existing CSS custom properties from `styles/base/colors.css`. No hardcoded hex values for theme colors.
|
||||||
|
- Reuse the existing post-title accent pattern (blue heading + orange `::after` underline from `.post-title h1` in `styles/base/misc.css`) for consistency. Do not introduce a new accent style.
|
||||||
|
- Reuse the existing `pull-quote` block for the closing statement — no duplicate block.
|
||||||
|
- Page template `page.php` is not modified. The page-children block is not used.
|
||||||
|
- This work does **not** edit `header.php`, `footer.php`, `views/partials/page-hero.php`, or `views/partials/page-hero-services.php`.
|
||||||
|
|
||||||
|
## Reference Mockup
|
||||||
|
|
||||||
|
`Mapping-Services.png` shows three content-area sections on the Mapping services page (URL `/services/mapping/`):
|
||||||
|
|
||||||
|
1. **Featured services row** — 2 large cards side-by-side. Each card: image (top), blue heading with orange underline, intro paragraph. In the mockup, the orange horizontal line cuts through the middle of the images.
|
||||||
|
2. **Service grid** — 4 small cards in a 4-up grid. Each card: square image, blue heading with orange underline, short description. The orange line again bisects the images.
|
||||||
|
3. **Closing statement** — light-blue full-bleed section with decorative linework, centered text "At CWC, mapping is about more than data. It is about helping people understand and make decisions about their land and communities." with "more than data." colored (likely the orange secondary accent).
|
||||||
|
|
||||||
|
The mockup shows a single orange horizontal line that bleeds past the container on both sides, intersecting both rows of images at their vertical midpoint.
|
||||||
|
|
||||||
|
## File Structure
|
||||||
|
|
||||||
|
| File | Responsibility | Created/Modified |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `views/blocks/services-list/` | Folder for the new ACF block. | Create |
|
||||||
|
| `views/blocks/services-list/services-list.php` | Block template (PHP). | Create |
|
||||||
|
| `views/blocks/services-list/services-list.css` | Block styles (CSS). | Create |
|
||||||
|
| `views/blocks/services-list/block.json` | Block registration (ACF block name, category, icon). | Create |
|
||||||
|
| `acf/group_services_list.json` | ACF field group for the `acf/services-list` block. | Create |
|
||||||
|
| `static/img/services-list-line.svg` | Decorative orange horizontal line SVG that bisects the images. | Create |
|
||||||
|
| `styles/blocks/index.css` | Import the new block's CSS. | Modify |
|
||||||
|
| `tests/services-page.spec.js` | Playwright tests for the rendered block. | Create |
|
||||||
|
| `static/dist/theme.css` | Rebuilt via `npm run build`. | Modified |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Design Details
|
||||||
|
|
||||||
|
### 1. New ACF block: `services-list`
|
||||||
|
|
||||||
|
**Block name (registration key):** `acf/services-list`
|
||||||
|
**Editor title:** "Services List"
|
||||||
|
**Category:** common
|
||||||
|
**Description (in block.json):** "A row of service cards. Card count (2-4) determines the layout."
|
||||||
|
|
||||||
|
#### ACF field group (`acf/group_services_list.json`)
|
||||||
|
|
||||||
|
```
|
||||||
|
Group key: group_services_list
|
||||||
|
Group title: Services List
|
||||||
|
Position: normal
|
||||||
|
Menu order: 0
|
||||||
|
Location: block == acf/services-list
|
||||||
|
```
|
||||||
|
|
||||||
|
Fields:
|
||||||
|
- `items` (repeater, layout: block, button label: "Add Service")
|
||||||
|
- `image` (image, return_format: array, required: 0) — Card image.
|
||||||
|
- `heading` (text, required: 0) — Card title.
|
||||||
|
- `description` (textarea, rows: 4, required: 0) — Card body copy.
|
||||||
|
|
||||||
|
The block is intentionally minimal. No per-item "size" select, no global layout toggle, no CTA field. The grid layout derives from the item count alone.
|
||||||
|
|
||||||
|
#### Block template (`views/blocks/services-list/services-list.php`)
|
||||||
|
|
||||||
|
Top of file:
|
||||||
|
|
||||||
|
```php
|
||||||
|
namespace CWC;
|
||||||
|
|
||||||
|
$items = get_field( 'items' );
|
||||||
|
if ( empty( $items ) ) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
$count = count( $items );
|
||||||
|
|
||||||
|
// Grid columns by count: 2 -> lg:grid-cols-2, 3 -> lg:grid-cols-3, 4 -> lg:grid-cols-4
|
||||||
|
$grid_class = 'lg:grid-cols-' . max( 2, min( 4, (int) $count ) );
|
||||||
|
|
||||||
|
$classes = "services-list mx-break-out relative $grid_class";
|
||||||
|
$wrapper = blockWrapperAttributes( $classes, $is_preview );
|
||||||
|
```
|
||||||
|
|
||||||
|
Render:
|
||||||
|
|
||||||
|
```html
|
||||||
|
<section class="services-list ..."> <!-- the wrapper from blockWrapperAttributes -->
|
||||||
|
<div class="services-list__line" aria-hidden="true"></div> <!-- full-bleed orange line, see CSS -->
|
||||||
|
<div class="container">
|
||||||
|
<div class="services-list__grid grid grid-cols-1 gap-8 lg:gap-12">
|
||||||
|
<?php foreach ( $items as $item ) : ?>
|
||||||
|
<article class="services-list__card">
|
||||||
|
<?php if ( ! empty( $item['image'] ) ) : ?>
|
||||||
|
<figure class="services-list__media aspect-square overflow-hidden rounded-md">
|
||||||
|
<img
|
||||||
|
src="<?php echo esc_url( $item['image']['url'] ); ?>"
|
||||||
|
alt="<?php echo esc_attr( $item['image']['alt'] ?? '' ); ?>"
|
||||||
|
class="services-list__img w-full h-full object-cover"
|
||||||
|
loading="lazy"
|
||||||
|
/>
|
||||||
|
</figure>
|
||||||
|
<?php endif; ?>
|
||||||
|
|
||||||
|
<?php if ( ! empty( $item['heading'] ) ) : ?>
|
||||||
|
<h3 class="services-list__heading">
|
||||||
|
<?php echo wp_kses_post( $item['heading'] ); ?>
|
||||||
|
</h3>
|
||||||
|
<?php endif; ?>
|
||||||
|
|
||||||
|
<?php if ( ! empty( $item['description'] ) ) : ?>
|
||||||
|
<div class="services-list__desc">
|
||||||
|
<?php echo wp_kses_post( $item['description'] ); ?>
|
||||||
|
</div>
|
||||||
|
<?php endif; ?>
|
||||||
|
</article>
|
||||||
|
<?php endforeach; ?>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
```
|
||||||
|
|
||||||
|
Notes:
|
||||||
|
- The `lg:grid-cols-N` class is generated dynamically. Tailwind v4 picks up the class from the source file and emits the rule. No safelist needed.
|
||||||
|
- Card aspect ratio: `aspect-square` for all counts. Mockup shows square images for both the 2-up and 4-up rows.
|
||||||
|
- Heading: `<h3>` to sit below the page H1 in document order.
|
||||||
|
|
||||||
|
#### Block styles (`views/blocks/services-list/services-list.css`)
|
||||||
|
|
||||||
|
```
|
||||||
|
.services-list {
|
||||||
|
/* vertical position of the bisecting line, relative to the .container block.
|
||||||
|
The image is the first child of each card; bisecting it = approx 25% from the top. */
|
||||||
|
--services-line-top: 25%;
|
||||||
|
|
||||||
|
&__line {
|
||||||
|
position: absolute;
|
||||||
|
inset-inline: 0;
|
||||||
|
top: var(--services-line-top);
|
||||||
|
height: 8px;
|
||||||
|
pointer-events: none;
|
||||||
|
z-index: 1;
|
||||||
|
/* background SVG served from theme root */
|
||||||
|
background-image: url('/wp-content/themes/community-works-collaborative/static/img/services-list-line.svg');
|
||||||
|
background-repeat: no-repeat;
|
||||||
|
background-position: center center;
|
||||||
|
background-size: 100% 100%;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__grid {
|
||||||
|
position: relative;
|
||||||
|
z-index: 2; /* cards stack above the line so images are not visually cut */
|
||||||
|
}
|
||||||
|
|
||||||
|
&__card {
|
||||||
|
@apply flex flex-col;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__heading {
|
||||||
|
@apply text-cwc-blue-01 text-24px font-bold leading-none mt-6 mb-4;
|
||||||
|
/* the orange accent underline from .post-title h1 */
|
||||||
|
&::after {
|
||||||
|
background: var(--color-secondary);
|
||||||
|
content: "";
|
||||||
|
display: block;
|
||||||
|
height: 4px;
|
||||||
|
margin-top: 0.45rem;
|
||||||
|
width: 3rem;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
&__desc {
|
||||||
|
@apply text-gray-600 text-16px font-light leading-snug;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
The bisecting line is rendered behind the cards (z-index: 1 on the line, 2 on the grid). The 25% top offset aims at the vertical center of the square image; minor visual variation is acceptable. The line itself is a thin orange `<rect>` SVG (8px tall) spanning full width.
|
||||||
|
|
||||||
|
#### Block registration (`views/blocks/services-list/block.json`)
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "acf/services-list",
|
||||||
|
"title": "Services List",
|
||||||
|
"description": "A row of service cards (2, 3, or 4). Layout adapts to the count.",
|
||||||
|
"category": "common",
|
||||||
|
"icon": "grid-view",
|
||||||
|
"keywords": ["services", "cards", "mapping"],
|
||||||
|
"acf": {
|
||||||
|
"mode": "preview",
|
||||||
|
"renderTemplate": "services-list.php"
|
||||||
|
},
|
||||||
|
"supports": {
|
||||||
|
"anchor": true,
|
||||||
|
"align": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
The block is auto-registered via `regACFBlocks()` in `functions.php`, which scans `views/blocks/*` and calls `register_block_type()` on each folder.
|
||||||
|
|
||||||
|
### 2. Decorative SVG: `static/img/services-list-line.svg`
|
||||||
|
|
||||||
|
A simple orange horizontal line, 1600×8 viewBox, full-bleed:
|
||||||
|
|
||||||
|
```svg
|
||||||
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1600 8" preserveAspectRatio="none">
|
||||||
|
<rect x="0" y="3" width="1600" height="2" fill="#F26B53" />
|
||||||
|
</svg>
|
||||||
|
```
|
||||||
|
|
||||||
|
The `preserveAspectRatio="none"` lets the line stretch to whatever width the container is. Fill `#F26B53` matches the existing brand orange already used in the icons (`stroke="#F26B53"` on `next.php` / `prev.php`).
|
||||||
|
|
||||||
|
### 3. Closing block: reuse `pull-quote`
|
||||||
|
|
||||||
|
The closing "At CWC, mapping is about more than data…" block already matches the `pull-quote` block's contract. The editor adds a `Pull Quote` block to the page, sets:
|
||||||
|
- **Text** (wysiwyg with bold): `At CWC, mapping is about more than data. It is about helping people understand and make decisions about their land and communities.` with **"more than data."** bolded.
|
||||||
|
- **Background Color**: `#E6F0F5` (the light blue in the mockup) or the default `--color-pullquote-bg` if it's already correct.
|
||||||
|
- **Background Image**: optional, if the decorative linework is editor-managed; otherwise leave blank — the existing `mobile-pullquote-vector.svg` / `pull-quote__vector--mobile` provides the linework.
|
||||||
|
|
||||||
|
If `pull-quote`'s default `bg-(--color-pullquote-bg)` already matches the mockup's light blue, no field tweak is needed. If it does not match, the editor sets the explicit hex. **No code change to the pull-quote block.**
|
||||||
|
|
||||||
|
### 4. Page integration
|
||||||
|
|
||||||
|
The mapping page (and any future service sub-page) is composed entirely in Gutenberg:
|
||||||
|
|
||||||
|
1. Add a `Services List` block, populate with 4 items: Community Mapping Initiatives, Spatial Analysis and GIS Services, Spatial Database Management, Data Collection Services, Cartography, Land Related Support Services. Wait — the mockup has 2 large + 4 small = 6 items across 2 separate rows. **Resolution:** the editor adds **two `Services List` blocks** on the mapping page: one with 2 items, one with 4 items. Each block renders as a single row.
|
||||||
|
2. Add a `Pull Quote` block, populate with the closing text.
|
||||||
|
|
||||||
|
`page.php` already iterates `the_content()` and renders whatever blocks are present. No PHP change.
|
||||||
|
|
||||||
|
### 5. CSS import (`styles/blocks/index.css`)
|
||||||
|
|
||||||
|
Add at the end of the existing imports:
|
||||||
|
|
||||||
|
```css
|
||||||
|
@import '../../views/blocks/services-list/services-list.css';
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. Tests (`tests/services-page.spec.js`)
|
||||||
|
|
||||||
|
A new Playwright spec covering the rendered block on the mapping page:
|
||||||
|
|
||||||
|
```js
|
||||||
|
import { test, expect } from "@playwright/test";
|
||||||
|
import AxeBuilder from "@axe-core/playwright";
|
||||||
|
|
||||||
|
test.describe("Services List block on /services/mapping/", () => {
|
||||||
|
test("renders the heading and image for each card", async ({ page }) => {
|
||||||
|
await page.goto("/services/mapping/");
|
||||||
|
|
||||||
|
// Both services-list blocks render.
|
||||||
|
const blocks = page.locator(".services-list");
|
||||||
|
await expect(blocks).toHaveCount(2);
|
||||||
|
|
||||||
|
// First block (featured) has 2 cards; second (grid) has 4.
|
||||||
|
await expect(blocks.nth(0).locator(".services-list__card")).toHaveCount(2);
|
||||||
|
await expect(blocks.nth(1).locator(".services-list__card")).toHaveCount(4);
|
||||||
|
|
||||||
|
// Each card has an image and a heading.
|
||||||
|
const firstCard = blocks.nth(0).locator(".services-list__card").first();
|
||||||
|
await expect(firstCard.locator(".services-list__media img")).toBeVisible();
|
||||||
|
await expect(firstCard.locator(".services-list__heading")).toBeVisible();
|
||||||
|
});
|
||||||
|
|
||||||
|
test("bisecting line is present and aria-hidden", async ({ page }) => {
|
||||||
|
await page.goto("/services/mapping/");
|
||||||
|
const line = page.locator(".services-list__line").first();
|
||||||
|
await expect(line).toBeAttached();
|
||||||
|
await expect(line).toHaveAttribute("aria-hidden", "true");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("no axe violations on the block", async ({ page }) => {
|
||||||
|
await page.goto("/services/mapping/");
|
||||||
|
const results = await new AxeBuilder({ page })
|
||||||
|
.include(".services-list")
|
||||||
|
.analyze();
|
||||||
|
expect(results.violations).toEqual([]);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Out of Scope
|
||||||
|
|
||||||
|
- `header.php`, `footer.php`, the page hero — explicitly untouched.
|
||||||
|
- A new template file for service pages — `page.php` already suffices.
|
||||||
|
- Per-item "size" override (the size is fully driven by item count).
|
||||||
|
- A custom layout for the closing block — `pull-quote` covers it.
|
||||||
|
- An editor-uploadable linework SVG — the line is a fixed asset.
|
||||||
|
- Mobile-specific layout — the responsive `grid-cols-1 lg:grid-cols-N` handles it. The bisecting line is hidden on mobile (below `lg:`) so it does not bisect the stacked single-column cards awkwardly.
|
||||||
|
- Animations on the cards.
|
||||||
|
- Dark mode.
|
||||||
|
- A new CSS color or a new font — everything reuses existing tokens.
|
||||||
|
|
||||||
|
## Self-Review Notes
|
||||||
|
|
||||||
|
- **Spec coverage:** One new ACF block (4 files), one SVG asset, two file modifications (CSS index, dist rebuild), one test file. Every spec section is covered.
|
||||||
|
- **Placeholder scan:** No "TBD", "TODO", or vague requirements. The bisecting line CSS, the dynamic `lg:grid-cols-N` class, the card aspect ratio, the title accent reuse — all explicit.
|
||||||
|
- **Type consistency:** Class names follow the existing BEM convention (`services-list__card`, `__media`, `__heading`, `__desc`, `__line`).
|
||||||
|
- **Scope check:** Single focused build, no decomposition needed. Block is small (≤4 files), testable in isolation, and composable on any service page.
|
||||||
|
- **Ambiguity check:** The "2 rows on the mapping page" question is resolved — editor adds 2 instances of the same block, one with 2 items, one with 4. The "orange line bisects images" question is resolved — fixed-positioned SVG with `top: 25%`, behind the cards, hidden on mobile.
|
||||||
@@ -0,0 +1,332 @@
|
|||||||
|
# Team Grid Block Design
|
||||||
|
|
||||||
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||||
|
|
||||||
|
**Goal:** Build a new `team-grid` ACF block for the Team page (and any other page that needs a team grid) that renders a responsive grid of team members. Each member shows their photo (rounded rectangle), name, and title. The bio is collapsed by default and expands vertically with a smooth animation when the photo, name, or title is clicked.
|
||||||
|
|
||||||
|
**Architecture:** One new ACF block (`acf/team-grid`) with a single repeater of `members` (image, name, title, bio). The block uses native HTML `<details>`/`<summary>` for the click-to-expand interaction, animated with the `grid-template-rows: 0fr → 1fr` CSS pattern (no JavaScript). The block has no built-in background — the editor wraps it in an existing Section block when a dark/light background is needed. The page template is unchanged; the editor adds the block to the Team page in Gutenberg.
|
||||||
|
|
||||||
|
**Tech Stack:** WordPress 6.x, PHP 8.x, Tailwind CSS v4, Playwright, axe-core, PHPCS (WordPress standard).
|
||||||
|
|
||||||
|
## Global Constraints
|
||||||
|
|
||||||
|
- Tabs for PHP indentation (project standard).
|
||||||
|
- `static/dist/theme.css` is committed (not gitignored) per project convention.
|
||||||
|
- PHPCS uses the WordPress coding standard; `composer lint` must pass for all touched files.
|
||||||
|
- All design colors use the project's existing CSS custom properties from `styles/base/colors.css`. No hardcoded hex values for theme colors.
|
||||||
|
- Reuse existing design tokens where possible (e.g. the `text-cwc-blue-01` heading color, `var(--color-secondary)` accent if needed).
|
||||||
|
- The headshot uses `rounded-md` to match other image cards in the project (`post-list`, `services-list`).
|
||||||
|
- All commits follow the project's emoji-prefixed commit-message style (e.g. `✨ feat: …`).
|
||||||
|
- This work does **not** edit `header.php`, `footer.php`, `views/partials/page-hero.php`, or `views/partials/page-hero-services.php`.
|
||||||
|
- `page.php` is not modified.
|
||||||
|
- No JavaScript files are added. The `<details>`/`<summary>` interaction is fully native.
|
||||||
|
- Reuse the same `regACFBlocks()` auto-registration pattern as `services-list`.
|
||||||
|
|
||||||
|
## Reference Mockup
|
||||||
|
|
||||||
|
`team-example.png` shows a dark-blue section with 8 team members in a 2-column grid. Each member has a circular headshot, name (bold), title (italic), and a multi-line bio below. All bios are visible in the mockup.
|
||||||
|
|
||||||
|
**Intent of the design (per the user):**
|
||||||
|
- The bio should be a `<details>` element that **opens vertically** when the photo, name, or title is clicked. The mockup shows the open state for every member for context; the live behavior is collapsed by default.
|
||||||
|
- The headshot should be a **rectangle with rounded corners that match other images in the project** — `rounded-md` is the project standard. The mockup's circular headshots are a visual approximation; the live design uses rounded rectangles.
|
||||||
|
- The block has no built-in background. The editor wraps it in a Section block (`acf/section`) when a dark or light background is needed.
|
||||||
|
- Layout is responsive: 1 column on mobile, 2 on tablet, 3 on desktop (the user's "3-2-1" choice).
|
||||||
|
|
||||||
|
## File Structure
|
||||||
|
|
||||||
|
| File | Responsibility | Created/Modified |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `acf/group_team_grid.json` | ACF field group for the `acf/team-grid` block. | Create |
|
||||||
|
| `views/blocks/team-grid/team-grid.php` | Block template (PHP) — renders the grid. | Create |
|
||||||
|
| `views/blocks/team-grid/team-grid.css` | Block styles (CSS) — layout, photo, summary, animation. | Create |
|
||||||
|
| `views/blocks/team-grid/block.json` | Block registration metadata. | Create |
|
||||||
|
| `styles/blocks/index.css` | Import the new block's CSS. | Modify |
|
||||||
|
| `tests/team-page.spec.js` | Playwright tests for the rendered block. | Create |
|
||||||
|
| `static/dist/theme.css` | Rebuilt via `npm run build`. | Modified |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Design Details
|
||||||
|
|
||||||
|
### 1. ACF field group: `acf/team-grid`
|
||||||
|
|
||||||
|
**Block name (registration key):** `acf/team-grid`
|
||||||
|
**Editor title:** "Team Grid"
|
||||||
|
**Category:** common
|
||||||
|
**Description (in block.json):** "A responsive grid of team members. Click a card to expand the bio."
|
||||||
|
|
||||||
|
#### ACF field group (`acf/group_team_grid.json`)
|
||||||
|
|
||||||
|
```
|
||||||
|
Group key: group_team_grid
|
||||||
|
Group title: Team Grid
|
||||||
|
Position: normal
|
||||||
|
Menu order: 0
|
||||||
|
Location: block == acf/team-grid
|
||||||
|
```
|
||||||
|
|
||||||
|
Fields:
|
||||||
|
- `members` (repeater, layout: block, button label: "Add Team Member")
|
||||||
|
- `image` (image, return_format: array, required: 0) — Headshot.
|
||||||
|
- `name` (text, required: 0) — Person's name (e.g. "Christopher Werner").
|
||||||
|
- `title` (text, required: 0) — Person's role (e.g. "Principal Consultant & CEO").
|
||||||
|
- `bio` (wysiwyg, tabs: visual, toolbar: basic, media_upload: 0, required: 0) — Bio body copy.
|
||||||
|
|
||||||
|
The block is intentionally minimal. No per-card size, no global layout toggle, no CTA field, no group-level background color. Layout derives from CSS (`grid-cols-1 sm:grid-cols-2 lg:grid-cols-3`).
|
||||||
|
|
||||||
|
#### Block registration (`views/blocks/team-grid/block.json`)
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "acf/team-grid",
|
||||||
|
"title": "Team Grid",
|
||||||
|
"description": "A responsive grid of team members. Click a card to expand the bio.",
|
||||||
|
"category": "common",
|
||||||
|
"icon": "groups",
|
||||||
|
"keywords": ["team", "people", "staff", "bio"],
|
||||||
|
"acf": {
|
||||||
|
"mode": "preview",
|
||||||
|
"renderTemplate": "team-grid.php"
|
||||||
|
},
|
||||||
|
"supports": {
|
||||||
|
"anchor": true,
|
||||||
|
"align": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
The `icon: "groups"` is a WordPress Dashicon that visually represents a group of people.
|
||||||
|
|
||||||
|
#### Block template (`views/blocks/team-grid/team-grid.php`)
|
||||||
|
|
||||||
|
```php
|
||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* Block Name: Team Grid
|
||||||
|
*
|
||||||
|
* A responsive grid of team members. Each card uses a native <details>
|
||||||
|
* element so the bio expands when the photo, name, or title is clicked.
|
||||||
|
*
|
||||||
|
* @package CWC
|
||||||
|
*/
|
||||||
|
|
||||||
|
namespace CWC;
|
||||||
|
|
||||||
|
$members = get_field( 'members' );
|
||||||
|
|
||||||
|
if ( empty( $members ) ) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
$classes = 'team-grid container my-section mx-auto';
|
||||||
|
$wrapper = blockWrapperAttributes( $classes, $is_preview );
|
||||||
|
?>
|
||||||
|
|
||||||
|
<section <?php echo wp_kses_post( $wrapper ); ?>>
|
||||||
|
<div class="team-grid__inner grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-8 lg:gap-12">
|
||||||
|
<?php foreach ( $members as $member ) : ?>
|
||||||
|
<article class="team-grid__card">
|
||||||
|
<details class="team-grid__details">
|
||||||
|
<summary class="team-grid__summary">
|
||||||
|
<?php if ( ! empty( $member['image'] ) ) : ?>
|
||||||
|
<img
|
||||||
|
class="team-grid__photo"
|
||||||
|
src="<?php echo esc_url( $member['image']['url'] ); ?>"
|
||||||
|
alt="<?php echo esc_attr( $member['image']['alt'] ?? '' ); ?>"
|
||||||
|
loading="lazy"
|
||||||
|
/>
|
||||||
|
<?php endif; ?>
|
||||||
|
|
||||||
|
<?php if ( ! empty( $member['name'] ) ) : ?>
|
||||||
|
<h3 class="team-grid__name">
|
||||||
|
<?php echo wp_kses_post( $member['name'] ); ?>
|
||||||
|
</h3>
|
||||||
|
<?php endif; ?>
|
||||||
|
|
||||||
|
<?php if ( ! empty( $member['title'] ) ) : ?>
|
||||||
|
<p class="team-grid__title">
|
||||||
|
<?php echo wp_kses_post( $member['title'] ); ?>
|
||||||
|
</p>
|
||||||
|
<?php endif; ?>
|
||||||
|
</summary>
|
||||||
|
|
||||||
|
<div class="team-grid__bio-wrap">
|
||||||
|
<div class="team-grid__bio-inner">
|
||||||
|
<?php if ( ! empty( $member['bio'] ) ) : ?>
|
||||||
|
<div class="team-grid__bio">
|
||||||
|
<?php echo wp_kses_post( $member['bio'] ); ?>
|
||||||
|
</div>
|
||||||
|
<?php endif; ?>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</details>
|
||||||
|
</article>
|
||||||
|
<?php endforeach; ?>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
```
|
||||||
|
|
||||||
|
Notes:
|
||||||
|
- Native `<details>`/`<summary>`: the summary is the click target (photo + name + title); the body is the bio wrap.
|
||||||
|
- The `<details>` element is closed by default — no `open` attribute. The user opens it on click.
|
||||||
|
- The bio uses `wysiwyg` so editors can add links or basic formatting. Output is sanitized via `wp_kses_post`.
|
||||||
|
- `team-grid__bio-wrap` is a 1-row grid container that animates `grid-template-rows` from `0fr` to `1fr`. The `__bio-inner` inside has `overflow: hidden; min-height: 0` so the bio is clipped during the transition.
|
||||||
|
|
||||||
|
#### Block styles (`views/blocks/team-grid/team-grid.css`)
|
||||||
|
|
||||||
|
```css
|
||||||
|
/* Team Grid block */
|
||||||
|
|
||||||
|
.team-grid {
|
||||||
|
&__card {
|
||||||
|
@apply flex flex-col;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__details {
|
||||||
|
@apply flex flex-col;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* summary is the click target. Strip the default disclosure triangle. */
|
||||||
|
&__summary {
|
||||||
|
@apply flex flex-col items-center text-center cursor-pointer list-none;
|
||||||
|
|
||||||
|
&::-webkit-details-marker {
|
||||||
|
display: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
&::marker {
|
||||||
|
display: none;
|
||||||
|
content: '';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
&__photo {
|
||||||
|
@apply w-32 h-32 sm:w-40 sm:h-40 lg:w-48 lg:h-48 object-cover rounded-md mb-4;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__name {
|
||||||
|
@apply text-cwc-blue-01 text-22px font-bold leading-tight mb-1;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__title {
|
||||||
|
@apply text-gray-600 text-16px font-light italic mb-3;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Animation: animate grid-template-rows 0fr -> 1fr. */
|
||||||
|
&__bio-wrap {
|
||||||
|
display: grid;
|
||||||
|
grid-template-rows: 0fr;
|
||||||
|
transition: grid-template-rows 300ms ease;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__details[open] &__bio-wrap {
|
||||||
|
grid-template-rows: 1fr;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__bio-inner {
|
||||||
|
overflow: hidden;
|
||||||
|
min-height: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
&__bio {
|
||||||
|
@apply text-gray-700 text-16px font-light leading-snug pt-2;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Notes:
|
||||||
|
- The summary is a flex column with `items-center` so the photo, name, and title stack centered. This matches the mockup.
|
||||||
|
- The default `<summary>` marker (▶ triangle) is hidden with `list-style: none` plus vendor-prefixed `::-webkit-details-marker` and `::marker` reset.
|
||||||
|
- The `&__details[open] &__bio-wrap` selector uses CSS nesting to target the bio wrap when the parent details is open. This compiles to `.team-grid__details[open] .team-grid__bio-wrap { grid-template-rows: 1fr; }`.
|
||||||
|
- The `team-grid__details[open] &__bio-wrap` syntax uses CSS nesting: `&` inside `&__details[open]` is the previous compound selector. Tailwind v4 (lightningcss) unwraps this correctly.
|
||||||
|
- Photo sizes: `w-32 h-32` (8rem / 128px) on mobile, `w-40 h-40` (10rem / 160px) on small, `w-48 h-48` (12rem / 192px) on large.
|
||||||
|
|
||||||
|
### 2. CSS import wiring (`styles/blocks/index.css`)
|
||||||
|
|
||||||
|
Append at the end of `styles/blocks/index.css`:
|
||||||
|
|
||||||
|
```css
|
||||||
|
@import '../../views/blocks/team-grid/team-grid.css';
|
||||||
|
```
|
||||||
|
|
||||||
|
After the edit, the file ends with:
|
||||||
|
|
||||||
|
```
|
||||||
|
@import '../../views/blocks/services-list/services-list.css';
|
||||||
|
@import '../../views/blocks/team-grid/team-grid.css';
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Page integration
|
||||||
|
|
||||||
|
`page.php` is unchanged. The editor adds a `Team Grid` block to the Team page (`/team/`) in Gutenberg. To get the dark-blue background, the editor wraps the `Team Grid` block in a `Section` block (`acf/section`) and sets the Section's `background_color` to the dark blue.
|
||||||
|
|
||||||
|
No PHP template change is required.
|
||||||
|
|
||||||
|
### 4. CSS Build
|
||||||
|
|
||||||
|
Run `npm run build` to compile Tailwind v4 → `static/dist/theme.css`. The new utilities (e.g. `text-22px`, `text-16px`, `w-32 h-32`, `rounded-md`) must appear in the dist.
|
||||||
|
|
||||||
|
### 5. Tests (`tests/team-page.spec.js`)
|
||||||
|
|
||||||
|
```js
|
||||||
|
import { test, expect } from "@playwright/test";
|
||||||
|
import AxeBuilder from "@axe-core/playwright";
|
||||||
|
|
||||||
|
test.describe("Team Grid block on /team/", () => {
|
||||||
|
test("renders the photo, name, and title for each member", async ({ page }) => {
|
||||||
|
await page.goto("/team/");
|
||||||
|
|
||||||
|
const cards = page.locator(".team-grid__card");
|
||||||
|
await expect(cards.first()).toBeVisible();
|
||||||
|
|
||||||
|
const firstCard = cards.first();
|
||||||
|
await expect(firstCard.locator(".team-grid__photo")).toBeVisible();
|
||||||
|
await expect(firstCard.locator(".team-grid__name")).toBeVisible();
|
||||||
|
await expect(firstCard.locator(".team-grid__title")).toBeVisible();
|
||||||
|
});
|
||||||
|
|
||||||
|
test("bio is hidden by default and expands on summary click", async ({ page }) => {
|
||||||
|
await page.goto("/team/");
|
||||||
|
|
||||||
|
const firstDetails = page.locator(".team-grid__details").first();
|
||||||
|
// Bio is closed by default.
|
||||||
|
await expect(firstDetails).not.toHaveAttribute("open", "");
|
||||||
|
|
||||||
|
// Click the summary; the details should open and the bio should be visible.
|
||||||
|
await firstDetails.locator(".team-grid__summary").click();
|
||||||
|
await expect(firstDetails).toHaveAttribute("open", "");
|
||||||
|
await expect(firstDetails.locator(".team-grid__bio")).toBeVisible();
|
||||||
|
|
||||||
|
// Click again; the details should close.
|
||||||
|
await firstDetails.locator(".team-grid__summary").click();
|
||||||
|
await expect(firstDetails).not.toHaveAttribute("open", "");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("no axe violations on the team-grid block", async ({ page }) => {
|
||||||
|
await page.goto("/team/");
|
||||||
|
const results = await new AxeBuilder({ page })
|
||||||
|
.include(".team-grid")
|
||||||
|
.analyze();
|
||||||
|
expect(results.violations).toEqual([]);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
### Out of Scope
|
||||||
|
|
||||||
|
- The Team page template — `page.php` is unchanged. The editor adds the block in Gutenberg.
|
||||||
|
- The Section block wrapper for the dark-blue background — the editor composes this in Gutenberg.
|
||||||
|
- A custom open/close icon or arrow indicator — the click target is the entire summary (photo + name + title), so no chevron is needed.
|
||||||
|
- Animations beyond the bio's expand/collapse transition. No hover transforms, no entry animations.
|
||||||
|
- Per-card size variants — all cards are the same size.
|
||||||
|
- A `data-team-member-id` slug for deep-linking to a specific member's expanded bio.
|
||||||
|
- Dark-mode overrides — the block is color-agnostic and inherits the parent Section's color scheme.
|
||||||
|
- Per-page header/footer changes.
|
||||||
|
|
||||||
|
## Self-Review Notes
|
||||||
|
|
||||||
|
- **Spec coverage:** One new ACF block (4 files), one CSS import, dist rebuild, one test file. Every spec section is covered.
|
||||||
|
- **Placeholder scan:** No TBDs. Every step has a concrete file path, exact content, exact command, and expected output.
|
||||||
|
- **Type consistency:** Class names use the existing BEM convention (`__card`, `__details`, `__summary`, `__photo`, `__name`, `__title`, `__bio-wrap`, `__bio-inner`, `__bio`). Field names (`members`, `image`, `name`, `title`, `bio`) are used in the JSON, the PHP, and the tests.
|
||||||
|
- **Scope check:** Single focused build, no decomposition needed. Block is small (≤4 files), testable in isolation, and composable on the Team page (and any other page that needs a team grid).
|
||||||
|
- **Ambiguity check:** The "rounded rectangle" headshot is concretely specified as `rounded-md`. The "open vertically" animation is concretely specified as `grid-template-rows: 0fr → 1fr` with a 300ms transition. The "3-2-1" responsive grid is concretely specified. The "no background" decision is concretely scoped to the Section block wrapper (editor's responsibility, not this block's).
|
||||||
+5
-1
@@ -20,7 +20,11 @@ $footerNav = ! empty( $locations['footer_navigation'] )
|
|||||||
? ( wp_get_nav_menu_items( (int) $locations['footer_navigation'] ) ? wp_get_nav_menu_items( (int) $locations['footer_navigation'] ) : array() )
|
? ( wp_get_nav_menu_items( (int) $locations['footer_navigation'] ) ? wp_get_nav_menu_items( (int) $locations['footer_navigation'] ) : array() )
|
||||||
: array();
|
: array();
|
||||||
|
|
||||||
if ( ! is_page( 'contact' ) ) {
|
$services = get_page_by_path( 'services' )->ID;
|
||||||
|
|
||||||
|
$svcChild = $post->post_parent === $services ? true : false;
|
||||||
|
|
||||||
|
if ( ! is_page( 'contact' ) && ! $svcChild ) {
|
||||||
$marginClass = 'mt-20';
|
$marginClass = 'mt-20';
|
||||||
}
|
}
|
||||||
?>
|
?>
|
||||||
|
|||||||
@@ -154,6 +154,7 @@ add_filter(
|
|||||||
unset( $blocks['core/calendar'] );
|
unset( $blocks['core/calendar'] );
|
||||||
unset( $blocks['core/buttons'] );
|
unset( $blocks['core/buttons'] );
|
||||||
unset( $blocks['core/search'] );
|
unset( $blocks['core/search'] );
|
||||||
|
unset( $blocks['core/pullquote'] );
|
||||||
|
|
||||||
// return the new list of allowed blocks
|
// return the new list of allowed blocks
|
||||||
return array_keys( $blocks );
|
return array_keys( $blocks );
|
||||||
|
|||||||
Vendored
+6043
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,3 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1600 32" preserveAspectRatio="none">
|
||||||
|
<rect x="0" y="3" width="1600" height="32" fill="#F26B53" />
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 162 B |
@@ -5,3 +5,5 @@
|
|||||||
@import './misc.css';
|
@import './misc.css';
|
||||||
@import './page-hero.css';
|
@import './page-hero.css';
|
||||||
@import '../../views/blocks/contact-info/contact-info.css';
|
@import '../../views/blocks/contact-info/contact-info.css';
|
||||||
|
@import '../../views/blocks/services-list/services-list.css';
|
||||||
|
@import '../../views/blocks/team-grid/team-grid.css';
|
||||||
|
|||||||
@@ -77,7 +77,7 @@
|
|||||||
top: calc(100% + 1rem);
|
top: calc(100% + 1rem);
|
||||||
z-index: 10000;
|
z-index: 10000;
|
||||||
|
|
||||||
@apply bg-cwc-blue-02 shadow-lg left-0 w-64 flex-col rounded-b-lg ml-0;
|
@apply bg-cwc-blue-02 shadow-lg left-0 w-84 flex-col rounded-b-lg ml-0;
|
||||||
|
|
||||||
>li {
|
>li {
|
||||||
@apply w-full border-b border-[#D24D32];
|
@apply w-full border-b border-[#D24D32];
|
||||||
|
|||||||
@@ -0,0 +1,36 @@
|
|||||||
|
import { test, expect } from "@playwright/test";
|
||||||
|
import AxeBuilder from "@axe-core/playwright";
|
||||||
|
|
||||||
|
test.describe("Services List block on /services/mapping/", () => {
|
||||||
|
test("renders the heading and image for each card", async ({ page }) => {
|
||||||
|
await page.goto("/services/mapping/");
|
||||||
|
|
||||||
|
const blocks = page.locator(".services-list");
|
||||||
|
await expect(blocks).toHaveCount(2);
|
||||||
|
|
||||||
|
await expect(blocks.nth(0).locator(".services-list__card")).toHaveCount(2);
|
||||||
|
await expect(blocks.nth(1).locator(".services-list__card")).toHaveCount(4);
|
||||||
|
|
||||||
|
await expect(blocks.nth(0)).toHaveClass(/lg:grid-cols-2/);
|
||||||
|
await expect(blocks.nth(1)).toHaveClass(/lg:grid-cols-4/);
|
||||||
|
|
||||||
|
const firstCard = blocks.nth(0).locator(".services-list__card").first();
|
||||||
|
await expect(firstCard.locator(".services-list__media img")).toBeVisible();
|
||||||
|
await expect(firstCard.locator(".services-list__heading")).toBeVisible();
|
||||||
|
});
|
||||||
|
|
||||||
|
test("bisecting line is present and aria-hidden", async ({ page }) => {
|
||||||
|
await page.goto("/services/mapping/");
|
||||||
|
const line = page.locator(".services-list__line").first();
|
||||||
|
await expect(line).toBeAttached();
|
||||||
|
await expect(line).toHaveAttribute("aria-hidden", "true");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("no axe violations on the services-list block", async ({ page }) => {
|
||||||
|
await page.goto("/services/mapping/");
|
||||||
|
const results = await new AxeBuilder({ page })
|
||||||
|
.include(".services-list")
|
||||||
|
.analyze();
|
||||||
|
expect(results.violations).toEqual([]);
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -0,0 +1,41 @@
|
|||||||
|
import { test, expect } from "@playwright/test";
|
||||||
|
import AxeBuilder from "@axe-core/playwright";
|
||||||
|
|
||||||
|
test.describe("Team Grid block on /team/", () => {
|
||||||
|
test("renders the photo, name, and title for each member", async ({ page }) => {
|
||||||
|
await page.goto("/team/");
|
||||||
|
|
||||||
|
const cards = page.locator(".team-grid__card");
|
||||||
|
await expect(cards.first()).toBeVisible();
|
||||||
|
|
||||||
|
const firstCard = cards.first();
|
||||||
|
await expect(firstCard.locator(".team-grid__photo")).toBeVisible();
|
||||||
|
await expect(firstCard.locator(".team-grid__name")).toBeVisible();
|
||||||
|
await expect(firstCard.locator(".team-grid__title")).toBeVisible();
|
||||||
|
});
|
||||||
|
|
||||||
|
test("bio is hidden by default and expands on summary click", async ({ page }) => {
|
||||||
|
await page.goto("/team/");
|
||||||
|
|
||||||
|
const firstDetails = page.locator(".team-grid__details").first();
|
||||||
|
// Bio is closed by default.
|
||||||
|
await expect(firstDetails).not.toHaveAttribute("open", "");
|
||||||
|
|
||||||
|
// Click the summary; the details should open and the bio should be visible.
|
||||||
|
await firstDetails.locator(".team-grid__summary").click();
|
||||||
|
await expect(firstDetails).toHaveAttribute("open", "");
|
||||||
|
await expect(firstDetails.locator(".team-grid__bio")).toBeVisible();
|
||||||
|
|
||||||
|
// Click again; the details should close.
|
||||||
|
await firstDetails.locator(".team-grid__summary").click();
|
||||||
|
await expect(firstDetails).not.toHaveAttribute("open", "");
|
||||||
|
});
|
||||||
|
|
||||||
|
test("no axe violations on the team-grid block", async ({ page }) => {
|
||||||
|
await page.goto("/team/");
|
||||||
|
const results = await new AxeBuilder({ page })
|
||||||
|
.include(".team-grid")
|
||||||
|
.analyze();
|
||||||
|
expect(results.violations).toEqual([]);
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -34,7 +34,6 @@
|
|||||||
font-weight: 500;
|
font-weight: 500;
|
||||||
line-height: 1;
|
line-height: 1;
|
||||||
text-align: center;
|
text-align: center;
|
||||||
text-wrap: balance;
|
|
||||||
|
|
||||||
strong,
|
strong,
|
||||||
b {
|
b {
|
||||||
|
|||||||
@@ -36,7 +36,7 @@ $wrapper = blockWrapperAttributes( $classes, $is_preview );
|
|||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="container wider pull-quote__content">
|
<div class="container wider pull-quote__content">
|
||||||
<div class="pull-quote__text">
|
<div class="pull-quote__text <?php if ( is_front_page() ) { echo 'text-balance'; } // phpcs:ignore ?>">
|
||||||
<?php echo wp_kses_post( $quote_text ); ?>
|
<?php echo wp_kses_post( $quote_text ); ?>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|||||||
@@ -0,0 +1,19 @@
|
|||||||
|
{
|
||||||
|
"name": "acf/services-list",
|
||||||
|
"title": "Services List",
|
||||||
|
"description": "A row of service cards. Card count (2, 3, or 4) determines the layout.",
|
||||||
|
"category": "vdi-blocks",
|
||||||
|
"style": [
|
||||||
|
"file:./services-list.css"
|
||||||
|
],
|
||||||
|
"icon": "grid-view",
|
||||||
|
"keywords": ["services", "cards"],
|
||||||
|
"acf": {
|
||||||
|
"mode": "preview",
|
||||||
|
"renderTemplate": "services-list.php"
|
||||||
|
},
|
||||||
|
"supports": {
|
||||||
|
"anchor": true,
|
||||||
|
"align": false
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,60 @@
|
|||||||
|
/* Services List block */
|
||||||
|
|
||||||
|
.services-list {
|
||||||
|
--services-line-top: 22%;
|
||||||
|
|
||||||
|
.container { @apply px-0!; }
|
||||||
|
|
||||||
|
.services-list__line {
|
||||||
|
position: absolute;
|
||||||
|
inset-inline: 0;
|
||||||
|
top: var(--services-line-top);
|
||||||
|
height: 16px;
|
||||||
|
pointer-events: none;
|
||||||
|
z-index: 1;
|
||||||
|
background-image: url('../img/services-list-line.svg');
|
||||||
|
background-repeat: no-repeat;
|
||||||
|
background-position: center center;
|
||||||
|
background-size: 100% 100%;
|
||||||
|
}
|
||||||
|
|
||||||
|
.services-list__grid {
|
||||||
|
position: relative;
|
||||||
|
z-index: 2;
|
||||||
|
}
|
||||||
|
|
||||||
|
.services-list__card {
|
||||||
|
@apply flex flex-col;
|
||||||
|
}
|
||||||
|
|
||||||
|
.services-list__media {
|
||||||
|
@apply overflow-hidden rounded-md bg-gray-100;
|
||||||
|
}
|
||||||
|
|
||||||
|
.services-list__img {
|
||||||
|
@apply w-full h-full object-cover;
|
||||||
|
}
|
||||||
|
|
||||||
|
.services-list__heading {
|
||||||
|
@apply text-cwc-blue-01 text-32px font-black leading-none mt-6 mb-4;
|
||||||
|
|
||||||
|
&::after {
|
||||||
|
background: var(--color-secondary);
|
||||||
|
content: "";
|
||||||
|
display: block;
|
||||||
|
height: 4px;
|
||||||
|
margin-top: 0.45rem;
|
||||||
|
width: 3rem;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.services-list__desc {
|
||||||
|
@apply text-gray-600 text-16px font-light leading-snug;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (max-width: 1023px) {
|
||||||
|
.services-list__line {
|
||||||
|
display: none;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,59 @@
|
|||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* Block Name: Services List
|
||||||
|
*
|
||||||
|
* A row of service cards. Card count (2, 3, or 4) determines the layout.
|
||||||
|
*
|
||||||
|
* @package CWC
|
||||||
|
*/
|
||||||
|
|
||||||
|
namespace CWC;
|
||||||
|
|
||||||
|
$items = get_field( 'items' );
|
||||||
|
|
||||||
|
if ( empty( $items ) ) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
$count = count( $items );
|
||||||
|
$grid_cols = max( 2, min( 4, (int) $count ) );
|
||||||
|
$grid_class = 'lg:grid-cols-' . $grid_cols;
|
||||||
|
|
||||||
|
$classes = 'services-list mx-break-out relative mb-8 lg:mb-12 xl:mb-16 ' . $grid_class;
|
||||||
|
$wrapper = blockWrapperAttributes( $classes, $is_preview );
|
||||||
|
?>
|
||||||
|
|
||||||
|
<section <?php echo wp_kses_post( $wrapper ); ?>>
|
||||||
|
<div class="services-list__line" aria-hidden="true"></div>
|
||||||
|
|
||||||
|
<div class="container">
|
||||||
|
<div class="services-list__grid grid grid-cols-1 <?php echo esc_attr( $grid_class ); ?> gap-8 lg:gap-12">
|
||||||
|
<?php foreach ( $items as $item ) : ?>
|
||||||
|
<article class="services-list__card">
|
||||||
|
<?php if ( ! empty( $item['image'] ) ) : ?>
|
||||||
|
<figure class="services-list__media">
|
||||||
|
<img
|
||||||
|
class="services-list__img"
|
||||||
|
src="<?php echo esc_url( $item['image']['url'] ); ?>"
|
||||||
|
alt="<?php echo esc_attr( $item['image']['alt'] ?? '' ); ?>"
|
||||||
|
loading="lazy"
|
||||||
|
/>
|
||||||
|
</figure>
|
||||||
|
<?php endif; ?>
|
||||||
|
|
||||||
|
<?php if ( ! empty( $item['heading'] ) ) : ?>
|
||||||
|
<h3 class="services-list__heading">
|
||||||
|
<?php echo wp_kses_post( $item['heading'] ); ?>
|
||||||
|
</h3>
|
||||||
|
<?php endif; ?>
|
||||||
|
|
||||||
|
<?php if ( ! empty( $item['description'] ) ) : ?>
|
||||||
|
<div class="services-list__desc font-light text-18px">
|
||||||
|
<?php echo wp_kses_post( $item['description'] ); ?>
|
||||||
|
</div>
|
||||||
|
<?php endif; ?>
|
||||||
|
</article>
|
||||||
|
<?php endforeach; ?>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
@@ -0,0 +1,19 @@
|
|||||||
|
{
|
||||||
|
"name": "acf/team-grid",
|
||||||
|
"title": "Team Grid",
|
||||||
|
"description": "A responsive grid of team members. Click a card to expand the bio.",
|
||||||
|
"category": "common",
|
||||||
|
"style": [
|
||||||
|
"file:./team-grid.css"
|
||||||
|
],
|
||||||
|
"icon": "groups",
|
||||||
|
"keywords": ["team", "people", "staff", "bio"],
|
||||||
|
"acf": {
|
||||||
|
"mode": "preview",
|
||||||
|
"renderTemplate": "team-grid.php"
|
||||||
|
},
|
||||||
|
"supports": {
|
||||||
|
"anchor": true,
|
||||||
|
"align": false
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,66 @@
|
|||||||
|
/* Team Grid block */
|
||||||
|
|
||||||
|
.team-grid {
|
||||||
|
@apply my-12;
|
||||||
|
|
||||||
|
.team-grid__card { @apply flex flex-col; }
|
||||||
|
|
||||||
|
.team-grid__details { @apply flex flex-col; }
|
||||||
|
|
||||||
|
.team-grid__summary {
|
||||||
|
@apply flex flex-col items-center text-center cursor-pointer list-none;
|
||||||
|
|
||||||
|
&::-webkit-details-marker {
|
||||||
|
display: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
&::marker {
|
||||||
|
display: none;
|
||||||
|
content: '';
|
||||||
|
}
|
||||||
|
|
||||||
|
&:hover {
|
||||||
|
.team-grid__read-bio::after {
|
||||||
|
content: url("data:image/svg+xml,%3Csvg%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20transform%3D%22rotate(0%200%200)%22%3E%3Cpath%20d%3D%22M6.28033%2010.5947C5.98744%2010.3018%205.51256%2010.3018%205.21967%2010.5947C4.92678%2010.8876%204.92678%2011.3624%205.21967%2011.6553L11.4697%2017.9053C11.7626%2018.1982%2012.2374%2018.1982%2012.5303%2017.9053L18.7803%2011.6553C19.0732%2011.3624%2019.0732%2010.8876%2018.7803%2010.5947C18.4874%2010.3018%2018.0126%2010.3018%2017.7197%2010.5947L12%2016.3143L6.28033%2010.5947Z%22%20fill%3D%22%23006196%22%2F%3E%3Cpath%20opacity%3D%221%22%20d%3D%22M6.28033%206.09467C5.98744%205.80178%205.51256%205.80178%205.21967%206.09467C4.92678%206.38756%204.92678%206.86244%205.21967%207.15533L11.4697%2013.4053C11.7626%2013.6982%2012.2374%2018.1982%2012.5303%2013.4053L18.7803%207.15533C19.0732%206.86244%2019.0732%206.38756%2018.7803%206.09467C18.4874%205.80178%2018.0126%205.80178%2017.7197%206.09467L12%2011.8143L6.28033%206.09467Z%22%20fill%3D%22%23006196%22%2F%3E%3C%2Fsvg%3E");
|
||||||
|
width: 1.25rem;
|
||||||
|
height: 1.25rem;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-grid__photo {
|
||||||
|
@apply w-full h-full object-cover rounded-md mb-4;
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-grid__name {
|
||||||
|
@apply text-cwc-blue-01 text-22px font-bold leading-tight mb-1;
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-grid__title {
|
||||||
|
@apply text-cwc-blue-01 text-16px font-normal italic mb-3;
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-grid__read-bio {
|
||||||
|
@apply flex gap-2 justify-center items-center text-cwc-blue-01 text-16px font-bold leading-snug mb-1;
|
||||||
|
transition: transform 300ms ease;
|
||||||
|
|
||||||
|
&::after {
|
||||||
|
content: url("data:image/svg+xml,%3Csvg%20viewBox%3D%220%200%2024%2024%22%20fill%3D%22none%22%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20transform%3D%22rotate(0%200%200)%22%3E%3Cpath%20d%3D%22M6.28033%2010.5947C5.98744%2010.3018%205.51256%2010.3018%205.21967%2010.5947C4.92678%2010.8876%204.92678%2011.3624%205.21967%2011.6553L11.4697%2017.9053C11.7626%2018.1982%2012.2374%2018.1982%2012.5303%2017.9053L18.7803%2011.6553C19.0732%2011.3624%2019.0732%2010.8876%2018.7803%2010.5947C18.4874%2010.3018%2018.0126%2010.3018%2017.7197%2010.5947L12%2016.3143L6.28033%2010.5947Z%22%20fill%3D%22%23006196%22%2F%3E%3Cpath%20opacity%3D%220.5%22%20d%3D%22M6.28033%206.09467C5.98744%205.80178%205.51256%205.80178%205.21967%206.09467C4.92678%206.38756%204.92678%206.86244%205.21967%207.15533L11.4697%2013.4053C11.7626%2013.6982%2012.2374%2018.1982%2012.5303%2013.4053L18.7803%207.15533C19.0732%206.86244%2019.0732%206.38756%2018.7803%206.09467C18.4874%205.80178%2018.0126%205.80178%2017.7197%206.09467L12%2011.8143L6.28033%206.09467Z%22%20fill%3D%22%23006196%22%2F%3E%3C%2Fsvg%3E");
|
||||||
|
width: 1.25rem;
|
||||||
|
height: 1.25rem;
|
||||||
|
transition: transform 300ms ease;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-grid__details[open] .team-grid__read-bio::after {
|
||||||
|
transform: rotate(180deg);
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-grid__bio-wrap {
|
||||||
|
max-height: 0;
|
||||||
|
overflow: hidden;
|
||||||
|
transition: max-height 300ms ease;
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-grid__bio { @apply text-16px font-light leading-snug pt-2 text-center text-balance; }
|
||||||
|
}
|
||||||
@@ -0,0 +1,144 @@
|
|||||||
|
/**
|
||||||
|
* Team Grid block — bio expand/collapse animation.
|
||||||
|
*
|
||||||
|
* Native <details>/<summary> handles accessibility (keyboard, screen
|
||||||
|
* reader), but its default toggle behavior hides the children of the
|
||||||
|
* details element synchronously when [open] is removed. That makes
|
||||||
|
* CSS transitions impossible on the close direction, because by the
|
||||||
|
* time the toggle event fires, the element is already hidden.
|
||||||
|
*
|
||||||
|
* This module intercepts the click on the summary, prevents the default
|
||||||
|
* toggle, animates max-height manually, and toggles [open] after the
|
||||||
|
* animation completes. The bio is always at a known state during the
|
||||||
|
* animation.
|
||||||
|
*
|
||||||
|
* The module is enqueued per-block by the team-grid PHP template. It
|
||||||
|
* auto-initializes on import: queries the DOM for any existing
|
||||||
|
* .team-grid__details elements and attaches a click handler to each.
|
||||||
|
*/
|
||||||
|
|
||||||
|
const DETAILS_SELECTOR = '.team-grid__details';
|
||||||
|
const BIO_WRAP_SELECTOR = '.team-grid__bio-wrap';
|
||||||
|
const DURATION_MS = 300;
|
||||||
|
|
||||||
|
const setMaxHeight = (el, value) => {
|
||||||
|
el.style.maxHeight = typeof value === 'number' ? `${value}px` : value;
|
||||||
|
};
|
||||||
|
|
||||||
|
const measureBioHeight = (bioWrap) => {
|
||||||
|
// Temporarily allow the inner content to render at its natural size
|
||||||
|
// so scrollHeight reports the real height rather than the clipped height.
|
||||||
|
const previousMax = bioWrap.style.maxHeight;
|
||||||
|
const previousOverflow = bioWrap.style.overflow;
|
||||||
|
|
||||||
|
setMaxHeight(bioWrap, 'none');
|
||||||
|
bioWrap.style.overflow = 'visible';
|
||||||
|
|
||||||
|
const height = bioWrap.scrollHeight;
|
||||||
|
|
||||||
|
bioWrap.style.overflow = previousOverflow;
|
||||||
|
setMaxHeight(bioWrap, previousMax || '');
|
||||||
|
|
||||||
|
return height;
|
||||||
|
};
|
||||||
|
|
||||||
|
const animateOpen = (bioWrap, onComplete) => {
|
||||||
|
const target = measureBioHeight(bioWrap);
|
||||||
|
|
||||||
|
setMaxHeight(bioWrap, '0px');
|
||||||
|
|
||||||
|
// Force a reflow so the browser registers the starting value before
|
||||||
|
// we change it to the target — otherwise the transition is skipped.
|
||||||
|
// eslint-disable-next-line no-unused-expressions
|
||||||
|
bioWrap.offsetHeight;
|
||||||
|
|
||||||
|
requestAnimationFrame(() => {
|
||||||
|
setMaxHeight(bioWrap, `${target}px`);
|
||||||
|
});
|
||||||
|
|
||||||
|
const onEnd = (event) => {
|
||||||
|
if (event.propertyName !== 'max-height' || event.target !== bioWrap) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
bioWrap.removeEventListener('transitionend', onEnd);
|
||||||
|
if (onComplete) {
|
||||||
|
onComplete();
|
||||||
|
}
|
||||||
|
};
|
||||||
|
bioWrap.addEventListener('transitionend', onEnd);
|
||||||
|
};
|
||||||
|
|
||||||
|
const animateClose = (bioWrap, onComplete) => {
|
||||||
|
// The bio is currently open and rendered at its natural height.
|
||||||
|
// Capture it before we change anything.
|
||||||
|
const current = bioWrap.getBoundingClientRect().height;
|
||||||
|
|
||||||
|
setMaxHeight(bioWrap, `${current}px`);
|
||||||
|
|
||||||
|
// Force a reflow so the browser registers the starting value.
|
||||||
|
// eslint-disable-next-line no-unused-expressions
|
||||||
|
bioWrap.offsetHeight;
|
||||||
|
|
||||||
|
requestAnimationFrame(() => {
|
||||||
|
setMaxHeight(bioWrap, '0px');
|
||||||
|
});
|
||||||
|
|
||||||
|
const onEnd = (event) => {
|
||||||
|
if (event.propertyName !== 'max-height' || event.target !== bioWrap) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
bioWrap.removeEventListener('transitionend', onEnd);
|
||||||
|
if (onComplete) {
|
||||||
|
onComplete();
|
||||||
|
}
|
||||||
|
};
|
||||||
|
bioWrap.addEventListener('transitionend', onEnd);
|
||||||
|
};
|
||||||
|
|
||||||
|
const handleClick = (details, bioWrap, event) => {
|
||||||
|
// Only intercept clicks on the summary (or its descendants).
|
||||||
|
const summary = details.querySelector('summary');
|
||||||
|
if (!summary || !summary.contains(event.target)) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Prevent the browser's default toggle so we can animate first.
|
||||||
|
event.preventDefault();
|
||||||
|
|
||||||
|
if (details.open) {
|
||||||
|
// Closing: animate to 0, then remove [open] so the children hide.
|
||||||
|
animateClose(bioWrap, () => {
|
||||||
|
details.open = false;
|
||||||
|
});
|
||||||
|
} else {
|
||||||
|
// Opening: set [open] first (so the children are visible), then
|
||||||
|
// measure and animate to the natural height.
|
||||||
|
details.open = true;
|
||||||
|
animateOpen(bioWrap);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const attach = (details) => {
|
||||||
|
if (details.dataset.teamGridBound === 'true') {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
details.dataset.teamGridBound = 'true';
|
||||||
|
|
||||||
|
const bioWrap = details.querySelector(BIO_WRAP_SELECTOR);
|
||||||
|
if (!bioWrap) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Use click (not toggle) so we can preventDefault. Keyboard activation
|
||||||
|
// (Enter/Space on the summary) also dispatches a click event, so this
|
||||||
|
// covers both mouse and keyboard.
|
||||||
|
details.addEventListener('click', (event) => {
|
||||||
|
handleClick(details, bioWrap, event);
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
||||||
|
const init = () => {
|
||||||
|
document.querySelectorAll(DETAILS_SELECTOR).forEach(attach);
|
||||||
|
};
|
||||||
|
|
||||||
|
init();
|
||||||
@@ -0,0 +1,86 @@
|
|||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* Block Name: Team Grid
|
||||||
|
*
|
||||||
|
* A responsive grid of team members. Each card uses a native <details>
|
||||||
|
* element so the bio expands when the photo, name, or title is clicked.
|
||||||
|
*
|
||||||
|
* @package CWC
|
||||||
|
*/
|
||||||
|
|
||||||
|
namespace CWC;
|
||||||
|
|
||||||
|
$single = get_field( 'single' );
|
||||||
|
$members = get_field( 'members' );
|
||||||
|
|
||||||
|
if ( empty( $members ) ) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Enqueue the per-block JS only when this block actually renders.
|
||||||
|
$js_path = '/views/blocks/team-grid/team-grid.js';
|
||||||
|
if ( file_exists( get_stylesheet_directory() . $js_path ) ) {
|
||||||
|
wp_enqueue_script_module(
|
||||||
|
'cwc-team-grid',
|
||||||
|
get_stylesheet_directory_uri() . $js_path,
|
||||||
|
array(),
|
||||||
|
(string) filemtime( get_stylesheet_directory() . $js_path )
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
$modeSingle = '';
|
||||||
|
|
||||||
|
$blockID = wp_unique_id( 'single-' );
|
||||||
|
|
||||||
|
if ( $single ) {
|
||||||
|
$modeSingle = 'name=' . $blockID;
|
||||||
|
}
|
||||||
|
|
||||||
|
$classes = 'team-grid container my-section mx-auto';
|
||||||
|
$wrapper = blockWrapperAttributes( $classes, $is_preview );
|
||||||
|
?>
|
||||||
|
|
||||||
|
<section <?php echo wp_kses_post( $wrapper ); ?>>
|
||||||
|
<div class="team-grid__inner grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-8 lg:gap-12">
|
||||||
|
<?php foreach ( $members as $member ) : ?>
|
||||||
|
<article class="team-grid__card">
|
||||||
|
<details class="team-grid__details" <?php echo esc_attr( $modeSingle ); ?>>
|
||||||
|
<summary class="team-grid__summary">
|
||||||
|
<?php if ( ! empty( $member['image'] ) ) : ?>
|
||||||
|
<img
|
||||||
|
class="team-grid__photo"
|
||||||
|
src="<?php echo esc_url( $member['image']['url'] ); ?>"
|
||||||
|
alt="<?php echo esc_attr( $member['image']['alt'] ?? '' ); ?>"
|
||||||
|
loading="lazy"
|
||||||
|
/>
|
||||||
|
<?php endif; ?>
|
||||||
|
|
||||||
|
<?php if ( ! empty( $member['name'] ) ) : ?>
|
||||||
|
<h2 class="team-grid__name">
|
||||||
|
<?php echo wp_kses_post( $member['name'] ); ?>
|
||||||
|
</h2>
|
||||||
|
<?php endif; ?>
|
||||||
|
|
||||||
|
<?php if ( ! empty( $member['title'] ) ) : ?>
|
||||||
|
<h3 class="team-grid__title">
|
||||||
|
<?php echo wp_kses_post( $member['title'] ); ?>
|
||||||
|
</h3>
|
||||||
|
<?php endif; ?>
|
||||||
|
|
||||||
|
<h4 class="team-grid__read-bio" aria-label="Read Bio for <?php echo esc_attr( $member['name'] ); ?>">Read Bio</h4>
|
||||||
|
</summary>
|
||||||
|
|
||||||
|
<div class="team-grid__bio-wrap">
|
||||||
|
<div class="team-grid__bio-inner">
|
||||||
|
<?php if ( ! empty( $member['bio'] ) ) : ?>
|
||||||
|
<div class="team-grid__bio">
|
||||||
|
<?php echo wp_kses_post( $member['bio'] ); ?>
|
||||||
|
</div>
|
||||||
|
<?php endif; ?>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</details>
|
||||||
|
</article>
|
||||||
|
<?php endforeach; ?>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
Reference in New Issue
Block a user