municipio/wp-plugin-modularity

Modular component system for WordPress

v25.x-dev 2025-12-21 17:11 UTC

Requires

• php: ^8.0
• composer/installers: ^2.2
• helsingborg-stad/acf-export-manager: >=1.0.0
• helsingborg-stad/acf-select-image-field: ~1.4.3
• ooksanen/acf-focuspoint: ^1.2.1

Requires (Dev)

• 10up/wp_mock: dev-trunk#1.0.1
• php-mock/php-mock-mockery: ^1.4
• wpackagist-plugin/acf-extended: >=0.8.9.4

Suggests

• clark-nikdel-powell/post-type-select-for-acf: Required by Modularity
• enshrined/svg-sanitize: Required by Modularity
• helsingborg-stad/component-library: Required for modules in modularity
• jeradin/acf-dynamic-table-field: Required by Modularity
• jeradin/acf-website-field: Required by Modularity
• johannheyne/advanced-custom-fields-table-field: Required by Modularity

MIT

• Kristoffer Svanmark
• Sebastian Thulin
• Nikolas Ramstedt
• Karl Pettersson
• Whitespace

README

This plugin is an LTS version of the Modularity plugin.

Changes in this Fork

This LTS version includes significant security enhancements and feature improvements. Critical security fixes include AJAX nonce verification, sanitization of sidebar options and module fields, protection against host header injection vulnerabilities, and XSS prevention through proper output escaping.

New features include WebP image format support, MediaFlow video integration, and text box color customization options. The posts module has been enhanced with better filtering capabilities, archive link visibility controls, and support for rendering posts as template elements. Manual input modules now support proper link fields and improved accessibility with aria-describedby attributes.

Search functionality has been improved with better Elasticsearch indexing, fixed total count display, and prevention of hidden modules appearing in results. The plugin now properly handles translations when installed as an MU plugin and includes numerous accessibility improvements including removal of invalid aria-labelledby attributes.

Module management has been enhanced with submenu support for single post modules, improved sidebar handling, and fixes for module placement issues. The codebase includes performance optimizations such as preventing unnecessary queries with empty includes and proper dependency management.

New WordPress Hooks

This fork adds extensive WordPress hooks for enhanced customization:

Filters:

• Modularity/Module/Posts/TemplateController/{$template} - Modify posts module template controller
• Modularity/Module/Posts/archiveUrl - Customize posts module archive URL
• Modularity/Module/Template - Modify module templates
• Modularity/Module/Hero/imageSize - Control hero module image size
• Modularity/Display/mod-video/pre_getEmbedMarkup - Pre-process video embed markup
• Modularity/Module/Posts/Helper/pre_getPosts - Pre-process posts retrieval
• Modularity/Module/Posts/Helper/getPosts - Modify retrieved posts
• Modularity/Display/BeforeModule::widthClass - Control module width classes
• Modularity/Display/modules - Modify displayed modules
• Modularity/Display/pre_outputModule - Pre-process module output
• Modularity/Module/ManualInput/data/item - Modify manual input item data

Actions:

• Modularity/Editor/getModule - Hook into module editor retrieval

Installation

1. Install the package:

   composer require municipio/wp-plugin-modularity

2. Activate the plugin in WordPress.