=== pb-embedFlash === Contributors: pasber Donate link: http://pascal-berkhahn.de/impressum/donation-spende/ Tags: flash, post, video, widget, sidebar, media player, swf, flv, SWFObject, flashbox Requires at least: 2.0 Tested up to: 2.3.3 Stable tag: 1.5 (rc 5.2) A filter for WordPress to display any flash content in valid XHTML code offering the possibility to specify attributes and parameters individually. With admin panel, sidebar widget and TinyMCE Popup! == Description == **pb-embedFlash** is a filter for WordPress to display **any flash content** in **valid XHTML 1.0 Strict** code offering the possibility to specify attributes and parameters individually. It's easy to use but the final appearance of your embedded files can be modified heavily. With *admin panel*, *sidebar widget* and *TinyMCE Popup*! Playlist/Media manager comes in final v1.5! This plugin comes with currently three ways of displaying your flash content: * `` tag * SWFObject (JavaScript) * Flashbox ("Lightbox for videos", JavaScript). **pb-embedFlash** primary supports, but is not limited to... * .swf * .flv, .mp3, .png, .jpg, .gif and .xml playlist via JW FLV Media Player * YouTube * Google Video * Revver * SevenLoad * Vimeo * GUBA * ClipFish * MetaCafe * MyVideo * Veoh * ifilm * MySpace Videos * Brightcove * aniBOOM * vSocial * GameVideos * VideoTube * AOL UnCut * grouper Unfortunately, Blip.tv, Garage TV, Break.com, dailymotion and Yahoo! do not put the videoID into the browser URL; therefore you have grab the path to the video file from the embedding-HTML-code they offer. If your favorite video hoster is not listed as supported by this plugin, *you still can use it* by copying the link to the video out of the embedding code. Please give me a note if a video hoster is missing or not fully supported, thanks. **See the Installation tab for more information about the usage.** == Installation == = Installation = 1. Unpack the zip archive. 2. Upload the folder `pb-embedflash` to *wp-content/plugins/*. 3. Activate the plugin in your admin panel. = Update = If you are updating from v1.2 or later: 1. Deactivate the plugin 2. Delete *wp-content/plugins/pb-embedflash/* 3. Install the new version. If you are updating from v1.0 or later: 1. Deactivate the plugin. 2. Delete `wp-pb-embedFlash.php` and, if existing, `flvplayer.swf` from *wp-content/plugins/*. 3. Install the new version. = Usage = To embed flash files into your posts, please insert the URL into following code: `[flash URL]`. URL is the full address with heading http://. **If you want to embed movies from YouTube, Google Video, etc., simply post the full address of the item's site.** Example: `[flash http://www.youtube.com/watch?v=SOME_CHARACTERS]` or `[flash http://video.google.com/videoplay?docid=SOME_NUMBERS]`. Width and height are set to the respective settings of the supported hoster automatically. **You don't need to cut sth. out of an address or HTML code!** **flv support** is realized with [Jeroen Wijering's FLV Media Player](http://www.jeroenwijering.com/?item=JW_FLV_Media_Player), included within the plugin archive. Just use [flash URL], the flv file is detected automatically. (You have to buy a license to use that player commercially.) **!!! *The following documentation of possible values is eased heavily by the admin panel popup (since v1.5)* !!!** You can define different values by using the following code: `[flash URL VALUES]`. VALUES can be one or more of these: * If you want to override the default values for width and hight, use the following code: `w=WIDTH h=HEIGHT`. WIDTH and HEIGHT are in pixels as number-only without unit. * If you want to override the default value for the class, use the following code: `class=CLASS`. CLASS is the class to be used. If you don't specify a class, the default class "embedflash" will be taken. * To specify the style for the `` without defining a class, use the following code: `style={STYLE}`. STYLE must be valid CSS code. Please ensure that you put it into {} brackets! * You can also display a link to the file with a specified text: `extern={TEXT|LINK}` or `extern={TEXT}`. TEXT is the text to show as link, LINK will be the target. If no LINK is given, it defaults to URL. Please ensure that you put it into {} brackets! Example #1: `extern={Go to YouTube}` will output: `Go to YouTube`. Example #2: `extern={Visit the author's website|http://domain.com/?site=home}` will output: `Visit the author's website` If you are embedding a video from a hoster supported by this plugin, you can add a "Watch it at ..." link by adding `extern=1` instead. * If you want to specify additional parameters to the `` tag, use the following code: `o={PARAMETERS}`. PARAMETERS can be one ore mutiple valid parameters for the `` tag except 'data', 'width', 'height', 'class' and 'style'. Please ensure that you put it into {} brackets! Example: `o={tabindex="2" name="flashmovie"}` will be outputted as: `` * If you want to specify additional `` tags, use the following code: `p={NAME-1;VALUE-1|NAME-2;VALUE-2|...|NAME-N;VALUE-N}`. Both NAME and VALUE have to be specified. You can add quite infinite `` tags by seperating the different couples with the "|" character. Please ensure that you put it into {} bracktes! Example: `p={menu;false|quality;high}` will be outputted as: `` * You can also specify some flashvars for Jeroen Wijering's Media Player: `f={FLASHVARS}`. Example: `f={autostart=true&repeat=true}`. Please ensure that you connect the flashvars with ampersands (&), that you avoid whitespaces and that you put it into {} bracktes!. Visit [Jeroen Wijering's website](http://www.jeroenwijering.com/?item=Supported_Flashvars) for a list of flashvars you can use. * For Flashbox, you can specify the `linktext={}` (some text or an image) and the `caption={}` (text displayed inside the box). HTML is supported. Example: `linktext={Flashbox} caption={Great movie!}`. Please ensure that you put both into {} brackets! * To easily use an image as link to Flashbox, you can specify the source of an image in `preview={}`. The alt attribute of the image tag is set to the image filename (e.g. movie.gif). Example: `preview={http://domain.tld/img/thumb/movie.gif}`. Please ensure that you put it into {} brackets! * If loading preview images from YouTube and GameVideos has been disabled by default, you can still use it by adding `preview=force`. The alt attribute of the image tag is set to "preview image". * To easily overwrite the default mode of embedding your flash content, you can specify `mode`. Examples: `mode=0` will use the object tag, `mode=1` refers to SWFObject, `mode=2` to SWFObject on IE only and `mode=3` to Flashbox. == Frequently Asked Questions == = How can I switch to object tag, SWFObject or Flashbox? = You can decide to use one of them in the admin panel (**Options/pb-embedFlash**) or on per-flash basis via the `mode` option. = How can I activate Slimbox, Lightbox and Flashbox disturb each other? = You can activate Slimbox in the admin panel (**Options/pb-embedFlash**). It also works if Flashbox is not used! = How can I disable the fullscreen feature of JW FLV Media Player? = Simply add "f={usefullscreen=false}" to the flash tag. [Read more](http://www.jeroenwijering.com/?item=Supported_Flashvars) about supported flashvars or use [the wizard](http://www.jeroenwijering.com/?page=wizard&example=91). Please post your questions in a [new topic](http://wordpress.org/tags/pb-embedflash?forum_id=10#postform). == Screenshots == 1. All you need is the [flash ...] tag, e.g. to add a video from YouTube ... 2. ... or your own flash file or movie with the help of the TinyMCE Popup. 3. This is the code generated by the popup. 4. The second gameplay trailer of StarCraft II in Flashbox. 5. This is the head of the admin panel (**Options/pb-embedFlash**). 6. You can change the main options, ... 7. ... messages displayed on missing JavaScript or on search results, .... 8. ... Flashbox settings, ... 9. ... Slimbox settings and ... 10. ... the default flashvars for the JW FLV Media Player == Issues == * Unfortunetly, mootools.js (used for Flashbox) and Lightbox don't like each other, so there are problems using both of them simultaneously. But there is a solution: [Slimbox](http://www.digitalia.be/software/slimbox) (by Christophe Beils)! It's a clone of Lightbox, but small, efficient, more convenient and 100% compatible - and it uses mootools! (Slimbox also uses rel="lightbox". You don't need to change existing posts. NGGallery and other Plugins will still work. If a plugin supports Lightbox, it supports Slimbox, too.) Slimbox is included within the plugin archive and can be activated in the admin panel (**Options/pb-embedFlash**). * Flashbox does not work for Internet Explorer versions lesser than 7.0! All other browsers should work, like Opera, Firefox, Safari and IE7. == Change log == **1.5** (*rc 5*) * advanced admin panel * added popup button to TinyMCE * added sidebar widget * added Flashbox * added Popup * added Slimbox as alternative to Lightbox (see Issues) * added possibility to choose the embedding mode individually * added the new version 3.15 of JW FLV Media Player * renewed translation * changes to automatic detection of video hoster platforms * code rework **1.4** (*2008-01-18*) * added an options page to the admin panel * set `allowfullscreen=true` as default for JW FLV Media Player **1.3** (*2008-01-12*) * added workaround for the "Click to activate" issue by using SWFObject on IE browsers. * added the new version 3.13 of JW FLV Media Player **1.2.3** (*2007-12-08*) * improved extension detection * added alternative text to feeds * updated language files **1.2.2** (*2007-05-23*) * bugfixes and some code rework **1.2.1** (*2007-05-15*) * bugfixes **1.2** (*2007-05-08*) * added automatic detection of YouTube, Google Video, Revver, SevenLoad, Vimeo, GUBA, ClipFish, MetaCafe, MyVideo, Veoh, ifilm, MySpace Videos, Brightcove, aniBOOM, vSocial, GameVideos, VideoTube, AOL UnCut and grouper links. (Blip.tv, Garage TV, Break.com, AOL Video, dailymotion and Yahoo! don't put the videoIDs into the URL, you have to grab the video file path from the embedding code they offer) * added language support via .mo files * added extern=1 to generate a link to the video hosters easily * changed the usage of the extern={} value * reworked all regular expression patterns * switched to Jeroen Wijering's Media Player (also plays .mp3 music and displays .png, .jpg and .gif files; read the [documentation](http://www.jeroenwijering.com/extras/readme.html#playlists) for playlist creation) **1.1.1** (*2007-05-03*) * fixed style={} so that it works how documented **1.1** (*2007-05-03*) * added flvplayer.swf * added .flv support via Jeroen Wijering's FLV Player * added f={} to use flashvars for Jeroen Wijering's FLV Player **1.0** (*2007-03-25*) - Initial release.