WPGameList Carousel Extension Guide

Are you the proud owner of the WPGameList Carousel Extension? If so, then great – you’re one step further on the path to mastering the universe! You’ll still need to know how to use it, of course. Luckily, I’ve written this handy guide illustrating the many different ways the WPGameList Carousel Extension can be used on your very own website.

The easiest way to begin using the WPGameList Carousel Extension is to place this shortcode on a page, post, text widget, or wherever else shortcodes work:

[wpgamelist_carousel]

The result should look something like this:

By default, the WPGameList Carousel Extension will pull games from the Default WPGameList Library, display three of them at a time, rotate to the left, take 5 seconds for one rotation to complete, and display games covers at a width of 103 pixels and a height of 170 pixels. Here’s the same shortcode with all of the optional arguments filled in:

[wpgamelist_carousel titlecount="3" transition="rotateleft" speed="5" coverwidth="103" coverheight="170"]

Here’s a little more information on each of the shortcode arguments and their possible values:

  • table – I know, I know, this table argument isn’t included in the shortcode above… by not including this argument at all, WPGameList Carousel will grab games from the Default Library. Keep reading for an example of using games from a custom Library.
  • titlecount – How many titles you want displayed at once. If the available area isn’t wide enough to display the number of titles you’ve specified, you can either try reducing the size of the game covers, or do nothing and let WPGameList Carousel display as many as it can.
  • transition – The direction WPGameList Carousel moves. There are two possible values here – ‘rotateleft’ and ‘rotateright’.
  • speed – The speed with which WPGameList Carousel rotates, in seconds. In the example above, the Carousel will rotate once every 5 seconds.
  • coverwidth – The width of the game cover, in pixels.
  • coverheight – The height of the game cover, in pixels.
  • adjust – If you just can’t get the cover width set to display full game images without seeing any of the upcoming games to the right or left, use this to make adjustments, in pixels. This will accept negative values as well (so for example: adjust=”-3″).

Okay, so let’s get a little crazy and radically change things up. Say I wanted to create a Carousel that pulls from my StoreFront Demo Library, rotates to the right once every 3 seconds, and displays 5 larger game cover images. Here’s the shortcode:

[wpgamelist_carousel table="storefront" titlecount="5" transition="rotateright" speed="3" coverwidth="175" coverheight="280"]

And here’s the outcome:

Now, unless you have a very large computer screen or some such other new-fangled piece of technology all the kids are using these days, you probably aren’t seeing 5 games displayed all at once in the example above – instead, WPGameList Carousel has automatically displayed as many games as the allotted space can support. What if we wanted a ton of smaller games shown on-screen at once?

[wpgamelist_carousel titlecount="15" transition="rotateright" speed="1" coverwidth="50" coverheight="65"]

One last thing…

If you just can’t get your Carousel to display properly on your website, i.e., you see clipped images of previous or upcoming game images, you can use the “Adjust” argument to nudge the width/placement of the images. For example, one of the shortcodes I used above actually has a hidden “adjust” argument (I know, I know, my deceit and treachery knowns no bounds…)

Here’s how it actually displays without the “adjust” argument:

And here’s the shortcode and how it displays with the “adjust” argument set:

[wpgamelist_carousel table="storefront" titlecount="5" transition="rotateright" speed="3" coverwidth="175" coverheight="280" adjust="20"]

And that’s pretty much all there is to using WPGameList Carousel! If you don’t have your very own copy of WPGameList Carousel, be sure to check it out here. I mean really, it’s only $5… it’s either this or that Starbucks Latte… actually, that’s kind of a hard choice…

Share WPGameList Everywhere!