From iThemes Codex
Revision as of 21:29, 15 June 2011 by Skylermoore (talk | contribs)
Jump to: navigation, search

Series: DisplayBuddy


Carousel lets you display a rotating set of images anywhere on your site with customizable content and effects. Multiple groups of images may be created for use anywhere on your site. Each group can be fully customized.


Carousel has the ability to save multiple groups that can each have different images and settings. The only information required to create a group is a group name.

Adding Images

In order to add images you will need to select a group then adjust the "Slide Image Dimensions" width and height so that the Carousel plugin will know what dimensions it will need to resize the images to. After saving the desired image dimensions then you can add an image by clicking the "+Add image" button. Carousel uses WordPress's built in media up-loader. This will allow you to either upload new images or select images that you have already added to the media library.



Here is a list of all of the Carousel settings and a description of what each setting controls.

Group Title - This setting will allow you to change the title of the group at any time.

Carousel orientation and direction - This will change which direction the images slide.

Horizontal Alignment - This controls the horizontal alignment of Carousel on a page.

Entity width - This option is used to set the width of the entire Carousel container.

Images to show at once - This sets the amount of images to display at one time. If the entity isn't wide enough to show all of the images then it will hide any images that extend outside that width.

Scroll duration - This determines how long the scroll transition will last in milliseconds.

Pause duration - This is the amount of time that Carousel will pause in between each automatic transition.

Start delay - The amount of time after the page loads before a transition will happen.

Pause on hover - Option to pause transitions if a visitor hovers their mouse over Carousel.

Randomize image order each page load - Option to randomize the order that the images are displayed in each time the page loads.

Circular loop - When the carousel transitions to the end of the images it automatically transitions back to the beginning image.

Inifinite - Set whether carousel infinitely loops through the images continuously transitioning through them.

Display navigation - Option to display buttons that allow visitors to manually control the transitions.

Display pagination - Option to display pagination for each of the transitions below the Carousel.


How can I move the arrows from overlapping the Carousel?

The CSS styling below can be added to your theme's style.css. Adjust the -60 and -70 pixel values as needed.

To apply the change to all Carousels:

a.pb_carousel_default_prev {
   left: -60px !important;
a.pb_carousel_default_next {
   right: -70px !important;

To apply the change to an individual Carousel (replace the 1 with the specific entity you want to style):

#pb_carousel_prev-1 {
   left: -60px !important;
#pb_carousel_next-1 {
   right: -70px !important;

The Carousel container is too large until the page finishes loading. How do I fix this?

The CSS styling below will cap the height of the Carousel so that overflowing content will not show before the page is done loading. Change the 75 to your desired height:

#pb_carousel-1 {
   height: 75px;
   overflow: hidden;

Is it possible to open linked full sized images in a lightbox?

Yes. Use Auto Thickbox plugin.


Additional Resources

  1. Free Plugins by PluginBuddy
  1. PluginBuddy Tutorials
  3. Support Forums