Extension:OpenGraphMeta

MediaWiki extensions manualManual:Extensions

OpenGraphMeta Release status:Extension status beta
ImplementationTemplate:Extension#type	Data extraction, Parser function
DescriptionTemplate:Extension#description	Provides OpenGraph meta tags providing data for 3rd parties like Facebook to extract
Author(s)Template:Extension#username	Daniel Friesen (Dantmantalk)
Database changesTemplate:Extension#needs-updatephp	No
LicenseTemplate:Extension#license	GNU General Public License 2.0 or later
Download	Download snapshot (Git master) Git [?]: repo summary browse file tree (GitHub) commit history code review
ParametersTemplate:Extension#parameters $egFacebookAppId $egFacebookAdmins
Hooks usedTemplate:Extension#hook ParserAfterTidyManual:Hooks/ParserAfterTidy BeforePageDisplayManual:Hooks/BeforePageDisplay
Translate the OpenGraphMeta extension if it is available at translatewiki.net
Check usage and version matrix.

OpenGraphMeta provides OpenGraph protocol metadata for articles on the wiki for 3rd parties like Facebook to extract. The primary use for this extension is for any wiki that provides its users a button to "Like" pages on the wiki, especially if the wiki uses a custom default skin. As sometimes Facebook can extract undesirable parts from the page (known on some custom skins to potentially extract random images irrelevant to the content) providing this data gives Facebook clean data to display in likes, and cleans up the long title into a pair of clean site and page titles. A parser function {{#setmainimage:Filename.ext}} which also exports what it is passed so you can use it easily in a [[File:{{#setmainimage:Filename.ext}}|thumb|right|...]] format can be used to set the image in the article which you prefer Facebook to use when displaying information about the page on your wiki (hint: This works very nicely when you incorporate it into an infobox template making the infobox image the preferred image for 3rd parties to use).

This extension can also be paired with Extension:Description2 which extracts description information from articles, when both are installed OpenGraphMeta will make use of the information Description2 extracts.

Tags

We need to provide the ability to maximize the amount of information available of the shared content so that it is more descriptive, while still in compliance with our policy.

Installation

1. Download a snapshot and extract it to your extensions directory. Try the development version, or choose the version that matches your version of MediaWiki if the trunk version breaks.
2. Add

   require_once( "$IP/extensions/OpenGraphMeta/OpenGraphMeta.php" );
   

   to the bottom of LocalSettings.php.
3. Installation can now be verified through Special:Version of your wiki.

See Also

• Extension:Description2 – Provides page description information. When installed OpenGraphMeta will use the information it extracts from articles.
• http://developers.facebook.com/tools/debug - Simple tool that enables preview of what Facebook will display based on Open Graph meta tags
• Extension:TextExtracts - Provides an API to retrieve plain-text or limited HTML extracts of page content.
• pageterms API query module - Provides an API to retrieve the Wikidata description of any page