Note that you will need to upload your images separately using WordPress’ built-in image gallery feature.
This section describes how to install the plugin and get it working.
- Upload the entire
js-banner-rotatefolder to the
- Activate the plugin through the ‘Plugins’ menu in WordPress
[jsbrotate images=image1url|image2url... /]on your pages/posts
- Optionally, you can place the function
<?php jsbrotate(images=image1|image2...); ?>in your templates to call the banner
The shortcode/template tag accepts several parameters …
Specify your images in a pipe-delimited list:
Link your entire banner to a specific page on the site or to an external URL:
Give your banner a title so people know what it’s about:
Height and Width
Specify the dimensions of your banner. All images not already at these proportions will be stretched/scaled to fix:
Display and Fade Duration
Manage the length of time each image is displayed on the screen and the length of time it takes to fade between them:
- 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.
- 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_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
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).
Contributors & Developers
“JS Banner Rotate” is open source software. The following people have contributed to this plugin.Contributors
- Fix a JS scope issue preventing the fade duration setting from propogating to the script.
- Fix an error where deprecated arguments were flagged with the wrong function.
- Refactor display system to use a pluggable template.
- Deprecate older
- Switch to jQuery (issue 1)
- Fix white background image (issue 2)
- Contextual script inclusion and execution (issue 3)
- Upgrade to PHP5 OOP syntax
- Fix an exotic IE7 bug related to linking to images.
- Removes insecure Elliot RPC integration
- Fixed calls to deprecated functions
- Overhauled system to integrate advanced error reporting
- Updated and improved documentation
- Fixed CSS typo for .banner-container definition
- Updated documentation for PHP function call
- Tested to WordPress version 2.9.1
- Modified GPL references to restrict to version 2 only
- Allows the use of more than 5 images
- Removed image numbers
- Fixes IE CSS display problem
- Adds the ability to change the color of the image numbers
- Adds the ability to toggle the image numbers on and off
- Adds the ability to change the timing of the image display and fade
- Adds template tag
- Changes default image sizing to match WordPress defaults
- Adds the ability to toggle the banner title on and off
- Cleans up CSS to prevent interference with other plug-ins
- Updates readme.txt to explain required/optional shortcode parameters and defaults
- Tests compatability with WP 2.8.1
- First release