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.

+

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. In order to select an image to add from the list of images click the "show" link for that image and then click the "select this image" button as shown in the image below.

−

[[File:Medialibraryup.png|408px]]

+

[[File:Displaybuddyselectimage.png|408px]]

==Settings==

==Settings==

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

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.

'''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.

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

+

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

'''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.

'''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.

'''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.

'''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.

'''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.

'''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.

'''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.

'''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.

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

You may want your Carousel images (or certain groups/images) to be email links, so that people can send emails. That is easily done by putting the following (changing '''[email protected]''' to YOUR email) in the '''LINK''' field for the Carousel image in question:

[http://ithemes.com/codex/page/PluginBuddy#Extra_Customizations Check out the official policy and details on any Extra Customizations]

+

+

====Customize Carousel Dimensions and Placements via CSS====

+

Sometimes, Carousel shows everything properly BUT your image dimensions may result in more or fewer images being shown. This can be fixed by selecting the proper size or number of images.

+

+

You can also customize the entire Carousel Display via CSS. The following CSS code template can be used to customized to your own needs. You need to add this css to your theme's css file at the very end.

+

+

*Remember: the following will change the styling for ALL Carousels on your site EXCEPT the first <code>#pb_carousel-1</code> part, which (only that part) will work only on the 1st Carousel (Carousel whose shortcode is 1).

+

+

<pre brush"css">

+

#pb_carousel-1 { /* Controls the actual Carousel in question. In this example, it is Carousel 1. You can find the Carousel number in the shortcode in your Carousel admin panel */

+

left: 90px ! important;

+

width: 960px ! important;

+

}

+

+

.pb_carousel_default { /* Controls the width of the actual Carousel - this is usually always changed, if you want, with the actual Carousel */

Description

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.

Groups

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. In order to select an image to add from the list of images click the "show" link for that image and then click the "select this image" button as shown in the image below.

Settings

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.

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

Can I have email links INSTEAD of url links for Carousel?

You may want your Carousel images (or certain groups/images) to be email links, so that people can send emails. That is easily done by putting the following (changing [email protected] to YOUR email) in the LINK field for the Carousel image in question:

Customize Carousel

Extra Customizations Policies

Customize Carousel Dimensions and Placements via CSS

Sometimes, Carousel shows everything properly BUT your image dimensions may result in more or fewer images being shown. This can be fixed by selecting the proper size or number of images.

You can also customize the entire Carousel Display via CSS. The following CSS code template can be used to customized to your own needs. You need to add this css to your theme's css file at the very end.

Remember: the following will change the styling for ALL Carousels on your site EXCEPT the first #pb_carousel-1 part, which (only that part) will work only on the 1st Carousel (Carousel whose shortcode is 1).

Align Images between Navigation Arrows

You can align the images between the navigation arrows by adding the following CSS styling, customized to your needs, at the very end of your theme's css file:

#post-102 .caroufredsel_wrapper
/* the #post-102 part makes it apply this setting ONLY to the Carousel on the post whose id is 102. Change it to meet your needs OR remove it completely.
Play with the "left" value of 11 also. This tells the Carousel to push the images 11 pixels to the right (from the left). */
{
left: 11px;
}