About this plugin
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
EpitomeSlider({ width: ‘auto’, height: ‘viewport’ }); }); `