Visit SlideShowPro.net  Community Forums
SlideShowPro Help Wiki
  

SlideShowPro Standalone

How it works

SlideShowPro Standalone is a version of the SlideShowPro media player distributed as a SWF file that can embedded in any HTML document. You use it to display photo galleries, slideshows and video players just like you would with the Flash and Lightroom versions. Except with Standalone, all parameter edits happen through your own XML files or with our free SlidePress plugin for WordPress.

Basic functionality

The core element of SlideShowPro Standalone is slideshowpro.swf in the "SWF" folder. You can embed this SWF in any web document that allows you to embed the Flash Player.

When the SWF is embedded and viewed in a web browser, it automatically calls param.xml (found in the "Samples" folder) using the URL assigned through the paramXMLPath variable in the player embed code. This XML file contains all of the SlideShowPro player's editable parameters. You may change any of these to a value that's acceptable, reload your browser, and the new settings will be displayed.

Each parameter is named the same as their ActionScript equivalents. Complete information about what each parameter does, and what values are acceptable, is available in the SlideShowPro for Flash API section.

Sizing the SWF

SlideShowPro Standalone automatically scales itself to the size of slideshowpro.swf, so if you want a slideshow that's 600px wide by 400px high, simply embed the SWF at those dimensions and SlideShowPro will resize itself to fill those dimensions.

Slideshow Data

Standalone can load a static XML file (coded by you), dynamic XML markup returned through a web scripting language (PHP, ASP, etc), Media RSS feeds, OPML documents containing one or more XML feeds, or content from our content management system SlideShowPro Director.

Using a static XML file

Inside the "Sample" folder is a demonstration XML file that shows the general markup SlideShowPro Standalone needs. It consists of a parent <gallery> element, which can contain one or more <album> elements of content. Each album element is the parent of one or more img elements for your slideshow content. There are a number of options when coding a static XML file, which are covered in more detail in the "Creating an XML document" wiki document.

Using a Media RSS feed

SlideShowPro Standalone can load any valid Media RSS 2.0 feed from a third party site as long as that web site allows Flash applications (like ours) to retrieve data from them. Most photo sharing sites publish Media RSS feeds and allow access.

To assign a Media RSS file, copy the URL of the feed and edit xmlFilePath in param.xml accordingly. Then set xmlFileType directly underneath to "Media RSS". Reload the HTML document embedding slideshowpro.swf and your RSS feed should load.

If your feed doesn't load, view the source to ensure it's a RSS 2.0 file (and not Atom). Second, try looking for the host site's crossdomain file, which is at the root of their domain . If it doesn't exist, their feeds can't be loaded by Flash. If it does exist, but does not contain the domain where slideshowpro.swf is loaded, or a wild card to allow any domain, their feeds also can't be loaded.

Using SlideShowPro Director

SlideShowPro Director is our server-side, content management and publishing application for supplying slideshow data. When used with the standalone version, simply copy the XML File Path displayed on the "Summary" page for any album / gallery created inside Director, paste it as the value of xmlFilePath, and set xmlFileType to "Director". SlideShowPro Director will create all requisite content for your slideshow using the parameters you've assigned.

Using an OPML file

OPML files group together more than one XML file so that each feed is joined together into a single gallery. Simply edit xmlFilePath with the path to your OPML file, and change xmlFileType to "OPML". For more information on how to create an OPML file, see the Loading multiple XML documents document.

Content

If you are coding your own XML file, chances are you're creating your own slideshow content as well. The SlideShowPro player accepts GIFs, PNGs or JPGs for images. For video, you can load FLV or h264 encoded MP4 files.

There are three main pieces of external content the SlideShowPro player loads: slideshow content, thumbnails, and an album preview. Slideshow content is the main images/videos seen in the Content Area. Thumbnails show up in the navigation (if the "Thumbnails" Navigation Link Appearance setting is used) as slideshow content links, and as link previews when navigation links are rolled over. Album previews appear in the gallery, and have multiple layout/display options available. More information on manually creating your own slideshow content can be obtained in the Content Loading and Creation section of the SlideShowPro for Flash User Guide.

Where to from here?

Because embedding SWFs is a topic unto itself, see the Embedding document for help embedding slideshowpro.swf. If you're interested in some of the more advanced customization options, see Extra customization options.

Page last modified by tdominey on June 11, 2010, at 12:49 PM
© 2010 Dominey Design Inc. All Rights Reserved.
About | Merchandise | Contact | Privacy policy | Legal | Licensing