Short Description
Documents the [[gallery]] syntax, and provides a streamlined “light box” user interface
Gallery of images
To insert a series of images into a page content use the [[gallery]] element:
[[gallery size="image-size"]]
or
[[gallery size="image-size"]]
: image-source1 attribute1="value1" attribute2="value2" ...
: image-source2 attribute1="value1" attribute2="value2" ...
...
[[/gallery]]
The allowed attributes within the [[gallery]] tag are:
attribute | allowed values | default | description |
---|---|---|---|
size | "square", "thumbnail", "small", "medium" | "thumbnail" | sets the size of preview image |
order | "name", "nameDesc", "dateAdded", "dateAddedDesc" | "name" | sets order type |
viewer | "false", "no" | "yes" | disables LightBox viewer |
If the [[gallery]] tag is invoked without a list of images it automatically displays rescaled images (thumbnails) of image files attached to the current page (without .pdf and .ps documents as gallery displays only images by default).
If [[gallery]] is invoked with a list of images, only these images are displayed. image-source must not be a URL in this case. Allowed "per-image attributes are:
- link - URL or wiki page name (does not work with Flickr images to be o.k. with Flickr terms)
- alt - alternative text when the image is not available
To make a document open in a new window the same rules as with a single image applies.
The gallery by default is using LightBox to view images. It means that if you click on an image in the gallery, a very nice looking pop-up will show up with a possibility to scroll images forward / backward without reloading page / opening new tab or window. To disable LightBox view use parameter:
[[gallery viewer="no"]] or [[gallery viewer="false"]]
Also see FlickrGallery module if you wish to import images from Flickr.
Put the [[gallery]] tag on its own line or the parser will not recognize it.