The FooGallery shortcode is pretty powerful. There are a few attributes you can add to the shortcode to tweak it slightly from page to page and still use the same gallery.
Limit Thumbnails
You only want to show a maximum number of thumbs. Code example to limit the gallery to only show 3 thumbs:
[[foogallery id="123" limit="3"]]Code language: JSON / JSON with Comments (json)Offset Thumbnails
You only want to start showing thumbs from a particular index. Code example to only show from the 4th thumb onwards:
[[foogallery id="123" offset="3"]]Code language: JSON / JSON with Comments (json)Thumbnail Sort Order
Change the sort order of the gallery using the “sort” attribute. Possible values you can sort by are:
date_desc – order thumbnails by the date they were uploaded to the media library, newest first
date_asc – order thumbnails by the date they were uploaded to the media library, oldest first
rand – random order
title_desc – order thumbnails inverse alphabetically by the media title
title_asc – order thumbnails alphabetically by the media title
modified_asc – order thumbnails by the date they were last modified, most recently modified first
modified_desc – order thumbnails by the date they were last modified, most recently modified last
[[foogallery id="123" sort="data_desc" ]]Code language: JSON / JSON with Comments (json)Override Thumbnails
You can override which attachments are shown in a FooGallery completely by providing an attachment_ids attribute:
[[foogallery id="123" attachment_ids="45,46,49"]]Code language: JSON / JSON with Comments (json)The ids 45,46,49 used above are the attachment id’s.
Override Gallery Template
You can override the gallery template:
[[foogallery id="123" template="masonry"]]Code language: JSON / JSON with Comments (json)A list of gallery templates are:
- default
- image-viewer
- justified
- masonry
- simple_portfolio
- thumbnail
- foogridpro
- polaroid_new
- slider
Dynamic Galleries
If you want, you do not even need to save a gallery to display one. Simply use the shortcode and provide a gallery template and which attachments must be used:
[[foogallery attachment_ids="45,46,49" template="masonry"]]Code language: JSON / JSON with Comments (json)Media Tags
You can make a gallery display images that have a particular tag(s) or category(s) using shortcode attributes. For example, to make the gallery display images containing a media tag called “adventure”, you can add the shortcode attribute “media_tags” to the shortcode:
[[foogallery id="1431" media_tags="adventure"]]Code language: JSON / JSON with Comments (json)If it was a media category of the same name, you’d simply use the shortcode attribute “media_categories” instead:
[[foogallery id="1431" media_categories="adventure"]]Code language: JSON / JSON with Comments (json)If you want to use more than one tag/category, just separate them with a comma:
[[foogallery id="1431" media_categories="adventure,travel,business"]]Code language: JSON / JSON with Comments (json)Note that only 1 taxonomy source can be used at a time when adding them in the shortcode, meaning that you cannot add both “media_categories” and “media_tags” attributes to the shortcode.
Note also that the “media_categories” or “media_tags” shortcode attributes can only be used with an existing gallery, which means you will have to always supply the id=”??” attribute.