Files
homeproz/db_content_updates/2026-01-21_18-15_blog-enhancements.md
T
root b6df4dbb92 Snapshot: MLS sync fixes, image refresh, plugin/theme updates
MLS plugin fixes from this session:
- Fix silent insert failures: location column NOT NULL was rejecting wpdb->insert calls,
  causing ~18k new properties since Dec 2025 to be lost. Inserts now build raw SQL
  with ST_PointFromText so the spatial column is populated atomically.
- Auto-refresh expired media URLs in MLS_Media_Handler::fetch_and_cache(), guarded by
  a property-level GET_LOCK so concurrent fetches share one API refresh.
- Normalize WP_Error to null in mls_get_property_image() so callers can rely on the
  documented string|null contract.
- Support comma-separated property_type filters in MLS_Query and MLS_Cluster so the
  homepage "View All Commercial" link (?property_type=Commercial+Sale,Land,Farm)
  actually filters correctly.
- Incremental sync now looks back 10 minutes past the latest modification timestamp
  as a safety margin against missed records.
- Smart sync exits silently (info-level, not warning) when a full sync is in progress.

Operational:
- New cron: weekly full sync Sundays at 3 AM (/usr/local/bin/mls-full-sync).
- New cron: hourly 2GB cap on mls-thumbnails/ and cache/transformed-images/
  (/usr/local/bin/mls-image-cache-cap).
- Logrotate config for wp-content/debug.log (2-day retention, daily rotation,
  delaycompress).

Repo policy:
- CLAUDE.md updated with explicit "commit everything except build artifacts" policy.
- .gitignore: untrack runtime image caches and debug.log rotations.

Other modifications in this snapshot are pre-existing in-flight theme/plugin/db_content_updates work.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-29 15:32:23 +00:00

68 lines
2.4 KiB
Markdown
Executable File

# 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)