kaiseki/wp-favicon

Render favicon and touch-icon link tags on the WordPress front end, admin and login screens

1.0.0 2026-06-01 09:51 UTC

Requires

• php: ^8.2
• kaiseki/config: ^2.0
• kaiseki/wp-hook: ^2.0
• psr/container: ^1.1 || ^2.0
• thecodingmachine/safe: ^2.0

Requires (Dev)

• bnf/phpstan-psr-container: ^1.1
• kaiseki/php-coding-standard: ^1.0
• maglnet/composer-require-checker: ^4.0
• php-stubs/wordpress-stubs: ^6.2
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• phpstan/phpstan-strict-rules: ^2.0
• phpunit/phpunit: ^11.0
• roave/security-advisories: dev-latest
• szepeviktor/phpstan-wordpress: ^2.0
• thecodingmachine/phpstan-safe-rule: ^1.4

MIT

• Kaiseki
• David Mondok
• Wolfgang Schaefer

README

Render favicon and touch-icon link tags on the WordPress front end, admin and login screens.

Point it at a directory containing favicon.ico, icon.svg, apple-touch-icon.png and manifest.json; it prints the matching <link> tags on wp_head, login_head and (optionally) admin_head, and disables WordPress' own site-icon output in the admin. Wired through ConfigProvider and the favicon config key.

Installation

composer require kaiseki/wp-favicon

Requires PHP 8.2 or newer.

Usage

Register ConfigProvider with your laminas-style config aggregator and configure the favicon key:

use Kaiseki\WordPress\Favicon\Favicon;

return [
    'favicon' => [
        // Directory holding the icon assets, relative to the active theme directory
        // (the theme directory URI is prepended automatically).
        'path' => 'assets/favicon',
        // Optional separate directory for the admin; falls back to `path`.
        'admin_path' => '',
        // Whether to also render the favicon in the admin when no admin_path is set.
        'show_in_admin' => true,
    ],
    'hook' => [
        'provider' => [
            Favicon::class,
        ],
    ],
];

ConfigProvider registers FaviconFactory, which reads the favicon config. With path set, the front-end and login tags are rendered; admin_path (or show_in_admin) controls the admin output.

Development

composer install
composer check   # check-deps, cs-check, phpstan

License

MIT — see LICENSE.