cms-alchemy/mild-media-manipulation

Token-based media layout wrappers for Drupal using controlled CSS variants.

dev-main 2026-03-31 00:15 UTC

Requires

• drupal/core: ^10 || ^11

GPL-3.0-or-later

README

Mild Media Manipulation is a lightweight Drupal text filter that allows editors to apply simple layout styles to embedded media using inline tokens.

It wraps content in semantic containers (<div> or <figure>) and applies predefined CSS classes, optionally including captions.

Installation

composer require cms-alchemy/mild-media-manipulation
drush en mild_media_manipulation

Features

• Token-based syntax for inline layout control
• Controlled vocabulary (no arbitrary class injection)
• Optional captions using semantic <figure> / <figcaption>
• Automatically attaches required CSS
• Works inside standard text formats (e.g., Basic HTML, Full HTML)

Concept

Instead of forcing editors to manually write HTML or rely on complex media configuration, this module provides a simple wrapper syntax:

[mmm:variant] ... [/mmm]

This allows layout decisions to remain editor-controlled but constrained, avoiding layout chaos.

🧾 Usage

Basic syntax

[mmm:left-side] [/mmm]

With caption

[mmm:right-side] | This is a caption [/mmm]

Available Variants

• left-side → floats content left
• right-side → floats content right
• two-column → grid layout (2 columns)
• centered → centered content

Invalid variants are ignored (content passes through unchanged).

Output Behavior

Without caption

... ``` With caption ... ...