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>
82 lines
2.5 KiB
Markdown
Executable File
82 lines
2.5 KiB
Markdown
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**:
|
|
1. `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
|
|
|
|
2. `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_once` for `inc/favicon.php`
|
|
|
|
### Modified: `inc/acf-fields.php`
|
|
- Added Branding tab with favicon fields
|
|
|
|
## Server Requirements
|
|
|
|
- **ImageMagick**: Must be installed with `convert` command available
|
|
- Admin notice displays if ImageMagick is not found
|
|
|
|
## How to Use
|
|
|
|
1. Go to Theme Options in WordPress admin
|
|
2. Click the "Branding" tab
|
|
3. Upload a square PNG or WebP image (minimum 256x256, recommended 512x512)
|
|
4. Save the Theme Options
|
|
5. 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
|