Installation instructions for:

Download the image-scroller.zip package, extract it and copy all the resulted files and folders in the same location as the web page in which you want the product to be displayed. As an alternative, you can copy all the resulted files and folders in a different folder.

From the downloaded package, the SWF file represents the actual product while the other files (XMLs, images) are the assets that the SWF file uses. A short explanation how SWFs and XMLs interacts can be found here.

Open the HTML file with a text editor (like Notepad or TextEdit) and add the following code where you want the product to be displayed:

Don't forget to replace the 600 and 220 from the swfobject.embedSWF() function above with your own width and height that you specified in the settings.xml file through componentWidth and componentHeight elements. Also, don't forget to update the paths as specified in this FAQ article if you copied the product's files in a different folder.

CUSTOMIZATION

You can customize the Image Scroller FX using the Live Demo above and then download the image-scroller.zip package with the changes you've made or you can edit the settings.xml file with a text editor.

To use your own images, edit the images.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 text between CDATA tags. Here's an example:

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 in 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 fximagescroller_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. Download the ZIP file and use the included settings.xml file 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 fximagescroller_echo_embed_code() function call (for example <?php fximagescroller_echo_embed_code("settings2.xml"); ?>).

Add as widget

To add the Image Scroller FX as a widget, go to Widgets from the Appearance tab in your WordPress Dashboard, then drag and drop the Image Scroller FX from Available Widgets to the widget area you want. You can specify a different settings.xml file and an alternative content for users without Adobe Flash Player from the widget's settings.

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 fximagescroller_echo_embed_code() function call (for example <?php fximagescroller_echo_embed_code("", "Alternative content"); ?>).

Change WMODE

By default, the WMODE value is transparent but you can change it to window from the Image Scroller FX in the Settings tab in your WordPress Dashboard. For widgets, this can be done from the widget's settings. If you want to have a different WMODE value in a specific place, it can be done like this: [image-scroller-fx wmode="window"][/image-scroller-fx]. If you're using the PHP function, here's an example on: <?php fximagescroller_echo_embed_code("", "", 0, 0, "window"); ?>.

If you have PHP4

To make it work with PHP4, add [image-scroller-fx width="400" 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 fximagescroller_echo_embed_code() function call. 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'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.

1. Download the free package. You need to host all the included files from the package on your own domain because Facebook doesn't allow file hosting.

Don't forget to use your own URL for the product's location, name, width and height.

7. Click preview to see how it looks or save changes. The product is now added to the Welcome tab of your page.

8. Optional: To change the tab's name, called by default Welcome, edit your page, go to the Apps tab and click Edit Settings option next to the Static HTML: iframe tabs application to enter the name you want.

To remove the FlashXML.net label from the top-left corner you'll need to buy the paid package. Once you do that, simply use the SWF file from the paid package to overwrite the SWF file from the location where you hosted all the files from the free package.

The module is used for adding the product in one or more pages in a given position (e.g. top, bottom, sidebar) while the plugin is used for adding the product inside a specific article.

You can see an example on how to install a module in your Joomla 1.5 website here, how to install a plugin in your Joomla 1.5 website here, how to install a module in your Joomla 1.6 website here and how to install a plugin in your Joomla 1.6 website here.

Make sure your Joomla version is at least 1.5 and your hosting provider is using PHP5.

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 plugin'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. Download the ZIP file and use the included settings.xml file 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.

No Flash support text

To support visitors without Adobe Flash Player, you can provide alternative content by adding the text between {imagescrollerfx} and {/imagescrollerfx}.

Changing WMODE

By default, the WMODE value is transparent but you can change it to window from the module/plugin's parameters. If you want to have a different WMODE value in a specific article, it can be done like this: {imagescrollerfx wmode=window}{/imagescrollerfx}.

Getting rid of the FlashXML.net labelTo 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.

The Image Scroller FX component is available for Flash CS3, CS4, CS5, CS5.5 and requires Flash Player 9 or later. To use this product in Flash you need the MXP file that is available only in the paid package.

You can see an example of how to install a component in Flash Professional 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 an 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 any of these 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).

Maybe the most useful information consists in the events the component is dispatching. Instructions on how to catch these events can be found here.

Find out what license you need

Will the component be used in a project owned by a company?

Yes

No

Will the component be used in a project that will generate any sort of income?

Yes

No

Do you plan on using the component in multiple projects?

Yes

No

Do you plan on using the component for different persons/companies/clients?

Yes

No

You are not allowed to include this product in applications that are for sale.

You are not allowed to directly or indirectly license, sub-license, distribute, redistribute, sell or resell this product

Find out what license you need

We have determined that you need the Personal License for your project.

Use in a single non-commercial projectProject can be owned by you or your client

Unlimited use in the same projectUse it on any page of the same project

Use the product in multiple projects of your ownYou will need a Special License

Use the product in multiple projects of your clientsYou will need an Extended License

The “Personal License (single use)” grants you a non-exclusive and non-transferable right to make use of this product in a single non-commercial* website (or application**), your own work or client work.

* A non-commercial application is an application which is not owned by

a company, even if the application in which this product will be included does not directly generate income

an individual, when the application in which this product will be included generates income in any form (i.e. a website with paid advertising)

** An application can be a website, a software, an electronic document such as a PowerPoint presentation or an e-book, a printed document, a video production

There is no restriction on the number of copies of this product within the same application. For example, with one Personal License you can include this product in all the pages of your website. But you will need two Personal Licenses for two different websites.

If you want to use this product in multiple non-commercial applications owned by:

you or your non-profit organization - you must purchase a Personal License for each different application OR you can purchase the Special License

your clients - you must purchase a Personal License for each different application. The Special License does not apply in this case. If you want to use this product in an unlimited number of applications owned by your clients you must purchase the Extended License.

Use the product in multiple projects of your ownYou will need a Special License

Use the product in multiple projects of your clientsYou will need an Extended License

The “Commercial License (single use)” grants you a non-exclusive and non-transferable right to make use of this product in a single commercial* website (or application**), your own work or client work.

* A non-commercial application is an application which is not owned by

a company, even if the application in which this product will be included does not directly generate income

an individual, when the application in which this product will be included generates income in any form (i.e. a website with paid advertising)

** An application can be a website, a software, an electronic document such as a PowerPoint presentation or an e-book, a printed document, a video production

There is no restriction on the number of copies of this product within the same application. For example, with one Commercial License you can include this product in all the pages of your website. But you will need two Commercial Licenses for two different commercial websites.

If you want to use this product in multiple commercial applications owned by:

you or your company - you must purchase a Commercial License for each different application OR you can purchase the Special License

your clients - you must purchase a Commercial License for each different application. The Special License does not apply in this case. If you want to use this product in an unlimited number of applications owned by your clients you must purchase the Extended License.

Use the product in multiple projects of your clientsYou will need an Extended License

The “Special License (multiple use)” grants you a non-exclusive and non-transferable right to make use of this product in multiple commercial OR non-commercial websites (or applications*), your own work.

* An application can be a website, a software, an electronic document such as a PowerPoint presentation or an e-book, a printed document, a video production

If you want to use this product in multiple non-commercial or commercial applications owned by your clients you must purchase a Personal or Commercial License for each different application or you can purchase the Extended License.

Publicly advertise that you are offering this productDo not mention our product as one of your tools of service

Include this product in applications that are for saleContact Us if you are not not sure your project complies with our Licenses

License, distribute or sell this productThis also applies for sub-licensing, redistribution or reselling.

The “Extended License (multiple use)” grants you a non-exclusive and non-transferable right to make use of this product in multiple commercial or non-commercial websites (or applications*), your own work or client work.

* An application can be a website, a software, an electronic document such as a PowerPoint presentation or an e-book, a printed document, a video production

Use the product in multiple projects of your ownYou will need a Special License

Use the product in multiple projects of your clientsYou will need an Extended License

The “Personal License (single use)” grants you a non-exclusive and non-transferable right to make use of this product in a single non-commercial* website (or application**), your own work or client work.

* A non-commercial application is an application which is not owned by

a company, even if the application in which this product will be included does not directly generate income

an individual, when the application in which this product will be included generates income in any form (i.e. a website with paid advertising)

** An application can be a website, a software, an electronic document such as a PowerPoint presentation or an e-book, a printed document, a video production

There is no restriction on the number of copies of this product within the same application. For example, with one Personal License you can include this product in all the pages of your website. But you will need two Personal Licenses for two different websites.

If you want to use this product in multiple non-commercial applications owned by:

you or your non-profit organization - you must purchase a Personal License for each different application OR you can purchase the Special License

your clients - you must purchase a Personal License for each different application. The Special License does not apply in this case. If you want to use this product in an unlimited number of applications owned by your clients you must purchase the Extended License.

Click here to make the Extended License visible in the list of licenses under the paid package. Please read its full license terms before purchasing.

You are not allowed to include this product in applications that are for sale.

You are not allowed to directly or indirectly license, sub-license, distribute, redistribute, sell or resell this product

Personal License (single use)

Use in a single non-commercial projectProject can be owned by you or your client

Unlimited use in the same projectUse it on any page of the same project

Use the product in multiple projects of your ownYou will need a Special License

Use the product in multiple projects of your clientsYou will need an Extended License

The “Personal License (single use)” grants you a non-exclusive and non-transferable right to make use of this product in a single non-commercial* website (or application**), your own work or client work.

* A non-commercial application is an application which is not owned by

a company, even if the application in which this product will be included does not directly generate income

an individual, when the application in which this product will be included generates income in any form (i.e. a website with paid advertising)

** An application can be a website, a software, an electronic document such as a PowerPoint presentation or an e-book, a printed document, a video production

There is no restriction on the number of copies of this product within the same application. For example, with one Personal License you can include this product in all the pages of your website. But you will need two Personal Licenses for two different websites.

If you want to use this product in multiple non-commercial applications owned by:

you or your non-profit organization - you must purchase a Personal License for each different application OR you can purchase the Special License

your clients - you must purchase a Personal License for each different application. The Special License does not apply in this case. If you want to use this product in an unlimited number of applications owned by your clients you must purchase the Extended License.

Click here to make the Extended License visible in the list of licenses under the paid package. Please read its full license terms before purchasing.

You are not allowed to include this product in applications that are for sale.

You are not allowed to directly or indirectly license, sub-license, distribute, redistribute, sell or resell this product

Use the product in multiple projects of your ownYou will need a Special License

Use the product in multiple projects of your clientsYou will need an Extended License

The “Commercial License (single use)” grants you a non-exclusive and non-transferable right to make use of this product in a single commercial* website (or application**), your own work or client work.

* A non-commercial application is an application which is not owned by

a company, even if the application in which this product will be included does not directly generate income

an individual, when the application in which this product will be included generates income in any form (i.e. a website with paid advertising)

** An application can be a website, a software, an electronic document such as a PowerPoint presentation or an e-book, a printed document, a video production

There is no restriction on the number of copies of this product within the same application. For example, with one Commercial License you can include this product in all the pages of your website. But you will need two Commercial Licenses for two different commercial websites.

If you want to use this product in multiple commercial applications owned by:

you or your company - you must purchase a Commercial License for each different application OR you can purchase the Special License

your clients - you must purchase a Commercial License for each different application. The Special License does not apply in this case. If you want to use this product in an unlimited number of applications owned by your clients you must purchase the Extended License.

Click here to make the Extended License visible in the list of licenses under the paid package. Please read its full license terms before purchasing.

You are not allowed to include this product in applications that are for sale.

You are not allowed to directly or indirectly license, sub-license, distribute, redistribute, sell or resell this product

Commercial License (single use)

Use in a commercial projectProject can be owned by you or your client

Unlimited use in the same projectUse it on any page of the same project

Use the product in multiple projects of your ownYou will need a Special License

Use the product in multiple projects of your clientsYou will need an Extended License

The “Commercial License (single use)” grants you a non-exclusive and non-transferable right to make use of this product in a single commercial* website (or application**), your own work or client work.

* A non-commercial application is an application which is not owned by

a company, even if the application in which this product will be included does not directly generate income

an individual, when the application in which this product will be included generates income in any form (i.e. a website with paid advertising)

** An application can be a website, a software, an electronic document such as a PowerPoint presentation or an e-book, a printed document, a video production

There is no restriction on the number of copies of this product within the same application. For example, with one Commercial License you can include this product in all the pages of your website. But you will need two Commercial Licenses for two different commercial websites.

If you want to use this product in multiple commercial applications owned by:

you or your company - you must purchase a Commercial License for each different application OR you can purchase the Special License

your clients - you must purchase a Commercial License for each different application. The Special License does not apply in this case. If you want to use this product in an unlimited number of applications owned by your clients you must purchase the Extended License.

Click here to make the Extended License visible in the list of licenses under the paid package. Please read its full license terms before purchasing.

You are not allowed to include this product in applications that are for sale.

You are not allowed to directly or indirectly license, sub-license, distribute, redistribute, sell or resell this product

Use the product in multiple projects of your clientsYou will need an Extended License

The “Special License (multiple use)” grants you a non-exclusive and non-transferable right to make use of this product in multiple commercial OR non-commercial websites (or applications*), your own work.

* An application can be a website, a software, an electronic document such as a PowerPoint presentation or an e-book, a printed document, a video production

If you want to use this product in multiple non-commercial or commercial applications owned by your clients you must purchase a Personal or Commercial License for each different application or you can purchase the Extended License.

Click here to make the Extended License visible in the list of licenses under the paid package. Please read its full license terms before purchasing.

You are not allowed to include this product in applications that are for sale.

You are not allowed to directly or indirectly license, sub-license, distribute, redistribute, sell or resell this product

Special License (multiple use)

Use in an unlimited number of projectsProject can be owned by you or your client

Use the product in multiple projects of your clientsYou will need an Extended License

The “Special License (multiple use)” grants you a non-exclusive and non-transferable right to make use of this product in multiple commercial OR non-commercial websites (or applications*), your own work.

* An application can be a website, a software, an electronic document such as a PowerPoint presentation or an e-book, a printed document, a video production

If you want to use this product in multiple non-commercial or commercial applications owned by your clients you must purchase a Personal or Commercial License for each different application or you can purchase the Extended License.

Click here to make the Extended License visible in the list of licenses under the paid package. Please read its full license terms before purchasing.

You are not allowed to include this product in applications that are for sale.

You are not allowed to directly or indirectly license, sub-license, distribute, redistribute, sell or resell this product

Publicly advertise that you are offering this productDo not mention our product as one of your tools of service

Include this product in applications that are for saleContact Us if you are not not sure your project complies with our Licenses

License, distribute or sell this productThis also applies for sub-licensing, redistribution or reselling.

The “Extended License (multiple use)” grants you a non-exclusive and non-transferable right to make use of this product in multiple commercial or non-commercial websites (or applications*), your own work or client work.

* An application can be a website, a software, an electronic document such as a PowerPoint presentation or an e-book, a printed document, a video production

You are not allowed to include this product in applications that are for sale.

You are not allowed to directly or indirectly license, sub-license, distribute, redistribute, sell or resell this product

Extended License (multiple use)

Use in an unlimited number of projectsProject can be owned by you or your client

Publicly advertise that you are offering this productDo not mention our product as one of your tools of service

Include this product in applications that are for saleContact Us if you are not not sure your project complies with our Licenses

License, distribute or sell this productThis also applies for sub-licensing, redistribution or reselling.

The “Extended License (multiple use)” grants you a non-exclusive and non-transferable right to make use of this product in multiple commercial or non-commercial websites (or applications*), your own work or client work.

* An application can be a website, a software, an electronic document such as a PowerPoint presentation or an e-book, a printed document, a video production

You are not allowed to include this product in applications that are for sale.

You are not allowed to directly or indirectly license, sub-license, distribute, redistribute, sell or resell this product

I’ve just bought your components.
Is it possible to bypass the image.xml file and to provide the images using ActionScript? Using an image.xml is not an option for me because my images are generated dynamicaly.

Hi,

This feature is not implemented.
Anyway we could implement it for you but this means custom work and for custom work we charge an extra fee.
If you are interested please let me know.

Jules

Posted 4 years ago

Hi..Back again.

I’ve been trying to change the width of the imagescroller – it is at the moment set to 500 and working fine. I want it to be wider than this but when I set it to more than 500 it stops working?

Do you know if this is a bug?

Thanks

Hi,

What do you mean by it stops working ?
Could you show me an example?

Anuag Katoch

Posted 4 years ago

Can we control the scrolling speeding. I use jquery for this in my website <a href=“http://www.nightlifeblues.com”>Nightlifeblues</a>

Hi,

Sure, for example if you’ll check the above live demo you’ll see that there is a property called onRollOutSpeed.
This property controls the speed when you are with the mouse out.
To control the speed when you are with the mouse over the scroller, you have a property onRollOverSpeed.
This two properties can be customized using an XML file called settings.xml.

Jules

Posted 4 years ago

Hi,

Please disregard my last post I have found the solution.

Anyone wanting to edit the speed of the imagescroller increase of decrease the onrolloutspeed value :)

Thanks

Jules

Posted 4 years ago

Hello,

Is there anyway of slowing down the image scroll? I’ve noticed that the images slow down when set to a larger thumbsize setting but I want them to move slower at the size I have them ( currently 130px x 130px ) so that customers can see them better. when currently looking at the image scroll – it tends to hurt your eyes.