Skip to content

Commit

Permalink
Just a quick FAQ update and README.md update.
Browse files Browse the repository at this point in the history
  • Loading branch information
mathetos committed Nov 23, 2016
1 parent 64e0aa0 commit c4349de
Show file tree
Hide file tree
Showing 2 changed files with 115 additions and 14 deletions.
112 changes: 111 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,114 @@ This repository will most often be one step ahead of the WordPress Repo. Develop
* [Contribute to FooGallery on Github](https://github.com/fooplugins/foogallery)
* [Read about Owl Carousel and see demos](http://www.owlcarousel.owlgraphic.com/)
* [Contribute to Owl Carousel 2 on Github](https://github.com/OwlFonk/OwlCarousel2)
* [Found out more about Matt Cromwell, author of this plugin](http://mattcromwell.com)
* [Found out more about Matt Cromwell, author of this plugin](http://mattcromwell.com)

##Screenshots
*Choose Owl Carousel from the "Gallery Template" field in FooGallery*

![FooGallery Owl Carousel Template](https://ps.w.org/foogallery-owl-carousel-template/assets/screenshot-1.png?rev=1064277)

*Custom settings for each Owl Carousel that control items per "stage", margin between items, navigation, pagination and more.*

![Custom settings for each Owl Carousel that control items per "stage", margin between items, navigation, pagination and more.](https://ps.w.org/foogallery-owl-carousel-template/assets/screenshot-2.png?rev=1064277)

*Have multiple types, shapes, sizes and functionalities for multiple galleries on the same page.*

![Have multiple types, shapes, sizes and functionalities for multiple galleries on the same page.
](https://ps.w.org/foogallery-owl-carousel-template/assets/screenshot-3.png?rev=1064277)

*Choose a custom link and target to launch from each image in your Carousel. Combined with FooBox Pro you can launch videos, forms, a Google Map, and more from each individual image in your Carousel.*

![Choose a custom link and target to launch from each image in your Carousel. Combined with FooBox Pro you can launch videos, forms, a Google Map, and more from each individual image in your Carousel.](https://ps.w.org/foogallery-owl-carousel-template/assets/screenshot-4.png?rev=1064277)

*Choose from a plethora of styles and hover effects. See a preview live while you create your gallery.*

![Choose from a plethora of styles and hover effects. See a preview live while you create your gallery.](https://ps.w.org/foogallery-owl-carousel-template/assets/screenshot-5.png?rev=1064277)

##FAQs
**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](http://genericons.com/) 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](https://www.mattcromwell.com/products/foogallery-owl-carousel/).
17 changes: 4 additions & 13 deletions readme.txt
Original file line number Diff line number Diff line change
Expand Up @@ -66,23 +66,10 @@ Assuming you already have [FooGallery](http://wordpress.org/plugins/foogallery)

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

**Where did the Custom Owl Carousel link fields go?**

FooGallery added this ability to it's core, so the Owl fields were superfluous and so were removed, but that functionality still exists, you just need to update your Gallerys to use the FooGallery fields now instead.

**The Owl Carousel JS supports "X" feature, why doesn't this?**

Lots of reasons. I added settings which I felt made the plugin as robust as possible without creating a never-ending page of settings. I really want this template to work well out of the box as easily as possible for the most amount of users possible. That's why I've added all these conditional fields. Users who want more can get more.
But, if you think a feature of the JS is really awesome, let me know in the support forum and I'll evaluate it. I already added both the [break points](https://wordpress.org/support/topic/responsiveness-24?replies=3), and [auto-width](https://wordpress.org/support/topic/keep-image-proportions?replies=5) based on user feedback.

**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.

**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 feel that way, feel free to send me a [tip over here](https://www.mattcromwell.com/products/foogallery-owl-carousel/)

**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.
Expand Down Expand Up @@ -150,6 +137,10 @@ 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](https://www.mattcromwell.com/products/foogallery-owl-carousel/).

== Screenshots ==

1. Choose Owl Carousel from the "Gallery Template" field in FooGallery
Expand Down

0 comments on commit c4349de

Please sign in to comment.