root
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.5 KiB
Executable File
2.5 KiB
Executable File
Favicon Management Feature
Date: 2026-01-06 Type: ACF Field Addition + Theme Feature
Summary
Added favicon management through Theme Options. Site administrators can upload a source image that gets automatically converted to all required favicon sizes using ImageMagick.
ACF Field Group Changes
Theme Options (group_theme_options)
Added new "Branding" tab (before Advanced tab):
New Tab: Branding (field_theme_tab_branding)
New Fields:
-
theme_favicon_source(field_theme_favicon_source) - Image field- Return format: ID
- Mime types: png, webp
- Minimum dimensions: 256x256 pixels
- Instructions: Upload square image at least 512x512
-
theme_favicon_status(field_theme_favicon_status) - Message field- Shows instructions about saving to generate favicons
Generated Files
When a favicon source is uploaded and saved, the following files are generated in /wp-content/uploads/favicon/:
| File | Size | Purpose |
|---|---|---|
| favicon.ico | 16x16, 32x32, 48x48 | Legacy browsers |
| favicon-16x16.png | 16x16 | Standard favicon |
| favicon-32x32.png | 32x32 | Standard favicon |
| favicon-48x48.png | 48x48 | Standard favicon |
| apple-touch-icon.png | 180x180 | iOS home screen |
| android-chrome-192x192.png | 192x192 | Android/Chrome |
| android-chrome-512x512.png | 512x512 | Android/Chrome splash |
| mstile-150x150.png | 150x150 | Windows tiles |
| site.webmanifest | - | PWA manifest |
| browserconfig.xml | - | Windows tile config |
Theme Files Added/Modified
New File: inc/favicon.php
- ACF save hook for favicon processing
- ImageMagick conversion functions
- Web manifest generation
- HTML head output with cache busting
- Disables WordPress Site Icon (Customizer)
Modified: functions.php
- Added
require_onceforinc/favicon.php
Modified: inc/acf-fields.php
- Added Branding tab with favicon fields
Server Requirements
- ImageMagick: Must be installed with
convertcommand available - Admin notice displays if ImageMagick is not found
How to Use
- Go to Theme Options in WordPress admin
- Click the "Branding" tab
- Upload a square PNG or WebP image (minimum 256x256, recommended 512x512)
- Save the Theme Options
- Favicons are automatically generated and output in the HTML head
Cache Busting
Favicon URLs include a version query parameter based on file modification time to ensure browsers load updated favicons when changed.
Dependencies
- ACF Pro
- ImageMagick on server
- Theme must include favicon.php