Open Graph
The Open Graph protocol enables any web page to become a rich object in a social graph. Most notably, this allows for these pages to be used with Facebook’s Share Button and Graph API as well as within Twitter posts. The Open Graph plugin inserts the Open Graph metadata into WordPress posts and page
The Open Graph protocol enables any web page to become a rich object in a social graph. Most notably, this allows for these pages to be used with Facebook’s Share Button and Graph API as well as within Twitter posts.
The Open Graph plugin inserts the Open Graph metadata into WordPress posts and pages, and provides a simple extension mechanism for other plugins and themes to override this data, or to provide additional Open Graph data.
This plugin does not directly add social plugins like the Facebook Share Button to your pages (though they’re pretty simple to add). It will however make your pages look great when shared using those kinds of tools.
Frequently asked questions.
How do I configure the Open Graph plugin?
You don’t; there’s nothing to configure and there is no admin page. By default, it will use whatever standard WordPress data it can to populate the Open Graph data. There are very simple yet powerful filters you can use to modify or extend the metadata returned by the plugin, described below.
How do I extend the Open Graph plugin?
There are two main ways to provide Open Graph metadata from your plugin or theme. First, you can implement the filter for a specific property. These filters are of the form opengraph_{name} where {name} is the unqualified Open Graph property name. For example, if you have a plugin that defines a custom post type named “movie”, you could override the Open Graph type property for those posts using a function like:
function my_og_type( $type ) { if ( get_post_type() == "movie" ) { $type = "movie"; } return $type; } add_filter( 'opengraph_type', 'my_og_type' );
This will work for all of the core Open Graph properties. However, if you want to add a custom property, such as fb:admins , then you would need to hook into the opengraph_metadata filter. This filter is passed an associative array, whose keys are the qualified Open Graph property names. For example:
function my_og_metadata( $metadata ) { $metadata['fb:admins'] = '12345,67890'; return $metadata; } add_filter( 'opengraph_metadata', 'my_og_metadata' );
Note that you may need to define the RDFa prefix for your properties. Do this using the opengraph_prefixes filter.
How does the plugin choose the images?
The plugin uses the featured image first, then the images in the post content, then the images attached to the post. If there is no image at all, it uses the site icon, the custom logo or the header image.