Files
homeproz/db_content_updates/2026-01-21_18-15_blog-enhancements.md
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

2.4 KiB
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
  • Shows 3 posts from same category
  • Falls back to 3 recent posts if no category matches
  • Always displays something (unless only 1 post exists)
  • 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)