57b752f54e
- Manual properties linked to MLS now inherit status (Active/Pending/Closed) and days_on_market from the MLS listing dynamically - Properties not in MLS default to Closed status - Clone feature now auto-populates listing agent by matching MLS ID to Agent CPT - Description formatter detects embedded headers (unpunctuated text after sentences) and splits them into separate paragraphs Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2.5 KiB
2.5 KiB
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