heimrichhannot/contao-media-library-bundle

Add a Media Library to your Contao CMS Web Application.

2.0.0-beta.9 2025-11-24 14:41 UTC

Requires

• php: ^8.2
• ausi/slug-generator: ^1.0
• contao/core-bundle: ^4.13 || ^5.3
• heimrichhannot/contao-encore-contracts: ^1.0
• heimrichhannot/contao-flare-bundle: ^0.0
• heimrichhannot/contao-form-type-bundle: ^0.2.0
• heimrichhannot/contao-utils-bundle: ^2.220 || ^3.0
• symfony/config: ^5.4 || ^6.4 || ^7.0
• symfony/event-dispatcher-contracts: ^1.0 || ^2.0 || ^3.0
• symfony/translation-contracts: ^1.0 || ^2.0 || ^3.0

Suggests

• codefog/tags-bundle: ^3.2
• heimrichhannot/contao-categories-bundle: ^1.1
• heimrichhannot/contao-filecredits-bundle: ^2.1

Conflicts

• heimrichhannot/contao-filecredits-bundle: <2.1.0
• heimrichhannot/contao-flare-bundle: <0.0.13

LGPL-3.0-or-later

README

The Contao Media Library Bundle provides archive‑based management of media library items (such as images, videos, and files) and their downloadable files.

Features

• Organize your media as objects in archives
• Predefined media library product types: image, video, file
• For image archives, define image sizes that are used to automatically create downloads
• Individually add additional DCA fields to the archives and their items
• Automatically generate downloads for images in desired formats and dimensions
• Upload and edit media library items directly from the frontend with a form generator preset form-type
• Integration with FLARE Bundle to list media libraries, e.g., in gallery views
• Integration with Form Type Bundle to handle form submissions with media library items
• Integration with Encore Bundle to easily add the media library assets to your frontend
• Optional: Integration with Codefog Tags Bundle to tag items
• Optional: Integration with H & H Categories Bundle to categorize items
• Optional: Integration with H & H Filecredits Bundle (private) to ease assignment of file credits to the files of items

Installation

Install the bundle via Composer and update the database afterwards.

composer require heimrichhannot/contao-media-library-bundle

Setup

1. Create a media library archive and configure its settings.
2. Create an entry in this archive.
3. Optional: Manually add additional files or file variants.

Configuration

huh_media_library:
    # Default upload path for media library items when using the frontend form
    file_upload_path: 'files/media-library/##author##/##title##'

Editing and deleting products

You can enable edit and delete support for media library products by activating the corresponding options in the archive settings.
Make sure to configure the member (and/or member group) permissions accordingly.

If a front end member has the required permissions, edit and delete links are automatically added to the template data of reader bundle templates.
The variables are available as editLink and deleteLink.