Most properties can be set in the style sheet or in the custom CSS module for your theme. The following settings are shortcode settings that apply to individual grids. Note that for width and height values you may use any valid unit of height: px, cm, %, etc. Note: Media Image sizes are configured in the wordpress admin panel under Settings/Media. The default thumbnail size is 150px by 150px. The style sheet is configured to handle the default thumbnail size. To properly display your images, you must modify the height and witdth in the thumbanil shortcode or the style sheet.
Many of the parameters available in the WordPress Codex can be used in the shortcode, with a few exceptions.
Default Settings as of version 6.0
‘showcaption’ = true
‘imagesize’ =’thumbnail’
Grid:
The width of the grid. this value defaults to the width of the grid area or to the setting in the style sheet.
maxgridwidth – as of ver. 5.3
Use max width instead of width with align to wrap the grid when the window resizes.
When the gridwidth value is set, set this value to left, right, center or autocenter (as of version 5.3). center may not work in all themes. autocenter uses jQuery to center the grid instead.
thumbnailgrid maxgridwidth=”700px” post_type=”post” aligngrid=”left” posts_per_page = “3” cat=”41″
thumbnailgrid maxgridwidth=”700px” aligngrid=”right” post_type=”post” posts_per_page = “3” cat=”41″
thumbnailgrid maxgridwidth=”700px” aligngrid=”center” post_type=”post” posts_per_page = “3” cat=”41″
thumbnailgrid aligngrid=””autocenter” cat=”41″ post_type=”post”
Captions:
Set showcaption=FALSE to hide the captions showcaption defaults to TRUE
thumbnailgrid showcaption=FALSE posts_per_page = “3” post_type=”post” cat=”41″
This value sets the caption height and hides the overflow (if there is more text than can fit into the caption area, it will not be visible). The display defaults to one line of text or the value in the style sheet.
The caption width. This value defaults to the width variable above or to the setting in the style sheet.
Wrap the text in the caption. Normally the text is limited to one line and overflow is indicated by an elipses. Please note that, to avoid a misaligned grid, you should set a caption height when wrapping text in a grid that has more than one row. wraptext defaults to FALSE
thumbnailgrid wraptext=TRUE captionheight=”50px” posts_per_page = “3” post_type=”post” cat=”41″
Thumbnail:
has_thumbnails (as of version 6.0)
When set to true, only thumbnails with images will be displayed in the grid
The height of thumbnail image. This value defaults to the height of the thumbnail or the setting in the style sheet.
width
The width of the thumbnail image. This value defaults to the width of the thumbnail or the setting in the style sheet. To display an image proportionately, set this value to ‘auto’;
thumbnailgrid width=”25px” height=”25px” posts_per_page=”3″ post_type=”post” cat=”41″
If you have images of different sizes, use a fixed height and set the width to auto to display your thumbnails proportionately.
thumbnailgrid cat=”41″ posts_per_page=”3″ imagesize=”medium” height=”100px” post_type=”post” width=”auto”
imagesize
Media Image sizes are configured in the wordpress admin panel under Settings/Media. You can use any size in the plugin. The default value is ‘thumb’. thumb thumbnail medium large post-thumbnail.
If you wish, you can display the posts at the appropriate size for the image.
thumbnailgrid cat=”41″ posts_per_page=”3″ post_type=”post” imagesize=”medium” height=”200px” width=”200px”
Posts:
Reminder: A page is a type of post. Use post_type to display thumbnails for pages or for custom posts.
thumbnailgrid post_type=”page”
You can use the following parameters to restrict posts. All of these parameters take a comma delimited list of post (or page) id’s except for the tag_slug parameters.
author__in
thumbnailgrid post_type=”post” author__in=”20″
author__not_in (Not currently working)
category__and
thumbnailgrid post_type=”post” category__and=”41, 142″
category__in
thumbnailgrid post_type=”post” category__in=”41, 143″
category__not_in (Available in version 5.4 and up)
thumbnailgrid post_type=”post” has_thumbnails=’TRUE’ category__not_in=”142, 143,144″
tag__and
thumbnailgrid post_type=”post” tag__and=”62, 45
]
tag__in
thumbnailgrid post_type=”post” tag__in=”62, 45, 46″
tag__not_in (Available in version 5.4 & up)
thumbnailgrid post_type=”post” has_thumbnails=’TRUE’ tag__not_in=”62, 45, 46, 145, 147″
tag_slug__and (available in version 5 & up)
thumbnailgrid post_type=”post” tag_slug__and=”hac, gravida”
tag_slug__in (available in version 5 & up)
thumbnailgrid post_type=”post” tag_slug__in=”hac, gravida, semper”
post_parent__in (available in version 5 & up)
thumbnailgrid post_type=”page” post_parent__in=”208″
post_parent__not_in (available in version 5 & up)
thumbnailgrid post_type=”page” cat=”41″ post_parent__not_in=”208″ has_thumbnails=’TRUE’
post__in (available in version 5 & up)
thumbnailgrid post_type=”post” post__in=”169,146″
post__not_in (available in version 5.4 & up)
thumbnailgrid post_type=”post” post__not_in=”144, 169,146,790″ has_thumbnails=’TRUE’
Dates:
day, month, year
thumbnailgrid month=”11″ year=”2014″ day=”30″ has_thumbnails=’TRUE’
before, after, inclusive (available in version 5 & up) -
Set a date range using before & after. Set inclusive = true to include before & after in the query.
thumbnailgrid before=”December 30, 2014″ inclusive=true has_thumbnails=true
thumbnailgrid after=”November 29, 2014″ has_thumbnails=true
thumbnailgrid before=”December 1, 2015″ after=”January 1, 2014″ has_thumbnails=true
You may also use “today” in place of the date. (Version 5.0 & up)
thumbnailgrid before=”today” inclusive=true has_thumbnails=true
Other:
debug_query
Setting debug_query to true can be used by advanced users to diagnose the query generated by this shortcode or for support purposes.
thumbnailgrid debug_query=true has_thumbnails=true