Site Updates

This development cycle completed one of the most significant architectural milestones in the Knowledge Platform’s development. While the original goal was relatively straightforward—migrate the Portal…

With the major architectural foundation now established, development priorities are intentionally shifting toward content creation, taxonomy population, and incremental infrastructure improvements rather than large-scale subsystem redesigns.

Major architectural work completed across the Knowledge Platform, including Footnotes Engine v2 migration, collector integration, artist subsystem consolidation, presentation groundwork, and a broad filesystem reorganization that establishes a cleaner foundation for future development.

The Artist Footnotes subsystem has been completely refactored into a shared implementation and fully integrated with the new collector architecture. This removes the last major architectural exception within Footnotes Engine v2 and establishes Songs as the canonical music reference object for inheritance across Chapters, Fragments, and Elements.

The Sources UI was simplified by separating data ownership from presentation, allowing multiple content owners to render within a single expandable Sources section while preserving attribution.

Introduced the first collector-based architecture for the Knowledge Platform by separating relationship traversal from rendering. Implemented a reusable Reference Context collector, added reverse lookup support for Featured In pages, updated the Orphan Finder to recognize inherited Element relationships, and established the architectural pattern that future collectors and renderers will follow.

One of the largest architectural refactors on the project was eliminating the dedicated Reference custom post type in favor of an embedded ACF-based Sources system. What began as a simple migration quickly evolved into a complete redesign of how citations, footnotes, inheritance, and reusable narrative elements work throughout the Knowledge Platform.

Completed a comprehensive audit of all content page templates, consolidated duplicated rendering logic into shared helpers, migrated Wikipedia integrations to a centralized system, simplified book rendering architecture, and began modularizing the site’s growing CSS layer. This update documents the transition from CPT-specific implementations toward a reusable component-based structure.

A major cleanup effort began to standardize relationship rendering across CPT templates, reduce duplicated logic, and prepare the Knowledge Platform for future visual navigation and atlas-style content presentation.

One of the most significant planning efforts currently underway is a new documentation initiative focused on the architecture and evolution of the site itself.

After repeated VPS crashes during development, both the main site and development site were migrated to local environments. Code can now be tested safely on a local machine before being pushed to production, reducing server load and creating a more reliable workflow.

Development site reorganized from legacy chapters/posts into structured framework: Page, Article CPT, Update CPT, Task CPT. Project and Series taxonomies added. Sidebar and homepage refactored.

Portal pages refactored into modular data, renderer, and CSS layers. Atlas view (card-based Knowledge Atlas) and Index view (alphabetical browser) share centralized dataset. View switching framework enables future experiments without rebuilding queries.

Tag Audit tool refactored from finding missing taxonomies to reviewing and pruning inaccurate Topic/Theme assignments. New interface exports ID lists for bulk removal, supporting portal quality.

Bulk migration of plain-text fields (quote_plain_text, lyric_plain_text, etc.) into WordPress post_excerpt for Yoast meta descriptions. WP-CLI script rebuilds excerpts from source fields, removing truncation artifacts. Repeatable for other CPTs.

WP-CLI based import system for bulk-assigning topic/theme taxonomy terms to lyrics using CSV with pipe-separated values. Script validates CPT, merges terms safely, supports dry-run. Reusable for other CPTs.

Topics and Themes redesigned into layered directories with Portals, Emerging, and long-tail tiers. New Lexicon Topics layer tied to Concept CPT. Portal Grid updated with explanatory sections and cross-navigation.

Top Content pages redesigned as curated multi-section editorial system with URL view navigation. Narrative Threads/Episodes elevated with large cards; Lyrics/Excerpts/Quotes cleaned; Images section added with responsive grid.

Portal system transformed from flat CPT lists into structured thematic indexes with sectional rendering and editorial presentation. New “Top Content” system in development for curated excerpts, lyrics, and quotes using full cover block layouts.

New Video CPT and Video Room archive for curating visually significant media. Supports parent inheritance from Songs, standalone videos, footnote integration, and cinematic thumbnail grids without direct YouTube embedding throughout the site.

Admin Tools framework evolved into modular toolkit for content discovery, taxonomy refinement, and relationship visualization. Semantic discovery workflows identify topic clusters; portal pages now prioritize entries semantically; taxonomy automation pipeline using WP-CLI batch tagging.

CPT conversion complete; focus shifts to relational refinement, attribution standards, new sections (Listening Room, rap separation, video games), and content prioritization from backlog.

Major restructuring converting narrative threads and fragments into modular CPTs (lyrics, excerpts, quotes, images) under unified theme/topic taxonomies. Manual curation, backlog preparation, and long-term vision for dynamic interconnected content.

ACF integration issues caused fatal errors in footnote/profile templates when chapters lacked related CPTs. Reverted to stable version until safer implementation.

New Show CPT for television series and serialized visual works, distinct from Movies. Fully integrated into taxonomy and footnote system with dedicated templates and 📺 identifier.

New Element CPT replaces private drafts with public, evolvable micro-units of thought. Elements can mature into Episodes or Threads, embodying an emergent creative workflow: publish widely, select resonant motifs, integrate into narratives.

LocalWP sandbox for theme migration experiments; tested GeneratePress and Kadence as parent themes; resolved CPT permalink issues; analyzed hybrid DB restore strategies; documented challenges of transferring ACF relationships and layout settings.

Standardized lyric, excerpt, and quote display sections across CPTs with consistent image logic, source linking, and text trimming – each now uses a reusable template block.

New Portal CPT modeled on Concepts; search result hierarchy reordered; breadcrumbs unified via central metadata mapper; archive redirects modernized; dedicated narrative thread and fragment pages created.

Search results now include posts tagged with matching theme/topic terms, merged seamlessly with Relevanssi text results. Case-insensitive matching, taxonomy archives unaffected.

Fixed CSS truncation in Safari/Waterfox caused by Cloudflare cache – added filemtime() versioning. Debugged phantom nav bar flash – traced to Nginx config overrides, not theme. Restored backup, issue resolved.

Deep dive into theme taxonomy behavior between search and archive pages. Recovered working taxonomy template, identified artist CPT misbehavior, planned Relevanssi theme collector. Also: featured in system refactor, sidebar fixes, artist search bug resolved, reference CPT content standardization.

All CPT listing pages and search results now share identical template parts. Centralized CPT metadata mapping for emoji/title/links. Search wrappers forward WP_Query to shared grid/list partials. Uniform image handling and list styles across all templates.

Footnotes system broken into per‑CPT modules; WP‑CLI scripts auto‑populate Yoast excerpts; featured images synced for SEO; PHP/nginx cleanup; new fragment CPT launched; song index pages expanded.

Organization CPT cleanup, song CPT taxonomy vs ACF clarification, lyric CPT source display, quote/excerpt template consistency, footnote system rollback, and reference CPT simplification planned.

New Excerpt CPT for reusable content blocks; quotes, lyrics, excerpts converted to cover block patterns; hub pages as tag archives; lexicon modernization; PHP module fixes and MailPoet slowdown resolved.

Controlled removal of legacy ACF fields from chapters; rebuilt artist/song relationships; planned Incoming CPT for quick capture; consolidated CPT registrations into single loader; footnotes system moved to standalone module.

Rebuilt Songs Referenced section to use Song CPT’s ACF post object; fixed artist/song navigation groups; added Songs section to Artist CPT and Narrative Threads to Movie CPT; cleaned old meta keys.

Dedicated Image CPT replaces Media Library enrichment. Includes archive with theme filtering, ACF metadata for symbolic tagging, and integration with songs, lyrics, chapters, and themes.

Song CPT now supports up to four artists with YouTube embeds; PHP 8.2 upgrade; image gallery planning as Media Library + ACF; new Organization CPT for institutions; dynamic quote rendering using patterns.

New themes taxonomy for symbolic motifs across CPTs; song CPT display enhancements (album thumbnails, YouTube embeds); concept relationship linking; footnotes UX improvements.

Dev site brought back in sync with main site: homepage reorganization, task cleanup, and child theme connected to a separate GitHub repository for version control.

Full migration from two separate WordPress installs to a single Debian 12 VPS running NGINX. Post‑migration cleanup includes Git access, permissions realignment, database audit, and observed RAM improvements.

Search page redesigned to group results by CPT type. Chapters by Song index now fully automated. Artist metadata finalized, tags retired, ACF standardization begins.

Automated footnote engine now live inside chapters, pulling data from related CPTs with type-specific icons, back‑links, manual reference fallback, and a new “Songs Referenced” field.

All primary Custom Post Types now active (Books, Profiles, Artists, Lyrics, Movies, Concepts). Lyric CPTs can render Cover Block HTML. Theme CSS refactored into child theme.

New Custom Post Types for artists, profiles, movies, and concepts (lexicon); deprecating tags in favor of structured relationships; unified navigation and WP-CLI automation.

Beginning a structured reference layer with a Book custom post type, relationship fields for chapters, and a new dynamic footnote system.

Initial server deployment, LAMP stack configuration, WordPress installation, backup setup, content migration start, and UI customization.