free package
Fully functional, no restrictions
Easy to install on any website
XML customizable
GPL Licensed
Watermarked :
paid package
NO watermark:
plus a Flash component (AS3) which can be used in Flash projects
Features
- finite or infinite scrolling
- supports different thumbs dimensions
- multiple scrolling properties
- customizable speeds on rolling out and over the scroller
- expand/zoom effects on rolling over a thumb
- low CPU usage
- external assets for arrows and preloader
- color and transparency roll over effects
- customizable reflection
- 20 customizable tooltip properties
- supports JPG, PNG, BMP, GIF for the thumbs, configurable through images.xml file
- overall dimensions resizable to the extent of 1680 x 1050
Installation instructions for:
How to install this Image Scroller on your website
Step 1. SWF embedding
Download the image-scroller.zip package and put all the files from this package into the same folder with the HTML file in which you want the component to be embedded.
You should know first of all that the SWF file is the one that actually represents the component, while the other files (settings.xml, images.xml and JPGs in the images folder) are the assets that the SWF file uses.
A short explanation on how SWFs and XMLs interacts you will find here.
Open your HTML file with a text editor and insert somewhere between the <head> </head> tags the following lines:
<script type="text/javascript" src="swfobject.js"></script>
<script type="text/javascript">
var flashvars = {};
var params = {};
params.scale = "noscale";
params.salign = "tl";
params.wmode = "transparent";
var attributes = {};
swfobject.embedSWF("FXImageScroller.swf", "ImageScrollerDiv", "600", "300", "9.0.0", false, flashvars, params, attributes);
</script>
For a fast and easy publishing, the best thing to do is to have the SWF file, the HTML file which embeds the SWF, the swfobject.js file, and the assets that the SWF uses (XMLs, JPGs folder) in the same folder.
If that is not possible, please read this detailed article on how to specify the paths correctly.
The above code itself isn’t enough to publish the SWF file on your webpage. You just need to add a div somewhere in the body section of your page (between the <body> </body> tags of your HTML file).
So, in a specific location of your HTML body section insert this div:
<div id="ImageScrollerDiv"></div>
Step 2. Customization
You’ll be able to define a maximum size of 1680 in width and 1050 in height in the 3rd and 4th arguments of the swfobject.embedSWF() function above. Usually the same values as for width and height on the live demo (which you will set below).
Now you will have to define the properties of your Image Scroller.
You can do that by editing the settings.xml file, or much simpler, set your values on the Live Demo above and press Generate button, then select all (Ctrl+A) and copy-paste over the existing content of settings.xml file.
If you intend to have multiple Image Scrollers on the same page, for the same imagescroller.swf file you’ll need to have different settings. Please read here how publish a component twice on the same page.
Now all you have to do is to put your own images, add the tooltip text and add the behavior for when clicking each image. All these through the images XML file. Open the XML file with a text editor and define in each row the image path, the URL to go to when clicking the image, the target (_self for the same browser window, or _blank for a new browser window), and the tooltip text.
You can have as many images as you like. To add a new image add a new row in the XML file.
To add Lightbox functionality (showing a bigger image and a description when clicking on an image) please read this article.
imagescroller.swf has about 40 KB and embeds only the Verdana font. To be able to embed any other font you’ll need the Image Scroller Flash component.
If you’ll want to use the Image Scroller in Flash projects (FLA files), the Image Scroller is available as a Flash component (MXP file) in the paid package
Instructions on how to use the Image Scroller component in Flash you will find here.
To be able to remove the FlashXML.net label from the top-left corner you will need to purchase the paid package
Make sure your Wordpress version is greater than 2.8 and your hosting provider is using PHP5.
1. There are two files to download:
a. WordPress Plugin that you have to install and activate
b. Free package
2. Create a new folder inside your wp-content folder called flashxml, inside this folder create a new one called image-scroller-fx and copy the content of the free package there
3. If you copied the free package to a location different than the one above, go to Image Scroller FX from the Settings tab from your WordPress Dashboard and update the path accordingly
4. Add [image-scroller-fx][/image-scroller-fx] where you want the Flash to show up in your post/page.
5. If you want to make the Image Scroller FX part of your theme, edit the template files and add <?php imagescrollerfx_echo_embed_code(); ?> where you want it to show up
6. Customize your Image Scroller FX using the Live Demo from the top of this page. Generate the settings.xml text and use it to overwrite wp-content/flashxml/image-scroller-fx/settings.xml
7. To use your own images, upload them to wp-content/flashxml/image-scroller-fx/images and update the wp-content/flashxml/image-scroller-fx/images.xml file accordingly
Additional settings file
To embed the Image Scroller FX 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. Add [image-scroller-fx settings="settings2.xml"][/image-scroller-fx] where you want the Flash to show up in your post/page. If you made the Flash part of your theme, add the file name as the first argument of the imagescrollerfx_echo_embed_code() function call (for example <?php imagescrollerfx_echo_embed_code("settings2.xml"); ?>).
No Flash support text
To support visitors without Adobe Flash Player, you can provide alternative content by adding the text between [image-scroller-fx] and [/image-scroller-fx]. If you made the Flash part of your theme, add the text as the second argument of the imagescrollerfx_echo_embed_code() function call (for example <?php imagescrollerfx_echo_embed_code("","Alternative content"); ?>).
If you have PHP4
To make it work with PHP4, add [image-scroller-fx width="600" height="300"][/image-scroller-fx] where you want the Flash to show up in your post/page. If you made the Flash part of your theme, add the width and height as the third and fourth argument of the imagescrollerfx_echo_embed_code() function call. Don't forget to provide your own width and height values, since 600 and 300 are just examples.
Getting rid of the FlashXML.net label
To remove the FlashXML.net label from the top-left corner you'll need to buy the paid package. Once you'll do that, simply use the SWF file from the paid package to overwrite the SWF file from the wp-content/flashxml/image-scroller-fx/ folder.
Make sure your Joomla version is 1.5 and your hosting provider is using PHP5.
Joomla Module Instructions:
1. There are two files to download (both under GPL License):
a. Joomla Module that you have to install and enable
b. Free package
2. Create a new folder inside your Joomla folder called flashxml, inside this folder create a new one called imagescrollerfx and copy the content of the free package there
3. If you copied the free package to a location different than the one above, update the Path from module's parameters accordingly
4. Customize your Image Scroller FX using the Live Demo from the top of this page. Generate the settings.xml text and use it to overwrite flashxml/imagescrollerfx/settings.xml
Joomla Plugin Instructions:
1. There are two files to download (both under GPL License):
a. Joomla Plugin that you have to install and enable
b. Free package
2. Create a new folder inside your Joomla folder called flashxml, inside this folder create a new one called imagescrollerfx and copy the content of the free package there
3. If you copied the free package to a location different from the one above, update the Path from module's parameters accordingly
4. Add {imagescrollerfx}{/imagescrollerfx} where you want the Flash to show up in your article
5. Customize your Image Scroller FX using the Live Demo from the top of this page. Generate the settings.xml text and use it to overwrite flashxml/imagescrollerfx/settings.xml
6. The default name for the settings file is settings.xml, but if you want to use another file (for example settings2.xml), specify the name like this: {imagescrollerfx settings="settings2.xml"}{/imagescrollerfx} where you want the component to show up in your article
7. In some cases the width and height will not be read from the settings.xml file but you can specify them like this: {imagescrollerfx width="400" height="300"}{/imagescrollerfx}. Don't forget to provide your own width and height values, since 400 and 300 are just examples.
Getting rid of the FlashXML.net label
To remove the FlashXML.net label from the top-left corner you'll need to buy the paid package.
Once you will do that, simply use the SWF file from the paid package to overwrite the SWF file from the flashxml/imagescrollerfx/ folder.
Below you will see instructions on how to install and use the Image Scroller Component in Flash (available for Flash CS3, CS4, and Flash Player 9 or later).
For basic instructions on how to integrate the Image Scroller’s SWF file into HTML/PHP, click here.
You can watch an installation video tutorial of a very similar component in Flash (3D Carousel Menu FX) by clicking here.
In this video you will see:
- how to create an instance of the component on the stage: from the Components panel (Ctrl+F7) drag & drop the component on the stage
- how to give a name to that instance for further use in ActionScript: click on the component instance on the stage and from the Properties panel (Ctrl+F3) enter a name in the text input
- how to access the properties of the component (read or modify) during different moments of your Flash application
Any property of the Component could be accessed that way. The names of the properties are identical with the ones from the settings.xml file.
The properties of the component can be of any of the three types: Number, String, Boolean. We assume it’s intuitive of which type each property is.
Warning! Setting the parameters of the component in the Component Inspector window (Shift+F7) and in the same time having a settings.xml file populated with different values for each property, the properties from the settings.xml file will have priority (meaning that a parameter set in the Component Inspector will be ignored if that parameter is also defined in the XML file)
For now, this component doesn't dispatch events, but stay tuned for an update.
Similar products
Do you have a question?
you will get an answer in 24 hours, tops.
Kadum
Posted 29 Days AgoMy site is made in AS2. Is there any way to convert the scroller, or is there any other scroller in AS2?
Hi,
I’m sorry but we only have this component in AS3.
alessio cristino
Posted 29 Days AgoHi, I installed the module, everything’s ok but the lightbox, it doesn’t starts. I already followed th step 3 of the guide… nothing to do.
some ideas?
Hi,
If you’ll take a look at the source code of the page where you have the Image Scroller you’ll see that there’s nowhere the code specified on step 3 from the Lightbox tutorial. Add it and it will work.
Alex
Posted 29 Days AgoHi,
I don’t know if this has been answered yet, but is there a way to increase the size of the thumbnail images to above 300 pixels tall and 300 pixels wide? Thanks in advance.
Alex
Hi,
You can change those values in your settings.xml file directly and use whatever you want.
Mike
Posted 30 Days AgoWhat do you mean the joomla folder in step 2. I have Joomla installed in the root location.
Hi,
We’re referring to the folder where the joomla folders and files are present.
Mike
Posted 30 Days AgoI am sorry about the link. here it is
I checked the settings.xml and the lightbox is set to true
Thanks
Hello,
You need to follow step 3 from this tutorial.
Andi
Posted 30 Days Agogreat component! im gonna buy this once i able to make it the way i want it. i have 3 questions:
1. im having the same problem with mike. this seems to be a problem with flash security.
2. how do you make the images default-ly runs left instead of right?
3. how can we put a link in the lightbox? ive tried to put xml link script in the “lightboxinfo” but it made the xml not working.
Thanks in advance!
Andi
Hi,
1. im having the same problem with mike. this seems to be a problem with flash security
From where do you load the images?
From the server where the SWF file resides or from a different server?
2. how do you make the images default-ly runs left instead of right?
In your settings.xml file set onRollOutSpeed to a negative value.
3. how can we put a link in the lightbox? ive tried to put xml link script in the “lightboxinfo” but it made the xml not working
The lightbox feature is not created by us.
If you want you could use a different lightbox feature that supports adding a link in the lightbox description.
Thank you.
Mike
Posted 30 Days AgoThis is just what I have been looking for. But I can’t get the thumbnails to open the larger pictures. I have followed all of the instructions. I am not sure if I am missing something or what. I am using Joomla 1.5
Thanks for your help.
Hello,
The link that you gave us appears to be broken so we couldn’t check for sure. However, we’re guessing that you haven’t actived the lightbox. Open the settings.xml file and change the value of the useLightbox attribute to true.
Melker
Posted 31 Days AgoI just bought this, but I have a problem. I want to use the image-scroller on my index-site which is not in the image-scroller folder, but it won’t work unless i put my index-site in the image-scroller folder.
I relinked everything but all I get is an invisible image-scroller, although i am able to right-click and and I can clearly see it’s there because i get the “About Adobe Flash Player 10” option.
How do i solve this?
Thanks! :) Great support
Hi,
You should use folderPath in the embedding code of the index-site page. Please read this tutorial for more info.
Melker
Posted 31 Days AgoHey! Really nice flash application! Will buy it as soon i get to know why the lightbox doesn’t open when i click a thumbnail :(? Haven’t made any changes and it just wont work!
Hi,
You have to add the code from step 3 from this tutorial to the page that embeds the Image Scroller. Make sure you use the absolute path for those files.
daniele
Posted 1 Month AgoThank you so much guys! :)