PHPackages                             municipio/wp-plugin-municipio-theme-extensions - 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. municipio/wp-plugin-municipio-theme-extensions

ActiveWordpress-plugin

municipio/wp-plugin-municipio-theme-extensions
==============================================

Focused theme compatibility extensions for modern Municipio installations.

0107↑125%PHP

Since Jul 24Pushed 1w agoCompare

[ Source](https://github.com/municipio-se/wp-plugin-municipio-theme-extensions)[ Packagist](https://packagist.org/packages/municipio/wp-plugin-municipio-theme-extensions)[ RSS](/packages/municipio-wp-plugin-municipio-theme-extensions/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependenciesVersions (1)Used By (0)

Municipio Theme Extensions
==========================

[](#municipio-theme-extensions)

Municipio Theme Extensions adds focused theme compatibility options that are missing from modern Municipio. It does not add editorial workflows or business functionality.

The plugin supports modern Municipio only. Municipio LTS is a migration source, not a supported runtime.

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

[](#installation)

Install the package with Composer:

```
composer require municipio/wp-plugin-municipio-theme-extensions
```

The package type is `wordpress-plugin`, and `extra.installer-name` ensures that `composer/installers` places it in `wp-content/plugins/municipio-theme-extensions`. Activate **Municipio Theme Extensions** in WordPress after installation.

Header settings
---------------

[](#header-settings)

The first release adds two fields to Municipios existing **Header → Appearance**section:

- header link color;
- header link size and weight.

The fields target links and icons shown directly in the header. Header trigger buttons, drawer navigation, other menus, and Municipio markup remain owned by Municipio. The configured color also applies to hover, focus, active, and visited states so generic link colors cannot reduce header contrast.

The release also adds **Letter Spacing** as a subfield in Municipios existing **Typography → Button** control. The value is stored with the other `typography_button` choices and writes `--letter-spacing-button`, which a plugin rule uses to override the fixed spacing on Municipios small buttons without replacing its Blade markup. The default preserves Municipios current `.1rem`; migrated LTS button typography uses `normal` because the former Municipio Extended button template did not apply that spacing.

Secondary menu behavior
-----------------------

[](#secondary-menu-behavior)

The plugin adds **Start secondary menu at level two** to Municipios existing **Menu → Behaviour** section. The setting is enabled by default and removes the active level-one branch from the secondary sidebar navigation even when the primary menu has no assigned items. Disabling it restores modern Municipios current behavior for that configuration and displays the complete tree.

The option uses Municipios controller applicator and its cache. The runtime default matches the field default, so existing installations receive the enabled behavior without an activation migration or an initial Customizer save. Primary, mobile, drawer, mega-menu, and breadcrumb data are not modified.

One Page classic content
------------------------

[](#one-page-classic-content)

The plugin restores the LTS-compatible **Display text content for One Page template** option in Municipios existing **General settings** section. It reuses the `municipio_customizer_onepage_body_text` theme mod, promotes the current One Page title when enabled without overriding the static front page's page-level title choice, and lets Municipios own template render filtered classic content through the same content branch used for blocks. No page template or content is copied or migrated.

Activation migration
--------------------

[](#activation-migration)

Activation runs a versioned, idempotent migration for the settings needed by the first release:

- compatible color values are reused directly;
- legacy `header_color` tokens are mapped to explicit colors;
- the existing primary-navigation contrast color is used as a fallback;
- button font size and weight are copied to the new header-specific typography setting;
- reusable LTS button typography receives normal letter spacing without overwriting an explicitly configured value.

Existing target values are never overwritten. Legacy theme mods remain in the database for troubleshooting and rollback, and the completed migration version is stored in `municipio_theme_extensions_migration_version`.

Development
-----------

[](#development)

Migration development and release cleanup follow the canonical policy in [`docs/migrations.md`](docs/migrations.md). Unreleased migration iterations are squashed into one schema version per package release; released migrations are retained until their source versions are no longer supported.

```
composer install
composer test
composer lint
```

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance64

Regular maintenance activity

Popularity14

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 77.8% of commits — single point of failure

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://avatars.githubusercontent.com/u/8242740?v=4)[Fredrik Johansson](/maintainers/jeanfredrik)[@jeanfredrik](https://github.com/jeanfredrik)

---

Top Contributors

[![Tsubarah](https://avatars.githubusercontent.com/u/67978743?v=4)](https://github.com/Tsubarah "Tsubarah (7 commits)")[![jeanfredrik](https://avatars.githubusercontent.com/u/8242740?v=4)](https://github.com/jeanfredrik "jeanfredrik (2 commits)")

### Embed Badge

![Health badge](/badges/municipio-wp-plugin-municipio-theme-extensions/health.svg)

```
[![Health](https://phpackages.com/badges/municipio-wp-plugin-municipio-theme-extensions/health.svg)](https://phpackages.com/packages/municipio-wp-plugin-municipio-theme-extensions)
```

PHPackages © 2026

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