Skip to content

Portal pages, breadcrumb refactor & archive redirects

Published on October 5, 2025

Last updated on June 8, 2026

This round focused on structural refinements and unifying behavior across the site’s growing network of CPTs, archive redirects, and breadcrumb logic — with “Portal Pages” officially introduced as a new core content type.

Portal CPT registered & integrated

  • Added a dedicated portal custom post type modeled after “Concepts.”
  • Supports title, editor, thumbnail, and excerpt for consistent grid display.
  • Implemented a concise excerpt: “Curated overviews consolidating key topics with context and connections.”
  • Set up proper archive and single templates (content-portal.php, single-portal.php, and page-portal.php) for full integration.

Search page hierarchy adjusted

  • Reordered search result priorities: Portal Pages → Topics → Themes → All Other CPTs.
  • Ensured consistent styling via theme-grid partial for taxonomy results.

Breadcrumbs unified via central mapper

  • Refactored inc/breadcrumbs.php to pull titles and links directly from the global CPT metadata array (get_cpt_metadata()), ensuring consistency across CPT archives, breadcrumbs, and redirects.
  • Fixed pluralization mismatches (e.g., “Books” → “Books Cited,” “Songs” → “Songs Featured”).
  • Cleaned up redundant self‑links for themes/topics taxonomy breadcrumbs.

Archive redirects modernized

  • Updated inc/redirects.php to use the same centralized CPT mapper for all archive → page redirects.
  • Removed outdated anchor‑based pagination redirects (/#narrative-threads) since dedicated pages now exist.
  • Verified all redirects resolve correctly post‑permalink flush.

Dedicated narrative thread & fragment pages created

  • Broke out both sections from the homepage anchor system into their own standalone templates (page-narrative-threads.php, page-narrative-fragments.php), allowing cleaner routing and independent indexing.
  • Replicated homepage grid structure exactly for visual consistency.

Homepage structure refined for clarity

  • Cleaned and reordered homepage sections for intuitive flow: Site Resources → Narrative Threads → Portal Pages → Narrative Fragments.
  • Removed confusing nested <hr> placements and redundant comment markers.
  • Standardized section breaks and anchors for a clean, readable template hierarchy.

Result: All narrative and portal‑based content types now share a unified routing and breadcrumb system, fully aligned with the site’s internal mapper. The homepage and new pages display in a consistent grid‑based design, while archive URLs redirect seamlessly to their curated landing pages.