Plugin Directory

JS Banner Rotate

Create a JavaScript-driven rotating banner image on your WordPress site.

Download Version 1.3.3

How do I pass multiple parameters in the jsbrotate() function?

To pass multiple parameters (height, fadetime, images, etc), separate them with & characters like this: <?php jsbrotate('images=http://blog.url/image2.jpg|http://blog.url/image2.jpg&height=200&width=900'); ?>

How many images can I rotate?

You can have as few as 1 image (which is a bit boring) and as many as you want in the rotation.

Previous versions of the plug-in have limited you to just 5 images ...

Just make sure your list of images is pipe-delimited (use the | key to separate the URLs).

Can they be different sizes?

Yes and no. The slideshow itself will only render at one size (whatever you specify in the shortcode). However, if your images are larger or wider than this setting, they will be resized using the CSS max-width and max-height properties. Basically, they'll be "squished" in whatever direction was larger than the display box. This can be problematic in older web browsers and can break certain complex images, so it's highly recommended that all of your rotating images be the same size.

In any case, the first image in your rotation MUST be the same size as the slideshow. This image is used as a static background (in the event your site visitors don't have Javascript) and can't yet be dynamically resized.

What other options does the shortcode/template tag allow?

You can set several things via the shortcode:

  • Image URLs (images=http://blog.url/image.jpg|http://blog.url/image2.jpg)
  • Slideshow hyperlink (link=http://whateveryouwant.com)
  • Image height and width (height=300 width=300)
  • Image display and fade time (imgdisp=8, imgfade=4)
  • Title visibility (titlevis=true)
  • Title (title=Home)

What are the shortcode/template tag parameter defaults?

  • link = Blog's URL
  • height = WordPress large image default height
  • width = WordPress large image default width
  • imgdisp = 8 seconds
  • imgfade = 4 seconds
  • titlevis = false
  • title = Home

What happened to the image numbers?

The majority of users we spoke with wanted to remove the numbers, so we've eliminated them altogether.

The images rotate too slowly!

You can now change the length of time each image remains on the screen and the amount of time it takes to fade between images. We recommend that the fade time be no more than half the display time, otherwise the images don't stay on the screen for very long at all!

I like the new template tag. Can I put it wherever I want?

No. You must use the template tag after wp_head() and before wp_footer() for it to work!

My banners aren't rotating! / Something isn't working!

Check to make sure you have the wp_head() template tag in your header and the wp_footer tag in your footer. If you're missing either of these tags, the scripts won't work. If you're using the template tag, make sure you've placed it after wp_head() and before wp_footer().

You can only have one rotating banner on any given page. If you're using the banner in your posts, only the first post on the page will rotate!

Requires: 2.8 or higher
Compatible up to: 3.1.4
Last Updated: 2011-2-6 Downloads: 16,651

Average Rating

5 stars
4 stars
3 stars
2 stars
1 star
(8 ratings)

Compatibility

+
=
Not enough data

0 people say it works.
1 person says it's broken.

Log in to vote.

100,1,1
100,2,2
100,1,1
100,1,1 100,1,1
50,2,1 100,1,1
100,1,1 100,2,2 50,2,1
25,4,1
20,5,1
100,1,1
100,1,1
100,1,1
100,1,1
0,1,0