jnweaver / owl-slideshow-wp

Wordpress simple slideshow plugin using Owl Carousel 2

Owl Slideshow

Contributors: jnweaver
Tags: carousel, slideshow, owl
Requires at least: 4.0.0
Tested up to: 4.2.2
Stable tag: 0.0.15 License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Output an Owl Carousel 2 slideshow using Wordpress’s built-in gallery shortcode.

Description

This Wordpress plugin takes a Wordpress Gallery and adds options to display the gallery shortcode as a slideshow using Owl Carousel 2.

The plugin add two options to the standard Wordpress Gallery options:

1. An Output as Owl slideshow? checkbox. Check it if you want the gallery to present as an Owl slideshow. (Otherwise, the gallery will appear as a default Wordpress gallery.)
2. An optional slideshow title text input that appears if you check the Owl slideshow checkbox. The title will appear above the slideshow.

Owl Options

You can override the plugin's default Owl 2 optios and/or pass additional options via an owl_options attribute inside the shortcode:

**[gallery output_as_slideshow="true" owl_slideshow_title="A slideshow title" ids="116,119,118,117,114,174" owl_options='{"startPosition":** 2, "nav": false}']  

Or use filters instead:

You can override the navText option (because it's impossible to pass HTML and quotes via a shortcode attribute):

function my_owl_nav_text( $navText ) {
  $myNavText = array('<span class="my-class">Previous</span>',
    '<span class="my-class">Next</span>');
  return $myNavText;
}
add_filter( 'owl_slideshow_nav_text', 'my_owl_nav_text', 100 );

Or you can override the entire Owl options object:

function my_owl_options( $json_options ) {
  return array('nav' => false, 'dots' => false);
}
add_filter( 'owl_json_options', 'my_owl_options');

Changelog

0.0.15

Updates for PHP 8.1

0.0.7

• Add filters for Owl's navText option and for replacing the default Owl options entirely
• Better (simpler) CSS and JS defaults

0.0.6

• Add image size option to gallery settings and shortcode

0.0.3

• Use large image size as a default

0.0.2

• Add arrow-key navigation for slideshow

0.0.1

• Initial release