Player Gallery Shortcode
Display a gallery of players. The player list's post ID is required unless you're in The Loop.
[player_gallery id="99"]
By default, all players from the player list will be included. Change the number
parameter to choose the number of players to show. A value of -1
will show all.
Unlike in Player Lists, the columns
parameter is a number that defines the number of thumbnails to show per row. Default to 3
, just like image galleries.
The orderby
parameter defines which column to use for the default sorting. By default, the player list's setting will be applied. Use order
to sort the players in ASC
(ascending) or DESC
(descending) order. This will also default to the player list's setting.
You can change the HTML tags used in the gallery output by setting itemtag
, icontag
, and captiontag
. These parameters default to dl
, dt
, and dd
, respectively.
Just like in Player Lists, players in a gallery can also be grouped into smaller lists by position by setting grouping
to position
. The grouptag
parameter changes the tag used in group headings, defaulting to h4
.
Player Galleries uniquely have a size
parameter which can be used to display thumbnails in a different size. By default, the standard WordPress thumbnail
size will apply, and can be changed to any size — even custom ones added by themes or plugins.
Setting link_posts
to 1
links player thumbnails to their pages.
If you would like to show a link to view all players below your player gallery, set show_all_players_link
to 1
.
Args:
array( 'id' => '', 'number' => '-1', 'columns' => '3', 'orderby' => 'default', 'order' => 'ASC', 'itemtag' => 'dl', 'icontag' => 'dt', 'captiontag' => 'dd', 'grouping' => '', 'grouptag' => 'h4', 'size' => 'thumbnail', 'link_posts' => '1', 'show_all_players_link' => '0' )
Example usage:
[player_gallery id="99" number="15" columns="5" grouping="position" grouptag="h3" size="sportspress-fit-icon" show_all_players_link="1"]