Agnosia Bootstrap Carousel By AuSoft Wordpress Plugin - Rating, Reviews, Demo & Download
Plugin Description
Agnosia Bootstrap Carousel hooks the
shortcode with attribute
type="carousel"
in order to show a Bootstrap Carousel 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.
Basic example:
Required attributes:
type
: it needs to betype="carousel"
.ids
: you must provide a list ofids
corresponding to attachments, likeids="1,2,3"
.
Otherwise, the default
shortcode function will be processed instead of this plugin’s one.
Optional attributes:
name
: 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:indicators
: indicators position. Accepted values: before-inner, after-inner, after-control, false (hides indicators). Default: before-inner. Example:width
: carousel container width, inpx
or%
. Default: not set. Example:height
: carousel item height, inpx
or%
. Default: not set. Example:titletag
: define HTML tag for image title. Default: h4. Example:wpautop
: auto-format text. Default: true. Example:title
: show or hide image title. Set false to hide. Default: true. Example:text
: show or hide image text. Set false to hide. Default: true. Example:containerclass
: extra class for carousel container. Default: not set. Example:itemclass
: extra class for carousel item. Default: not set. Example:captionclass
: extra class for item caption. Default: not set. Example:control
: control arrows display. Accepted values: true (to show), false (to hide). Default: true. Example:interval
: the amount of time to delay between automatically cycling an item. If false, carousel will not automatically cycle. Default: 5000. Example:pause
: pauses the cycling of the carousel on mouseenter and resumes the cycling of the carousel on mouseleave. Default: “hover”. Example:size
: size for image attachment. Accepted values: thumbnail, medium, large, full. Default: full. See wp_get_attachment_image_src() for further reference. Example:
Native supported attributes:
orderby
: Alternative order for your images. Example:link
: where your image titles will link to. Accepted values: file, none and empty. An empty value will link to your attachment’s page. Example:
Extending
This plugin offers hooks for actions and filters, so you can modify its functionality or add your own.
Action hooks:
agnosia_bootstrap_carousel_before_init
: Do something before the carousel is loaded.agnosia_bootstrap_carousel_init
: Do something after the carousel is loaded.
Filter hooks:
agnosia_bootstrap_carousel_attributes
: Modify the attributes passed to the shortcode.agnosia_bootstrap_carousel_posts
: Modify the$post
objects that the shortcode is using.agnosia_bootstrap_carousel_container_style
: Modify the carousel container style.agnosia_bootstrap_carousel_item_style
: Modify the style of the carousel items.agnosia_bootstrap_carousel_output
: Modify the full HTML output of the carousel.agnosia_bootstrap_carousel_container
: Modify the HTML output of the carousel container tag.agnosia_bootstrap_carousel_inner
: Modify the HTML output of the carousel inner tag.agnosia_bootstrap_carousel_caption_container
: Modify the HTML output of the caption container tag.agnosia_bootstrap_carousel_img_container
: Modify the HTML output of the image container tag.agnosia_bootstrap_carousel_img
: Modify the HTML output of the item image tag.agnosia_bootstrap_carousel_excerpt
: Modify the HTML output of the image caption.agnosia_bootstrap_carousel_indicators
: Modify the HTML output of the indicators element.agnosia_bootstrap_carousel_control
: Modify the HTML output of the control element.agnosia_bootstrap_carousel_javascript
: Modify the output of the carousel Javascript.agnosia_bootstrap_carousel_make_array
: Modify the list of$post
IDs that the carousel is using.
Contributing
You can make suggestions and submit your own modifications to this plugin on Github.
For more information, visit our website.
Screenshots
-
This is how you should use the shortcode.
-
This is how it should appear in your website. Note that your theme styles may override Bootstrap styles.
-
This is an approximation on how the resultant HTML code should look like.