Files
homeproz/wp-content/themes/homeproz/template-parts/property/CLAUDE.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

1.7 KiB
Executable File

Property Archive System

MLS-based property listing and filtering system for the real estate website.

Files

File Purpose
property-filters.php Filter form UI (Type, Location, Beds, Price Range)
property-filters.js AJAX filtering without page reload
property-filters.scss Filter bar and map view styles
property-filters-sticky.php Sticky filter bar variant
property-results.php Property grid with pagination (MLS data)
property-card-mls.php Individual MLS property card component
property-card-minimal.php Compact property card for featured sections
property-agent.php Agent sidebar widget on single property
property-gallery.php Gallery component for property detail
single-property-mls.php Single MLS property detail page
agent-card-minimal.php Compact agent card for property pages

Data Source

All property data comes from the MLS plugin (wp-content/plugins/mls-by-hansonxyz/). Use mls_get_properties() to query listings.

Sorting Logic

Properties are sorted by:

  1. Status: Active first, Pending second, Sold third
  2. Modified Date: Most recently modified first within each status group

Filter Fields

  • Type: MLS property type (House, Land, Commercial, etc.)
  • Location: MLS city
  • Beds: Minimum bedrooms filter
  • Price Range: Min/max price filter

Status filter was removed - all properties (Active, Pending, Sold) are always shown.

Map View

Toggle between Grid and Map views. Map view:

  • Uses Leaflet.js with OpenStreetMap tiles
  • City-based coordinates from MLS data
  • Properties displayed in half-height map + 2-column grid