Search by

drupal / mutamad_media

Drupal-Infrastructure

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

Homepage

Issues

Type:drupal-recipe

pkg:composer/drupal/mutamad_media

Statistics

Installs: 70

Dependents: 3

Suggesters: 0

1.0.x-dev 2026-11-15 08:37 UTC

This package is not auto-updated.

Last update: 2026-11-16 06:01:53 UTC


README

Mutamad Media — الوسائط

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 outWhy
dropzonejs_eb_widgetDropzoneJS's Entity Browser widget; it requires entity_browser, which Mutamad does not use. Bulk upload uses media_bulk_upload_dropzonejs.
embedThe API behind Entity Embed, which Mutamad does not use; its 1.10 release causes a fatal error once CKEditor 5 plugins are scanned.
canvasDrupal Canvas, the visual page builder. Not needed by any media configuration.
Content editors deleting any mediaMutamad 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

iSpectra

Built and maintained by iSpectra (on drupal.org).