FooGallery Owl Carousel Template

FAQ

Installation Instructions

This is a normal plugin, and can be installed as normal.

Downloading the Zip?

1. Upzip the zip
2. Upload the zip to the /wp-content/plugins/ directory
3. Activate the plugin through the ‹Plugins› menu in WordPress

Searching in the backend

1. Go to «Plugins > Add New» then click «Search»
2. In the search field type «FooGallery Owl Carousel»
3. Click install
4. Click Activate

It’s Installed. What do I do now?

Assuming you already have FooGallery installed, go to «FooGallery > Extensions». Then go to the «Build Your Own» tab and you’ll see the Owl Carousel there. Click «Activate» and you’re good to go. Now when you go to create a new Gallery, you’ll see «Owl Carousel» as a template option.

Can I set a different number of images for different size screens?

Yes. This feature was added into version 1.2. Enable the «Advanced Options» section to set those options.

I don’t see Owl Carousel as an option in the Gallery Templates field when I go to add a new Gallery

Make sure you go to «FooGallery > Extensions» and make sure you see «Owl Carousel» activated there.

Can I update the text for the «prev» and «next» buttons?

Yes, since version 1.2.3 you can now use a simple filter to change the text of those buttons. Here’s some sample code that you can add into your theme’s function.php file to customize that text.

Update the «prev» text
add_filter(‹owl_prev_text›,’new_prev_text›);

function new_prev_text() {
    return 'Go to the previous slide';
}

Update the «next» text
add_filter(‹owl_next_text›,’new_next_text›);

function new_next_text() {
    return 'Go to the next slide';
}

You can also return simple HTML. This allows you to swap out the text with font icons instead. For example, Twentyfifteen preloads the Genericons font-icons on the front end for you. So you could swap out the text with a right and left button. In that case, your code would look like this:

Use a Genericon Left Arrow for «prev»
add_filter(‹owl_prev_text›,’new_prev_text›);

function new_prev_text() {
    return '<span class="genericon genericon-leftarrow"></span>';
}

Use a Genericon Right Arrow for «next»
add_filter(‹owl_next_text›,’new_next_text›);

function new_next_text() {
    return '<span class="genericon genericon-rightarrow"></span>';
}

Can I use initialization rules from the original Owl Carousel?

Yes! Since version 1.4 there’s now a filter you can use to add additional Owl init rules. Here’s some examples:

add_filter('foogallery_owl_custom_init', 'my_custom_init', 10, 2);

 function my_custom_init($custom_init, $gallid) {
    $custom_init = "startPosition: 'URLHash',";
    return $custom_init;
 }

Just remember to always end the line with a comma, and understand that doing this wrong can definitely break your galleries.

You can also target per gallery like so:

add_filter('foogallery_owl_custom_init', 'my_custom_init', 10, 2);

 function my_custom_init($custom_init, $gallid) {
    if ( "5" != $gallid ) {
            return null;
    } else {
        $custom_init = "startPosition: 'URLHash',";
        return $custom_init;
    }
 }

What other filters are available?

Since version 1.4 there now the following filters available as well:

• foogallery_owl_lazyload — to override the default laszyLoad : true, just return this false instead.
• foogallery_owl_startposition — this is used in comination with the Deep Linking feature. You can choose to change the first slide to whatever you like here.

How do you do it, Matt!? How do you make such awesome stuff!?

Awww shucks! I lean on tons of other stronger, smarter, more skilled people than me and work at it every day. If you really appreciate this plugin, then please feel free to send me a tip over here.