Epitome Gallery aims to bring new possibilites to the native WordPress gallery. From the Edit Gallery panel in the Gallery Settings sidebar, you will find new fields for selecting the gallery type and optionaly applying a custom class. Available gallery types are the following: Slider, Featured Slider, Callout. You manage your gallery (selection, sorting, description) as usual. Epitome Gallery is great to create complex layouts based on a simple WordPress gallery.
When saving, the plugin add custom attributes in the WordPress gallery shortcode. The first one is
epitome_type="name" that define the type of gallery (optional if the type is set to default). The second one is optional
epitome_class="name" and contains one or more class names to apply.
Gallery types
- Slider - Transform a WordPress gallery to a interactive slider. Works fine in the body of an article.
- Featured Slider - Same as Slider, but provides titles, caption and/or description. Works fine at the top of an article as a featured content.
- Callout - Transfom a WordPress gallery to a set of columns containing images with title, caption and/or description. No need to use a column shortcode or a composer, just use this type of gallery for building this kind of layout.
JavaScript
Epitome Gallery use a JavaScript file (coded with jQuery) to handle the slider. You can use to customize your own slider. Parameters are the following:
javascript
pauseTime: 3000, // Delay between 2 slides
pauseOnHover: true, // Pause slider on hover
autoSlide: false, // Start sliding automatically
startSlide: 1, // Initial slide number at start
width: 640, // In pixel, or keyword 'auto', 'viewport'
height: 360, // In pixel, or keyword 'auto', 'viewport'
prefetch: true, // Load adjacent slides
sitOnTop: false, // Scroll at the top on slider when clicking on it
prevText: "Prev", // Direction of previous button label
nextText: "Next", // Direction of next button label
directionNav: true, // Display direction button (arrows at the egdge of slider)
paginationNav: true, // Display pagination button (dots at bottom of slider)
prevHandle: null, // Callback function when clicking previous button
nextHandle: null, // Callback function when clicking next button
itemHandle: null, // Callback function to filter dot elements
beforeChange: null, // Callback function to launch action before a slide changes
afterChange: null, // Callback function to launch action after a slide changes
resize: null // Callback function when catching a window resize event.
Usage
You can replace the default event initialized by the Epitome Gallery in the main JavaScript file of your theme. Instanciate the EpitomeSlider JavaScript object through a custom event and with custom parameters used for this theme. This is similar to the WordPress function
do_action(). That's important to declare this event outside a
ready event.
javascript
$(document).on('epitome_slider_init', function(e) {
// Instanciate for a regular slider
$('.gallery.slider[data-type="regular-slider"]').EpitomeSlider({
width: 'auto',
height: 'auto'
});
// Instanciate for a featured slider
$('.gallery.slider[data-type="featured-slider"]').EpitomeSlider({
width: 'auto',
height: 'viewport'
});
});