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);
    }
}