This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
Setting up a random item list¶
1. General Configuration¶
First you select the Plugin Mode “ImageList (Uncached)”. Hence the name and unlike the other YAG modes, this mode is uncached and the HTML is rendered on every reload. This is slower, than using the TYPO3 Cache, but necesarry to pick new random images on every reload.
For another new function described later in the article it is necasarry to define a context. This can be every string you like, in this example i choose yag.
2. Configure The ItemList¶
The Itemlist configuration received some new options in version 2.3. For our purpose, the “Items per Page” option defines how many random images are displayed.
There is also a new “Filter” selction at the bottom. Here i added a filter to pick random images. Check this option.
That is all you have to do. With this configurartion, a set of 4 images is randomly picked from your images and displayed. A click on the image opens a detail view of the image on the same page with the default theme or renders a lightbox with the lightbox theme.
A comon use case is to use a list of random images as a teaser and then jump to the containing album when clicked on an image. To configure this behavior, you can use the new “Image Link” section. The default “Image Link Mode” is to use the configuration from the theme. When you set it to “Detail Page”, the image links to a detail page which can be chosen with the next option.
The option “Plugin Mode on Target Page” defines whcih YAG mode should be triggered on the target page. You have the option to show the gallery or the album containing the image, or just show the detail view of this image on the target page.
Here comes the context identifier into play. To make this work, you have to set the context identifier of the YAG instance on the target page to the same as in the random list.