Usage Instuctions

Setting up the "AJAX Header Rotator" Module

The "AJAX Header Rotator" module offers a smart and eye-candy image rotating mechanism (or slideshow in plain English) for the masses! It is an alternative to Flash image rotation scripts, which are sometimes difficult to implement. The module borrows the nice effects from such scripts, but uses javascript (the JQuery library in particular) to auto-"magically" rotate images from any given folder!

It's actually a simple to use module, which adds to the overall look of your Joomla! website.

Check out a demo HERE and at Cinemad for a real world example!

So how do we setup the module? First of all, create a folder anywhere in your Joomla site. Prefer to do this under images/stories, so that you want stumble upon file permission issues! Create for example a folder named headers inside images/stories. Now add the full path to this newly created folder in the parameters below. The path would be images/stories/headers.

Fill in below a unique ID for this image rotator (this allows to have multiple rotators at once), adjust the speed and timeout of the rotation as well as the target width and height of your images and that's it! Publish the module in an existing position and enjoy! You can also choose to display images in sequence or randomly and even add a link to some URL, e.g. a link to your products page (when your rotator displays product images).

It doesn't get any simpler!

Changelog

CHANGELOG

• Minor code fixes.
• Fixed the "bullet" issue, occuring in some users' websites (due to CSS conflicts with their template).

• Fixed the "cannot redeclare..." error message showing up in some server setups (minority).

• Minor bug fixes.
• Now the AJAX Header Rotator can display without conflicting with other javascript libraries, like Mootools, Moo.fx, Prototype etc. The only thing you need to do is move the script call to jquery.js in your template. For more, check out JoomlaWorks.gr.
• You can now choose to enable/disable the "master" link of the rotating images.
• If you enable the "master link", you can now choose if it will open in a new or the same page.

• Added the ability to have multiple instances of the "AJAX Header Rotator" module in the same page. That means you can rotate images in different module positions, on the same page, something that was not possible with the previous version of the module! You obviously need to insert different IDs for each module instance!
• Added a "master" link to the rotating images (per rotator instance, of course). Useful when you want the user to click on the rotator and get redirected to e.g. the "products" page.
• Added width and height definitions for images being rotated.
• Added the ability for the user to select the display order of the images being rotated (in sequence or randomly).
• Updated documentation to reflect new changes and additional credits/copyrights.

Credits

CREDITS

The development of the "AJAX Header Rotator" Module is based on work by Medienfreunde and the very popular JQuery Javascript library.

About

FOR INFO, UPDATES, REQUESTS & CONTACT

Check out JoomlaWorks.gr, the official website of this Joomla extension and home to other popular ones, like the AJAX Newsflash Module, the AllVideos Plugin or the Tabs In Content Items Plugin.

JoomlaWorks.gr is the place to read interesting articles or find useful tips and tutorials for the Joomla! CMS and web design/development in general. At JoomlaWorks.gr you can always download the latest software updates as well as post comments, requests or even discuss the extension.

Thank you for your support!

This extension is released under the GNU/GPL license.

(Last update: January 6th, 2007 - version 2.3)