# Media Slideshow FX

Published on Jul. 9th 2010

## Features

Version 1.0.9.8485 - 18.04.2012 (view changelog)

- autoplay functionality
- supports JPG, BMP, PNG, GIF, SWF and FLVs
- customizable playlist position and orientation
- customizable widths and heights for the whole application
- multiple image transitions and text effects customizable using Image Transition Generator and Text Effects Generator
- playlist roll over/out effects
- the text is HTML/CSS formatted
- you can have text on playlist and over the images
- a lot of other customizable properties on the Live Demo

## Installation instructions for:

Download the media-slideshow.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:

<div id="DivMediaSlideshowFX"></div>
<script type="text/javascript" src="swfobject.js"></script>
<script type="text/javascript">
var flashvars = {};
var params = {};
params.base = "";
params.scale = "noscale";
params.salign = "tl";
params.wmode = "transparent";
params.allowFullScreen = "true";
params.allowScriptAccess = "always";
swfobject.embedSWF("MediaSlideshowFX.swf", "DivMediaSlideshowFX", "600", "300", "9.0.0", false, flashvars, params);
</script>

Don't forget to replace the 600 and 300 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 Media Slideshow FX using the Live Demo above and then download the media-slideshow.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 big.xml(responsible for the bigger images) and the thumbs.xml(responsible for the smaller images) files 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 to add images for big.xml:

<photo image="images/big/101.jpg" url="http://www.flashxml.net"><![CDATA[<head>Hello</head><body>world</body>]]></photo>

Here's an example to add videos for big.xml:

<video media="video/101.flv" image="video/101.jpg" skin="assets/skins/videoSkin1.xml" backColor="0x000000" backAlpha="1" autoplay="false" defaultVolume="50"></video>

Here's an example for thumbs.xml (NOTE: you can't add url for thumbs images):

<photo image="images/thumbs/101.jpg"><![CDATA[Hello]]></photo>

You can have as many images as you like. To add a new image, add a new row in the XML files.

If you want to get rid of the flashxml.net label from the top-left corner visible in the free version you have to purchase the product and use the paid version instead.

You can see an example on how to add a product in your Wordpress article/page here and how to add it in your theme or as a widget here.

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

a. WordPress Plugin that you have to install and activate

2. Create a new folder inside your wp-content folder called flashxml, inside this folder create a new one called media-slideshow-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 Media Slideshow FX from the Settings tab in your WordPress Dashboard and update the path accordingly

4. Add [media-slideshow-fx][/media-slideshow-fx] where you want the Flash to show up in your post/page

5. If you want to make the Media Slideshow FX part of your theme, edit the template files and add <?php fxmediaslideshow_echo_embed_code(); ?> where you want it to show up

6. Customize your Media Slideshow 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/media-slideshow-fx/settings.xml

7. To use your own images, upload them to wp-content/flashxml/media-slideshow-fx/images and update the wp-content/flashxml/media-slideshow-fx/images/thumbs.xml and wp-content/flashxml/media-slideshow-fx/images/big.xml

To embed the Media Slideshow 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 [media-slideshow-fx settings="settings2.xml"][/media-slideshow-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 fxmediaslideshow_echo_embed_code() function call (for example <?php fxmediaslideshow_echo_embed_code("settings2.xml"); ?>).

To add the Media Slideshow FX as a widget, go to Widgets from the Appearance tab in your WordPress Dashboard, then drag and drop the Media Slideshow 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 [media-slideshow-fx] and [/media-slideshow-fx]. If you made the Flash part of your theme, add the text as the second argument of the fxmediaslideshow_echo_embed_code() function call (for example <?php fxmediaslideshow_echo_embed_code("", "Alternative content"); ?>).

Change WMODE

By default, the WMODE value is transparent but you can change it to window from the Media Slideshow 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: [media-slideshow-fx wmode="window"][/media-slideshow-fx]. If you're using the PHP function, here's an example on: <?php fxmediaslideshow_echo_embed_code("", "", 0, 0, "window"); ?>.

If you have PHP4

To make it work with PHP4, add [media-slideshow-fx width="400" height="300"][/media-slideshow-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 fxmediaslideshow_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/media-slideshow-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.

3. Search for the Static HTML: iframe tabs application and select it.

4. Click on Add Static HTML to a page button and you'll be prompted for the page where you want the app to be added.

5. Once added you'll see on the left side menu of your page a new tab with a star icon called Welcome. Click on it to edit it.

6. Add the following HTML embedding code in the text field:

<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/swfobject/2.2/swfobject.js"></script>
<script type="text/javascript">
var flashvars = {};
flashvars.folderPath = "http://www.yourdomain.com/product_folder/";
var params = {};
params.scale = "noscale";
params.salign = "tl";
params.wmode = "transparent";
params.allowScriptAccess = "always";
params.allowFullScreen = "true";
var attributes = {};
swfobject.embedSWF("http://www.yourdomain.com/product_folder/ProductName.swf", "DivFlashComponent", "600", "400", "9.0.0", false, flashvars, params, attributes);
</script>
<div id="DivFlashComponent"></div>


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.

9. Optional: To make the tab your default landing tab (first thing your visitors see on your page) edit your page and go to the Manage Permissions tab and change the Default Landing Tab.

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 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.

Joomla Module Instructions:

a. Joomla Module (version 1.5 or version 1.6, 1.7 & 2.5) that you have to install and enable

2. Create a new folder inside your Joomla folder called flashxml, inside this folder create a new one called mediaslideshowfx 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 Media Slideshow 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/mediaslideshowfx/settings.xml

Note that the Joomla Module can only be used once in your website.

Joomla Plugin Instructions:

a. Joomla Plugin (version 1.5 or version 1.6, 1.7 & 2.5) that you have to install and enable

2. Create a new folder inside your Joomla folder called flashxml, inside this folder create a new one called mediaslideshowfx 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 {mediaslideshowfx}{/mediaslideshowfx} where you want the Flash to show up in your article

5. Customize your Media Slideshow 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/mediaslideshowfx/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: {mediaslideshowfx settings=settings2.xml}{/mediaslideshowfx} 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: {mediaslideshowfx width=400 height=300}{/mediaslideshowfx}. 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 {mediaslideshowfx} and {/mediaslideshowfx}.

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: {mediaslideshowfx wmode=window}{/mediaslideshowfx}.

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/mediaslideshowfx/ folder.

The Media Slideshow FX component is available for Flash CS4, CS5, CS5.5 and requires Flash Player 10 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).

For now, this component does not dispatch events, but stay tuned for an update.

### free package

• Fully functional, no restrictions

• Easy to install on

• XML customizable

• Watermarked :

### how to install

Hello

I dont find the reason why this is happening, the thing is that the playlist does not appear when I upload the component to my server, in my local server it works perfectly, I alredy cheked all the files, all of them are on my server, and in the right position, the image slideshow works all right, just the thumbs are the ones that doesnt appear.

Hi,

You are missing the favorites-text.xml file from assets/transitions folder. You need to upload this file and to write the correct path to it, through the * <textEff>* attribute in settings.xml.
e.g:

 <textEff value="assets/transitions/favorites-text.xml"/>

Hello

How can i make this component fullscreen like the galleries??

Hi,

I’m sorry but this feature is not implemented.

I installed this as a module in Joomla and updated the xml files to load my own custom pictures and videos. When I preview the swf file natively on my computer it works perfectly. However, when I upload the directory and install the module in Joomla it appears but somehow it is referencing the old stock photos. When I look at my flashxml/mediaslideshowfx/ directory it appears that the correct files are uploaded. How come my files are not translating onto my site.

Hi,

After making these changes, please clear the browser cache to see the modifications.

this plugin does not work in the new version of wordpress 3.1.1.

“Fatal error: Call to undefined function mediaslideshowfx_echo_embed_code() in…”

Hi,

Please make sure that you are using the latest version of the WP plugin and that you have uploaded the files in the package to the correct folder. This error usually happens when the plugin can’t find the component’s files. If you are still having problems please give us a link to your page to check out the problem.

Hello there,

I was trying to download the free trial version, but I keep getting:

test failed,
unable to extract file. test aborted.

crc failed in images\big\05.jpg the file is corrupt

media-slideshow.zip. The archive is corrupt.

Thanks very much, Be Blessed

Hi,

We have tested the Download Archive process and we didn’t encounter any problems.

Please tell us what browser are you using and what modification have you made in the Live Demo controls before you tried to download the archive.

## Do you have a question?

you will get an answer in 24 hours, tops.

(required) Only alphanumeric characters allowed
(required) (will not be published)
Please type a message! Your message is too long! Either try to keep within 1500 characters, or contact our support team via email at support [at] flashxml.net.
(will not be published)
You mistyped the two words!