Simple Image Gallery (bm_image_gallery)

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

Features

• List, detail and single view for File Collections
• Sorting, Limit of files
• Extends TYPO3 'File Collections' by RTE field 'Gallery Description'
• TYPO3 9: Route Enhancer example for speaking URLs, see
  EXT:bm_image_gallery/Resources/Private/Examples/RouteEnhancer.yml

For editors

The 'Simple Image Gallery' Plugin provides 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):

1. Create one or more file collection records in a folder inside your page tree and include your files. Each file collection represents a gallery.

2. Add a 'Simple Image Gallery' Plugin on the page where you want to show your gallery.

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

4. (Optional) The Plugin Options provide a second tab named 'Gallery'. Here 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.

Possible scenarios

There are the following scenarios to display galleries:

Scenario 1: A list of galleries with gallery view on the same page as the plugin (default).

For that set:

• 'Display Mode' -> 'List'
• 'Detail View' -> 'Same Page'

---

Scenario 2: A list of galleries with gallery view on another page as the plugin.

Recommended for multiple Plugins on the same page.
For that set:

• 'Display Mode' -> 'List'
• 'Detail View' -> 'Selected Page'
• Create a reference to another page (target page).
• Create a 'Simple Image Gallery' Plugin on the target page.
• Inside the plugin on the target page set 'Display Mode' -> 'Gallery View'

---

Scenario 3: A list of galleries without gallery view.

For that set:

• 'Display Mode' -> 'List'
• 'Detail View' -> 'No Detail View'

---

Scenario 4: A gallery view for a single gallery.

For that set:

• 'Display Mode' -> 'Selected Gallery'

For administrators

Installation

If you are in composer mode, use

composer req bitmotion/bm-image-gallery

The extension is available in the TYPO3 Extension Repository (TER) and can also be installed via Extension Manager. Ensure, that the static templates are included.

Configuration

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

Settings

These settings may be overwritten in your TypoScript:

plugin.tx_bmimagegallery.settings {
	# Show the number of file collections. 1 means TRUE, 0 means FALSE.
	list.showCount = 1

	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 {
		# 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 image sizes.
		width = 300c
		maxWidth = 500
		height = 300c
		maxHeight = 500
	}
	
	lightbox {
		# 'cssClass' and 'relAttribute' are not predefined in the constants 
		# by default but in the Fluid Templates.
		cssClass = {$styles.content.textmedia.linkWrap.lightboxEnabled}
		relAttribute = {$styles.content.textmedia.linkWrap.lightboxCssClass}
	}
}

Templating

If you want to change the Fluid templates or use your own, copy the original files with the complete folder structure, e.g. into your site package and set the TypoScript configuration as shown above. If TYPO3 finds a fluid template file under the given alternative path, it will use this, otherwise the original files in the extension.