Skip to content

Flexia 3.2.1: keep the 3.1.0 header and footer on upgrade - #52

Open
rupok wants to merge 2 commits into
masterfrom
dev
Open

rupok wants to merge 2 commits into
masterfrom
dev

Conversation

@rupok

@rupok rupok commented Sep 13, 2026

Copy link
Copy Markdown
Owner

Follow-up to the 3.2.1 upgrade QA, which failed sign-off on four blocking issues.

Cause

parts/header.html and parts/footer.html contain nothing but a wp:pattern slug reference. 3.2.0 rewrote patterns/header.php and patterns/footer.php under those same slugs, so every site — customized or not — picked up the new chrome on update. A database-saved template part that only holds a pattern reference re-resolves the same way, so preserving the saved record did not preserve the layout.

Changes

  • FX-01 / FX-03 — patterns/header.php and patterns/footer.php restored byte-identical to 3.1.0. The 3.2.0 chrome ships as the new flexia/header-minimal and flexia/footer-minimal patterns, selectable in the Site Editor.
  • FX-02 — the minimal header's wp:navigation gets an explicit wp:page-list fallback, so it no longer resolves to the most recently created menu. The restored header carries its own inline links and never hits the fallback.
  • FX-04 — the minimal header lays out nowrap, keeping WooCommerce's injected account and mini-cart icons on the logo row.
  • FX-05 — .wp-block-post-content a no longer underlines .wp-element-button, .wp-block-button__link or .wc-block-components-button.
  • Migration note corrected; both new patterns added to tools/release-files.txt so the manifest builder ships them.

FX-06 needs no change: patterns/single-product.php already carries Inserter: no, so the pattern never reaches the block inserter.

Verification

  • 38 PHP files lint clean on PHP 8.2.29
  • tools/check-theme.py — 832 block declarations, 0 errors
  • Release ZIP builds to 131 files from a clean tree
  • Restored patterns confirmed byte-identical to 3.1.0 via git diff 7fa2ef7^

Still open

FX-04 needs a browser re-test against the restored header, which keeps its original flexWrap: "wrap". The reported slowdown on 3.2.0 is not addressed here.

🤖 Generated with Claude Code

Updating an existing site replaced its header and footer, because both
patterns were rewritten under their existing slugs while the template
parts only reference those slugs. Saved parts that contain nothing but a
wp:pattern reference re-resolve to the new markup, so preserving the
database record did not preserve the layout.

Restore patterns/header.php and patterns/footer.php to their 3.1.0
markup, and ship the native-identity chrome as the new header-minimal
and footer-minimal patterns. Give the minimal header's navigation an
explicit page-list fallback so it no longer resolves to an unrelated
saved menu, and lay that header out nowrap so WooCommerce's account and
mini-cart icons stay on the logo row.

Stop underlining button-shaped links inside post content, which also
underlined WooCommerce's Proceed to Checkout button, and correct the
migration note on database-saved template parts.

Covers FX-01 to FX-05 from the 3.2.1 upgrade QA.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant