CPT Bootstrap Carousel

Wordpress Plugin
Download latest - 1.12



Download Stats

Today 12
Yesterday 15
Last Week 99
All Time 140,297
Banner 772x250

A custom post type for choosing images and content which outputs a carousel from Twitter Bootstrap using the shortcode [image-carousel].

The plugin assumes that you're already using Bootstrap, so you need to load the Bootstrap javascript and CSS separately.

  • Download Twitter Bootstrap
  • Bootstrap CDN (hotlink CSS and javascript files)
  • Bootstrap Carousel in action

This plugin is available from the WordPress Plugins Directory: https://wordpress.org/plugins/cpt-bootstrap-carousel/. The source code is maintained on GitHub: https://github.com/ewels/cpt-bootstrap-carousel.

Shortcode Options

As of version 1.5, nearly all of these options can be set in the CPT Bootstrap Carousel Settings page. However, if you'd like different settings for different carousels, you can override these by using shortcode options...

  • interval (default 5000)

    • Length of time for the caption to pause on each image. Time in milliseconds.
    • [image-carousel interval="12000"]
  • showcaption (default true)

    • Whether to display the text caption on each image or not. true or false.
    • [image-carousel showcaption="false"]
  • showcontrols (default true)

    • Whether to display the control arrows or not. true or false.
    • [image-carousel showcontrols="false"]
  • orderby and order (default menu_order ASC)

    • What order to display the posts in. Uses WP_Query terms.
    • [image-carousel orderby="rand"]
    • [image-carousel orderby="date" orderby="DESC"]
  • category (default all)

    • Filter carousel items by a comma separated list of carousel category slugs.
    • [image-carousel category="homepage,highlights"]
  • id (default all)

    • Specify the ID of a specific carousel post to display only one image.
    • Find the image ID by looking at the edit post link, eg. post 109 would be /wp-admin/post.php?post=109&action=edit
    • [image-carousel id="109"]
  • twbs (default 2)

    • Output markup for Twitter Bootstrap Version 2 or 3.
    • [image-carousel twbs="3"]


This plugin was written by @tallphil with help and suggestions from several others including (but not limited to) @reddo, @joshgerdes, @atnon, @grahamharper, @rchq, @oheijo, @smtk, @cla63, @cookierebes and @sipman.

The Serbo-Croation translation was kindly provided by Borisa Djuraskovic from http://www.webhostinghub.com


If you would like to contribute to this plugin, please make a personal fork of the GitHub repository and then submit a pull request. For more details please see the contributing guide.

Releases (14 )

Version Release Date Change Log
1.11 2020-04-17
  • Added support for crossfading images instead of sliding
1.10 2019-03-25
1.9.1 2015-09-02
  • Titles and captions now show if present, independently of each other (previously both needed to be filled in)
    • You can hide them by leaving blank, or setting Show Slide Titles / Captions? to False in the settings
  • New German translation courtesy of @stefan-meier
  • Undefined index warning fixed by @pfernandez
  • Carousel items now have proper CSS IDs (by @chickahoona)
  • Fixed bug where interval of 0 was replaced with the default interval time
  • Nicer icon in the WordPress admin (thanks @stefan-meier)
  • Localization file path issue fixed (thanks @stefan-meier)
1.9 2015-02-09
  • Prevented the help tab from displaying on pages other than Carousel Items
  • Made the output buffer cleaning only happen if we have images (thanks @ChrisLomax)
  • Tidied up some warnings generated when WP_DEBUG was true
  • New settings option to rely on data-attributes only, without any Javascript chunks
  • Split the plugin into multiple files to make code easier to maintain
  • Re-wrote the settings page to make things clearer
  • Added new feature to have a link button instead of clickable slider image
  • Bugfix: Carousel items with links using background images now work.
1.8.1 2014-09-04
  • Bugfix. Apologies to anyone who ran into it and thanks to kylewhenderson for the spot.
1.7 2014-09-04
  • Added custom classes for next/prev buttons - written by @reddo
  • Added admin column for categories
  • Made the category dropdown in the settings work (bugfix)
  • Addeed contextual help on post and page editing screens
1.8 2014-09-04
  • Bumped "tested with" up to WP 4.0
  • Added new plugin icon and updated the banner + screenshots
  • Carousel controls now hidden if there is only one image - thanks to @rchq
  • Option to use a different WordPress image size, suggested by oheijo
  • Added option to specify HTML tags for caption and title. Suggested by smtk
  • New option to use background images instead of <img> tags. Good for resizing. Suggested by @cla63 and @cookierebes
  • New Serbo-Croatian translation! Thanks to borisa from http://www.webhostinghub.com
1.6 2014-03-31
  • Made the title and caption linked if we have a URL
  • Stopped the caption div from displaying if there is not caption
  • Added a unique CSS id attribute to each item, based on the wordpress post ID
  • Fixed a bug where the plugin was throwing and error when WP_DEBUG was on
  • Updated the FAQ a little
  • Changed the default version of bootstrap to v3 for new installs. This can be customised in the settings.
1.5 2013-12-15
  • Added new Settings page. Means less shortcode attributes, more user friendly
  • Added i18n functions so that the plugin can be translated
  • Fix: Bug where featured images were shown on all post types. Noticed by @grahamharper
1.4 2013-10-25
  • Fix: Bug limited carousel to only 10 images. Now displays all images.
  • Fix: Specifying interval didn't always worked. Re-written javascript to make it more reliable
  • Added id shortcode attribute to specify a single image for the carousel
  • Restructured the readme file to make usage clearer
1.3 2013-08-06
  • Added support for carousel categories, using filtering with the category shortcode
  • Added orderby shortcode attribute to specify ordering of images
    • This means that images can now be in a random order
  • Added twbs shortcode attribute to allow the output of Twitter Bootstrap v3 markup
  • Added WordPress directory screenshots
  • Admin thumbnail images now link to the edit page
1.2 2013-07-29
  • Featured images are now shown in the admin list view
  • Added new admin metabox for image url (written by @tallphil, based on code contributed by @atnon)
1.1 2013-05-20
  • Added shortcode attributes (code contributed by @joshgerdes)
1.0 2013-05-20
  • Initial release