Primary

Open Graph Protocol Framework

Description

The Open Graph Protocol enables any web page to become a rich object in a social graph. For instance, this is used on Facebook to allow any web page to have the same functionality as any other object on Facebook.

The Open Graph Protocol Framework WordPress plugin is aimed at automating the process of adding basic and optional metadata to a site’s pages. It is also designed to act as a framework for other plugins or themes and allows to modify and adapt the information provided as needed.

Usage

Install and activate the plugin. It will automatically render the following metadata for posts, pages, etc. :

  • og:title : The page’s title is used, this provides the title for posts, pages, archives etc.
  • og:type : The type will be article in general, website for the front page and blog for the blog homepage.
  • og:image : For post types that support featured images, the URL of the featured image is used. Additional metadata is added, including:
    og:image:width
    og:image:height
    og:image:url
    og:image:secure_url
    og:image:alt
  • og:url : The URL of the current page.
  • og:site_name : The name of the site.
  • og:description : Uses the full excerpt if available, otherwise derives it from the content. For author and archive pages, the type of page and title is used.

Constants

OPEN_GRAPH_PROTOCOL_DEBUG

The OPEN_GRAPH_PROTOCOL_DEBUG constant can be used to enable debug traces where meta tags are generated by the extension. If enabled, meta tags generated by the plugin will have <!-- OFPF x.y.z --> appended, where x.y.z is the version of the plugin. To enable, add this line to your site’s wp-config.php:

define( 'OPEN_GRAPH_PROTOCOL_DEBUG', true );

… before the line that says:

/* That's all, stop editing! Happy blogging. */

Note that you do not need to set this constant, unless you want those traces to be added for debugging purposes.

Filters

This section is for developers. If you’re not a developer, you can safely skip it.

The plugin provides the following filters:

open_graph_protocol_meta

This filter allows to modify the value of the content attribute for a given meta tag. It is invoked for every supported type of metadata.

Parameters:

  • string content – the current value of the content attribute
  • string property – the metadata name, for example og:title

Filters must return:

  • string the desired value of the content attribute

open_graph_protocol_meta_tag

This filter allows to modify the actual HTML <meta> tag that is rendered in the <head> section of pages.

Parameters:

  • string HTML <meta> tag
  • string property – the metadata name, for example og:title
  • string content – the value of the content attribute

Filters must return: – string the desired output for the HTML <meta> tag

open_graph_protocol_meta_tag_suffix

This filter allows to modify the suffix that is appended to each meta tag. By default, this adds a newline character.

Parameters:

  • string suffix (defaults to the newline character)

Filters must return: – string the desired suffix

open_graph_protocol_metas

This filter allows to add or remove metadata before it is rendered.

Parameters:

  • array of metadata indexed by metadata name

Filters must return: – array of metadata indexed by metadata name

open_graph_protocol_echo_metas

This filter allows to modify the HTML that renders the plugin’s meta tags in the <head> section.

Parameters:

  • string HTML with <meta> tags to be rendered

Filters must return: – string HTML with <meta> tags to be rendered