WooNooW/tests/VERIFICATION_CHECKLIST.md

WooNooW v1.0 - Breaking Behavior Verification Checklist

This checklist should be completed before full rollout to verify no breaking behavior on existing pages and templates.

---

Pre-Flight Checks

• Database backup completed - Full backup including wp_options and wp_postmeta tables
• Staging environment verified - All tests pass on staging
• Error logging enabled - PHP error logging configured to catch any issues

---

Schema Migration Verification

Feature-Grid Items Normalization

• Legacy features → items migration works
  • Find a page with feature-grid using features prop
  • Load the page in admin editor
  • Verify features is normalized to items in the response
  • Save the page and verify items is persisted
  • Frontend still renders correctly

Style Key Normalization

• container_width → contentWidth migration works

  • Find pages with old style keys
  • Verify migration normalizes them on load
  • Frontend renders with correct width

• height → heightPreset migration works

  • Find pages with height: 'screen'
  • Verify migration converts to heightPreset: 'fullscreen'
  • Section renders with correct height

• backgroundType defaults added

  • Find pages with no backgroundType
  • Verify migration adds backgroundType: 'solid'
  • No visual changes occur

Element Styles Normalization

• cta → cta_text alias works
  • Find pages with elementStyles.cta
  • Verify migration normalizes to elementStyles.cta_text
  • Buttons still styled correctly

---

Section Rendering Verification

Hero Section

• Static title/subtitle/image render correctly

  • Create a hero section with all static content
  • Verify on frontend (human view)
  • Verify in SSR (bot view)
  • Content matches between both

• Dynamic placeholders resolve on frontend

  • Create a template with dynamic title source: post_title
  • Apply template to a blog post
  • Verify post title appears in hero

• Background styles render correctly

  • Hero with gradient background
  • Hero with image background
  • Hero with solid color
  • All styles match between React and SSR

Feature Grid Section

• Static items render correctly

  • Create feature grid with 3 items
  • Verify all items display
  • Verify icons render

• Dynamic related_posts source works

  • Create a template with items as dynamic: 'related_posts'
  • Apply to a blog post with 2+ related posts
  • Verify related posts appear as cards

• items prop used (not features)

  • Verify schema uses items
  • Verify SSR reads items
  • Backward compat with features still works

Image + Text Section

• Image left/right layouts work

  • Create with layout: 'image-left'
  • Create with layout: 'image-right'
  • Both render correctly

• Dynamic image source works

  • Use dynamic: 'post_featured_image'
  • Verify image appears

CTA Banner

• Button styling renders
  • CTA with custom colors
  • CTA with default styles
  • Both render correctly

Contact Form

• Form structure renders
  • Form fields present
  • Submit button present
  • No functional submission (acceptable for SSR)

All Other Sections

• Bento Category Grid - Categories render with images
• Product Carousel - Products display with prices
• Shoppable Image - Hotspots position correctly
• Marquee Banner - Text items separated correctly

---

Dynamic Source Resolution

Scalar Sources

• post_title resolves correctly
• post_content resolves with formatting
• post_excerpt resolves
• post_author resolves
• post_date resolves

URL Sources

• post_featured_image resolves to URL
• post_url / permalink resolves

Array Sources

• post_categories resolves to array
• post_tags resolves to array
• related_posts resolves to post objects with url, title, featured_image, excerpt

Fallback Behavior

• Empty post_title shows "(Untitled)"
• Empty post_featured_image returns empty string (no broken image)
• Empty related_posts returns empty array

---

Caching Behavior

• Post data caching works

  • First load fetches fresh data
  • Subsequent loads use cache
  • Cache expires after 5 minutes

• SSR cache invalidation works

  • Edit a page
  • Verify SSR cache is invalidated
  • Next bot visit renders fresh content

---

Edge Cases

Empty States

• Page with no sections renders empty container gracefully
• Feature grid with empty items shows empty state or nothing

Invalid Data

• Malformed section JSON doesn't crash the site
• Invalid dynamic source doesn't break rendering

Legacy Data

• Pages created before schema migration still work
• Templates created before migration still work
• No data loss on migration

---

Performance

• No significant SSR slowdown

  • SSR render time < 200ms for 10 sections
  • No N+1 queries in placeholder resolution

• No increased memory usage

  • Memory usage stable under load

---

Rollback Procedure

If issues are found:

1. Immediate: Disable plugin via WP Admin
2. Data safe: Migration is read-time, no destructive changes
3. Restore: Revert to previous plugin version
4. Investigation: Check error logs for specific failures

---

Sign-Off

• QA Sign-Off: _________________________ Date: ________
• Tech Lead Sign-Off: _________________________ Date: ________
• Product Sign-Off: _________________________ Date: ________

---

Notes

Use this space to document any issues found and their resolutions.

---