b6df4dbb92
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>
2.8 KiB
Executable File
2.8 KiB
Executable File
Manual Property Entry System
Date: 2026-01-21 Type: Schema Change + New Feature
Summary
Added the ability to manually enter properties that integrate seamlessly with MLS-synced listings. Manual properties can override MLS listings (same MLS ID), support cloning from existing MLS data, and include geocoding for addresses.
Schema Changes
New table wp_mls_properties_manual created automatically by the MLS plugin on activation/upgrade.
The table will be created automatically when the plugin runs - no manual SQL needed.
New Custom Post Type
CPT: manual_property
Menu: "Manual Properties" in WordPress admin
ACF Field Group
ACF fields are registered programmatically (no JSON import needed). Fields will appear automatically on the Manual Property edit screen.
How to Use
Add a Manual Property
- Go to Manual Properties > Add Property in WordPress admin
- Fill in property details across the tabs:
- Basic Info: Status, Price, Type, HomeProz checkbox, Featured toggle
- Location: Address (geocoded automatically), City, State, ZIP
- Details: Beds, Baths, Square Feet, etc.
- Description: Public remarks
- Media: Upload property photos
- Agent: Select from Agent CPT
- Dates: List date, close date, etc.
- Publish the property
Clone from MLS
- Go to Manual Properties > Add Property
- Enter an MLS # in the "Clone from MLS Listing" box
- Click "Clone Listing"
- Images will be downloaded and fields pre-populated
- Review and modify as needed, then publish
Override an MLS Listing
- Create a manual property
- Set the MLS # field to the MLS ID you want to override
- Publish
- The manual version will appear in search results instead of the MLS-synced version
Dependencies
- ACF Pro (already installed)
- MLS by HansonXyz plugin (updated in this release)
Files Changed
Plugin files (MLS plugin):
mls-by-hansonxyz.php- Added table constant, class includesincludes/class-mls-db.php- Added manual properties table schemaincludes/class-mls-query.php- Modified to include manual properties in queriesincludes/class-mls-image-endpoint.php- Handle manual property imagesincludes/class-mls-manual-property.php- NEW: CPT, ACF fields, sync logicincludes/class-mls-geocoder.php- NEW: Address geocoding via Nominatimadmin/js/manual-property.js- NEW: Clone from MLS functionalityadmin/css/manual-property.css- NEW: Admin styles
Notes
- Manual properties use WordPress Media Library for images (not MLS media cache)
- Geocoding uses free Nominatim API (rate limited, cached for 30 days)
- Manual property listing keys follow format:
MANUAL-{post_id} - Properties with
listing_idset will override MLS listings with matching ID