Simple Image Gallery

Extension key: bm_image_gallery
Package name: freshworkx/bm-image-gallery
Version: main
Language: en
Copyright: since 2016 by the authors
Author: Jens Neumann
License: This extension documentation is published under the Open Publication License.
Rendered: Fri, 10 Apr 2026 14:48:52 +0000

This extension creates galleries from images and YouTube videos organized within TYPO3's File Collection records.

Features

Plugin for list, detail or single view
Settings for sorting and limit of files per plugin
Extends TYPO3's File Collection record by
- description (RTE)
- preview image
- location
- date
- speaking url (slug)

Compatibility

Extension Version	TYPO3 v14 Support	TYPO3 v13 Support	TYPO3 v12 Support	TYPO3 v11 Support	TYPO3 v10 Support	TYPO3 v9 Support	TYPO3 v8 Support
8.0.x	yes	no	no	no	no	no	no
7.2.x	no	yes	no	no	no	no	no
7.1.x	no	yes	no	no	no	no	no
7.0.x	no	yes	no	no	no	no	no
6.2.x	no	no	yes	no	no	no	no
6.1.x	no	no	yes	no	no	no	no
6.0.x	no	no	yes	no	no	no	no
5.2.x	no	no	no	yes	yes	no	no
5.0.x	no	no	no	no	yes	no	no
4.2.x	no	no	no	no	yes	yes	no
4.1.x	no	no	no	no	no	yes	yes
4.0.x	no	no	no	no	no	yes	yes
3.1.x	no	no	no	no	no	yes	yes

Note

There are legacy versions of this extension supporting TYPO3 versions from 6.2 LTS on.

Links

Documentation	https://docs.typo3.org/p/freshworkx/bm-image-gallery/main/en-us/
TER	https://extensions.typo3.org/extension/bm_image_gallery/
Repository	https://github.com/freshworkx/typo3-image-gallery

For Administrators

This chapter describes how to manage the extension from a administrators point of view.

Installation

There are several ways to require and install this extension. We recommend to get this extension via composer.

Via Composer

If your TYPO3 instance is running in composer mode, you can simply require the extension by running:

composer req freshworkx/bm-image-gallery

Via Extension Manager

Open the extension manager module of your TYPO3 instance and select "Get Extensions" in the select menu above the upload button. There you can search for bm_image_gallery and simply install the extension. Please make sure you are using the latest version of the extension by updating the extension list before installing the extension.

Via ZIP File

You need to download the extension from the TYPO3 Extension Repository and upload the zip file to the extension manager of your TYPO3 instance and activate the extension afterwards.

Important

Please make sure to include all TypoScript files.

Templates

Set alternative Layout/Template/Partial path individually to use your own Fluid templates. Simply set the following TypoScript constants:

plugin.tx_bmimagegallery.view {
    templateRootPath = EXT:your_ext/Resources/Private/Template/Path/
    partialRootPath = EXT:your_ext/Resources/Private/Partial/Path/
    layoutRootPath = EXT:your_ext/Resources/Private/Layout/Path/
}

Configuration

Important

For TYPO3 v13 and later, you can use site sets instead of TypoScript constants. Site sets provide a modern, GUI-based configuration approach with full backward compatibility.

For details about the bm_image_gallery site set configuration take a look into Site Set section.
More information about TYPO3 Site Sets can be found here.

Constants

The following configuration may be overwritten in your TypoScript constants.

List

Show the number of file collections in the gallery list view. 1 means TRUE, 0 means FALSE.

plugin.tx_bmimagegallery {
    settings {
        list {
            showCount = 1
        }
    }
}

Gallery

You can configure whether to display the amount of files given in your file collection or whether to show the gallery description of the file collection. In addition, you can enable or disable pagination.

plugin.tx_bmimagegallery {
    settings {
        gallery {
            # Show the number of files in a gallery. 1 means TRUE, 0 means FALSE.
            showCount = 1

            # Show a description of a file collection in gallery mode. 1 means TRUE, 0 means FALSE.
            showDescription = 1

            # Show gallery with pagination. 1 means TRUE, 0 means FALSE.
            showPagination = 1
        }
    }
}

Videos

You can add some custom parameters to the URI where the videos will be retrieved from.

plugin.tx_bmimagegallery {
    settings {
        videos {
            # Append params for YouTube videos.
            youtube.params = autoplay=1&fs=1

            # Append params for Vimeo videos.
            vimeo.params = color=000
        }
    }
}

Images

Here you can set default image sizes.

plugin.tx_bmimagegallery {
    settings {
        images {
            width = 300c
            maxWidth = 500
            height = 300c
            maxHeight = 500
        }
    }
}

Lightbox

You can use your own lightbox library for showing images and videos in a lightbox. Several information are available in the anchor tag which should trigger the lightbox. However, you can add your own CSS class and rel attribute to adapt the source code to your needs.

plugin.tx_bmimagegallery {
    settings {
        lightbox {
            cssClass =
            relAttribute =
        }
    }
}

Pagination

Currently, the following TYPO3 core classes can be used for pagination:

TYPO3CMSCorePaginationSimplePagination
TYPO3CMSCorePaginationSlidingWindowPagination

Adapt the settings to your needs, further information can be found here.

Note

Theoretically, you can also implement your own custom pagination class here. But be careful, you may need to make further adjustments.

plugin.tx_bmimagegallery {
    settings {
        pagination {
            class = TYPO3\CMS\Core\Pagination\SimplePagination
            itemsPerPage = 10
            maximumNumberOfLinks = 3
        }
    }
}

Site Set

This site set provides modern TYPO3 v13 configuration for the bm_image_gallery extension using site settings.

Note

More information about TYPO3 Site Sets can be found here.

Installation

Add the site set to your site configuration in the site management module or directly in your site's config.yaml:

dependencies:
  - freshworkx/bm-image-gallery

Configuration

You can configure the bm_image_gallery settings in three ways:

Option A: Through the Backend

Go to Site Management > Sites
Edit your site
Navigate to the Settings tab
Find the Plugin Configuration > Image Gallery section
Configure your settings

Option B: In Site Configuration YAML

Add to your site's config/sites/<your-site>/settings.yaml:

plugin:
 tx_bmimagegallery:
   persistence:
     storagePid: 123
   settings:
     gallery:
       showCount: true
       showDescription: true
     images:
       maxWidth: 800
       maxHeight: 600
     pagination:
       itemsPerPage: 20

Changed in version 13.4.15

The settings in settings.yaml are stored as map instead of tree.

Important: #106894 - Site settings.yaml is now stored as a map

Option C: Override in Site Set

Create a custom site set that depends on this one and override settings in your settings.yaml.

Migration from TypoScript Constants

No Migration Needed!

Simply enable the site set - everything continues to work! Your existing constant overrides will continue to function until you move them to Site Settings.

Site Settings use exactly the same paths as TypoScript constants:

# This TypoScript works with both constants AND Site Settings:
plugin.tx_bmimagegallery.settings.gallery.showCount = {$plugin.tx_bmimagegallery.settings.gallery.showCount}

Important

When you set a site setting, it automatically takes priority over the constant!

Optional: Move to Site Settings

If you want to use the Backend UI or per-site configuration:

Enable the site set in your site configuration
Test that everything works as before
Move your custom constant values to site settings
Remove the constant overrides when ready

TypoScript Access

Settings are available using the standard constant syntax:

plugin.tx_bmimagegallery.settings.gallery.showCount = {$plugin.tx_bmimagegallery.settings.gallery.showCount}

Note

No changes needed! Site Settings use the same paths as constants.

Fluid Access

Access settings in Fluid templates:

<!-- Same as constants, just via site settings -->
{site.settings.plugin.tx_bmimagegallery.settings.gallery.showCount}

PHP Access

Access settings in PHP using the SiteSettings API:

<?php

declare(strict_types=1);

namespace YourVendor\YourExtension\Controller;

use TYPO3\CMS\Core\Site\Entity\SiteInterface;

final class YourController
{
    public function __construct(
        private readonly SiteInterface $site
    ) {}

    public function getSetting(): int
    {
        return (int)$this->site->getSettings()
            ->get('plugin.tx_bmimagegallery.settings.pagination.itemsPerPage', 10);
    }
}

Migration

This Section will help you to migrate your plugins and settings from 6.x.x to 7.0.0.

Important

Please make sure that you have made a backup of your database first!
Be aware that things added by 3rd party extensions are not migrated.

Migration `list_type` to `CType`

Important

Please make sure that you have successfully completed this wizard first!

According to the TYPO3 deprecation #105076. the plugin content element list and the plugin sub types field list_type have been marked as deprecated.

For this migration the extension provide an upgrade wizard which migrates all bm_image_gallery plugins from list_type to CType definition. The upgrade wizard is available in the Backend or via CLI:

CLI example to run migration wizard

./bin/typo3 upgrade:run bmImageGalleryCTypeMigration

Migration `flexForm` settings of plugins

Important

Please make sure that you have successfully completed the Migration list_type to CType wizard first!

The TCA of file_collections and the settings in flexForm of plugins had to be adjusted.

For this migration the extension provide an upgrade wizard which migrates all bm_image_gallery plugins. The upgrade wizard is available in the Backend or via CLI:

CLI example to run migration wizard

./bin/typo3 upgrade:run bmImageGalleryFlexFormMigration

Advanced routing configuration

Since TYPO3 v9 introduced native routing to the Core, it is possible to define route enhancers of various types. These route enhancers transform ugly URL's into nice readable.

An example of the route enhancer definition for the Gallery List plugin is stored in the extension itself.

bm_image_gallery/Configuration/Routes/List.yaml

routeEnhancers:
  GalleryPlugin:
    aspects:
      gallery_name:
        type: PersistedAliasMapper
        tableName: sys_file_collection
        routeFieldName: bm_image_gallery_path_segment
      localized_gallery:
        type: LocaleModifier
        default: 'gallery'
        localeMap:
          -
            locale: 'de_*'
            value: 'galerie'
    defaultController: 'Gallery::list'
    extension: BmImageGallery
    plugin: GalleryList
    routes:
      -
        routePath: '/{localized_gallery}/{gallery_name}'
        _controller: 'Gallery::detail'
        _arguments:
          gallery_name: show
    type: Extbase

You can import the file optionally into your own website configuration:

config/sites/<some_site>/config.yaml

# ... some more configuration is here ...
imports:
  - { resource: "EXT:bm_image_gallery/Configuration/Routes/List.yaml" }

Note

Feel free to import or overwrite your own route enhancer definition in the website configuration.

For Editors

The Image Gallery plugins provide various options to cover different scenarios.

Quick & Easy

The easiest way to get an front end output of your gallery is to follow these steps (default scenario):

Create file collection(s)

Create one or more file collection records in a folder inside your page tree and include your files. Each file collection represents a gallery. The bm_image_gallery extension extends TYPO3's file collection record. You can find some extra fields under the tab Image Gallery.

Optionally, you have the possibility to enter various details about your collection here.
Note

If your file collection do not contain
- a gallery description, the description of the file collection itself is used as fallback.
- a preview image, the first image of the file collection is taken as fallback (old behavior).
Select the proper plugin

Backend view of the new content element wizard. Add a Plugin content element on the page where you want to show your gallery. You have to choose the proper plugin type that fits your requirements.
Add reference

Add references to your file collections in the File Collection section.

Backend view of plugin for a gallery list.
Plugin options

The Plugin options provide a second section where you can limit the number of shown images the gallery. There are also options to sort images. Default will take the order from the file collection.

Backend view of plugin options for limiting number of images and sorting.

Possible Scenarios

There are the following scenarios to display galleries:

List of Galleries with Gallery View on Same Page

For that choose the Gallery List plugin and select Same Page as Detail View option.
List of Galleries with Gallery View on a Different Page

This scenario is recommended for multiple plugins on the same page.

For that choose the Gallery List plugin and select Selected Page as Detail View option. After an automatic reload, you will find an additional configuration option Gallery Page at the bottom of the screen. Please add a reference to the target detail page here. Save the plugin and navigate to the page just selected. Create a new plugin of type Elements of Gallery. Now you are all set.
List of Galleries without Gallery View

For that choose the Gallery List plugin and select No Detail View as Detail View option.
Gallery View for a Single Gallery

For that choose the Selected Gallery plugin.

For Developers

This chapter provides information for developers who want to extend the bm_image_gallery extension.

Events

The bm_image_gallery extension dispatches events that allow you to hook into the gallery rendering process at strategic points. These events follow TYPO3's PSR-14 event system and can be used to:

Modify collection data
Filter or enrich items
Add template variables
Implement custom business logic

Event Overview

Event	When Dispatched	Main Purpose
AfterCollectionInfoResolvedEvent	After complete processing	Enrich collection info array
AfterItemsSortedEvent	After sort + limit	Post-process sorted items
BeforeRenderingEvent	Before view assignment	Add template variables

AfterCollectionInfoResolvedEvent

Class: FreshworkxBmImageGalleryEventAfterCollectionInfoResolvedEvent

When is it dispatched?

After all extension processing
After description/preview fallbacks
After items have been sorted (if requested)

AfterItemsSortedEvent

Class: FreshworkxBmImageGalleryEventAfterItemsSortedEvent

When is it dispatched?

After FileCollector->sort()
After maxItems limit

BeforeRenderingEvent

Class: FreshworkxBmImageGalleryEventBeforeRenderingEvent

When is it dispatched?

Dispatched in all actions (list, gallery, detail)
Before $this->view->assign() or assignMultiple()

Event Registration

Method 1: PHP Attribute (Recommended)

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use Freshworkx\BmImageGallery\Event\AfterCollectionInfoResolvedEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
    identifier: 'my-ext/my-listener',
    event: AfterCollectionInfoResolvedEvent::class
)]
final readonly class MyListener
{
    public function __invoke(AfterCollectionInfoResolvedEvent $event): void
    {
        // Your logic
    }
}

Ensure autoconfiguration in Configuration/Services.yaml:

services:
  _defaults:
    autowire: true
    autoconfigure: true
    public: false

  MyVendor\MyExtension\EventListener\:
    resource: '../Classes/EventListener/*'

Method 2: Services.yaml

services:
  MyVendor\MyExtension\EventListener\MyListener:
    tags:
      - name: event.listener
        identifier: 'my-ext/my-listener'
        event: Freshworkx\BmImageGallery\Event\AfterCollectionInfoResolvedEvent

Further Resources

TYPO3 PSR-14 Documentation

AfterCollectionInfoResolvedEvent

Example Use Cases

Add Custom Metadata

This example shows how to add formatted dates and SEO metadata to collections.

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use Freshworkx\BmImageGallery\Event\AfterCollectionInfoResolvedEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
    identifier: 'my-ext/add-metadata',
    event: AfterCollectionInfoResolvedEvent::class
)]
final readonly class AddMetadataListener
{
    public function __invoke(AfterCollectionInfoResolvedEvent $event): void
    {
        $info = $event->getCollectionInfo();

        // Add formatted date
        if ($info['date']) {
            $info['formattedDate'] = date('d.m.Y', $info['date']);
        }

        // Add SEO data
        $info['metaDescription'] = sprintf(
            'Gallery "%s" with %d images',
            $info['title'],
            $info['itemCount']
        );

        $event->setCollectionInfo($info);
    }
}

Add Custom Fields

This example demonstrates adding custom fields to the collection info array.

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use Freshworkx\BmImageGallery\Event\AfterCollectionInfoResolvedEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
    identifier: 'my-ext/add-custom-fields',
    event: AfterCollectionInfoResolvedEvent::class
)]
final readonly class AddCustomFieldsListener
{
    public function __invoke(AfterCollectionInfoResolvedEvent $event): void
    {
        $info = $event->getCollectionInfo();

        // Add custom fields
        $info['formattedDate'] = date('d.m.Y', $info['date']);
        $info['hasMultipleImages'] = $info['itemCount'] > 1;

        $event->setCollectionInfo($info);
    }
}

Modify Existing Fields

This example shows how to modify existing collection fields.

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use Freshworkx\BmImageGallery\Event\AfterCollectionInfoResolvedEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
    identifier: 'my-ext/modify-title',
    event: AfterCollectionInfoResolvedEvent::class
)]
final readonly class ModifyTitleListener
{
    public function __invoke(AfterCollectionInfoResolvedEvent $event): void
    {
        $info = $event->getCollectionInfo();

        // Modify title
        $info['title'] = '[Gallery] ' . $info['title'];

        $event->setCollectionInfo($info);
    }
}

Add External Data

This example demonstrates enriching collections with external data.

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use Freshworkx\BmImageGallery\Event\AfterCollectionInfoResolvedEvent;
use MyVendor\MyExtension\Service\StatisticsService;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
    identifier: 'my-ext/add-statistics',
    event: AfterCollectionInfoResolvedEvent::class
)]
final readonly class AddStatisticsListener
{
    public function __construct(
        private StatisticsService $statisticsService
    ) {}

    public function __invoke(AfterCollectionInfoResolvedEvent $event): void
    {
        $info = $event->getCollectionInfo();

        // Add external data
        $info['downloadCount'] = $this->statisticsService
            ->getDownloadCount($info['identifier']);
        $info['viewCount'] = $this->statisticsService
            ->getViewCount($info['identifier']);

        $event->setCollectionInfo($info);
    }
}

AfterItemsSortedEvent

Example Use Cases

Filter Items by Extension

This example shows how to filter items to only allow specific file types.

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use Freshworkx\BmImageGallery\Event\AfterItemsSortedEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
    identifier: 'my-ext/filter-items',
    event: AfterItemsSortedEvent::class
)]
final readonly class FilterItemsListener
{
    public function __invoke(AfterItemsSortedEvent $event): void
    {
        $items = $event->getItems();

        // Only allow JPG and PNG
        $filtered = array_filter($items, function($item) {
            return in_array(
                strtolower($item->getExtension()),
                ['jpg', 'jpeg', 'png'],
                true
            );
        });

        $event->setItems(array_values($filtered));
    }
}

Filter Items by Size

This example demonstrates filtering items based on file size.

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use Freshworkx\BmImageGallery\Event\AfterItemsSortedEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
    identifier: 'my-ext/filter-by-size',
    event: AfterItemsSortedEvent::class
)]
final readonly class FilterBySizeListener
{
    public function __invoke(AfterItemsSortedEvent $event): void
    {
        $items = $event->getItems();

        // Only allow files larger than 1MB
        $filtered = array_filter($items, fn($item) => $item->getSize() > 1048576);

        $event->setItems(array_values($filtered));
    }
}

Enrich Items

This example shows how to enrich items with additional metadata.

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use Freshworkx\BmImageGallery\Event\AfterItemsSortedEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;
use TYPO3\CMS\Core\Resource\ProcessedFile;

#[AsEventListener(
    identifier: 'my-ext/enrich-items',
    event: AfterItemsSortedEvent::class
)]
final readonly class EnrichItemsListener
{
    public function __invoke(AfterItemsSortedEvent $event): void
    {
        $items = $event->getItems();

        foreach ($items as $item) {
            // Add metadata or prepare thumbnails
            // This is just for demonstration - in real scenarios,
            // you might want to add custom properties or process files
        }

        $event->setItems($items);
    }
}

Re-sort Items

This example demonstrates custom sorting of items.

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use Freshworkx\BmImageGallery\Event\AfterItemsSortedEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
    identifier: 'my-ext/resort-items',
    event: AfterItemsSortedEvent::class
)]
final readonly class ResortItemsListener
{
    public function __invoke(AfterItemsSortedEvent $event): void
    {
        $items = $event->getItems();

        // Sort alphabetically by name
        usort($items, fn($a, $b) => $a->getName() <=> $b->getName());

        $event->setItems($items);
    }
}

BeforeRenderingEvent

Example Use Cases

Add Analytics Tracking

This example shows how to add analytics tracking data to view variables.

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use Freshworkx\BmImageGallery\Event\BeforeRenderingEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
    identifier: 'my-ext/add-analytics',
    event: BeforeRenderingEvent::class
)]
final readonly class AddAnalyticsListener
{
    public function __invoke(BeforeRenderingEvent $event): void
    {
        // Add tracking
        $event->setViewVariable('trackingAction', 'gallery_' . $event->getAction());

        // Add page context
        $pageId = $event->getRequest()->getAttribute('routing')?->getPageId();
        $event->setViewVariable('pageId', $pageId);
    }
}

Add Custom View Variables

This example demonstrates adding custom variables for use in templates.

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use Freshworkx\BmImageGallery\Event\BeforeRenderingEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
    identifier: 'my-ext/add-custom-variables',
    event: BeforeRenderingEvent::class
)]
final readonly class AddCustomVariablesListener
{
    public function __invoke(BeforeRenderingEvent $event): void
    {
        // Add custom variables
        $event->setViewVariable('analyticsId', 'UA-12345-6');
        $event->setViewVariable('customData', ['foo' => 'bar']);
    }
}

Modify Existing Variables

This example shows how to modify existing view variables before rendering.

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use Freshworkx\BmImageGallery\Event\BeforeRenderingEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
    identifier: 'my-ext/modify-variables',
    event: BeforeRenderingEvent::class
)]
final readonly class ModifyVariablesListener
{
    public function __invoke(BeforeRenderingEvent $event): void
    {
        $vars = $event->getViewVariables();

        // Modify collection title
        if (isset($vars['fileCollection']['title'])) {
            $vars['fileCollection']['title'] = 'Modified: ' . $vars['fileCollection']['title'];
        }

        $event->setViewVariables($vars);
    }
}

Action-Specific Logic

This example demonstrates action-specific modifications.

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use Freshworkx\BmImageGallery\Event\BeforeRenderingEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(
    identifier: 'my-ext/action-specific',
    event: BeforeRenderingEvent::class
)]
final readonly class ActionSpecificListener
{
    public function __invoke(BeforeRenderingEvent $event): void
    {
        // Different logic based on action
        if ($event->getAction() === 'detail') {
            $event->setViewVariable('showBreadcrumb', true);
            $event->setViewVariable('showBackButton', true);
        }

        if ($event->getAction() === 'list') {
            $event->setViewVariable('showFilters', true);
        }

        if ($event->getAction() === 'gallery') {
            $event->setViewVariable('showLightbox', true);
        }
    }
}

Changelog

This chapter provides an overview of changes. Take a deeper look on a version listed below to see which bugs have been fixed, which new features have been introduced and what you should not use anymore.

List of versions

Version 8.0.0 - 2026/04/10

This release is a major release. It introduces compatibility with TYPO3 v14 and drops compatibility with older TYPO3 versions.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Compatibility with TYPO3 v14

Removed

Compatibility with TYPO3 v13 LTS

All Changes

This is a list of all changes in this release:

2026-04-10 feat(v14): update composer dependencies (Commit 2e18632 by Jens Neumann)
2026-04-10 feat(v14): add var folder to .gitignore and .gitattributes (Commit e7ccaf1 by Jens Neumann)
2026-04-10 feat(v14): apply rector rules (Commit db784ef by Jens Neumann)
2026-02-25 feat(v14): fix wrong version of shivammathur/setup-php (Commit f124fd1 by Jens Neumann)
2026-02-25 feat(v14): enhance PHP 8.5 support (Commit 18cca27 by Jens Neumann)
2026-02-25 feat(v14): fix upgrade wizards (Commit f9c339c by Jens Neumann)
2026-02-25 feat(v14): enhance TCA configuration (Commit 4fdea04 by Jens Neumann)
2026-02-25 feat(v14): update PHPStan and Rector configs (Commit 6a2afcd by Jens Neumann)
2026-02-25 feat(v14): prepare v14 compatibility (Commit 4df05fb by Jens Neumann

Version 7.2.0 - 2025/12/07

This release is a feature release. It supports site sets and introduces PSR-14 events for extensibility. In addition more unit and functional tests have been provided.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Site Set Support
PSR-14 Events

Changed

More unit and functional tests added

All Changes

This is a list of all changes in this release:

2025-12-07 [DOC] fix branch in link to documentation (Commit 5d404d1 by Jens)
2025-12-06 [TASK] add documentation for administrators on how to handle site set (Commit a9cd0e6 by Jens)
2025-12-06 [TASK] add typoscript constants to site set for backwards compatibility (Commit e90f616 by Jens)
2025-12-06 [TASK] add site set with settings and TypoScript (Commit e1f1769 by Jens)
2025-11-25 [BUGFIX] fix content links in developer documentation (Commit 367f116 by Jens)
2025-11-25 [BUGFIX] fix typo for extension key in documentation (Commit 70d0425 by Jens)
2025-11-25 [TASK] add documentation for developers on how to handle PSR-14 events (Commit 4245277 by Jens)
2025-11-25 [TASK] introduce PSR-14 events in GalleryController (Commit f8e07ac by Jens)
2025-11-18 [TASK] extend galleryController tests for different settings (Commit 21abd8b by Jens)
2025-11-18 [TASK] extend fileCollectionRepository tests for folder based collections (Commit f0b89ae by Jens)
2025-11-18 [TASK] update scripts in composer.json (Commit d598bda by Jens)
2025-11-18 [TASK] update config files for testing (Commit 1f3dcb1 by Jens)
2025-11-18 [TASK] add functional tests for getCollectionInfo (Commit 913840d by Jens)
2025-11-18 [TASK] add functional tests for fileCollections (Commit b969256 by Jens)
2025-11-18 [TASK] add fixtures for functional tests (Commit 4b25736 by Jens)
2025-11-18 [TASK] add unit tests for pagination (Commit 944c91e by Jens)

Version 7.1.0 - 2025/11/13

This release is a feature release. It introduces the pagination feature for gallery and detail view. This release is fully backward compatible, existing templates will continue to work. If you want to use the new feature, adapt your own custom templates accordingly. For more information take a look into the Configuration section or at the provided templates on how to use the feature.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Advanced pagination functionality with support of different pagination types for gallery and detail view.

All Changes

This is a list of all changes in this release:

2025-11-12 [TASK] update documentation for pagination (Commit 81b1eec by Jens Neumann)
2025-11-12 [TASK] update partials for pagination (Commit 21052d6 by Jens Neumann)
2025-11-12 [TASK] add pagination feature to GalleryController (Commit 0c7eea1 by Jens Neumann)

Version 7.0.2 - 2025/07/29

This release is a bugfix release. It fixes a incorrect action in title link for galley list view.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Changed

Fix wrong action in title link for galley list view

All Changes

This is a list of all changes in this release:

2025-07-29 [TASK] update ddev config.yaml for local test environment (Commit 6acf09f by Jens Neumann)
2025-06-02 [BUGFIX] fix wrong action in title link for galley list view (Commit f79d82c by Jens Neumann)
2025-06-02 [BUGFIX] add missing date in changelog 7.0.1 (Commit 49fa503 by Jens Neumann)

Version 7.0.1 - 2025/05/15

This release is a bugfix release. It prevents the optionally available composer.lock file from being included in TER release. Make sure to execute the provided upgrade wizards to migrate from version 6.2.x to 7.0.x.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Changed

Prevent to include optionally available composer.lock file in TER releases

All Changes

This is a list of all changes in this release:

2025-04-23 [BUGFIX] prevent to include optionally available composer.lock file (Commit f491dd3 by Jens Neumann)

Version 7.0.0 - 2025/04/23

This release is a major release. It introduces compatibility with TYPO3 v13 LTS and drops compatibility with older TYPO3 versions. It contains breaking changes and refactoring to modernize the source code.

Important

Please make sure to execute the upgrade wizards provided by this release. For more information please take a look into the Migration section.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Compatibility with TYPO3 v13 LTS
Upgrade wizards to migrate plugins and flexForm settings
Support for PHP 8.2 to PHP 8.4
Gallery preview image field for file collection

Removed

Compatibility with TYPO3 v12 LTS
Support for PHP 8.1
Translation files for languages ms nl pl ru th uk and zh

Changed

New documentation and updated README.md
Refactor and modernize the source code

All Changes

This is a list of all changes in this release:

2025-04-10 [TASK] revision of the documentation (Commit 4c64b4e by Jens Neumann)
2025-03-25 [DOC] update README.md (Commit 991d799 by Jens Neumann)
2025-03-13 [TASK] rename job for github action in workflow file (Commit 84115d7 by Jens Neumann)
2025-03-13 [TASK] ignore Tests/ folder for release (Commit 15bc8ee by Jens Neumann)
2025-03-12 [FEATURE] introduce new flexForm migration wizard (Commit 6cf6da6 by Jens Neumann)
2025-03-12 [TASK] rename wizard to CTypeMigrationWizard to make it more clear (Commit 184ecc1 by Jens Neumann)
2025-02-28 [TASK] hide false positives for extension scanner (Commit d066feb by Jens Neumann)
2025-02-28 [TASK] shorten the identifier of upgrade wizard (Commit d70e588 by Jens Neumann)
2025-02-28 [!!!][TASK] clarify the handling of list, detail and gallery plugin (Commit d146e68 by Jens Neumann)
2025-02-28 [TASK] streamline behavior of plugin fields (Commit 7c348e0 by Jens Neumann)
2025-02-27 [TASK] update composer.json and ext_emconf.php for correct constraints (Commit 1da8516 by Jens Neumann)
2025-02-27 [!!!][REFACTOR] refactor and modernize code basis (Commit b5a932f by Jens Neumann)
2025-01-03 [TASK] apply phpstan and rector rules to collections (Commit a2f1748 by Jens Neumann)
2025-01-03 [TASK] remove properties no longer used from composer.json (Commit ac2d5ec by Jens Neumann)
2025-01-03 [!!!][TASK] update translation files (Commit b2a1228 by Jens Neumann)
2025-01-03 [TASK] add xliff linter to code-quality script in composer.json (Commit 5354ffd by Jens Neumann)
2025-01-03 [TASK] suppress warnings for phpcs script in composer.json (Commit 574af36 by Jens Neumann)
2025-01-03 [BUGFIX] remove class-alias-maps from composer.json (Commit 673a86e by Jens Neumann)
2025-01-02 [REFACTOR] extend (XClass) the core file collections with gallery fields (Commit d42bda1 by Jens Neumann)
2025-01-02 [FEATURE] introduce new gallery preview image field for file collection (Commit 63b1107 by Jens Neumann)
2024-12-27 [TASK] delete deprecated code (Commit 705d35f by Jens Neumann)
2024-12-20 [BUGFIX] fix phpstan argument.type error (Commit cecd27d by Jens Neumann)
2024-12-20 [TASK] update composer.json (Commit 820b589 by Jens Neumann)
2024-12-20 [BUGFIX] fix branch for push events in ci.yaml workflow (Commit f840bf8 by Jens Neumann)
2024-11-20 [TASK] provide new plugin listType to cType wizard (Commit aab414c by Jens Neumann)
2024-11-20 [TASK] delete old plugin update wizard (Commit 5cc234f by Jens Neumann)
2024-11-20 [TASK] move plugin registration from list_type to CType (Commit 2dd37a6 by Jens Neumann)
2024-11-20 [TASK] extend version constraints for TYPO3 13 (Commit 0e7c610 by Jens Neumann)
2024-11-20 [TASK] remove deprecations from flexforms (Commit d4b2888 by Jens Neumann)
2024-11-20 [TASK] move deprecated AbstractFile to FileType class (Commit 4d3ffb2 by Jens Neumann)
2024-11-20 [TASK] apply rector rules (Commit f6064c7 by Jens Neumann)
2024-11-20 [TASK] prepare rector config for PHP 8.2 and TYPO3 13 (Commit 4a17136 by Jens Neumann)
2024-11-20 [TASK] update github workflow in ci.yaml (Commit 0be76b0 by Jens Neumann)
2024-11-20 [TASK] update ddev config.yaml to php 8.2 (Commit 60966fa by Jens Neumann)
2024-09-18 [DOC] Fix license badge in README.md (Commit c10e605 by Jens Neumann)

Version 6.2.2 - 2024/09/18

This release is a bugfix release.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Changed

Fix notices

All Changes

This is a list of all changes in this release:

2024-09-03 [BUGFIX] Fix notices (Commit 707c4e5 by Georg Ringer)
2024-06-19 [DOC] fix github links in guides.xml (Commit ab14f37 by Jens Neumann)
2024-06-19 [DOC] replace placeholder with extension key (Commit 07e7480 by Jens Neumann)

Version 6.2.1 - 2024/06/18

This release is a maintenance release. The documentation where converted to PHP-based rendering.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Changed

Documentation converted to PHP-based rendering

All Changes

This is a list of all changes in this release:

2024-06-18 [TASK] convert documentation to php rendering (Commit 43ada0a by Jens Neumann)
2024-06-07 [BUGFIX] fix warnings rendering documentation (Commit e657f1a by Jens Neumann)

Version 6.2.0 - 2024/06/07

This release is a bugfix and maintenance release. It contains a bug fix where the detail view is on a different page. In addition, the code has been cleaned up and the quality improved.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Provide documentation folder for ZIP archives of TER
Provide namespaces for TYPO3-Core viewHelper in templates and partials
Extend workflow for coding standards
Add a separate action for the detail plugin if the detail view is on a different page

Changed

Update PHP-Version matrix in workflow
Deprecate migrations for next major release
fix detail view on different page

Removed

Functional-Test for Filefactory-Class that tests nothing
The newly introduced TER-Upload workflow

All Changes

This is a list of all changes in this release:

2024-06-07 [BUGFIX] fix phpstan error (Commit 7ab0fe3 by Jens Neumann)
2024-06-07 [BUGFIX] fix detail view on different page (Commit 8389031 by Jens Neumann)
2024-05-29 [TASK] set phpstan-ignore-line for bugfix (Commit 4205e0f by Jens Neumann)
2024-05-29 [BUGFIX] fix description field of sys_file_collection can be null (Commit 1d3ee32 by Jens Neumann)
2024-04-27 [TASK] update ddev config.yaml (Commit 9b2fb87 by Jens Neumann)
2024-04-27 [CLEANUP] remove obsolete key/values in ext_emconf.php (Commit e16c4cc by Jens Neumann)
2024-04-27 [TASK] refactor code according to basic phpstan rules (Commit de243df by Jens Neumann)
2024-04-27 [TASK] remove parameter treatPhpDocTypesAsCertain from phpstan.neon (Commit c81e592 by Jens Neumann)
2024-04-27 [TASK] update workflow in ci.yaml to use composer scripts (Commit bc61a3c by Jens Neumann)
2024-03-26 [TASK] refactor code according to basic rector rules (Commit b035e5b by Jens Neumann)
2024-03-26 [TASK] update .gitattributes for local environment folders (Commit ec127e4 by Jens Neumann)
2024-03-26 [TASK] reformat code according to PSR-12 checked by phpcs (Commit 44690ea by Jens Neumann)
2024-03-26 [BUGFIX] remove non-existent exclude path in Services.yaml (Commit c7daece by Jens Neumann)
2024-03-26 [TASK] update composer.json to run code quality tools locally (Commit 6400b58 by Jens Neumann)
2024-03-26 [TASK] add ddev config.yaml for local php environment (Commit 591c083 by Jens Neumann)
2024-03-26 [TASK] normalize composer.json (Commit 3cc52aa by Jens Neumann)
2024-03-26 [TASK] cleanup .gitignore file (Commit 2e0e9a9 by Jens Neumann)
2024-03-26 [TASK] delete .editorconfig file (Commit 69deb5a by Jens Neumann)
2024-03-26 [TASK] update coding standards in workflow ci.yaml (Commit 7247ad3 by Jens Neumann)
2024-03-17 [TASK] provide namespace for TYPO3 core viewHelper (Commit eeb58d4 by Jens Neumann)
2024-03-17 [TASK] add .editorconfig file (Commit 3323a69 by Jens Neumann)
2024-03-15 [TASK] deprecate migration classes (Commit c0c01c0 by Jens Neumann)
2024-03-15 [CLEANUP] move php-cs-fixer configuration into Build folder (Commit 3f9b3ed by Jens Neumann)
2024-03-15 [BUGFIX] delete the remaining script section in composer.json (Commit 254fa7e by Jens Neumann)
2024-03-15 [TASK] rename workflow and add licence badge in Readme.md (Commit 6073e88 by Jens Neumann)
2024-03-15 [TASK] rename workflow in ci.yaml (Commit e2e04f5 by Jens Neumann)
2024-03-15 Update ci.yaml (Commit b2132ff by Jens Neumann)
2024-03-15 [TASK] update workflow in ci.yaml (Commit 0c67eb3 by Jens Neumann)
2024-03-15 [TASK] update config file for php-cs-fixer (Commit ff006fc by Jens Neumann)
2024-03-14 [TASK] remove ter-upload workflow (Commit 342e3ed by Jens Neumann)
2024-03-14 [TASK] provide documentation for ZIP archives (Commit 97f7e9f by Jens Neumann)
2024-03-14 [CLEANUP] remove codecov.yml file (Commit df21461 by Jens Neumann)
2024-03-14 [CLEANUP] remove empty functional test (Commit 5a9997f by Jens Neumann)

Version 6.1.0 - 2024/03/15

This release is a maintenance release. With this version a new maintainer is introduced and the repository was moved from Leuchtfeuer to freshworkx.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Changed

The git repository was moved from Leuchtfeuer to freshworkx
The vendor name has been changed from leuchtfeuer to freshworkx
The composer package name was renamed from leuchtfeuer/bm-image-gallery to freshworkx/bm-image-gallery.

All Changes

This is a list of all changes in this release:

2024-03-13 [TASK] update badges for README.md (Commit 2322ca0 by Jens Neumann)
2024-03-13 [TASK] add TYPO3 TER upload workflow (Commit 93723ec by Jens Neumann)
2024-03-13 [TASK] set ci workflow to manually trigger (Commit 4b61468 by Jens Neumann)
2024-03-12 [DOC] Add documentation for version 6.1.0 (Commit c2f48c0 by Jens Neumann)
2024-03-12 [TASK] update author and company information (Commit 5f346ab by Jens Neumann)
2024-03-11 [TASK] remove funding file (Commit d38cc6f by Jens Neumann)
2024-03-11 [!!!][TASK] rename composer package (Commit fff3801 by Jens Neumann)
2024-03-11 [TASK] adapt links to git repository (Commit b59d538 by Jens Neumann)
2024-03-11 [!!!][TASK] rename vendor (Commit fa8f984 by Jens Neumann)

Version 6.0.0 - 2024/03/01

This release is a major release. It introduces compatibility with TYPO3 v12 LTS and drops compatibility with older TYPO3 versions.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Compatibility with TYPO3 v12 LTS

Removed

Compatibility with TYPO3 v11 LTS
Compatibility with TYPO3 v10 LTS

All Changes

This is a list of all changes in this release:

2024-03-01 [TASK] Add missing plugin name to action link viewhelper when switching plugin (Commit 6732100 by Niklas Grieger)
2024-02-23 [TASK] Run code style fixer [TER-177] [TER-179] (Commit 0c80522 by Niklas Grieger)
2024-02-23 [TASK] Ensure compatibility with TYPO3 v12 [TER-177] [TER-179] (Commit 7a1f91c by Niklas Grieger)
2023-04-18 minimal typo3 12 LTS support (Commit 3ad14a6 by swisschocolate)

Version 5.2.0 - 2024/03/01

This release is a feature release. It introduces support for TYPO3 v11 LTS.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Support for TYPO3 v11 LTS

All Changes

This is a list of all changes in this release:

2024-03-01 [TASK] Add missing plugin name to action link viewhelper when switching plugin (Commit 6732100 by Niklas Grieger)
2021-08-30 [TASK] Update TER release script (Commit 7a80451 by Max Rösch)
2021-08-30 [TASK] Add release script for TER releases (Commit 5f674d5 by Max Rösch)

Version 5.1.1 - 2021/08/27

This release is a maintenance release. It contains mostly bug fixes.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Null coalescing operators where added to prevent data from being 'null'.
Add closing comma to TCA overrides in sys_file_collection.php

All Changes

This is a list of all changes in this release:

2021-04-09 [BUGFIX] Use proper link to documentation (Commit 0a8b57d by Florian Wessels)
2021-05-05 [BUGFIX] Add closing comma to TCA overrides (Commit 1814cd2 by Sebastian Afeldt)
2021-05-05 [TASK] Raise version to 5.1.1-dev (Commit 81aaf19 by Florian Wessels)
2021-05-05 [TASK] Support TYPO3 v11.2 (Commit b9d0f23 by Florian Wessels)
2021-07-18 [BUGFIX] Add coalescing operators (Commit 1aaf029 by Florian Wessels)

Version 5.1.0 - 2021/04/07

This release is a feature release. File collections can now contain information about the location and the datetime. Besides of that, this release introduces basic compatibility for TYPO3 v11.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Functional tests
A file collection can now contain information about the location and the datetime
Beta support for TYPO3 v11

All Changes

This is a list of all changes in this release:

2021-04-07 [TASK] Update .gitignore file (Commit c377379 by Florian Wessels)
2021-04-07 [TASK] Refactor file factory (Commit 3d33320 by Florian Wessels)
2021-03-24 [TASK] Raise dependencies (Commit 1f61fc5 by Florian Wessels)
2021-03-24 [TASK] Raise version to 5.1.0-dev (Commit b95793d by Florian Wessels)
2021-03-24 [FEATURE] Extend gallery data by datetime and location (Commit 7fdf40c by Florian Wessels)
2021-03-24 [BUGFIX] Do not instantiate file collection description with empty string (Commit 6ec0729 by Florian Wessels)
2021-01-03 [TASK] Apply CS (Commit 6f948c8 by Florian Wessels)
2021-01-03 [TASK] Kickstart functional tests (Commit 9f9dad8 by Florian Wessels)
2021-01-03 [TASK] Prepare composer.json for functional tests (Commit e137832 by Florian Wessels)
2021-01-03 [TASK] Add support for TYPO3 v11.0 (Commit 13ac9b1 by Florian Wessels)
2021-01-03 [TASK] Add keywords to composer file (Commit 637e19e by Florian Wessels)
2021-01-03 [TASK] Add codecov file (Commit 4d53d5d by Florian Wessels)
2021-01-03 [TASK] Move retrieving of files into dedicated method (Commit bbd4dc0 by Florian Wessels)
2021-01-03 [TASK] Set version to 5.0.1-dev (Commit cfe0e54 by Florian Wessels)
2021-01-03 [TASK] Inject logger via constructor (Commit b3692a2 by Florian Wessels)
2020-09-18 [TASK] Use unique class names within svg files (Commit 5537e0f by Florian Wessels)

Version 5.0.0 - 2020/08/10

This release is a major release. It contains several breaking changes and some refactoring of outdated source code.

Important

Please make sure to execute the upgrade wizard provided by this release.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Accessibility of HTML templates has been improved

Changed

The vendor name has been changed from bitmotion to leuchtfeuer
The plugin structure has been changed as formerly used SwitchableControllerActions are marked as deprecated
Content structure of the documentation

Removed

TYPO3 v9 support
TypoScript settings and HTML markup for lightboxes

All Changes

This is a list of all changes in this release:

2020-08-10 [DOC][BUGFIX] Use proper count (Commit 9e1a067 by Florian Wessels)
2020-08-10 [DOC][BUGFIX] Do not break line (Commit f1395dd by Florian Wessels)
2020-08-10 [DOC] Move changelog files (Commit 81eb2cc by Florian Wessels)
2020-08-10 [DOC] Update readme file (Commit d07ce56 by Florian Wessels)
2020-08-10 [DOC] Update images (Commit 24dd320 by Florian Wessels)
2020-08-10 [DOC] Add sitemap file (Commit d5dc3f3 by Florian Wessels)
2020-08-10 [DOC] Improve installation documentation (Commit 5c1bb3c by Florian Wessels)
2020-08-10 [BUGFIX] Do not use red as default color (Commit 01c7c0d by Florian Wessels)
2020-08-10 [DOC] Add documentation for lightboxes (Commit 39d41d8 by Florian Wessels)
2020-08-10 [DOC] Restructure documentation (Commit 40af1bc by Florian Wessels)
2020-08-10 [TASK] Raise dependencies (Commit 5c42a44 by Florian Wessels)
2020-08-10 [TASK] Add further examples to route enhancer config (Commit 06284e8 by Florian Wessels)
2020-08-10 [TASK] Apply CS (Commit f9555f4 by Florian Wessels)
2020-08-10 [BUGFIX] Do not break when collections are empty (Commit e03ea61 by Florian Wessels)
2020-08-10 [TASK] Improve accessibility of templates (Commit ad78163 by Florian Wessels)
2020-08-10 [BREAKING] Split plugins (Commit 7631b98 by Florian Wessels)
2020-06-17 [TASK] Add default values (Commit 062cc91 by Florian Wessels)
2020-06-17 [TASK] Use constants (Commit 14afa9e by Florian Wessels)
2020-06-17 [TASK] Add return types (Commit 396f1a5 by Florian Wessels)
2020-06-17 [TASK] Introduce constants for sorting order (Commit c91732b by Florian Wessels)
2020-06-17 [TASK] Mainstream php CS (Commit 55de94b by Florian Wessels)
2020-06-17 [TASK] Add ClassAliasMap (Commit cd99d14 by Florian Wessels)
2020-06-17 [BREAKING] Rename vendor (Commit a625449 by Florian Wessels)
2020-06-17 [TASK] Set version to 5.0.0-dev (Commit df1a99c by Florian Wessels)
2020-06-17 [BREAKING] Drop TYPO3 v9 support (Commit cef372d by Florian Wessels)
2020-06-17 [TASK] Add void return types (Commit 3f8507c by Florian Wessels)
2020-06-17 [TASK] Drop obsolete condition (Commit c44d89e by Florian Wessels)
2020-06-17 [TASK] Use LoggerAwareTrait (Commit b58b58a by Florian Wessels)
2020-06-17 [TASK] Update funding file (Commit 241d97c by Florian Wessels)
2020-06-17 [TASK] Set version to 4.3.0-dev (Commit 5f97d8f by Florian Wessels)

Version 4.2.1 - 2020/06/02

This release is regular maintenance release.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Changed

The composer package name was renamed from bitmotion/bm-image-gallery to leuchtfeuer/bm-image-gallery.

All Changes

This is a list of all changes in this release:

2020-06-02 [TASK] Rename composer package (Commit 80df9de by Florian Wessels)
2020-06-02 [TASK] Update dependencies (Commit afa1752 by Florian Wessels)
2020-06-02 [TASK] Update plugin registration (Commit 6b324ef by Florian Wessels)
2020-06-02 [TASK] Set version to 4.2.1-dev (Commit ab0f04e by Florian Wessels)

Version 4.2.0 - 2020/04/22

This release is a feature release. It introduces support for the new TYPO3 v10 LTS. However, it drops official support for TYPO3 v8, too.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Support for TYPO3 v10 LTS

Changed

The git repository was moved from bitmotion to Leuchtfeuer

Removed

TYPO3 v8 compatibility

All Changes

This is a list of all changes in this release:

2020-04-22 [TASK] Update repository URL (Commit aef3551 by Florian Wessels)
2020-04-22 [TASK] Add .github files (Commit c4c6361 by Florian Wessels)
2020-04-21 [TASK] Move TSconfig file for new CE wizard (Commit cd3ff92 by Florian Wessels)
2020-04-21 [TASK] Add change log for new version (Commit d397d94 by Florian Wessels)
2020-04-21 [TASK] Use extension key as variable (Commit 1a1fcb5 by Florian Wessels)
2020-04-21 [TASK] Adapt links to git repository (Commit 3beed46 by Florian Wessels)
2020-04-21 [TASK] Drop TYPO3 v8 compatibility (Commit 6d6f7e2 by Florian Wessels)
2020-04-21 [TASK] Raise version to 4.2.0-dev (Commit c64750c by Florian Wessels)

Version 4.1.2 - 2020/03/12

This release is a maintenance release. It contains mostly bug fixes.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Support for TYPO3 v10.3
Fourth argument for getFileCollectionById() method for sorting direction of files.

Changed

Author and company information

All Changes

This is a list of all changes in this release:

2020-03-12 [TASK] Add changelog for version 4.1.2 (Commit 2d7b9b5 by Florian Wessels)
2020-03-12 [BUGFIX] Respect sorting order (Commit 0b1db1e by Florian Wessels)
2020-03-12 [TASK] Support TYPO3 v10.3 (Commit 9797ecf by Florian Wessels)
2020-03-12 [DOC] Modify changelog (Commit 2da1965 by Florian Wessels)
2020-03-12 [TASK] Retrieve rich text information only once (Commit bc3ad24 by Florian Wessels)
2020-03-12 [DOC] Add phpdocs and type hints (Commit 80d5b1e by Florian Wessels)
2020-03-12 [TASK] Use global exception (Commit d625567 by Florian Wessels)
2020-03-12 [TASK] Fix spelling (Commit 4e3dd40 by Florian Wessels)
2020-03-12 [TASK] Update author and company information (Commit 5b9fb36 by Florian Wessels)
2020-03-12 [TASK] Set version to 4.1.2-dev (Commit 2a96d52 by Florian Wessels)
2020-02-11 [DOC] Update Changelog (Commit 1f2fd8d by Florian Wessels)
2020-02-11 [DOC] Add documentation for version 4.1.1 (Commit 5ec4408 by Florian Wessels)

Version 4.1.1 - 2020/02/11

This release is a maintenance release. It contains mostly bug fixes.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Dedicated License file
Gitattributes file
Second argument for getFileCollectionsToDisplay() method for retrieving file collections as objects.

Changed

Composer Dependencies
Extension Icon

All Changes

This is a list of all changes in this release:

2020-02-11 [RELEASE] Release of version 4.1.1 (Commit 7fae73c by Florian Wessels)
2020-02-05 [TASK] Use sprintf() (Commit 8b2c689 by Florian Wessels)
2020-02-05 [TASK] Add license file (Commit 38fe3c4 by Florian Wessels)
2020-02-05 [TASK] Add missing dependencies to composer file (Commit 2568175 by Florian Wessels)
2020-02-05 [TASK] Try to localize given file collection (Commit 01b8a8a by Florian Wessels)
2020-02-05 [TASK] Update php CS file and apply CS (Commit 5c02dc8 by Florian Wessels)
2020-02-05 [TASK] Add .gitattributes file (Commit 3e7f357 by Florian Wessels)
2019-12-14 [TASK] Exchange EXT:icon (Commit 8dad66b by Florian Wessels)
2019-12-14 [TASK] Do not get publicUrl directly (Commit d7891c3 by Florian Wessels)
2019-12-09 [TASK] Set version to 4.1.1-dev (Commit 2889470 by Florian Wessels)

Version 4.1.0 - 2019/12/09

This release is a feature release. It contains bug fixes and introduces documentation for docs.typo3.org. Also it introduces support for TYPO3 v10.2. It will be the last regular feature release, that supports TYPO3 8 LTS.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Documentation
Support for TYPO3 v10.2
Repository for retrieving file collections details
CollectionInfo transfer object.

Changed

Extension icon

Deprecations

Domain model CollectionInfo. You should use the eponymous transfer object istead.
Following methods of ListController were moved into a dedicated repository:
- getCollectionsToDisplay()
- getFileCollectionById()

All Changes

This is a list of all changes in this release:

2019-12-09 [DOC] Update change log (Commit 1aed013 by Florian Wessels)
2019-12-09 [TASK] Apply CS (Commit 0caaf14 by Florian Wessels)
2019-12-09 [DOC] Added change log (Commit ef83530 by Florian Wessels)
2019-12-09 [TASK] Update path to images (Commit 7a00e6f by Florian Wessels)
2019-12-09 [DOC] Add images (Commit 607cbf1 by Florian Wessels)
2019-12-08 [TASK] Add information about extension key (Commit 70b5e9d by Florian Wessels)
2019-12-08 [TASK] Use new extension icon as CE icon (Commit 6fe79c6 by Florian Wessels)
2019-12-08 [TASK] Call user functions in configuration files (Commit 9502d06 by Florian Wessels)
2019-12-08 [TASK] Bump version to 4.1.0-dev (Commit 971bfc6 by Florian Wessels)
2019-12-08 [TASK] Use constants in conditions (Commit 0a0d103 by Florian Wessels)
2019-12-08 [FEATURE] Introduce TYPO3 v10.2 compatibility (Commit a635ce2 by Florian Wessels)
2019-12-08 [TASK] Add typo3/cms-extbase as dependency (Commit 80df8f9 by Florian Wessels)
2019-12-06 [TASK] Move repository related methods into dedicated repository (Commit 970d57d by Florian Wessels)
2019-12-06 [CLEAN-UP] Remove obsolete use statements (Commit d1d3012 by Florian Wessels)
2019-12-06 [TASK] Move CollectionInfo to transfer namespace (Commit 43795f2 by Florian Wessels)
2019-12-06 [TASK] Add phpdoc headers (Commit 252d59b by Florian Wessels)
2019-12-06 [TASK] Exchange extension icon (Commit 8da2883 by Florian Wessels)
2019-12-06 [WIP] Add documentation (Commit 3697f83 by Florian Wessels)
2019-04-03 [TASK] Set version to 4.0.1-dev (Commit 6dea76d by Florian Wessels)
2019-04-03 [BUGFIX] Do not handle empty file collections (Commit 5dcc59e by Florian Wessels)

Version 4.0.0 - 2019/03/06

This release is a major release. It contains several breaking changes and some refactoring of outdated source code. Beside of that, there are several new features introduced with this release.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Images can now use a sitewide configured lightbox or a custom one
README file

Changed

The HTML tags now containing bootstrap CSS classes
Structure of plugin configuration.

Removed

TYPO3 7 LTS support

All Changes

This is a list of all changes in this release:

2019-03-06 [RELEASE] Release of version 4.0.0 (Commit 09b030d by Florian Wessels)
2019-03-06 [TASK] Remove obsolete braces (Commit 036d876 by Florian Wessels)
2019-03-06 [TASK] update documentation for v4.0 (Commit 2f24b93 by Sebastian Afeldt)
2019-03-06 [TASK] Adapt license (Commit bd52063 by Florian Wessels)
2019-03-04 [TASK] Split code (Commit 6638f27 by Florian Wessels)
2019-03-04 [TASK] Rename TypoScript settings and remove obsolete language labels (Commit 5748902 by Florian Wessels)
2019-03-04 [TASK] Change author (Commit c03a994 by Florian Wessels)
2019-03-04 [BUGFIX] Typo (Commit 1ed9a1a by Florian Wessels)
2019-03-04 [TASK] Add badges (Commit 7159f42 by Florian Wessels)
2019-03-04 [TASK] Clean up controller (Commit 7e8da6b by Florian Wessels)
2019-03-04 [BREAKING] Resturcture plugins (Commit 9db6ecb by Florian Wessels)
2019-03-04 [CLEAN-UP] Remove non used TypoScript setting (Commit 804dc54 by Florian Wessels)
2019-03-04 [FEATURE] Introduce slug and rte description (Commit 4d70f6a by Florian Wessels)
2019-02-27 [TASK] update documentation for v4.0 (Commit 036246c by Sebastian Afeldt)
2019-02-27 [TASK] Remove obsolete display condition (Commit 76b352f by Florian Wessels)
2019-02-26 [TASK] Use constants (Commit 1014afc by Florian Wessels)
2019-02-26 [TASK] Restructure list action and introduce file factory (Commit a092ef5 by Florian Wessels)
2019-02-26 [TASK] Add german translation for backend labels (Commit dcef238 by Florian Wessels)
2019-02-26 [BREAKING] Change structure of flexform (Commit ad7618f by Florian Wessels)
2019-02-26 [TASK] Introduces bootstrap classes for overview view (Commit 35d6de9 by Florian Wessels)
2019-02-26 [TASK] Force string (Commit db80d54 by Florian Wessels)
2019-02-26 [TASK] Remove php docs (Commit a60e55c by Florian Wessels)
2019-02-26 [TASK] Introduces bootstrap classes for list view (Commit 6810b0b by Florian Wessels)
2019-02-26 [BREAKING] Adapt settings and introduce new configurations (Commit 30651a9 by Florian Wessels)
2019-02-26 [TASK] Move label to xlf files (Commit 0f19c75 by Florian Wessels)
2019-02-26 [TASK] Remove sources from xlf file (Commit 1b10f18 by Florian Wessels)
2019-02-26 [TASK] Remove targets from xlf file (Commit 8794781 by Florian Wessels)
2019-02-26 [TASK] Add return types (Commit c87ea7a by Florian Wessels)
2019-02-26 [TASK] Use constructor injection (Commit 6ba730c by Florian Wessels)
2019-02-26 [TASK] Adapt PHP docs (Commit 59de3e8 by Florian Wessels)
2019-02-26 [TASK] Suggest EXT:fluid_styled_content (Commit 3a6909f by Florian Wessels)
2019-02-26 [TASK] Move code from ext_tables to override files (Commit 86cced8 by Florian Wessels)
2019-02-26 [TASK] Adapt composer.json file (Commit f4a07db by Florian Wessels)
2019-02-26 [BUGFIX] Remove strict type definition (Commit 8e07260 by Florian Wessels)
2019-02-26 [TASK] Adapt CS (Commit 9a9df1e by Florian Wessels)
2019-02-26 [TASK] Add CS file (Commit cb1f494 by Florian Wessels)
2019-02-26 [TASK] Set version to 4.0.0-dev and drop TYPO3 7 support (Commit 8b068cb by Florian Wessels)
2019-02-26 [TASK] Move extension icon (Commit 685f74f by Florian Wessels)
2019-01-28 [BUGFIX] Added missing dollar sign in TS constant reference (Commit 70a78b5 by mabolek)
2019-01-21 [FEATURE] Images can use sitewide or custom lightbox (Commit 20c3c83 by mabolek)
2019-01-21 [CLEANUP] Removed line (Commit 2c7901a by mabolek)
2019-01-21 [TASK] Removed unnecessary if clause (Commit fe2e5d1 by mabolek)

Contributors

Following people have contributed to this release:

Sebastian Afeldt
Mathias Bolt Lesniak
Florian Wessels

Thank you very much for your support. The next beer is on us! 🍻

Version 3.1.0 - 2018/11/22

This release is a feature release. It introduces support for TYPO3 9 LTS.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Support for TYPO3 9 LTS

All Changes

This is a list of all changes in this release:

2018-11-22 [RELEASE] Release of version 3.1.0 (Commit afe7e62 by Florian Wessels)
2018-11-22 [TASK] Adapt dependencies (Commit 262b662 by Florian Wessels)

Version 3.0.0 - 2018/08/20

This release is a major release. It contains breaking changes and improves the quality of the source code. Also it introduces support for upcoming TYPO3 9 LTS and adds its own content element wizard.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Support for TYPO3 v9.3
Dedicated content element wizard

Changed

Use <f:image /> view helper instead of <bm:image />

Removed

Class FreshworkxBmImageGalleryViewHelpersImageViewHelper
Class FreshworkxBmImageGalleryViewHelpersPropertyViewHelper

All Changes

This is a list of all changes in this release:

2018-08-20 [RELEASE] Release of version 3.0.0 (Commit 3c59658 by Florian Wessels)
2018-08-20 [TASK] Introduce TYPO3 9.3 compatibility (Commit 6f81a85 by Florian Wessels)
2018-08-20 [TASK] Update composer.json file (Commit e63255c by Florian Wessels)
2018-08-20 [TASK] Use core viewhelper for displaying images (Commit 02e7a52 by Florian Wessels)
2018-08-20 [TASK] Make code TYPO3 9 compatible (Commit 3cbea88 by Florian Wessels)
2018-08-20 [TASK] Update author information (Commit 5e5d03f by Florian Wessels)
2018-08-08 [FEATURE] Introduce content wizard (Commit 8b65a17 by Florian Wessels)
2018-08-08 [TASK] Set version to 3.0.0-dev (Commit bdea161 by Florian Wessels)
2018-08-08 [TASK] Add @throws annotiation and remove obsolete code (Commit 8c0c85c by Florian Wessels)
2018-08-08 [TASK] Use inject method instead of annotation (Commit f0b7aa5 by Florian Wessels)
2018-03-15 [TASK] Set version to 2.0.3-dev (Commit c46abeb by Florian Wessels)

Version 2.0.2 - 2018/03/15

This release is a bug fix release. It contains bug fixes and some improvements in code quality.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

Changelog file added.

Changed

Following methods are now protected:
- ListController->getCollectionsToDisplay()
- ListController->addToArray()

Removed

Private method ListController->cleanFiles()

All Changes

This is a list of all changes in this release:

2018-03-15 [RELEASE] Release of version 2.0.2 (Commit cb680fe by Florian Wessels)
2018-03-15 [TASK] Use proper SPDX license identifier (Commit dcb2be8 by Florian Wessels)
2018-03-15 [BUGFIX] Handle metadata overrides of collections containing single files (Commit d80f8fe by Florian Wessels)
2018-03-15 [TASK] Get rid of obsolete method cleanFiles() (Commit ba20e0b by Florian Wessels)
2018-03-15 [TASK] Make private methods protected (Commit 2c960c4 by Florian Wessels)
2018-01-11 [TASK] Set version to 2.0.2-dev (Commit 49291ef by Florian Wessels)
2018-01-11 [TASK] Add information for psr-4 autoload to ext_emconf.php (Commit 60c244e by Florian Wessels)

Version 2.0.1 - 2018/01/11

This release contains improvements in code quality only.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Changed

TCA was moved from ext_tables.php to TCA/Overrides directory.

All Changes

This is a list of all changes in this release:

2018-01-11 [TASK] Clean up and set version to 2.0.1 (Commit 141adcf by Florian Wessels)
2018-01-11 [TASK] Move TCA from ext_tables to TCA/Overrides (Commit e6fcf89 by Florian Wessels)

Version 2.0.0 - 2017/04/06

This release is a major release. Beside of some bug fixes it introduces support for TYPO3 8 LTS.

Download

Download this version from the TYPO3 extension repository or from GitHub.

Added

TYPO3 8 support

Removed

TYPO3 6.2 support

All Changes

This is a list of all changes in this release:

2017-04-06 [RELEASE] Release of version 2.0.0 (Commit a8dccaa by Florian Wessels)
2017-04-06 [BUGFIX] Use proper version of TYPO3 in ext_emconf.php dependencies (Commit 86e02a1 by Florian Wessels)
2017-04-06 [FOLLOW-UP] Remove PHP dependency from ext_emconf.php (Commit ac7c0a9 by Florian Wessels)
2017-04-06 [TASK] Remove PHP dependency from composer.json (Commit 57d9e82 by Florian Wessels)
2017-04-06 [TASK] Simplify code of action-controller and flexform (Commit 0fff2c3 by Florian Wessels)
2017-04-06 [CLEAN-UP] Reformat code in viewhelpers (Commit 809a341 by Florian Wessels)
2017-04-06 [TASK] Use action names in fluid templates (Commit d0150ad by Florian Wessels)
2017-04-06 [TASK] Remove unused namespace from fluid template (Commit ae6d692 by Florian Wessels)
2017-04-06 [TASK] Add LanguageLabel for FileCollection (Commit 273744f by Florian Wessels)
2017-04-06 [TASK] Unify PHP Headers and add further PHPDocs (Commit fb9ca2d by Florian Wessels)
2017-04-06 [TASK] Move CollectionInfo to Domain/Model/Dto and modify namespaces (Commit eed808e by Florian Wessels)
2017-04-06 [TASK] Do not support TYPO3 6.2 but TYPO3 8 LTS (Commit 7109804 by Florian Wessels)
2016-08-22 [TASK] Add TYPO3 6.2 compatibility (Commit 6819ad0 by Florian Wessels)

Version 1.0.0 - 2016/08/22

This is the initial release of this extension.

Download

Download this version from the TYPO3 extension repository or from GitHub.

All Changes

This is a list of all changes in this release:

2016-08-22 [RELEASE] Release 1.0.0 (Commit ba2a7de by Florian Wessels)
2016-08-22 [TYPO] Fix typo in composer.json (Commit 689c713 by Florian Wessels)
2016-08-22 [BUGFIX] Use proper language key for decimal separator (Commit 4a0043a by Florian Wessels)
2016-08-09 Initial commit (Commit 6187074 by Florian Wessels)

Simple Image Gallery

Features

Compatibility

Links

For Administrators

Installation

Via Composer

Via Extension Manager

Via ZIP File

Templates

Configuration

Constants

List

Gallery

Videos

Images

Lightbox

Pagination

Site Set

Installation

Configuration

Option A: Through the Backend

Option B: In Site Configuration YAML

Option C: Override in Site Set

Migration from TypoScript Constants

No Migration Needed!

Optional: Move to Site Settings

TypoScript Access

Fluid Access

PHP Access

Migration

Migration list_type to CType

Migration flexForm settings of plugins

Advanced routing configuration

For Editors

Quick & Easy

Possible Scenarios

For Developers

Events

Event Overview

AfterCollectionInfoResolvedEvent

AfterItemsSortedEvent

BeforeRenderingEvent

Event Registration

Method 1: PHP Attribute (Recommended)

Method 2: Services.yaml

Further Resources

AfterCollectionInfoResolvedEvent

Example Use Cases

Add Custom Metadata

Add Custom Fields

Modify Existing Fields

Add External Data

AfterItemsSortedEvent

Example Use Cases

Filter Items by Extension

Filter Items by Size

Enrich Items

Re-sort Items

BeforeRenderingEvent

Example Use Cases

Add Analytics Tracking

Add Custom View Variables

Modify Existing Variables

Action-Specific Logic

Changelog

List of versions

Version 8.0.0 - 2026/04/10

Download

Added

Removed

All Changes

Version 7.2.0 - 2025/12/07

Download

Added

Changed

All Changes

Version 7.1.0 - 2025/11/13

Download

Added

Migration `list_type` to `CType`

Migration `flexForm` settings of plugins