drupal / mutamad_media
Media for Mutamad: core media types, Media Library, Focal Point, drimage responsive images, Dropzone bulk upload and library editing.
Package info
git.drupalcode.org/project/mutamad_media.git
Type:drupal-recipe
pkg:composer/drupal/mutamad_media
Requires
- drupal/better_exposed_filters: ~7
- drupal/core: ~11.4.0
- drupal/crop: ~2
- drupal/drimage_improved: ~1
- drupal/dropzonejs: ~2
- drupal/focal_point: ~2
- drupal/media_bulk_upload: ~3
- drupal/media_library_edit: ~3
- drupal/media_library_form_element: ~2.1.0
- drupal/mutamad_roles: ~1.0.0
- drupal/svg_image: ~3
- drupal/views_bulk_edit: ~3
- drupal/views_bulk_operations: ~4
- drupal/views_infinite_scroll: ~2
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is not auto-updated.
Last update: 2026-11-16 06:01:53 UTC
README
Mutamad Media
The media recipe for Mutamad — a drupal-recipe, applied by the
mutamad_starter site
template on every Mutamad install.
Built and maintained by iSpectra — Imagine. Implement. Inspire. See iSpectra on drupal.org.
What you get
- Media types — Image, Document, Audio, Video and Remote video, from core's media-type recipes, and SVG Image, with uploaded SVGs sanitised.
- Media Library, with editing straight from the library
(
media_library_edit) and a Media Library form element for custom forms. - Focal Point cropping on images and on video cover images.
- Responsive images through
drimage_improved, on every image display a visitor sees — the default display, the aspect-ratio displays and video covers among them: each image sized to its box and cropped around its Focal Point. Not SVGs, which are vectors, nor the small fixed thumbnails of the media library. - Bulk upload with Dropzone for images, audio and video.
- Aspect-ratio display modes for images and video — 1:1, 2:1, 3:1, 4:1, 4:3, 16:9 and 21:9 — plus small, medium, large, original, background, autoplay, looping and autoloop.
- Cover image and provider fields on video and remote video. Alt text is required on cover images, as on images and SVG.
- Media admin view with Better Exposed Filters, bulk operations, bulk edit and infinite scroll.
- Permissions per job role (from
mutamad_roles, applied first): editors create and edit any media, approvers also delete any media, site administrators manage media and media types. Generic permissions, so media types added later are covered. Deleted media goes to Trash; only site administrators purge. - No standalone page per media item (
standalone_url: false), so a media item is only reachable where it is placed.
What is left out
| Left out | Why |
|---|---|
dropzonejs_eb_widget | DropzoneJS's Entity Browser widget; it requires entity_browser, which Mutamad does not use. Bulk upload uses media_bulk_upload_dropzonejs. |
embed | The API behind Entity Embed, which Mutamad does not use; its 1.10 release causes a fatal error once CKEditor 5 plugins are scanned. |
canvas | Drupal Canvas, the visual page builder. Not needed by any media configuration. |
| Content editors deleting any media | Mutamad grants to its own job roles, and deletion is the approver's. |
Dropzone's library
Bulk upload needs the Dropzone library under web/libraries/dropzone, and the
recipe cannot install it: the official release is not on Packagist, and only
the root composer.json can declare the package repository it comes from. The
mutamad_project template
does. On another site, add the repository DropzoneJS's README gives, then
require the library:
"repositories": {
"dropzone": {
"type": "package",
"package": {
"name": "enyo/dropzone",
"version": "5.9.3",
"type": "drupal-library",
"dist": {
"url": "https://github.com/dropzone/dropzone/releases/download/v5.9.3/dist.zip",
"type": "zip"
}
}
}
}
composer require enyo/dropzone:5.9.3
Without it the upload form shows no drop area.
Apply it to an existing site
drush recipe ../recipes/mutamad_media
The recipe applies mutamad_roles first, so the job roles exist before
anything is granted to them.
Maintainers
Built and maintained by iSpectra (on drupal.org).
