Download the PHP package alengo/sulu-media-extra-bundle without Composer
On this page you can find all versions of the php package alengo/sulu-media-extra-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download alengo/sulu-media-extra-bundle
More information about alengo/sulu-media-extra-bundle
Files in alengo/sulu-media-extra-bundle
Package sulu-media-extra-bundle
Short Description Media utilities for Sulu CMS — @2x crop sync, format generation, media rename command
License MIT
Homepage https://github.com/alengodev/SuluMediaExtraBundle
Informations about the package sulu-media-extra-bundle
SuluMediaExtraBundle
Media utilities for Sulu CMS 3.x — @2x crop synchronization, image format generation, and media rename command.
Features
@2xcrop sync — automatically mirrors crop settings from800x@2xto800xon every crop save- Image format generation — generates
image-formats.xmlentries from a simple YAML list (including@2xvariants) - Format options duplicate — backfills existing
@2xcrop entries to their base format keys - Media rename — renames a media file in storage and database with dry-run support
Requirements
- PHP 8.2+
- Sulu CMS ~3.0
- Symfony 7.x
Installation
Register the bundle in config/bundles.php:
No further configuration required — all services are auto-registered.
@2x Crop Sync
MediaCropModifiedSubscriber listens to MediaCropModifiedEvent. Whenever a crop is saved for a format key containing @2x (e.g. 800x@2x), the same crop coordinates are automatically written to the base key (800x).
This ensures that @1x and @2x formats always use identical crop regions without manual duplication.
Commands
alengo:media:image-formats:generate
Generates image-formats.xml entries from a YAML source file. Each format produces two XML entries — the base format (marked internal="true") and the @2x variant.
Source YAML format:
Generated XML output (appended to existing image-formats.xml):
| Option | Default | Description |
|---|---|---|
--source / -s |
config/app/image-formats.yaml |
Source YAML file (relative to project root) |
--target / -t |
config/image-formats.xml |
Target XML file (relative to project root) |
alengo:media:image-format-options:duplicate
Backfills existing @2x crop entries (me_format_options) to their base format keys. Useful after adding the bundle to a project that already has saved crops.
| Option | Default | Description |
|---|---|---|
--source / -s |
config/app/image-formats.yaml |
YAML file listing the format keys to process |
alengo:media:rename
Renames a media file — updates the display name in the database, moves the file in storage, and increments the subVersion to invalidate format caches.
| Argument / Option | Description |
|---|---|
mediaId |
ID of the media to rename |
newName |
New base filename (extension is preserved from original) |
--locale / -l |
Locale for filename normalization (default: en) |
--dry-run |
Preview changes without writing anything |