Fred Dessaint

<p>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.</p>
<p>When saving, the plugin add custom attributes in the WordPress gallery shortcode. The first one is <code>epitome_type="name"</code> that define the type of gallery (optional if the type is set to default). The second one is optional <code>epitome_class="name"</code> and contains one or more class names to apply.</p>
<h4>Gallery types</h4>
<ul>
<li>Slider – Transform a WordPress gallery to a interactive slider. Works fine in the body of an article.</li>
<li>Featured Slider – Same as Slider, but provides titles, caption and/or description. Works fine at the top of an article as a featured content.</li>
<li>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.</li>
</ul>
<h4>JavaScript</h4>
<p>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:</p>
<pre><code>`javascript </code></pre>
<p>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.     `</p>
<h4>Usage</h4>
<p>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 <code>do_action()</code>. That’s important to declare this event outside a <code>ready</code> event.</p>
<pre><code>`javascript </code></pre>
<p>$(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’     }); });     `</p>


Epitome Gallery

Add new styles to your WordPress gallery of images that showcase a fully different look for complex layouts.

<p>The featured category is meant to set an introduction category that helps to identify the topic of a post. The plugin adds a metabox in the edit page of a regular post for selecting the featured category. Note that a small coding is required to display the featured category in the right location of your template. You can display the featured category in the desired location of the page with a set of functions that you call from your template. The plugin CMB2 is required for creating metaboxes.</p>
<h4>Functions</h4>
<ul>
<li><code>the_featured_category()</code> takes the current post or page ID and outputs the featured category.</li>
<li><code>get_the_featured_category($post_id)</code> has one optional parameter (post or page ID) and returns the featured category as a string.</li>
<li><code>has_featured_category($post_id)</code> has one optional parameter (post or page ID) and checks whether a featured category exists.</li>
</ul>


Epitome Featured Category

Set an introduction category as a metadata that helps to identify the topic of a post.

Epitome Gallery vs Epitome Featured Category