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.2
Release Date: April 9, 2008
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:
Versions prior to 1.4 are here, should you want them:
- kml_flashembed_wp_131.zip
- kml_flashembed_wp_12.zip
- kml_flashembed_wp_11.zip
- kml_flashembed_wp_10.zip
- kml_flashembed_wp_03.zip
- kml_flashembed_wp_02.zip
- kml_flashembed_wp.zip
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.
Help
Please refer to the Kimili Flash Embed FAQs section to help resolve the most common issues people come across when using KFE.
Bugs
If you come across a bug or an incompatibility, please contact me with the specifics. I will do my best to rectify it as quickly as possible.