Andrés Villarreal

Agnosia Bootstrap Carousel hooks the <code>[gallery]</code> shortcode with attribute <code>type="carousel"</code> in order to show a <a href="http://getbootstrap.com/javascript/#carousel" rel="nofollow ugc">Bootstrap Carousel</a> based on the selected images and their titles and descriptions.
This plugin assumes either your theme includes the necessary Bootstrap javascript and CSS files to display the carousel properly, or that you have included those files on your own. It will not include the files for you, so if they are not present, the carousel will not work and you will only obtain its bare HTML.
<h4>Basic example:</h4>
<pre><code>[gallery type="carousel" ids="61,60,59"]
</code></pre>
<h4>Required attributes:</h4>
<ul>
<li><code>type</code>: it needs to be <code>type="carousel"</code>.</li>
<li><code>ids</code>: you must provide a list of <code>ids</code> corresponding to attachments, like <code>ids="1,2,3"</code>.</li>
</ul>
Otherwise, the default <code>[gallery]</code> shortcode function will be processed instead of this plugin’s one.
<h4>Optional attributes:</h4>
<ul>
<li><code>name</code>: any name. String will be sanitize to be used as an HTML ID. Recommended when you want to have more than one carousel in the same page. Default: agnosia-bootstrap-carousel. Example: <code>[gallery type="carousel" ids="61,60,59" name="myCarousel"]</code></li>
<li><code>indicators</code>: indicators position. Accepted values: before-inner, after-inner, after-control, false (hides indicators). Default: before-inner. Example: <code>[gallery type="carousel" ids="61,60,59" indicators="after-inner"]</code></li>
<li><code>width</code>: carousel container width, in <code>px</code> or <code>%</code>. Default: not set. Example: <code>[gallery type="carousel" ids="61,60,59" width="800px"]</code></li>
<li><code>height</code>: carousel item height, in <code>px</code> or <code>%</code>. Default: not set. Example: <code>[gallery type="carousel" ids="61,60,59" height="400px"]</code></li>
<li><code>titletag</code>: define HTML tag for image title. Default: h4. Example: <code>[gallery type="carousel" ids="61,60,59" titletag="h2"]</code></li>
<li><code>wpautop</code>: auto-format text. Default: true. Example: <code>[gallery type="carousel" ids="61,60,59" wpautop="false"]</code></li>
<li><code>title</code>: show or hide image title. Set false to hide. Default: true. Example: <code>[gallery type="carousel" ids="61,60,59" title="false"]</code></li>
<li><code>text</code>: show or hide image text. Set false to hide. Default: true. Example: <code>[gallery type="carousel" ids="61,60,59" text="false"]</code></li>
<li><code>containerclass</code>: extra class for carousel container. Default: not set. Example: <code>[gallery type="carousel" ids="61,60,59" containerclass="container"]</code></li>
<li><code>itemclass</code>: extra class for carousel item. Default: not set. Example: <code>[gallery type="carousel" ids="61,60,59" itemclass="container"]</code></li>
<li><code>captionclass</code>: extra class for item caption. Default: not set. Example: <code>[gallery type="carousel" ids="61,60,59" captionclass="container"]</code></li>
<li><code>control</code>: control arrows display. Accepted values: true (to show), false (to hide). Default: true. Example: <code>[gallery type="carousel" ids="61,60,59" control="false"]</code></li>
<li><code>interval</code>: the amount of time to delay between automatically cycling an item. If false, carousel will not automatically cycle. Default: 5000. Example: <code>[gallery type="carousel" ids="61,60,59" interval="2000"]</code></li>
<li><code>pause</code>: pauses the cycling of the carousel on mouseenter and resumes the cycling of the carousel on mouseleave. Default: “hover”. Example: <code>[gallery type="carousel" ids="61,60,59" interval="hover"]</code></li>
<li><code>size</code>: size for image attachment. Accepted values: thumbnail, medium, large, full. Default: full. See <a href="https://codex.wordpress.org/Function_Reference/wp_get_attachment_image_src" rel="nofollow ugc">wp_get_attachment_image_src()</a> for further reference. Example: <code>[gallery type="carousel" ids="61,60,59" size="full"]</code></li>
</ul>
<h4>Native supported attributes:</h4>
<ul>
<li><code>orderby</code>: Alternative order for your images. Example: <code>[gallery type="carousel" ids="61,60,59" orderby="rand"]</code></li>
<li><code>link</code>: where your image titles will link to. Accepted values: file, none and empty. An empty value will link to your attachment’s page. Example: <code>[gallery type="carousel" ids="61,60,59" link="file"]</code></li>
</ul>
<h4>Extending</h4>
This plugin offers hooks for actions and filters, so you can modify its functionality or add your own.
Action hooks:
<ul>
<li><code>agnosia_bootstrap_carousel_before_init</code>: Do something before the carousel is loaded.</li>
<li><code>agnosia_bootstrap_carousel_init</code>: Do something after the carousel is loaded.</li>
</ul>
Filter hooks:
<ul>
<li><code>agnosia_bootstrap_carousel_attributes</code>: Modify the attributes passed to the shortcode.</li>
<li><code>agnosia_bootstrap_carousel_posts</code>: Modify the <code>$post</code> objects that the shortcode is using.</li>
<li><code>agnosia_bootstrap_carousel_container_style</code>: Modify the carousel container style.</li>
<li><code>agnosia_bootstrap_carousel_item_style</code>: Modify the style of the carousel items.</li>
<li><code>agnosia_bootstrap_carousel_output</code>: Modify the full HTML output of the carousel.</li>
<li><code>agnosia_bootstrap_carousel_container</code>: Modify the HTML output of the carousel container tag.</li>
<li><code>agnosia_bootstrap_carousel_inner</code>: Modify the HTML output of the carousel inner tag.</li>
<li><code>agnosia_bootstrap_carousel_caption_container</code>: Modify the HTML output of the caption container tag.</li>
<li><code>agnosia_bootstrap_carousel_img_container</code>: Modify the HTML output of the image container tag.</li>
<li><code>agnosia_bootstrap_carousel_img</code>: Modify the HTML output of the item image tag.</li>
<li><code>agnosia_bootstrap_carousel_excerpt</code>: Modify the HTML output of the image caption.</li>
<li><code>agnosia_bootstrap_carousel_indicators</code>: Modify the HTML output of the indicators element.</li>
<li><code>agnosia_bootstrap_carousel_control</code>: Modify the HTML output of the control element.</li>
<li><code>agnosia_bootstrap_carousel_javascript</code>: Modify the output of the carousel Javascript.</li>
<li><code>agnosia_bootstrap_carousel_make_array</code>: Modify the list of <code>$post</code> IDs that the carousel is using.</li>
</ul>
<h4>Contributing</h4>
You can make suggestions and submit your own modifications to this plugin on <a href="https://github.com/andrezrv/agnosia-bootstrap-carousel" rel="nofollow ugc">Github</a>.
For more information, visit <a href="http://aufieroinformatica.com" rel="nofollow ugc">our website</a>.

Agnosia Bootstrap Carousel by AuSoft

This plugin lets you use the [gallery] shortcode to show a Bootstrap Carousel.

Phil Ewels

A custom post type for choosing images and content which outputs a <a href="http://getbootstrap.com/javascript/#carousel" rel="nofollow ugc">carousel</a> from <a href="http://www.getbootstrap.com" rel="nofollow ugc">Twitter Bootstrap</a> using the shortcode <code>[image-carousel]</code>.
The plugin assumes that you’re already using Bootstrap, so you need to load the Bootstrap javascript and CSS separately.
<ul>
<li><a href="http://getbootstrap.com/" rel="nofollow ugc">Download Twitter Bootstrap</a></li>
<li><a href="http://www.bootstrapcdn.com/" rel="nofollow ugc">Bootstrap CDN</a> (hotlink CSS and javascript files)</li>
<li><a href="https://getbootstrap.com/docs/4.4/components/carousel/" rel="nofollow ugc">Bootstrap Carousel in action</a></li>
</ul>
This plugin is available from the WordPress Plugins Directory: <a href="https://wordpress.org/plugins/cpt-bootstrap-carousel/" rel="ugc">https://wordpress.org/plugins/cpt-bootstrap-carousel/</a>. 
The source code is maintained on GitHub: <a href="https://github.com/ewels/cpt-bootstrap-carousel" rel="nofollow ugc">https://github.com/ewels/cpt-bootstrap-carousel</a>.
<h4>Shortcode Options</h4>
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…
<ul>
<li>
<code>interval</code> (default 5000)
<ul>
<li>Length of time for the caption to pause on each image. Time in milliseconds.</li>
<li><code>[image-carousel interval="12000"]</code></li>
</ul>
</li>
<li>
<code>showcaption</code> (default true)
<ul>
<li>Whether to display the text caption on each image or not. <code>true</code> or <code>false</code>.</li>
<li><code>[image-carousel showcaption="false"]</code></li>
</ul>
</li>
<li>
<code>showcontrols</code> (default true)
<ul>
<li>Whether to display the control arrows or not. <code>true</code> or <code>false</code>.</li>
<li><code>[image-carousel showcontrols="false"]</code></li>
</ul>
</li>
<li>
<code>orderby</code> and <code>order</code> (default <code>menu_order</code> <code>ASC</code>)
<ul>
<li>What order to display the posts in. Uses <a href="https://codex.wordpress.org/Class_Reference/WP_Query#Order_.26_Orderby_Parameters" rel="nofollow ugc">WP_Query terms</a>.</li>
<li><code>[image-carousel orderby="rand"]</code></li>
<li><code>[image-carousel orderby="date" orderby="DESC"]</code></li>
</ul>
</li>
<li>
<code>category</code> (default all)
<ul>
<li>Filter carousel items by a comma separated list of carousel category slugs.</li>
<li><code>[image-carousel category="homepage,highlights"]</code></li>
</ul>
</li>
<li>
<code>id</code> (default all)
<ul>
<li>Specify the ID of a specific carousel post to display only one image.</li>
<li>Find the image ID by looking at the edit post link, eg. post 109 would be <code>/wp-admin/post.php?post=109&action=edit</code></li>
<li><code>[image-carousel id="109"]</code></li>
</ul>
</li>
<li>
<code>twbs</code> (default 2)
<ul>
<li>Output markup for Twitter Bootstrap Version 2 or 3.</li>
<li><code>[image-carousel twbs="3"]</code></li>
</ul>
</li>
</ul>
<h4>Credits</h4>
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 <a href="http://www.webhostinghub.com" rel="nofollow ugc">http://www.webhostinghub.com</a>
The Spanish translation was provided by Chema Bescós from IBIDEM GROUP (<a href="https://www.ibidemgroup.com" rel="nofollow ugc">https://www.ibidemgroup.com</a>)
<h4>Contributing</h4>
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 <a href="https://github.com/ewels/CPT-Bootstrap-Carousel/CONTRIBUTING.md" rel="nofollow ugc">contributing guide</a>.

CPT Bootstrap Carousel

A custom post type for choosing images and content which outputs Bootstrap Image Carousel (slider) from the [image-carousel] shortcode.

Agnosia Bootstrap Carousel by AuSoft vs CPT Bootstrap Carousel