Open Graph

by Will Norris

Description

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 Like 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 Like 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.

Faq

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:admin’, 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:admin'] = '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 to enable/disable “strict mode”

The plugin populates the meta ‘name’ attribute alongside the ‘property’ attribute by default. Because both, the og:* and twitter:* names, are actually registered at https://wiki.whatwg.org/wiki/MetaExtensions, this stays compliant with the HTML5 spec. If you want to use a more strict way anyways, you can enable the scrict mode by adding the following line to your config.php

define( 'OPENGRAPH_STRICT_MODE', true );

Reviews

Бұл қондырма жақсы істейді

By Данияр НАУРЫЗ (dnauryz) on March 10, 2025

Иә, қарапайым әрі мықты қондырма. Бәрі көңілдегідей.

Excellent and just do the job

By Chise Hachiroku (chise86) on October 29, 2024

This plugin does what it says it does - it adds open graph metadata on website.

No configuration and do the work just as advertised. Simply excellent.

Funciona perfectamente bien

By jvasquez1000 on August 31, 2023

El plugin funciona muy bien, solo lo instalé y pude compartir los productos de mi tienda en FB sin problema. Hasta ahorita todo bien.

Easy Plugin to Add Open Graph

By Generasi Muda Khonghucu Indonesia (generasikhonghucu) on August 7, 2022

Very easy to install and add ability to have open graph for my website

Works amazing!!

By MI (seppier) on July 26, 2021

Wow thank you for making this plugin!!! I was so stressed about thumbnails errors but now I don't need to worry about it! Thanks!

worked on my website when others wouldn't

By stargirl1 on June 29, 2021

Great plug-in! I just installed it last night and now the og:image (large image preview) is looking correct on my posts when shared to Facebook. I normally don't leave reviews but noticed this plug-in had very few. It worked like a charm on my website to show the big preview when others (including some well known ones) wouldn't. I was getting frustrated and wasting time googling plug-ins that didn't work on my site for some reason. Finally this one worked! It does what it says, and is very simple to use, no configuration needed.

Facebook previews show correctly now

By ssouthwell on December 5, 2019

Added this to a stock WordPress install, and Facebook previews for my pages began working correctly immediately! Thanks!

Does what it says on the tin

By bajandh on July 16, 2017

Runs just fine with 4.8. Had to edit the plugin and enable strict mode to make Facebook's sharing debugger happy - it's not happy about meta property=foo name=foo. Once that was done, the debugger showed all of the images in each post under the og:image tag, and sharing on Facebook enabled choosing one or more images for the share.

Changelog

Project maintained on github at pfefferle/wordpress-opengraph.

2.0.2 (Feb 25, 2025)

Add a constant to easily change the max number of images to be included in the OpenGraph meta tags.

2.0.1 (Dec 16, 2024)

Fixed a warning
Improved opengraph_max_images handling

2.0.0 (Dec 01, 2024)

complete rewrite of image handling
added support for block images
added parsing of HTML <img> tags
improved WordPress Coding Standards compliance

1.12.2 (Nov 17, 2024)

optimized readme and updated dependencies

1.12.1 (Jul 15, 2024)

fix fediverse account normalization

1.12.0 (Jul 3, 2024)

support <meta name="fediverse:creator" />

1.11.3 (Jun 4, 2024)

don’t return description for password protected posts

1.11.2 (Nov 13, 2023)

stript tags from title, site-name and description

1.11.1 (Apr 03, 2023)

fixed a typo

1.11.0 (Oct 21, 2021)

fixed attachment issue
fixed PHP 7.4 issue

1.10.0 (Apr 20, 2020)

basic video support
basic audio support

1.9.0 (Mai 14, 2019)

show only featured image if available
prefer header images over site-icon
use avatar for profile pages
fallback to description if title is empty
better twitter card handling

1.8.3 (Jan 27, 2019)

added escaping for the missing attributes

1.8.2 (Nov 21, 2018)

fixed PHP warning issue: https://wordpress.org/support/topic/php-warning-count-parameter-must-be-an-array-or-an-object-that-implements-c/

1.8.1 (Nov 19, 2016)

change og:image to use the full size of image (props @torenord)

1.8.0 (Jan 29, 2016)

fixed article:author property
added article:modified_time
added first category as article:section

1.7.0 (Jan 18, 2016)

added “strict mode” setting
better twitter:card handling
basic twitter:creator support
WordPress coding standard

1.6 (Dec 30, 2014)

implemented get_the_archive_title and get_the_archive_description (new in WordPress 4.1)
basic twitter cards support (thanks to elroyjetson)
replace $post->post_title with get_the_title() (see #17 for details)

1.5.1 (Nov 13, 2012)

fix duplicate opengraph markup when used with jetpack plugin (for real)

1.5 (Nov 13, 2012)

include descriptions on tag and category pages
include profile metadata on author pages
fix bug with 404 pages include extra og:image values
general code cleanup (including removal of dependency on global vars)
fix duplicate opengraph markup when used with jetpack plugin

1.4 (Aug 24, 2012)

better default description
include all images that are attached to a post, so that users can choose
which to use when sharing the page. If the post has a post thumbnail, that
is still used as the primary image.

1.3 (May 21, 2012)

add ‘opengraph_prefixes’ filter for defining additional prefixes
add new basic properties, and remove some old ones. This is a breaking
change for anyone that was using the old properties, but they can always be
added using the ‘opengraph_metadata’ filter. (see f476552 for details)
updates to many default values, particularly for individual posts and pages
(thanks pfefferle)
add basic support for array values (see d987eb7)

1.2 (Feb 21, 2012)

switch to newer RDFa prefix syntax rather than XML namespaces (props
pfefferle)

1.1 (Nov 7, 2011)

fix function undefined error when theme doesn’t support post thumbnails

1.0 (Apr 24, 2010)

initial public release