Create a JavaScript-driven rotating banner image on your WordPress site.
This plugin uses JavaScript to create a platform-agnostic rotating banner image for your website. Unlike similar Flash implementations, this feature will work even on Flash-disabled web browsers.
Note that you will need to upload your images separately using WordPress' built-in image gallery feature.
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.
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!
I think I found a bug! / I want to request a change!
If you thing you’ve found something going wrong with the plugin, or if there’s a feature you’d like added or changed, please create a new issue on GitHub: https://github.com/ericmann/JS-Banner-Rotate/issues
Where can I go for more support?
This plugin is offered without any warranty or express user support.
If you’ve found a bug, please report it on GitHub (https://github.com/ericmann/JS-Banner-Rotate/issues).
If you can’t figure out how to do something please feel free to ask around in the community support forums (https://wordpress.org/support/plugin/js-banner-rotate).