Overview

The Carousel extension allows you to create a customizable, carousel style slide show of your Facebook Posts.

Below are two examples of using the Carousel extension. Click here to see a live demo.

screenshot of Smash Balloon Carousel Extension for Custom Facebook Feed

Shortcode used above:
[custom-facebook-feed carousel="true"]

screenshot of Smash Balloon Carousel Extension for Custom Facebook Feed

Shortcode used above:
[custom-facebook-feed carousel="true" carouselcols=3 type="photos" photosource="photospage"]

Carousel Settings are located on the “Post Layout” tab on the plugin’s “Customize” page:

Screenshot of the Settings for the Carousel extension for the Custom Facebook Feed plugin

See the How to use tab above for directions on how to use the extension.

How to use

Installation

Extensions are installed just like any other WordPress plugin. You can follow the same process used when uploading and installing the Custom Facebook Feed Pro plugin.

Settings

Once activated, the extension will add a variety of settings to the “Post Layout” tab, which is on the plugin’s “Customize” page. These settings are shown below:

facebook-feed-carousel-settings

Shortcode

You can also set these settings directly in the shortcode. These are only required if you want to override the settings set on the plugin’s Settings page shown above. Here’s an example shortcode:

[custom-facebook-feed carousel="true" carouselcols=3]

Shortcode Options

Name Attribute Options Description Example
Carousel Feed carousel true
false
Whether or not to apply the carousel to this feed carousel=true
Number of columns carouselcols 1-6 The number of columns inside the carousel slide show carouselcols=3
Number of columns for mobile carouselmobilecols 1-6 The number of columns on mobile displays carouselmobilecols=2
Height of Carousel carouselheight tallest
clickexpand
autoexpand
How the height of the feed is set. Note: the “autoexpand” option only works when displaying 1 column in the carousel carouselheight="clickexpand"
Arrow Navigation carouselarrows none
below
onhover
How arrows are displayed for navigating through the carousel carouselarrows="onhover"
Pagination carouselpag true
false
Icons to indicate the relative position of the current slide carouselpag=true
Autoplay carouselautoplay true
false
Cycle through posts automatically when the feed loads carouselautoplay=true
Autoplay Time Interval carouseltime any number Number of milliseconds before a new post is shown carouseltime=5000

Change Log

= 1.2 =
* Tweak: Added spacing if the posts have the box-shadow setting applied or are displayed in multiple columns
* Fix: Fixed an issue with the navigation arrows not working when positioned below the carousel
* Fix: Fixed an issue where the navigation wouldn’t be displayed below the feed if the pagination was hidden

= 1.1.2 =
* Fix: When displaying events in the carousel the “Number of Posts” setting wasn’t working correctly
* Fix: Fixed an issue where empty carousel items may be displayed in photo carousels when using the ‘filter’ setting

= 1.1.1 =
* Tweak: Updated the plugin updater script to reduce requests on the WordPress Plugins page

= 1.1 =
* Compatible with version 3.0 of the Custom Facebook Feed Pro plugin

= 1.0 =
* Launched the Carousel Feed extension