FAQs

Because everyone has questions.

What is this "jQuery" you speak of?

jQuery is the most popular Javascript framework used today. It is used mostly for DOM manipulation (animating divs, changing dimensions, calculating positioning, etc..). However, it can be used for much more than that, such as AJAX, form validation, etc.. Almost every project in which I have played a role has used jQuery. So get to know it!

Nothing is working. What am I doing wrong?

Here is a list of things to check that should solve most "not working" problems:

  • Is the jQuery library included in the <head> of the document?
  • The jQuery library needs to be included BEFORE the jquery.bxslider.min.js file.
  • Is the jquery.bxslider.min.js file linked properly? Usually people will upload the file to a js directory, then link to it like so: <script src="js/jquery.bxslider.min.js"></script>
  • Using Firebug (http://getfirebug.com/), check the console for any errors. Any Javascript errors can and will prevent the slider from functioning properly.
  • Are you calling .bxSlider() inside of a $(document).ready() call? For more info on the .ready() call, click here.

Does the parent element have to have the class "bxslider"?

Nope! The slider does not care if the parent element (<ul> in the homepage example) has a classname. Simply target the parent element using any jQuery selector you desire. The following example is a completely legit slider setup:

HTML:

Child 1
Child 2
Child 3

JS:

$(document).ready(function(){
  $('#foobar').bxSlider();
});

Can I have more than one slideshow on a page?

You betcha. Check out the example.

My carousel is all jacked. What gives?

When using a horizontal carousel (displaying multiple slides at once) the following three settings MUST be defined (vertical carousels can omit maxSlides):

  • minSlides
  • maxSlides
  • slideWidth

Also remember that all slides should be the same width.

Why isn't my video responsive?

To make all videos in a slider responsive, make sure the following is true:

  • In the <head> of the document include the file: plugins/jquery.fitvids.js
  • Specify the following option: video: true

Why don't the "Next" / "Prev" controls appear in the theme?

The theme's images rely on the "images" folder included in the bxSlider package. Make sure that the "images" folder is in the same location as the jquery.bxslider.css file.

I hate your theme. Do I have to use it?

Absolutely not! Simply do not include the jquery.bxslider.css file and you will have a bare-bones slider, with no theme. Feel free to make yours look cooler than mine.

What browsers are supported?

All modern versions of Firefox, Chrome, Safari, iOS, Android, and Internet Explorer have been tested and are supported. IE8 and IE7 have been tested and work just fine. But if you're supporting IE8 and below, have mercy on your poor soul.

What does "responsive" mean?

Instead of trying to concoct my own lame definition, learn from the pros by clicking here.

Can I include your slider in my commercial WordPress theme? Do I have to pay you? Is thing really free?

The bxSlider is released under the WTFPL license - http://sam.zoy.org/wtfpl/ (love the name BTW). This means that you can literally do whatever you want with this plugin. If you like it and use it, buy me a beer for crying out loud!