=== Image Scroller FX ===
Contributors: flashxml
Tags: images, photos, widget, post, plugin, posts, sidebar, free, flash, scroll, zoom, text, effects, preloader, as3, vertical, horizontal, gallery, portfolio, thumb, image, roll, over, out
Requires at least: 2.8.0
Tested up to: 2.9.2
Stable tag: trunk

== Description ==

Maybe the most advanced Image Scroller. Fully XML customizable. And free! Embed it in your posts, pages, feed and themes!

= Main features =

The Image Scroller FX can be embedded in any website for free without even using Flash. It can have an overall width and height up to 1680 x 1050 pixels.
It supports the following files: JPG, PNG, BMP, GIF for the thumbs, which are configurable through the images.xml file.
The Scroller can be set to have infinite or finite scrolling, supporting different thumbs dimensions.
There are a multiple highly customizable scroll properties like speed (on roll over or roll out), reflection, tooltip properties etc.
On roll over can be applied different effects like: zooming, transparence, color saturation. An important thing is the low CPU usage for an extremely large number of thumbs.
It has almost 60 configurable properties through a settings.xml file.

== Installation ==

Make sure your Wordpress version is equal or greater than 2.8 and your hosting provider is using PHP5.

1. Upload the `image-scroller-fx` directory along with all its files to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. In the post editor use the following tag to embed the Image Scroller: `[image-scroller-fx][/image-scroller-fx]`. Or add `<?php imagescrollerfx_echo_embed_code(); ?>` in your templates
4. Go to [FlashXML.net](http://www.flashxml.net/ "Free Flash Components") and [customize your Image Scroller](http://www.flashxml.net/image-scroller.html "Image Scroller") using the Live Demo. Generate the `settings.xml` text and use it to overwrite `image-scroller-fx/component/settings.xml`
5. To use your own images, upload them to the `image-scroller-fx/component/images` directory and update the `image-scroller-fx/component/images.xml` file accordingly

= No Flash support text =

To support visitors without Adobe Flash, you can provide alternative textual content. From the post editor, add the text between `[image-scroller-fx]` and `[/image-scroller-fx]`. From the PHP files of your theme, add the text as *the first argument* of the `imagescrollerfx_echo_embed_code()` function call.

= Additional settings file =

To embed the Image Scroller more than once, you will need another settings file and (probably) another set of images. Let's assume your new file is called **settings2.xml**. From the post editor, use the following code: `[image-scroller-fx settings="settings2.xml"][/image-scroller-fx]`. From the PHP files of your theme, add the file name as *the second argument* of the `imagescrollerfx_echo_embed_code()` function call. If you use a separate set of images, don't forget to create a new XML file for that and update the `imagesXML` value in the settings file.

== Screenshots ==

1. The Live Demo on [FlashXML.net](http://www.flashxml.net/image-scroller.html "Image Scroller") is the utility that helps easily customize your Image Scroller to fit all of your needs.
2. Change the orientation if you want to use it in your sidebar.
3. Create special effects for the mouse roll over and out on the selected image.
4. Add custom scrolling controls.