=== Bootstrap Carousel Slider - Responsive Image Slider ===
Contributors: itpixelz
Donate link: http://www.itpixelz.com/
Tags: carousel, slider, image slider, bootstrap carousel, responsive slider
Requires at least: 5.0
Requires PHP: 7.0
Tested up to: 7.1
Stable tag: 1.1.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Responsive Bootstrap carousel slider. Add slides with a featured image and caption, then place the slider with one shortcode.

== Description ==

Add a responsive image slider to any page with one shortcode. Each slide is a
normal WordPress post with a featured image, a title and a caption, so you add
and reorder slides the same way you edit anything else on your site.

Built on the Bootstrap carousel markup, so if your theme already loads Bootstrap
the slider inherits your existing styling.

= Adding a slider =

1. Go to Sliders, then Add New. Set a title, add a caption in the editor, and
   set a featured image.
2. Put `[show_bootstrap_carousel]` in any post or page.

= Options =

Under Settings, then Carousel Settings:

* Show or hide the dot indicators
* Show or hide the previous and next arrows
* Show or hide captions
* How many slides to display
* Caption heading colour

= Showing one category =

Group slides with the Category taxonomy and show a single group:

`[show_bootstrap_carousel category="homepage"]`

= In a widget or in your theme =

There is a widget under Appearance, then Widgets. To place a slider directly in
a template file:

`<?php echo do_shortcode( '[show_bootstrap_carousel]' ); ?>`

= Requirements =

Your theme must load the Bootstrap CSS and JavaScript. The plugin supplies the
slider markup and its own small stylesheet, not the Bootstrap framework itself.


== Installation ==

1. In your WordPress admin go to Plugins, then Add New, and search for
   "Bootstrap Carousel Slider".
2. Click Install Now, then Activate.
3. Go to Sliders, then Add New, and create a slide with a featured image.
4. Put `[show_bootstrap_carousel]` in any post or page.

Your theme must load Bootstrap's CSS and JavaScript for the slider to animate.


== Frequently Asked Questions ==

= How do I add a slider to a page? =

Create slides under Sliders, then Add New, giving each one a featured image.
Then paste `[show_bootstrap_carousel]` into any post or page.

= How do I show only some slides? =

Assign your slides to a category, then pass its slug:
`[show_bootstrap_carousel category="homepage"]`

= Can I put a slider in my sidebar or footer? =

Yes. Go to Appearance, then Widgets, and add the WP Bootstrap Carousel widget to
any widget area.

= Can I put a slider straight into my theme? =

Yes, with `<?php echo do_shortcode( '[show_bootstrap_carousel]' ); ?>` in your
template file.

= Nothing shows up. What is wrong? =

Check that your slides are published and each one has a featured image, and that
your theme loads Bootstrap's CSS and JavaScript. This plugin provides the slider
markup, not the Bootstrap framework.

= Can I have more than one slider on the same page? =

Yes. Each one gets its own identifier, so they work independently.

= How do I change the caption colour? =

Under Settings, then Carousel Settings, there is a colour picker for the caption
heading.

= Does it work on multisite? =

Yes. Slides and settings are per site.


== Screenshots ==

1. This is how slider will look like on the website front-end
2. Slider can be placed from sidebar and footer widgets
3. Go to the Settings link from left side bar in wp-admin and then go to the link "Carousel Settings" and then change the settings as per your requirement.
4. Go to left sidebar from wp-admin dashboard, Sliders link dropdown and click on add new slider, and enter title, content for caption and featured image for slider and publish it.
5. Go to widgets settings from wp-admin dashboard and display that slider to your front end.

== Changelog ==

= 1.1.1 =

* Rewrote the plugin listing so people searching for "carousel slider" or
  "responsive image slider" can find it. No change to how the plugin works.
* The plugin is now called Bootstrap Carousel Slider - Responsive Image Slider.
  Your slides, settings and shortcodes are untouched.

= 1.1.0 =
* Fixed: the shortcode printed its markup instead of returning it, so the
  carousel appeared at the top of the page rather than where the shortcode was
  placed, and do_shortcode() returned nothing.
* Fixed: turning navigation off left the slide query undefined, so no slides
  were fetched. The query is now built independently of the display options.
* Fixed: a fresh install raised PHP warnings on every carousel and rendered
  with every feature switched off, because no default settings were stored.
  Defaults are now seeded on activation and applied when a setting is absent.
* Fixed: settings are validated when saved, and all output is escaped.
* Fixed: the stylesheet was linked from a hardcoded path that broke when the
  plugin folder was renamed. It now resolves relative to the plugin.
* Fixed: an empty image placeholder was rendered when no slides existed.
* Changed: the slide identifier is now unique per carousel, so more than one
  carousel can appear on the same page.
* Tested up to WordPress 7.1. Declared a minimum of PHP 7.0.
* Note: the previous stable tag referred to a version 4.3 that was never
  released. Versioning now follows the plugin's actual history.

= 1.0 =
* Initial release.
