PHPackages                             mercator/wn-localfonts-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. mercator/wn-localfonts-plugin

ActiveWinter-plugin[Utility & Helpers](/categories/utility)

mercator/wn-localfonts-plugin
=============================

Localize Google, Bunny, and Fontshare fonts for WinterCMS

00PHP

Since Jan 6Pushed 4mo agoCompare

[ Source](https://github.com/helmutkaufmann/wn-localfonts-plugin)[ Packagist](https://packagist.org/packages/mercator/wn-localfonts-plugin)[ RSS](/packages/mercator-wn-localfonts-plugin/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

LocalFonts for WinterCMS (v5.0)
===============================

[](#localfonts-for-wintercms-v50)

**LocalFonts** is a professional CLI utility for WinterCMS that localizes fonts from **Google Fonts**, **Bunny Fonts**, and **Fontshare**. It surgically extracts font assets, generates a `manifest.json` for version tracking, and builds a `fonts.less` file for immediate integration with your theme.

Key Features
------------

[](#key-features)

- **Multi-Source Discovery**: Automatically falls back from Google to Bunny to Fontshare.
- **Regex Isolation**: Critical logic is protected within the `BaseCommand` to prevent syntax errors.
- **Smart Filtering**: Automatically bypasses subset filters if the provider labels a block with the font name (common for Fontshare/Satoshi).
- **Variable Font Support**: Downloads both individual "Static" weights and modern "Variable" font files.
- **Surgical Removal**: Intelligent file cleanup that only deletes assets when no other variants reference them.

---

Installation
------------

[](#installation)

### Via Composer

[](#via-composer)

Add the repository to your root `composer.json` and install:

```
composer require mercator/wn-localfonts-plugin
```

### Manual Installation

[](#manual-installation)

1. Create: `plugins/mercator/localfonts`
2. Place the plugin files in their respective folders.
3. Register the commands:

```
php artisan plugin:refresh Mercator.LocalFonts
```

---

Configuration
-------------

[](#configuration)

Control font character sets via your root `.env` file.

SettingEnvironment VariableDefaultDescription**Subsets**`LOCALFONTS_SUBSETS``latin`Comma-separated list (e.g., `latin,latin-ext`). Set to empty to fetch all.---

Usage
-----

[](#usage)

### 1. Add a Font (`localfonts:add`)

[](#1-add-a-font-localfontsadd)

Search and localize a font family.

```
# Add standard weight
php artisan localfonts:add Satoshi

# Add full family (All weights + Italics + Variable blocks)
php artisan localfonts:add Satoshi --full
```

### 2. List Fonts (`localfonts:list`)

[](#2-list-fonts-localfontslist)

View managed fonts. You can filter by family to see specific variants.

```
# List all
php artisan localfonts:list

# Filter by family
php artisan localfonts:list Satoshi
```

### 3. Remove Fonts (`localfonts:remove`)

[](#3-remove-fonts-localfontsremove)

Surgically clean up your font directory.

```
# Remove only the large Variable files to save space
php artisan localfonts:remove Satoshi --variable

# Remove only Static weights (keeping the Variable file)
php artisan localfonts:remove Satoshi --static

# Remove everything for a family without confirmation
php artisan localfonts:remove Satoshi --force
```

---

Theme Integration
-----------------

[](#theme-integration)

Include the generated `fonts.less` (default: `assets/src/fonts/fonts.less`) into your main theme file.

### UIkit Variable Mapping

[](#uikit-variable-mapping)

We recommend using a mixin to map the specific localized IDs:

```
@import "../src/fonts/fonts.less";

// Mixin for surgical weight control
.font-variant(@family; @weight; @style: normal) {
    font-family: @family;
    font-weight: @weight;
    font-style: @style;
}

h1 { .font-variant('Satoshi', 700); }
```

---

### Pro-Tip: Browser Auditing

[](#pro-tip-browser-auditing)

If you aren't sure whether to keep the **Static** or **Variable** files, you can use the **Chrome DevTools Coverage Tab** to see exactly which font files are being utilized by your page.

1. Open **DevTools** (`Cmd+Shift+P` or `Ctrl+Shift+P`).
2. Type **"Coverage"** and select **Show Coverage**.
3. Click the **Reload** icon.
4. If a 200kb Variable font is 90% "red" (unused), you should switch to the 20kb Static files using `localfonts:remove Satoshi --variable`.

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance52

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/2d4325040b5bcb235cf0f7555ec5b28498935f54c74bb90c3b2828461598500d?d=identicon)[mercator](/maintainers/mercator)

### Embed Badge

![Health badge](/badges/mercator-wn-localfonts-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/mercator-wn-localfonts-plugin/health.svg)](https://phpackages.com/packages/mercator-wn-localfonts-plugin)
```

###  Alternatives

[slack-php/slack-block-kit

OOP interface for writing Slack Block Kit messages and modals

55754.2k6](/packages/slack-php-slack-block-kit)[symfony/ux-map

Easily embed interactive maps in your Symfony application

18178.5k4](/packages/symfony-ux-map)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)