municipio/wp-theme-municipio

A bootstrap theme for creating municipality sites.

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

Requires

• php: ^8.0
• composer/installers: ^2.2
• dompdf/dompdf: ^2.0.4
• helsingborg-stad/acf-export-manager: >=1.0.0
• ouun/kirki-module-fonts_upload: ^1.0.1
• pragmarx/ia-arr: ^7.3
• spatie/schema-org: ^3.9

Requires (Dev)

• 10up/wp_mock: dev-trunk#1.0.1
• helsingborg-stad/phpcs: ^0.3.1
• php-mock/php-mock-mockery: ^1.4

Suggests

• helsingborg-stad/component-library: Required for theme to work properly.
• helsingborg-stad/kirki: Required for theme to work properly.

MIT

• Kristoffer Svanmark
• Sebastian Thulin
• Whitespace

README

This WordPress theme is an LTS version of the Municipio theme.

Version 25.x is based on v4.25.0 of the original Municipio theme.

Changes in this Fork

This LTS version includes substantial performance improvements and new functionality. Database query caching has been implemented for slow operations, and unused performance-impacting code has been removed. The theme now uses get_option instead of get_field for checking default post types, significantly improving load times.

New features include ReadSpeaker integration support, one-page template enhancements with navigation buttons and content display options, and an under-hero widget area. The theme now supports custom link targets, additional secondary navigation options, and content sections above and below article content through new hooks.

Archive functionality has been improved with better filtering, taxonomy information on post objects, and fixes for z-index issues. Post age notices now handle default posts and account for modified dates. The customizer includes new filters for archive styles and button configurations.

Security and accessibility improvements include disabling custom code input and advanced HTML tags by default, adding attributes to inline script tags, and fixing various template routing and styling issues. Multiple new filters and hooks have been added for better theme customization and extensibility.

New WordPress Hooks

This fork adds the following WordPress hooks for enhanced customization:

Filters:

• Municipio/Hook/showSiteNameInSearchResult - Control site name display in search results
• Municipio/Helper/Post/EmptyExcerpt - Modify empty excerpt handling
• Municipio/Admin/EnableMetaDataPlugin - Control metadata plugin activation
• Municipio/Admin/AllowAdvancedHtmlTags - Control advanced HTML tags in editor
• Municipio/Hook/searchFormValidation - Customize search form validation
• Municipio/Customizer/Sections/Archive/archiveStyleChoices - Modify archive style options
• Municipio/CustomPostType/args - Modify custom post type arguments
• Municipio/views/page-centered/content-area/show - Control centered page content area display
• Municipio/allowCustomCode - Control custom code input availability
• Municipio/views/partials/sidebar/classes - Modify sidebar CSS classes
• Municipio/Customizer/Sections/Button/*/kirkiFieldArgs - Modify button customizer fields
• Municipio/Admin/Acf/ImageAltTextValidation/getAltText - Customize image alt text validation

Actions:

• Municipio/Hook/articleContentBefore - Add content before article content
• Municipio/Hook/articleContentAfter - Add content after article content
• Municipio/Customizer/Sections/Archive/init - Hook into archive customizer initialization

Installation

1. Install the package:

   composer require municipio/wp-theme-municipio

2. Activate the theme in WordPress.