# Blog Enhancements

**Date**: 2026-01-21
**Type**: Template Updates + ACF Field Addition
**Status**: IMPLEMENTED IN DEV

## Summary

Enhanced single blog post pages with additional sections and added Agent author capability.

## Code Changes

### Templates
- `single.php` - Added three new sections below post content:
  1. Enhanced Next/Prev navigation with thumbnails
  2. Related Posts section (always shows, falls back to recent posts)
  3. Featured Properties section (3 active MLS listings)

- `template-parts/content/content-single.php` - Added agent author display in post meta

- `template-parts/content/content-single.scss` - Added styles for:
  - Post navigation with thumbnails
  - Featured properties grid
  - Author meta styling

### ACF Fields
- Added "Post Author" field group for blog posts:
  - Field: `post_agent_author` (post_object linking to Agent CPT)
  - Location: Sidebar of post edit screen
  - Only shows active (non-disabled) agents in dropdown

### Functions
- Added `homeproz_filter_agent_post_object()` filter to exclude disabled agents from author dropdown
- Removed comments functionality site-wide

## Features

### Agent Author on Blog Posts
- In post editor sidebar, select an agent as the post author
- Author name displays in post meta with link to agent profile
- If agent is later disabled, name still shows but link is removed
- Only active agents appear in the dropdown selector

### Enhanced Post Navigation
- Shows Previous/Next post with thumbnail images
- Falls back to placeholder icon if no featured image
- Responsive grid layout

### Related Posts
- Shows 3 posts from same category
- Falls back to 3 recent posts if no category matches
- Always displays something (unless only 1 post exists)

### Featured Properties
- Shows 3 active MLS listings below blog content
- "View All Properties" button links to /properties/
- Helps drive traffic from blog to listings

## Agent Disabled Flag Behavior

The existing `agent_disabled` ACF field controls:
1. **Team Page**: Disabled agents hidden from grid
2. **Agent Archive**: Disabled agents excluded
3. **Agent Profile**: Returns 404 for disabled agents
4. **Property Cards**: Shows office contact instead of disabled agent
5. **Blog Author Dropdown**: Only active agents shown (NEW)
6. **Blog Author Display**: Disabled agent names show without link (NEW)