Municipio Quality Extensions

Municipio Quality Extensions provides focused runtime improvements for modern Municipio installations. Features belong here when they improve accessibility, performance, security, or web standards through stable WordPress or Municipio extension points and are too broad or version-specific for a small upstream fix.

The plugin is independent of Municipio Cloud and contains no customer-specific behavior. Municipio LTS is not a supported runtime.

Installation

Install the package with Composer:

composer require municipio/wp-plugin-municipio-quality-extensions

Activate Municipio Quality Extensions as a network plugin for a Municipio multisite installation.

WordPress 6.9 late-style hoisting

WordPress 6.9 introduced a template enhancement buffer that moves styles discovered while rendering a classic theme from body to head. Municipio 6.43.3 renders its Blade response inside the template_include filter and returns false, so WordPress never reaches the point where it normally starts that buffer.

For WordPress 6.9 and later, the plugin starts the public WordPress buffer at priority 14, immediately before Municipios renderer at priority 15. WordPress continues to own style collection, ordering, HTML processing, and final output. The compatibility layer does nothing for block themes, non-Municipio themes, older WordPress versions, or runtimes without the public buffer API.

The feature can be removed once supported Municipio versions let WordPress run wp_before_include_template before rendering their response.

Server-local Material Symbols SVG

The optional Material Symbols integration reads prebuilt SVGs from a local, root-owned store and injects them through Component Library's documented icon data and attribute filters. It performs one indexed seek for each distinct icon variant in a request. Missing, unreadable or invalid data preserves Component Library's original font rendering.

The integration is disabled unless both constants are configured:

define('MUNICIPIO_QUALITY_EXTENSIONS_MATERIAL_SYMBOLS_SVG_ENABLED', true);
define(
    'MUNICIPIO_QUALITY_EXTENSIONS_MATERIAL_SYMBOLS_STORE_PATH',
    '/path/to/material-symbols',
);

The store must contain a current symlink to a release under releases/, with one JSON offset index and uncompressed SVG pack per supported style, weight and fill combination. The plugin validates names, byte ranges and content hashes before rendering. It does not download, generate or write icons during a web request.

The Material Symbols font remains a fallback in this phase. Remove its stylesheet only after every icon-rendering path used by the installation has been verified with the SVG integration enabled.

Development

composer install
composer test
composer lint