Transmuter
This module allows you to create reusable "transmuter" plugins that act as theme preprocessors. These plugins can integrate with Drupal's theme registry and preprocess hooks to modify HTML or theme elements, similar to how theme preprocess functions work. They are cached for performance and can be defined within themes or modules.
The module name is a play on the alchemy transmutation of elements. Elements in
this case refers to HTML elements or theme elements
This module adds transmuter plugins which can function as theme preprocessors of
Drupal templates. Transmuter plugins are discoverable in modules and theme by
using the Transmuter attribute on the plugin classes (@see README).
Attribute discovery of theme defined plugins are possible with the use of the
themespace module.
Transmuter plugins are added to the theme registry and are compatible and work
well with theme preprocess hooks which are defined by other modules and themes.
By applying to the theme registry, the definitions are cached when the theme
registry is built.
Features
Transmuter preprocess plugins work well and will interweave with other preprocess hooks defined by Drupal, modules or themes. They are applied to the theme registry and are cached with the theme registry. The plugins make good use of caching and static memory so generally provides good performance.
Transmuter plugins which are defined by themes are cached per theme and will
only be applied when that theme is active. This behavior matches what theme
preprocess hooks defined by themes would do.
Transmuters are applied to when sub-themes are active as well, and will run
execute before the sub-theme definitions.
Additional Requirements
This project requires the themespace module to help support theme discovery of transmuter plugins.
Similar projects
This module is similar to the Preprocess module
Depends on
Dependencies of the latest stable release
No dependencies recorded for this project.
Required by
Tracked projects that depend on this one
No tracked projects depend on this one yet.
Activity
Release Timeline
Releases
| Version | Type | Core | Notes | Release date | |
|---|---|---|---|---|---|
| 2.0.0-alpha2 | Pre-release | 11 | Fix composer.json dependency | Jul 31, 2026 | |
| 2.0.0-alpha1 | Pre-release | 11 | Jul 30, 2026 | ||
| 2.0.x-dev | Dev | 11 | Drupal 12 supported version | Jul 22, 2026 | |
| 1.0.0-alpha4 | Pre-release | 10–11 | Fix the determination of base hooks for the theme registry. | May 20, 2025 | |
| 1.0.0-alpha3 | Pre-release | 10–11 | fix bug with theme hook suggestions. | Mar 19, 2025 | |
| 1.0.0-alpha2 | Pre-release | 10–11 | Update to v3.x of themespace. | Mar 6, 2025 | |
| 1.0.0-alpha1 | Pre-release | 10–11 | Jan 8, 2025 | ||
| 1.0.x-dev | Dev | 10–11 | 1.0.x branch | Jan 8, 2025 |