Adding Flash animations
Flash is a software technology for creating interactive animations. You can add Flash animations to your Wild Apricot site to provide a dynamic experience for your visitors.
Visitors to your site will need to have a Flash player plugin installed on their browser to view Flash animations.
Flash files typically use the .swf extension, though other extensions are used as well.
Uploading and embedding Flash files
To add a Flash animation to your Wild Apricot site, follow these steps:
- Go to the Files screen – by clicking Files under the Website menu – and upload your Flash file. You should create a separate folder to store your Flash files.
- Copy the following code to the clipboard.
<object codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,0,0" classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" width="500" height="500"> <param name="Src" value="/resources/flash/myflash.swf"> <param name="WMode" value="Transparent"> <param name="Play" value="true"> <param name="Loop" value="false"> <param name="Quality" value="High"> <param name="Menu" value="false"> <param name="AllowScriptAccess" value=""> <param name="Scale" value="ShowAll"> <param name="DeviceFont" value="false"> <param name="AllowNetworking" value="all"> <embed type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer" src="/resources/flash/myflash.swf" wmode="Transparent" play="true" loop="false" quality="High" menu="0" scale="ShowAll" devicefont="0" allownetworking="all" width="500" height="500"> </object>
- Go to Sites pages (under the Website tab) and begin editing the site page or page template where you want to add the Flash animation.
- Click the Gadgets icon to display the list of available gadgets.
- Drag the custom HTML gadget from the Gadgets list, and drop it on the desired location.
When a layout section or placeholder is empty, a Drop gadget or grid here prompt will be displayed. When you drag a gadget over an empty layout section or placeholder, it turns green, indicating that you can drop the gadget there. When you drag a gadget above or below a layout, a prompt will appear indicating that you can drop the gadget before or after the layout.
- After you have inserted the gadget, hover over it and click the Settings icon.
- Within the gadget settings on the left, click the Edit code button.
- In the dialog that appears, paste the code you copied earlier.
- Within the pasted code, replace the two occurrences of myFlash.swf with the name of your Flash file. If you saved the file to a folder other than a Flash folder, then replace flash with the name of the folder. If you didn't create a subfolder for the file, remove /flash entirely.on the Files screen, then include the directory name.
- Within the code, change the two sets of width and height parameters to match the dimensions of your animation.
- Click the Save button to your code changes.
- Click the Save button to save your changes to the page.
The Flash animation should now appear on your page. If it does not, switch to public view.
The following attributes are optional when defining the object and/or embed tags.
For an object, all attributes are defined in param tags unless otherwise specified. When inserting a new attribute please look at the quality attribute in the code above. You should add a new PARAM tag line and a new attribute to the OBJECT tag.
- id (attribute for object, object only) - Identifies the flash file to the host environment (eg the web browser) so that it can be referenced using a scripting language.
- play - Possible values: true, false. Specifies whether the flash file begins playing immediately on loading in the browser. The default value is true if this attribute is omitted.
- loop - Possible values: true, false. Specifies whether the flash file repeats indefinitely or stops when it reaches the last frame. The default value is true if this attribute is omitted.
- menu - Possible values: true, false.
- true displays the full menu, allowing the user a variety of options to enhance or control playback.
- false displays a menu that contains only the Settings option and the About Flash option.
- quality - Possible values: low, high, autolow, autohigh, best.** low favors playback speed over appearance and never uses anti-aliasing.
- autolow emphasizes speed at first but improves appearance whenever possible. Playback begins with anti-aliasing turned off. If the Flash Player detects that the processor can handle it, anti-aliasing is turned on.
- autohigh emphasizes playback speed and appearance equally at first but sacrifices appearance for playback speed if necessary. Playback begins with anti-aliasing turned on. If the actual frame rate drops below the specified frame rate, anti-aliasing is turned off to improve playback speed. Use this setting to emulate the View > Antialias setting in Flash.
- medium applies some anti-aliasing and does not smooth bitmaps. It produces a better quality than the Low setting, but lower quality than the High setting.
- high favors appearance over playback speed and always applies anti-aliasing. If the flash file does not contain animation, bitmaps are smoothed; if the flash file has animation, bitmaps are not smoothed.
- best provides the best display quality and does not consider playback speed. All output is anti-aliased and all bitmaps are smoothed.
- scale - Possible values: showall, noborder, exactfit.
- default (showall) makes the entire flash file visible in the specified area without distortion, while maintaining the original aspect ratio of the flash file. Borders may appear on two sides of the flash file.
- noorder scales the flash file to fill the specified area, without distortion but possibly with some cropping, while maintaining the original aspect ratio of the flash file.
- exactfit makes the entire flash file visible in the specified area without trying to preserve the original aspect ratio. Distortion may occur.
- align (attribute for Object) - Possible values: l, t, r, b.
- Default centers the flash file in the browser window and crops edges if the browser window is smaller than the flash file.
- l (left), r (right), t (top), and b (bottom) align the flash file along the corresponding edge of the browser window and crop the remaining three sides as needed.
- salign - Possible values: l, t, r, b, tl, tr, bl, br.
- l, r, t, and b align the flash file along the left, right, top or bottom edge, respectively, of the browser window and crop the remaining three sides as needed.
- tl and tr align the flash file to the top left and top right corner, respectively, of the browser window and crop the bottom and remaining right or left side as needed.
- bl and br align the flash file to the bottom left and bottom right corner, respectively, of the browser window and crop the top and remaining right or left side as needed.
- wmode - Possible values: window, opaque, transparent. Sets the Window Mode property of the flash file for transparency, layering, and positioning in the browser.
- window - flash file plays in its own rectangular window on a web page.
- opaque - the flash file hides everything on the page behind it.
- transparent - the background of the HTML page shows through all transparent portions of the flash file, this may slow animation performance.
- bgcolor - [hexadecimal RGB value] in the format #RRGGBB . Specifies the background color of the flash file. Use this attribute to override the background color setting specified in the Flash file. This attribute does not affect the background color of the HTML page.
- base - . or [base directory] or [URL]. Specifies the base directory or URL used to resolve all relative path statements in the Flash Player flash file. This attribute is helpful when your Flash Player files are kept in a different directory from your other files.
- flashvars - Possible values: variable to pass to Flash Player. Requires Macromedia Flash Player 6 or later.
- Used to send root level variables to the flash file. The format of the string is a set of name=value combinations separated by '&'.
- Browsers will support string sizes of up to 64KB (65535 bytes) in length.