PHPackages                             municipio/wp-plugin-modularity-navigation - 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-modularity-navigation

ActiveWordpress-plugin

municipio/wp-plugin-modularity-navigation
=========================================

Navigation modules for modern Municipio installations.

0111↑225%PHP

Since Jul 29Pushed 1w agoCompare

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

READMEChangelogDependenciesVersions (4)Used By (0)

Modularity Navigation
=====================

[](#modularity-navigation)

Modularity Navigation ports focused navigation-module capabilities from Municipio LTS to modern Municipio without restoring Municipio Extended as a compatibility layer.

Supported combinations
----------------------

[](#supported-combinations)

- Existing `mod-navigation` posts remain the source of truth.
- Existing `mod_navigation_format`, `mod_navigation_source`, `mod_navigation_menu`, `mod_navigation_items`, `mod_navigation_show_if_empty`, and `mod_navigation_empty_message` metadata is reused.
- Formats `grid`, `buttons`, and `list` can each render sources `menu`, `manual`, and `children`.
- Menu sources render only top-level items. Manual sources retain their saved order, links, targets, icons, and button variants.
- Child-page sources resolve the current Municipio page and retain WordPress `menu_order` while excluding unpublished pages and pages hidden from menus.
- The legacy theme mod `mod_navigation_grid_style=blocks` is reused and exposed under Municipios existing component-appearance panel.
- Button output uses Municipios current Button and Icon components. List output uses the current Link and Icon components inside semantic unordered-list markup.

Other LTS formats and sources are intentionally outside this release. Their values remain in the database but render no output until separately ported.

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

[](#installation)

Install `municipio/wp-plugin-modularity-navigation` with Composer. Composer Installers places it in `wp-content/plugins/modularity-navigation` through `extra.installer-name`.

The plugin supports modern Municipio only and requires its bundled Modularity implementation.

Data migration
--------------

[](#data-migration)

No write migration runs. The plugin keeps the LTS post type, field names, repeater shape, menu slug, and theme-mod key intact, so imported content remains editable and repeat activation is idempotent by design.

Grid presentation extension
---------------------------

[](#grid-presentation-extension)

The package-owned `navigation-grid` Blade view remains the default. A site plugin can provide a focused grid presentation without replacing the complete Navigation module by registering its view root through `/Modularity/externalViewPath` and returning a plain Blade view name from:

```
add_filter(
    'MunicipioModularityNavigation/gridPresentationView',
    static fn(): string => 'site-navigation-grid',
);
```

The filter also receives the module ID, normalized items, and current grid style as its second through fourth arguments. The selected view receives Navigation's normalized module data. Invalid or missing override views safely fall back to `navigation-grid`; buttons, list, inline, bar, module title, and empty-state rendering never use the override.

Site presentations can set `--mod-navigation-grid-link-padding` and `--mod-navigation-grid-focus-color` on their own grid wrapper or items. Both variables fall back to the package's existing spacing and primary focus color, so the shared presentation is unchanged.

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

[](#development)

```
composer format
composer test
composer lint
```

###  Health Score

26

—

LowBetter than 40% of packages

Maintenance64

Regular maintenance activity

Popularity14

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity15

Early-stage or recently created project

 Bus Factor1

Top contributor holds 54.5% 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

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

### Embed Badge

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

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

PHPackages © 2026

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