For Administrators¶
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 leuchtfeuer/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 Auth0 extension.
Via ZIP File¶
You need to download the Auth0 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¶
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.
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
}
}
}
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 =
}
}
}