Site_Icons

This class allows you to bypass WordPress's default site icon handling and serve custom favicons and PWA icons from your theme's /resources/favicons/ directory. It also generates a real site.webmanifest file in the uploads directory, enabling Progressive Web App (PWA) features without routing manifest requests through WordPress.

Features

• Custom Favicon Path: Serves site icons from /resources/favicons/ in your child or parent theme.
• Generated Web Manifest: Writes a site.webmanifest (or site-{blog_id}.webmanifest on multisite) file to the uploads directory and serves it directly. Clear the cache with the wp bulldozer clear-manifest-cache WP-CLI command after updating icons or manifest attributes.
• PWA Support: Configure name, colors, display mode, orientation, and start URL for installable web apps.
• Multisite Compatible: Automatically generates unique manifest filenames per site in a multisite network.
• Theme Fallback: First checks the child theme for icons, then falls back to the parent theme.

Required Icon Files

Place these files in your theme at /resources/favicons/:

• favicon.svg (32x32)
• apple-touch-icon.png (180x180)
• android-chrome-192x192.png or web-app-manifest-192x192.png (192x192)
• android-chrome-512x512.png or web-app-manifest-512x512.png (512x512)

The class auto-detects whether you're using the newer web-app-manifest-* naming convention.

Usage

Customize manifest attributes:

new \HighGround\Bulldozer\Site_Icons([
    'short_name'       => 'MyApp',
    'background_color' => '#ffffff',
    'theme_color'      => '#1a1a1a',
]);

Enable installable PWA mode:

new \HighGround\Bulldozer\Site_Icons([
    'installable'      => true,
    'display'          => 'standalone',
    'background_color' => '#ffffff',
    'theme_color'      => '#1a1a1a',
]);

Filters

• highground/bulldozer/site-icons/folder-name - Change the favicon folder name (default: favicons).

Overview

Methods

Name	Return Type	Summary/Returns
__construct()		Constructor.
clear_manifest_cache()	void	Clears the manifest cache by deleting the manifest file and the transient storing its hash.
get_attribute()		Get attribute.

Class Methods

__construct()

Constructor.

Sets up site icons with an array of attributes.

__construct( array $attributes )

Name	Type	Description
$attributes	array{name?: string, short_name?: string, background_color?: string, theme_color?: string}	Array of attributes for the site icons and manifest.

PHP

new Site_Icons([
  'short_name'       => 'My App',
  'background_color' => '#ffffff',
  'theme_color'      => '#000000',
]);

---

clear_manifest_cache()

Clears the manifest cache by deleting the manifest file and the transient storing its hash.

Returns: void

---

get_attribute()

Get attribute.

get_attribute( string $attribute )

Name	Type	Description
$attribute	string	attribute name

---