GalleryItem

Last updated Mar 6th, 2021 | Page history | Improve this page | Report an issue

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

Budget

$306 per month—let's make that $500!

Learn more

GalleryItem Snippet¶

The GalleryItem snippet displays a single Gallery Item.

Properties¶

Name	Description	Default Value
id	The ID of the item to display
toPlaceholders	If true, will set the properties of the Item to placeholders. If false, will use the tpl property to output a chunk.	1
toPlaceholdersPrefix	Optional. The prefix to add to placeholders set by this snippet. Only works if toPlaceholders is true.	galitem
tpl	Name of a chunk to use when toPlaceholders is set to false.	galItem
albumTpl	Name of a chunk to use for each album that is listed for the Item.	galItemAlbum
albumSeparator	A string separator for each album listed for the Item.	,
albumRequestVar	The REQUEST var to use when linking albums.	galAlbum
tagTpl	Name of a chunk to use for each tag that is listed for the Item.	galItemTag
tagSeparator	A string separator for each tag listed for the Item.	,&nsbp;
tagSortDir	A the direction to sort the tags listed for the Item.	DESC
tagRequestVar	The REQUEST var to use when linking tags.	galTag
thumbWidth	The max width of the generated thumbnail, in pixels.	100
thumbHeight	The max height of the generated thumbnail, in pixels.	100
thumbZoomCrop	Whether or not to use zoom cropping for the thumbnail.	1
thumbQuality	The quality of the thumbnail, from 0-100.	90
thumbFar	The "far" value for phpThumb for the thumbnail, for aspect ratio zooming.	C
thumbProperties	A JSON object of parameters to pass to phpThumb as properties for the thumbnail.
imageWidth	The max width of the generated image.	500
imageHeight	The max height of the generated image.	500
imageZoomCrop	Whether or not to use zoom cropping for the image.	0
imageQuality	The quality of the image, from 0-100.	90
imageFar	The "far" value for phpThumb for the generated image, for aspect ratio zooming.	C
imageProperties	A JSON object of parameters to pass to phpThumb as properties for the generated image.

Default Placeholders¶

When toPlaceholders is set to 1, GalleryItem automatically sets placeholders for the item. They are prefixed by default with 'galitem', but you can change that with the toPlaceholdersPrefix parameter. A list of these placeholders is as follows:

Name	Description
name	The name of the Item.
filename	The filename of the item. This will be relative to the path where the files are stored, which is usually assets/components/gallery/files/.
description	The description of the item.
mediatype	The media type of the Item. Currently this is only 'image'.
createdon	The timestamp that this Item was created on.
createdby	The User ID of the creator of this Item.
active	If this Item is active or not. Can be 1 or 0.
albums	A list of Albums this Item is in.
tags	A list of Tags associated with this Item.
url	If set, a URL for this Item.

GalleryItem Chunks¶

There are 3 chunks that are processed in GalleryItem. Their corresponding GalleryItem parameters are:

tpl - The Chunk to use if toPlaceholders is set to 0.
albumTpl - The Chunk to use for each Album listed with the item.
tagTpl - The Chunk to use for each Tag listed with the item.

Examples¶

Display the Item with ID 12, but only if it exists.

[[!GalleryItem? &id=`12`]]
[[!+galitem.image:notempty=`
    <div class="image">
    <a href="[[+galitem.image]]">
    <img src="[[+galitem.image]]" alt="[[+galitem.name]]" />
    </a>
    <br />Albums: [[+galitem.albums]]
    <br />Tags: [[+galitem.tags]]
    </div>
`]]

Display the Item with ID 23, but use a Chunk called 'Photo' for display.

[[!GalleryItem?
    &id=`23`
    &toPlaceholders=`0`
    &tpl=`Photo`
]]

Display the Item with ID 432 with a Chunk called 'Photo', but separate the Tags associated with it by a pipe ("|"):

[[!GalleryItem?
    &id=`432`
    &toPlaceholders=`0`
    &tpl=`Photo`
    &tagSeparator=` | `
]]