kaiseki/wp-font-loader

Register and render @font-face stylesheets in WordPress, with preload, variable-font and exclusion filters

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

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
• roots/wordpress-core-installer: *
• roots/wordpress-no-content: @stable
• szepeviktor/phpstan-wordpress: ^2.0

MIT

• Kaiseki
• David Mondok
• Wolfgang Schaefer

README

Register and render @font-face stylesheets in WordPress, with preload, variable-font and exclusion filters.

Point it at a directory of font files; it parses each filename into a FontFace (family, weight, style, …), applies any configured filters, and renders the @font-face CSS for the chosen locations (front end, admin, login). Wired through ConfigProvider and the font_loader config key.

Installation

composer require kaiseki/wp-font-loader

Requires PHP 8.2 or newer.

Usage

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

use Kaiseki\WordPress\FontLoader\FontFaceInterface;
use Kaiseki\WordPress\FontLoader\FontFaceRegistry;
use Kaiseki\WordPress\FontLoader\FontFaceFilter\PreloadFilter;
use Kaiseki\WordPress\FontLoader\FontFaceFilter\VariableFontFilter;

return [
    'font_loader' => [
        // FontFaceFilterInterface instances/class-strings applied to every parsed face.
        'filter' => [
            PreloadFilter::class,
            new VariableFontFilter(weight: '100 900'),
        ],
        'path_loader' => [
            // Directories scanned for font files.
            'paths' => [
                get_stylesheet_directory() . '/assets/fonts',
            ],
            // Where the @font-face CSS is printed.
            'locations' => [
                FontFaceInterface::FRONTEND,
                FontFaceInterface::BACKEND,
                FontFaceInterface::LOGIN,
            ],
            'display'            => 'swap',
            'without_domain'     => false,
            'include_subfolders' => false,
        ],
    ],
    'hook' => [
        'provider' => [
            FontFaceRegistry::class,
        ],
    ],
];

ConfigProvider wires FontFaceRegistry (the hook provider), a PathLoader (LoaderInterface) that scans the configured paths, and a FontFilenameParser (FontFilenameParserInterface). Filenames are parsed into FontFace value objects; the configured FontFaceFilterInterfaces can adjust each face (PreloadFilter, VariableFontFilter) or drop it (ExcludeFromLoadingFilter, by returning null).

Development

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

License

MIT — see LICENSE.