Configuration

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:

TYPO3\CMS\Core\Pagination\SimplePagination
TYPO3\CMS\Core\Pagination\SlidingWindowPagination

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