Skip to content

Content Structure

Jump to bottom
Terrence Murray edited this page Apr 5, 2026 · 3 revisions

Content Structure

Site Map

The Digital Front
├── Home (static front page)
│   ├── Hero Section (featured article + sidebar articles)
│   ├── Breaking News Ticker
│   └── Recent Blog Posts
│
├── Articles Archive (/article/)
│   ├── Category Filter Tabs (Mobile Devices, Apple, Google, Samsung)
│   ├── Date Range Filter
│   └── Paginated Article Grid
│
├── Reviews Archive (/review/)
│   ├── Rating Filter (1–5 stars)
│   ├── Search
│   └── Paginated Review Grid
│
├── Trending in Tech
│   └── Posts ordered by view count
│
├── About Us
│   ├── Team (child page - member bios)
│   └── Mission (child page - editorial values)
│
└── Single Post Views
    ├── Article → linked opinions, video embed, source URL
    ├── Opinion → related article, author bio, pull quote
    └── Review  → product card, star rating, product image

Content Types

1. Article (Custom Post Type)

The primary content type for tech news and tutorials.

Property Value
Slug /article/
Archive /article/ (uses archive-article.php)
Supports Title, Editor, Thumbnail, Excerpt, Comments
Taxonomy Category (shared with standard posts)
REST API Enabled

Digital Content Types:

  1. Text — Long-form written content via the block editor (body text, headings, lists, code blocks)
  2. Video — Embedded video from YouTube or Vimeo via the video_embed ACF field, rendered with wp_oembed_get()

Custom Fields (ACF):

Field Type Description
video_embed Text Video embed URL (YouTube, Vimeo) - rendered via wp_oembed_get()
reading_time Number Estimated reading time in minutes (minimum: 1)
source_url URL Link to the original source material

2. Opinion (Custom Post Type)

Opinion and editorial pieces linked to articles. Opinions do not have a standalone archive page — they appear only under their related article on single post views.

Property Value
Slug /opinion/
Archive Disabled
Taxonomy Tags (standard WP post_tag)
Supports Title, Editor, Thumbnail, Excerpt, Custom Fields, Comments
REST API Enabled

Digital Content Types:

  1. Text — Editorial opinion content with highlighted pull quotes via the pull_quote ACF field
  2. Images — Featured images (thumbnails) displayed on single views and in linked opinion cards

Custom Fields (ACF):

Field Type Description
author_bio Textarea Short biography of the opinion writer
pull_quote Textarea Key highlighted quote from the piece
related_article Relationship Links to one or more Article CPT posts

3. Review (Custom Post Type)

Product and tech reviews with star ratings.

Property Value
Slug /review/
Archive /review/ (uses archive-review.php)
Supports Title, Editor, Thumbnail, Excerpt, Custom Fields, Comments
REST API Enabled

Digital Content Types:

  1. Text — Written review content with structured product metadata (product name, star rating)
  2. Images — Product images via the product_image ACF field, displayed in the review product card

Custom Fields (ACF):

Field Type Description
rating Number Star rating from 1 to 5
product_name Text Name of the product being reviewed
product_image Image Product image for the review card

4. Standard Posts

WordPress default posts used for general blog content. Displayed in the "From the Blog" section on the home page.

Page Templates

front-page.php (Home Page)

  • Queries the 8 most recent articles via WP_Query
  • Displays the newest article as a full-width hero with overlay text
  • Shows up to 3 articles in a stacked sidebar beside the hero
  • Includes an empty state fallback when no articles exist
  • All Articles section with category filter shortcode
  • Secondary query for 4 recent standard blog posts
  • What We Cover topic grid, stats bar, newsletter CTA, and quick links

single.php (Single Post / Article / Opinion / Review)

  • Breadcrumb navigation (Yoast)
  • Post type label badge (Article / Opinion / Review)
  • Publishing date and reading time display
  • Full-width featured image
  • Author info block with avatar, name, and role
  • Social sharing buttons (X/Twitter, LinkedIn, Copy Link)
  • Video embed container (for articles with video_embed field)
  • Review product card with star rating (for reviews)
  • Main content area
  • For Articles: queries and displays linked Opinion posts that reference this article
  • For Opinions: displays the related Article from the ACF relationship field
  • Source URL link (articles only)
  • Tags display
  • "You may also like" related posts by shared tags
  • Comment section with threaded replies (enabled on all post types)
  • Previous / Next post navigation

archive-article.php (Article Archive)

  • Breadcrumb navigation
  • Archive header with title and description
  • Embeds [tdf_category_filter per_page="9"] shortcode for filtering and pagination

archive-review.php (Review Archive)

  • Breadcrumb navigation
  • Archive header with title and description
  • Search input for reviews
  • Rating filter pills (1-5 stars)
  • Active filter indicator with result count and clear button
  • Paginated review card grid with star ratings, product names, and excerpts

page.php (Generic Pages)

  • Centered narrow-width layout (760px max)
  • Breadcrumb navigation
  • Page title and content

header.php

  • Custom logo with fallback to site name text
  • Primary navigation menu with fallback function
  • Mobile hamburger toggle with Escape key and click-outside dismissal
  • Breaking News ticker via [tdf_breaking_news] shortcode

footer.php

  • Copyright notice
  • wp_footer() hook for scripts

Categories

The following categories are seeded automatically during setup:

  • Mobile Devices
  • Apple
  • Google
  • Samsung

These categories are shared between Articles and standard Posts, enabling cross-content-type filtering via the category filter shortcode.

Navigation Menu Structure

The primary navigation menu is built automatically by setup.php:

Home | Trending (if page exists) | About ▾
                                     ├── Team
                                     └── Mission

The menu supports dropdown sub-items and is styled as pill-shaped nav links in the header.

Note: The Opinions archive link was removed from the nav menu because the Opinion CPT archive is disabled.

Clone this wiki locally