Kimili Flash Embed for Wordpress

The Kimili Flash Embed for Wordpress has been updated with the latest version of the SWFObject javascript. It is fully compatible with WP 2.x and plays well with most other plugins.

Download

Current Version: 1.4.3
Release Date: September 12, 2008

Download Kimili Flash Embed for Wordpress – v. 1.4.3 from wordpress.org

Archived Versions

Although I strongly recommend that you use the latest version of KFE, available above, you can download previous versions from 1.4 to the current from the Wordpress plugin repository:

Kimili Flash Embed Archive

Versions prior to 1.4 are here, should you want them:

Donate

If you enjoy using Kimili Flash Embed and find it useful, please consider making a donation. Your donation will help encourage the plugin’s continued development so you can be sure it always works with ever newer versions of your CMS of choice. Besides, when you donate, you will be repaid tenfold in good karma.

Donate Now

Basic Usage

To install Kimili Flash Embed on your Wordpress site, just unzip and upload the kml_flashembed_wp_14 folder to the /wp-content/plugins/ directory of your site. If you have an old version of kml_flashembed.php or a kml_flashembed_wp_xx folder in there, it’s fine to simply deactivate the old version and delete it. Then login to your site administration, go to the plugins screen and simply activate Kimili Flash Embed 1.4.

In order to add Flash movies to your article posts, use the following syntax:

[kml_flashembed movie="/path/to/your/movie.swf" height="300" width="300" /]

If you’re using the WYSIWYG editor to write your posts, you should see a new button on the right end of the toolbar with a Flash player logo. Click it, and a basic KFE tag will be dropped into your post editor, ready to be populated with the SWF URL, width and height.

If you have used KFE in the past, you will notice that the square brackets are new. This is because the WYSIWYG editor in Wordpress 2.0 has a tendency to strip non-standard html tags that use angle brackets. If you’re still on an older version of Wordpress, you can leave your existing KFE tags alone, as they will still be recognized.

The only required attributes in a KFE tag are movie, height, and width. See the KFE home page for all available attributes and advanced usage.

Using Flash Player Express Install

If you want to give visitors to your site the option to upgrade their Flash Player to the latest version as quickly and seamlessly as possible, you can use the Flash Player’s Express Install functionality. As of KFE 1.3, there is a new, simpler method for invoking the Express Install functionality which reflect changes in SWFObject 1.5.

General Notes

Your SWF files need to be a minimum of 214px wide by 137px high so the entire upgrade dialog can be seen by the user if the Express Install is triggered. Furthermore, if your Express-Install-enabled SWF is not at least that size, the Express Install function will automatically fail.

It may also be a good idea to only place one SWF with Express Install functionality on each page. This way users won’t be greeted with multiple upgrade dialog boxes and be forced to choose one. Onto the specifics:

Specifics

1. Define the minimum flash player version required by your .SWF using the fversion attribute:

fversion="9"

2. Add the useexpressinstall attribute to your [kml_flashembed /] tag, like this:

useexpressinstall="true"

3. OPTIONAL – You can also add the xiredirecturl attribute to redirect users who successfully upgrade their flash player:

xiredirecturl="http://www.yoursite.com/bleeding/edge/flash/"

In the end, your KFE tag should look something like this:

[kml_flashembed movie="filename.swf" height="300" width="300" fversion="9" useexpressinstall="true" /]

That is all you need in order to invoke the Express Install functionality. In the case of the above KFE tag, if a user arrives at your site with either a Flash Player 6, 7, or 8 installed, they will be alerted that they need a more recent version of the Flash Player and be given the option to upgrade it without leaving your site.