wrapper to support multi-paragraph WYSIWYG content"
- "Migration approach: one-time PHP script using update_field() instead of manual WP admin entry"
- "ACF JSON: added collaboration_steps layout directly to JSON sync file"
patterns-established:
- "ACF migration: create migrate-XXXX.php script with safety checks, run once, delete after"
- "New layouts: add to both sections.php dispatcher AND acf-json group file"
duration: ~45min
started: 2026-04-11
completed: 2026-04-11
---
# Phase 1 Plan 01: ACF Migration page-2707 Summary
**Migrated hardcoded "Ogrody zimowe" page (2707) to ACF Flexible Content with 10 layouts and auto-populated content via migration script.**
## Acceptance Criteria Results
| Criterion | Status | Notes |
|-----------|--------|-------|
| AC-1: Flexible Content dispatcher complete | Pass | 3 new layouts added to sections.php (hero_with_form, gallery, collaboration_steps) |
| AC-2: Collaboration steps layout works | Pass | New partial renders numbered steps with repeater, hover effects, responsive CSS |
| AC-3: Page 2707 uses Flexible Content | Pass | Page reduced to 3 lines (header + sections + footer) |
| AC-4: Migration script populates content | Pass | All 10 layouts populated programmatically, user verified |
## Accomplishments
- Page 2707 fully editable from WP admin (10 ACF Flexible Content layouts)
- New reusable `collaboration_steps` layout with ACF field group definition in JSON
- Migration script pattern established for future page migrations (2598, 2101)
## Files Created/Modified
| File | Change | Purpose |
|------|--------|---------|
| `sections.php` | Modified | Added 3 layout dispatchers (hero_with_form, gallery, collaboration_steps) |
| `page-2707.php` | Modified | Replaced ~225 lines of hardcoded content with 3-line Flexible Content loader |
| `section-collaboration-steps.php` | Created | New partial for numbered cooperation steps with repeater |
| `migrate-2707.php` | Created | One-time migration script populating all 10 layouts (TO DELETE) |
| `section-hero-with-form.php` | Modified | Changed `
` to `
` for multi-paragraph WYSIWYG support |
| `custom.css` | Modified | Added darker gradient overlay on hero for page 2707 |
| `group_6494221367141.json` | Modified | Added collaboration_steps layout definition to ACF JSON sync |
## Deviations from Plan
### Summary
| Type | Count | Impact |
|------|-------|--------|
| Auto-fixed | 3 | Essential fixes for visual fidelity |
| Deferred | 0 | — |
### Auto-fixed Issues
**1. Hero text rendering broken (nested `
` tags)**
- Found during: Checkpoint verification
- Issue: Template wrapped text in `
`, WYSIWYG content also had `
` tags — browsers broke layout
- Fix: Changed `
` to `
` in section-hero-with-form.php
- Verification: User confirmed hero displays correctly
**2. Hero background too bright for text readability**
- Found during: Checkpoint verification
- Issue: White text on light background image had poor contrast
- Fix: Added `body.page-id-2707 .hero-with-form .bg-filter` rule with darker gradient (55% → 25% opacity)
- Verification: User confirmed "Jest ok"
**3. Layout 3 column order incorrect**
- Found during: Checkpoint verification
- Issue: "Co wyróżnia" section had image-left layout, user wanted text-left/image-right
- Fix: Removed `imageLeft` class from layout 3 in migration script
- Verification: User confirmed correct order
## Next Phase Readiness
**Ready:**
- Migration pattern proven — same approach applies to page-2598 and page-2101
- All existing ACF layouts verified working (two_col, two_col_with_bg, hero_with_form, gallery)
- collaboration_steps layout reusable for page-2598 (which has identical section)
**Concerns:**
- `migrate-2707.php` must be deleted from server after verification (security risk)
- Gallery images require attachment IDs — if images aren't in Media Library, they won't appear
**Blockers:** None
---
*Phase: 01-acf-migration-2707, Plan: 01*
*Completed: 2026-04-11*