WordPress.org

What is oEmbed

oEmbed is a simple API that allows a website to display embedded content (such as photos or videos) when a user posts a link to that resource. It was designed to avoid copying and pasting HTML from the media you wish to embed.

What is oEmbed for BuddyPress?

oEmbed for BuddyPress utilizes WordPress' own oEmbed class, so by default, you can share content from the following sites:

• YouTube
• Blip.tv
• Vimeo
• DailyMotion
• Flickr
• Hulu
• Viddler
• Qik
• Revision3
• Photobucket
• Scribd
• WordPress.tv

The plugin allows you to input any URL from one of the listed sites above into an activity update or forum post in BuddyPress.

When the update is posted, the URL automagically transforms into the embedded content. There is no GUI.

For more information, check out the "Other Notes" tab.

What version of BuddyPress do I need to use this plugin?

You need at least BuddyPress 1.2, which in turn requires WordPress 2.9 or WordPress MU 2.9.1.1.

Where's the admin settings page?

oEmbed for BuddyPress works transparently in the background.

There is no admin settings page! This is intentional (at least for now). All settings can be modified in bp-oembed-config.php.

By default, the plugin allows embedding in activity updates, activity comments and forum posts.

Then how do I turn off oEmbed for certain BuddyPress components?

Open bp-oembed-config.php in a text editor.

Let's say you wanted to disable oEmbed for activity comments.

Find the following line:

$bp_oembed['activity_comments'] = true;

And change it to:

$bp_oembed['activity_comments'] = false;

How do I extend WordPress' oEmbed provider list?

By default, you can only embed content from websites listed on WordPress' internal whitelist. This is to prevent the embedding of malicious content from untrustworthy websites.

To add an oEmbed provider, read the following article for more info: http://codex.wordpress.org/Embeds#Adding_Support_For_An_oEmbed-Enabled_Site

The other option is you can override WordPress' internal whitelist and enable any site that is oEmbeddable by downloading and activating Viper007Bond's Enable oEmbed Discovery plugin. You should only activate the oEmbed Discovery plugin if you trust your user base. You've been warned.