Skip to content

Footnotes & song overhaul

Published on August 15, 2025

Last updated on June 6, 2026

After reviewing the song display logic, the Songs Referenced section in chapters was rebuilt to directly use the Song CPT’s ACF post object (song_artist) for linking songs to artists. This removed the old brittle title‑parsing approach and guaranteed 100% accurate artist‑song connections.

  • Songs now grouped under Primary Artist, Secondary Artist, and Other Artists based entirely on the linked CPT data.
  • Retained the Unknown Artist category deliberately as a pragmatic QA tool — this allows instant location of any songs missing proper CPT connections, acting as a “future‑proof bug finder.”
  • Removed complex “Primary Song / Other Songs” formatting for all artists — reverted to the clean, non‑clickable song list for now to avoid spacing and indentation issues. Artist names remain clickable only in the footnotes context.
  • Output kept simple for visual clarity at this stage, with more aesthetic refinement postponed until functional stability is locked in.

Artist & song navigation restructure

  • Fixed artist navigation so Rappers and Non‑Rappers use distinct navigation groups.
  • Removed dependency on the “Non‑Rapper” term — navigation now defaults automatically if no artist_type is set.
  • Applied similar grouping to Song CPT navigation:
    • Rap songs are grouped separately.
    • Non‑rap songs are grouped by feature level.
  • Eliminated feature_level as an ACF field — this is now entirely handled via taxonomy terms.
  • Bulk‑removed non-rapper terms via WP‑CLI to clean up legacy data.

CPT template additions

Artist CPT Template

  • Added a Songs section above Narrative Threads, pulling all song posts where song_artist matches the current artist.
  • Displayed in a 5‑per‑row square thumbnail grid consistent with the “Songs Featured” page style.

Movie CPT Template

  • Added Narrative Threads section pulling all chapter posts that reference the current movie via movies_referenced ACF relationship.
  • Uses serialized array matching in meta_query and keeps the same grid layout as Artist Narrative Threads.

Meta & embed cleanup

  • Deleted old is_featured_song meta key from all Song CPT posts.
  • Updated YouTube embed logic in content-song.php:
    • Auto‑embed only if feature_level is primary or featured.
    • Otherwise, display a nofollow link.
  • Removed unused or empty ACF meta:
    • quote_text (attachments)
    • footnote_text and anchor_id (all posts)
    • author_name (Book CPT, now handled via Author CPT)

Search result fixes

  • Fixed duplicate Rappers CPT entries in search results.
  • Unified display so Artists and Rappers share the same rounded‑headshot layout.
  • Added a default fallback image display for all other CPTs (songs, images, organizations, etc.) using:
    • featured_image
    • cover_image
    • portrait_image
    • image_file
  • Preserved existing working layout and styling.