Search

rue )); } }</code> ===== See Also ===== * [[reference:SimplePie:start]] * [[reference:SimplePie_Item:start]] * [[reference:SimplePie_Enclosure:start]] * [[reference:SimplePie_Enclosure:native_embed]]

====== native_embed() ====== ===== Description ===== <code>class SimplePie_Enclosure { native_embed ( [(array) $options] ) }</code> Embeds the enclosure into the webpage using the HTML ''<embed>'' tag. This will use ''[[reference:SimplePie_Enclosure:get_real_type]]'' to determine which handler should be used to embed the content into the page. SimplePie supports QuickTime, Windows Media, Flash, Flash Media, and the Odeo Player for Odeo feeds. Because of the fallout from the [[http://en.wikipedia.org/wiki/Eolas|Eolas lawsuit against Microsoft]] and the [[http://blogs.msdn.com/ie/archive/2006/04/11/573479.aspx|changes that were recently made to Internet Explorer]] as a result, we generate and include a [[http://msdn.microsoft.com/library/default.asp?url=/workshop/author/dhtml/overview/activating_activex.asp|JavaScript library containing functions]] that allow us to embed the multimedia content. This function is identical to ''[[reference:SimplePie_Enclosure:embed]]'' except that, whereas ''[[reference:SimplePie_Enclosure:embed]]'' uses JavaScript to dynamically create the ''<embed>'' object, this function writes the ''<embed>'' tag directly to your pages, so that JavaScript is not required. It also works better for free webhosts that insert advertisements into everything. On the flip-side, //pages using this function WILL NOT [[http://validator.w3.org|VALIDATE]] as HTML or XHTML, because the ''<embed>'' tag is invalid.// ===== Availability ===== * Available since SimplePie Beta 3. ===== Parameters ===== ==== options ==== ''options'' is an array of multiple options that can all be passed into the [[reference:SimplePie_Enclosure:embed]] method. They are as follows: * ''alt'' (string)\\ Alternate content for when an end-user does not have the appropriate handler installed or when a file type is unsupported. Can be any text or HTML. Defaults to blank. * ''altclass'' (string)\\ If a file type is unsupported, the end-user will see the alt text (above) linked directly to the content. That link will have this value as its class name. Defaults to blank. * ''audio'' (string)\\ This is an image that should be used as a placeholder for audio files before they're loaded (QuickTime-only). Can be any relative or absolute URL. Defaults to blank. * ''bgcolor'' (string)\\ The background color for the media, if not already transparent. Defaults to ''#ffffff''. * ''height'' (integer)\\ The height of the embedded media. Accepts any numeric pixel value (such as ''360'') or ''auto''. Defaults to ''auto'', and it is recommended that you use this default. * ''loop'' (boolean)\\ Do you want the media to loop when its done? Defaults to ''false''. * ''mediaplayer'' (string)\\ The location of the included ''mediaplayer.swf'' file. This allows for the playback of Flash Video (''.flv'') files, and is the default handler for non-Odeo MP3's. Defaults to blank. * ''video'' (string)\\ This is an image that should be used as a placeholder for video files before they're loaded (QuickTime-only). Can be any relative or absolute URL. Defaults to blank. * ''width'' (integer)\\ The width of the embedded media. Accepts any numeric pixel value (such as ''480'') or ''auto''. Defaults to ''auto'', and it is recommended that you use this default. * ''widescreen'' (boolean)\\ Is the enclosure widescreen or standard? This applies only to video enclosures, and will automatically resize the content appropriately. Defaults to ''false'', implying 4:3 mode. **NOTE:** Non-widescreen (4:3) mode with ''width'' and ''height'' set to ''auto'' will default to 480x360 video resolution. Widescreen (16:9) mode with ''width'' and ''height'' set to ''auto'' will default to 480x270 video resolution. ===== Examples ===== <code php>$feed = new SimplePie(); $feed->set_feed_url('http://youtube.com/rss/global/top_favorites.rss'); $feed->init(); $feed->handle_content_type(); foreach ($feed->get_items() as $item) { if ($enclosure = $item->get_enclosure()) { echo $enclosure->native_embed(array( 'alt' => 'Download this enclosure!', 'audio' => './for_the_demo/place_audio.png', 'video' => './for_the_demo/place_video.png', 'mediaplayer' => './for_the_demo/mediaplayer.swf', 'widescreen' => true )); } }</code> ===== See Also ===== * [[reference:SimplePie:start]] * [[reference:SimplePie_Item:start]] * [[reference:SimplePie_Enclosure:start]] * [[reference:SimplePie_Enclosure:embed]]