c975l/gallery-bundle

Symfony bundle providing a photo gallery (categories, batch upload, thumb/medium/highres derivatives) managed through EasyAdmin.

v0.1 2026-07-13 19:43 UTC

Requires

• php: >=8.0
• c975l/config-bundle: *
• c975l/ui-bundle: *
• doctrine/orm: *
• easycorp/easyadmin-bundle: *
• symfony/form: *
• vich/uploader-bundle: *

Requires (Dev)

• doctrine/doctrine-fixtures-bundle: *
• phpunit/phpunit: ^13.2
• symfony/browser-kit: *
• symfony/css-selector: *
• symfony/phpunit-bridge: *
• symfony/var-dumper: *

MIT

• Laurent Marquet
• 975L Community

• symfony
• bundle
• gallery
• photos

Published on Packagist.org on 2026-07-13 19:47 UTC

README

Symfony bundle providing a photo gallery (galleries → categories → photos) managed through EasyAdmin, with batch upload and automatic thumb/medium/highres derivatives.

Features

• Gallery → GalleryCategory → GalleryPhoto: a site can host more than one independent gallery, each with its own categories. The default gallery's public routes stay short (no {gallery} slug segment).
• Batch upload: add several photos at once to a category, with credits/rights-reserved applied to the whole batch and per-photo alt text - reuses the CollectionType + VichImageType pattern from UiBundle's own Slider block.
• Three derivatives generated automatically per photo (thumbnail square / medium / highres), via UiBundle's VichImageResizeListener and the VichMultiSizeImageInterface contract - naming and resizing stay centralized in UiBundle, this bundle only declares the target sizes.
• One EasyAdmin menu entry (the photo library); category management is reachable from its toolbar so both screens read as one linked feature.
• A catch-all "Non classé" category is created lazily so every photo always has one, even without picking a real one at upload time.

Requirements

• PHP >= 8.0
• c975l/ui-bundle (Vich naming/resizing, EasyAdmin form-theme conventions)
• c975l/config-bundle (EasyAdmin dashboard, menu provider)
• Doctrine ORM
• VichUploader Bundle

Installation

composer require c975l/gallery-bundle

php bin/console doctrine:migrations:diff
php bin/console doctrine:migrations:migrate

No extra Stimulus controller registration needed - the batch upload screen reuses EasyAdmin's own collection add/remove widget and Vich file preview (see gallery_photo_upload.html.twig).